Ticket #30292: 30292.3.diff

wp-includes/post-functions.php

@@ -425 +425 @@
  *                            When $output is OBJECT, a `WP_Post` instance is returned.
  */
 function get_post( $post = null, $output = OBJECT, $filter = 'raw' ) {
-        if ( empty( $post ) && isset( $GLOBALS['post'] ) )
+
+        if ( empty( $post ) && isset( $GLOBALS['post'] ) ) {
                 $post = $GLOBALS['post'];
+        }
 
-        if ( $post instanceof WP_Post ) {
-                $_post = $post;
-        } elseif ( is_object( $post ) ) {
-                if ( empty( $post->filter ) ) {
-                        $_post = sanitize_post( $post, 'raw' );
-                        $_post = new WP_Post( $_post );
-                } elseif ( 'raw' == $post->filter ) {
-                        $_post = new WP_Post( $post );
-                } else {
-                        $_post = WP_Post::get_instance( $post->ID );
-                }
-        } else {
-                $_post = WP_Post::get_instance( $post );
-        }
+        /**
+         * Filter that allows a custom object to be provided for post when appropriate.
+         *
+         * Allows a developer to substitute an object that contains a WP_Post or that simulates a WP_Post.
+         *
+         * @since 4.4.0
+         *
+         * @param null      null    Default value for filter to return. If null, filter is effectively ignored.
+         * @param WP_Post   $post   Post object
+         * @param string    $output Format of data to return, potentially 'OBJECT', 'ARRAY_A' or 'ARRAY_N'.
+         * @param string    $filter Type of filter to apply, potentially 'raw', 'edit', 'db' or 'display'.
+         * @return          null|WP_Post|object
+         */
+        $_post = apply_filters( 'do_get_post', null, $post, $output, $filter );
+
+        if ( is_null( $_post ) ) {
+
+                if ( $post instanceof WP_Post ) {
+                        $_post = $post;
+                } elseif ( is_object( $post ) ) {
+                        if ( empty( $post->filter ) ) {
+                                $_post = sanitize_post( $post, 'raw' );
+                                $_post = new WP_Post( $_post );
+                        } elseif ( 'raw' == $post->filter ) {
+                                $_post = new WP_Post( $post );
+                        } else {
+                                $_post = WP_Post::get_instance( $post->ID );
+                        }
+                } else {
+                        $_post = WP_Post::get_instance( $post );
+                }
 
-        if ( ! $_post )
-                return null;
+                if ( ! $_post ) {
+                        return null;
+                }
 
+        }
+
         $_post = $_post->filter( $filter );
 
-        if ( $output == ARRAY_A )
+        if ( $output == ARRAY_A ) {
                 return $_post->to_array();
-        elseif ( $output == ARRAY_N )
+        } elseif ( $output == ARRAY_N ) {
                 return array_values( $_post->to_array() );
+        }
 
         return $_post;
+
 }
 
 /**