Changeset 1036

Timestamp:

12/11/2014 11:29:10 PM (11 years ago)

Author:

coffee2code

Message:

developer.wordpress.org: introduce get_summary() and use it.

Abstracts the fact the summary (aka short description) is stored in post_excerpt, primarily to force display of special characters.

Location:

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer

Files:

• content-reference.php (modified) (1 diff)
• content-wp-parser-hook.php (modified) (1 diff)
• inc/template-tags.php (modified) (1 diff)

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/content-reference.php

@@ -8 +8 @@
 
     <section class="description">
-        <?php the_excerpt(); ?>
+        <?php echo get_summary(); ?>
     </section>
 

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/content-wp-parser-hook.php

@@ -5 +5 @@
     <h1><a href="<?php the_permalink() ?>"><?php echo get_signature(); ?></a></h1>
     <section class="description">
-        <?php the_excerpt(); ?>
+        <?php echo get_summary(); ?>
     </section>
 

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/inc/template-tags.php

@@ -991 +991 @@
 
     /**
+     * Gets the summary.
+     *
+     * The summary (aka short description) is stored in the 'post_excerpt' field.
+     *
+     * @param  null|WP_Post Optional. The post. Default null.
+     * @return string
+     */
+    function get_summary( $post = null ) {
+        $post = get_post( $post );
+
+        $summary = $post->post_excerpt;
+
+        if ( $summary ) {
+            add_filter( 'the_excerpt', 'htmlentities', 9 ); // Run before wpautop
+            $summary = apply_filters( 'the_excerpt', apply_filters( 'get_the_excerpt', $summary ) );
+            remove_filter( 'the_excerpt', 'htmlentities', 9 );
+        }
+
+        return $summary;
+    }
+
+    /**
      * Gets the long description.
      *