Make WordPress Core


Ignore:
Timestamp:
09/28/2009 02:36:48 PM (15 years ago)
Author:
ryan
Message:

Deprecates the_content_rss(). Add the_content_feed() and get_the_content_feed(). Convert places that called the_content_rss() with an excerpt length to the_excerpt_rss(). Remove the rss_excerpt_length option. Use the_content_feed() where the_content() was previously used in feeds. Props Viper007Bond.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/wp-includes/feed.php

    r11453 r11980  
    131131
    132132/**
    133  * Display the post content for the feed.
    134  *
    135  * For encoding the html or the $encode_html parameter, there are three possible
    136  * values. '0' will make urls footnotes and use make_url_footnote(). '1' will
    137  * encode special characters and automatically display all of the content. The
    138  * value of '2' will strip all HTML tags from the content.
    139  *
    140  * Also note that you cannot set the amount of words and not set the html
    141  * encoding. If that is the case, then the html encoding will default to 2,
    142  * which will strip all HTML tags.
    143  *
    144  * To restrict the amount of words of the content, you can use the cut
    145  * parameter. If the content is less than the amount, then there won't be any
    146  * dots added to the end. If there is content left over, then dots will be added
    147  * and the rest of the content will be removed.
    148  *
    149  * @package WordPress
    150  * @subpackage Feed
    151  * @since 0.71
    152  * @uses apply_filters() Calls 'the_content_rss' on the content before processing.
    153  * @see get_the_content() For the $more_link_text, $stripteaser, and $more_file
    154  *      parameters.
    155  *
    156  * @param string $more_link_text Optional. Text to display when more content is available but not displayed.
    157  * @param int|bool $stripteaser Optional. Default is 0.
    158  * @param string $more_file Optional.
    159  * @param int $cut Optional. Amount of words to keep for the content.
    160  * @param int $encode_html Optional. How to encode the content.
    161  */
    162 function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) {
    163     $content = get_the_content($more_link_text, $stripteaser, $more_file);
    164     $content = apply_filters('the_content_rss', $content);
    165     if ( $cut && !$encode_html )
    166         $encode_html = 2;
    167     if ( 1== $encode_html ) {
    168         $content = esc_html($content);
    169         $cut = 0;
    170     } elseif ( 0 == $encode_html ) {
    171         $content = make_url_footnote($content);
    172     } elseif ( 2 == $encode_html ) {
    173         $content = strip_tags($content);
    174     }
    175     if ( $cut ) {
    176         $blah = explode(' ', $content);
    177         if ( count($blah) > $cut ) {
    178             $k = $cut;
    179             $use_dotdotdot = 1;
    180         } else {
    181             $k = count($blah);
    182             $use_dotdotdot = 0;
    183         }
    184 
    185         /** @todo Check performance, might be faster to use array slice instead. */
    186         for ( $i=0; $i<$k; $i++ )
    187             $excerpt .= $blah[$i].' ';
    188         $excerpt .= ($use_dotdotdot) ? '...' : '';
    189         $content = $excerpt;
    190     }
     133 * Retrieve the post content for feeds.
     134 *
     135 * @package WordPress
     136 * @subpackage Feed
     137 * @since 2.9.0
     138 * @uses apply_filters() Calls 'the_content_feed' on the content before processing.
     139 * @see get_the_content()
     140 *
     141 * @param string $feed_type The type of feed. rss2 | atom | rss | rdf
     142 */
     143function get_the_content_feed($feed_type = null) {
     144    if ( !$feed_type )
     145        $feed_type = get_default_feed();
     146
     147    $content = apply_filters('the_content', get_the_content());
    191148    $content = str_replace(']]>', ']]&gt;', $content);
    192     echo $content;
     149    return apply_filters('the_content_feed', $content, $feed_type);
     150}
     151
     152/**
     153 * Display the post content for feeds.
     154 *
     155 * @package WordPress
     156 * @subpackage Feed
     157 * @since 2.9.0
     158 * @uses apply_filters() Calls 'the_content_feed' on the content before processing.
     159 * @see get_the_content()
     160 *
     161 * @param string $feed_type The type of feed. rss2 | atom | rss | rdf
     162 */
     163function the_content_feed($feed_type = null) {
     164    echo get_the_content_feed();
    193165}
    194166
Note: See TracChangeset for help on using the changeset viewer.