the_content_rss() - WordPress 函数参考中文文档

返回介绍

the_content_rss()

发布于 2017-09-11 字数3700 浏览 974 评论 0

Warning: This function has been deprecated. Use the_content_feed() instead.

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

Display the post content for the 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. The value of ‘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)
(Optional)
Text to display when more content is available but not displayed.

Default value: ‘(more…)’

$stripteaser

(int)
(Optional)
Default is 0.

$more_file

(string)
(Optional)

Default value: ”

$cut

(int)
(Optional)
Amount of words to keep for the content.

$encode_html

(int)
(Optional)
How to encode the content.


源代码

File: wp-includes/deprecated.php

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);
	$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(']]>', ']]&gt;', $content);
	echo $content;
}

更新日志

Version 描述
2.9.0 Use the_content_feed()
0.71 Introduced.

相关函数

Uses

  • wp-includes/formatting.php:
    esc_html()
  • wp-includes/deprecated.php:
    make_url_footnote()
  • wp-includes/deprecated.php:
    the_content_rss
  • wp-includes/functions.php:
    _deprecated_function()
  • wp-includes/plugin.php:
    apply_filters()
  • wp-includes/post-template.php:
    get_the_content()
  • Show 1 more use
    Hide more uses


User Contributed Notes

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!