Ticket #37462: 37462.diff

src/wp-includes/post.php

@@ -7025 +7025 @@
         $types = $wpdb->get_col( $wpdb->prepare( "SELECT DISTINCT post_mime_type FROM $wpdb->posts WHERE post_type = %s", $type ) );
         return $types;
 }
+
+/**
+ * Determine if a post is private or not. 
+ * 
+ * If the post is not found, it will return false. If the post is an attachment, 
+ * the parent post status will be checked.
+ * 
+ * @since 5.3
+ * 
+ * @see get_post_status()
+ * @link https://core.trac.wordpress.org/ticket/37462
+ *
+ * @param int|WP_Post $post Optional. Post ID or post object. Defaults to global $post.
+ * @return bool True if the post is private, false if not or if the post is not found.
+ */
+function is_private_post( $post = null ) {
+        if ( 'private' === get_post_status( $post ) ) {
+                return true;
+        }
+
+        return false;
+}
+ No newline at end of file

tests/phpunit/tests/post.php

@@ -1394 +1394 @@
         function filter_pre_wp_unique_post_slug( $default, $slug, $post_ID, $post_status, $post_type, $post_parent ) {
                 return 'override-slug-' . $post_type;
         }
+
+        /**
+         * @ticket 37462
+         */
+        function test_is_private_post() {
+                $post_id_private = $this->factory->post->create(
+                        array(
+                                'title'       => 'An example',
+                                'post_status' => 'private',
+                                'post_type'   => 'post',
+                        )
+                );
+
+                $post_id_published = $this->factory->post->create(
+                        array(
+                                'title'       => 'An example',
+                                'post_status' => 'publish',
+                                'post_type'   => 'page',
+                        )
+                );
+
+                $this->assertTrue( is_private_post( $post_id_private ) );
+                $this->assertFalse( is_private_post( $post_id_published ) );
+        }
+
 }