Changeset 24301 for trunk/wp-includes/post.php

Timestamp:

05/20/2013 11:05:50 AM (11 years ago)

Author:

ryan

Message:

• Introduce wp_parse_post_content() and use it in setup_postdata(), get_the_content(), and get_the_remaining_content().
• Add a post ID argument to the_content(), get_the_content(), the_remaining_content(), and get_the_remaining_content().
• Pass the post ID to the the_content filter.
• Remove the format_pages global.
• Declare format_content and split_content as vars in WP_Post.
• phpdoc for the the_content filter that documents the new ID argument and denotes it as not-so-portable.

Props gcorne, DrewAPicture, duck_, aaroncampbell
see #24330

File:

• trunk/wp-includes/post.php (modified) (2 diffs)

trunk/wp-includes/post.php

@@ -567 +567 @@
      */
     public $filter;
+
+    /**
+     * Private variable used by post formats to cache parsed content.
+     *
+     * @since 3.6.0
+     *
+     * @var array
+     * @access private
+     */
+    public $format_content;
+
+    /**
+     * Private variable used by post formats to cache parsed content.
+     *
+     * @since 3.6.0
+     *
+     * @var string
+     * @access private
+     */
+    public $split_content;
 
     public static function get_instance( $post_id ) {
@@ -4963 +4983 @@
     }
 }
+
+/**
+ * Parse post content for pagination
+ *
+ * @since 3.6.0
+ *
+ * @uses paginate_content()
+ *
+ * @param object $post The post object.
+ * @param bool $remaining Whether to parse post formats from the content. Defaults to false.
+ * @return array An array of values used for paginating the parsed content.
+ */
+function wp_parse_post_content( $post, $remaining = false ) {
+    $numpages = 1;
+
+    if ( $remaining ) {
+        $format = get_post_format( $post );
+        if ( $format && in_array( $format, array( 'image', 'audio', 'video', 'quote' ) ) ) {
+            // Call get_the_post_format_*() to set $post->split_content
+            switch ( $format ) {
+                case 'image':
+                    get_the_post_format_image( 'full', $post );
+                    break;
+                case 'audio':
+                    get_the_post_format_media( 'audio', $post, 1 );
+                    break;
+                case 'video':
+                    get_the_post_format_media( 'video', $post, 1 );
+                    break;
+                case 'quote':
+                    get_the_post_format_quote( $post );
+                    break;
+            }
+        }
+    }
+
+    if ( strpos( $post->post_content, '<!--nextpage-->' ) ) {
+        $multipage = 1;
+        if ( $remaining && isset( $post->split_content ) )
+            $pages = paginate_content( $post->split_content );
+        else
+            $pages = paginate_content( $post->post_content );
+        $numpages = count( $pages );
+    } else {
+        if ( $remaining && isset( $post->split_content ) )
+            $pages = array( $post->split_content );
+        else
+            $pages = array( $post->post_content );
+        $multipage = 0;
+    }
+
+    return compact( 'multipage', 'pages', 'numpages' );
+}