Changeset 35285

Timestamp:

10/20/2015 06:32:16 AM (11 years ago)

Author:

DrewAPicture

Message:

Query: Introduce the content_pagination filter, which makes it possible to manipulate how post content is split into "pages" in WP_Query::setup_postdata().

The "pages" — or chunks of post content – are determined by splitting based on the presence of <!-- nextpage --> tags in the post content.

Props sirzooro, chriscct7.
Fixes #9911.

File:

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

trunk/src/wp-includes/query.php

@@ -4772 +4772 @@
                 $content = $post->post_content;
                 if ( false !== strpos( $content, '<!--nextpage-->' ) ) {
-                        if ( $page > 1 )
-                                $more = 1;
                         $content = str_replace( "\n<!--nextpage-->\n", '<!--nextpage-->', $content );
                         $content = str_replace( "\n<!--nextpage-->", '<!--nextpage-->', $content );
@@ -4783 +4781 @@
 
                         $pages = explode('<!--nextpage-->', $content);
-                        $numpages = count($pages);
-                        if ( $numpages > 1 )
-                                $multipage = 1;
                 } else {
                         $pages = array( $post->post_content );
                 }
+
+                /**
+                 * Filter the "pages" derived from splitting the post content.
+                 *
+                 * "Pages" are determined by splitting the post content based on the presence
+                 * of `<!-- nextpage -->` tags.
+                 *
+                 * @since 4.4.0
+                 *
+                 * @param array   $pages Array of "pages" derived from the post content.
+                 *                       of `<!-- nextpage -->` tags..
+                 * @param WP_Post $post  Current post object.
+                 */
+                $pages = apply_filters( 'content_pagination', $pages, $post );
+
+                $numpages = count( $pages );
+
+                if ( $numpages > 1 ) {
+                        if ( $page > 1 ) {
+                                $more = 1;
+                        }
+                        $multipage = 1;
+                } else {
+                        $multipage = 0;
+                }
 
                 /**