the_content_rss() — описание функции WordPress на русском

Сигнатура

the_content_rss( string $more_link_text = '(more…)', int $stripteaser, string $more_file = '', int $cut, int $encode_html )

Описание

Для кодирования HTML, то есть для параметра $encode_html, возможны три значения:

'0' превратит URL-адреса в сноски и использует make_url_footnote() .

'1' закодирует специальные символы и автоматически отобразит всё содержимое.

'2' удалит из содержимого все HTML-теги.

Обратите внимание, что нельзя задать количество слов, не задав при этом кодирование HTML.
В этом случае для кодирования HTML будет использовано значение по умолчанию 2, при котором удаляются все HTML-теги.
Чтобы ограничить количество слов в содержимом, можно использовать параметр cut.
Если содержимое короче указанного количества, то в конце не добавляется многоточие.
Если же часть содержимого остаётся, то добавляется многоточие, а остаток содержимого удаляется.
См. alsothe_content_feed()

Оригинал (английский)

For encoding the HTML or the $encode_html parameter, there are three possible values:

‘0’ will make urls footnotes and use make_url_footnote() .
‘1’ will encode special characters and automatically display all of the content.
‘2’ will strip all HTML tags from the content.

Also note that you cannot set the amount of words and not set the HTML encoding.
If that is the case, then the HTML encoding will default to 2, which will strip all HTML tags.

To restrict the amount of words of the content, you can use the cut parameter.
If the content is less than the amount, then there won’t be any dots added to the end.
If there is content left over, then dots will be added and the rest of the content will be removed.

Параметры

$more_link_text string необязательный = '(more…)'

Текст, отображаемый, когда доступно ещё содержимое, но оно не показано. Значение по умолчанию: '(more...)'.

$stripteaser int необязательный

Значение по умолчанию: 0.

$more_file string необязательный = ''

Default:''

$cut int необязательный

Количество слов, которое нужно оставить в содержимом.

$encode_html int необязательный

Как кодировать содержимое.

Исходный код

wp-includes/deprecated.php:1683

function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) {
	_deprecated_function( __FUNCTION__, '2.9.0', 'the_content_feed()' );
	$content = get_the_content($more_link_text, $stripteaser);

	/**
	 * Filters the post content in the context of an RSS feed.
	 *
	 * @since 0.71
	 *
	 * @param string $content Content of the current post.
	 */
	$content = apply_filters('the_content_rss', $content);
	if ( $cut && !$encode_html )
		$encode_html = 2;
	if ( 1== $encode_html ) {
		$content = esc_html($content);
		$cut = 0;
	} elseif ( 0 == $encode_html ) {
		$content = make_url_footnote($content);
	} elseif ( 2 == $encode_html ) {
		$content = strip_tags($content);
	}
	if ( $cut ) {
		$blah = explode(' ', $content);
		if ( count($blah) > $cut ) {
			$k = $cut;
			$use_dotdotdot = 1;
		} else {
			$k = count($blah);
			$use_dotdotdot = 0;
		}

		/** @todo Check performance, might be faster to use array slice instead. */
		for ( $i=0; $i<$k; $i++ )
			$excerpt .= $blah[$i].' ';
		$excerpt .= ($use_dotdotdot) ? '...' : '';
		$content = $excerpt;
	}
	$content = str_replace(']]>', ']]>', $content);
	echo $content;
}

История изменений

Версия	Описание
2.9.0	Deprecated. Use the_content_feed()
0.71	Introduced.