Make WordPress Core


Ignore:
Timestamp:
09/28/2009 02:36:48 PM (17 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.