Ticket #33045: 33045.9.diff

src/wp-includes/post-template.php

@@ -1963 +1963 @@
         echo $rows;
         echo '</ul>';
 }
+
+/**
+ * Retrieve the parent post object.
+ *
+ * @since 5.7.0
+ *
+ * @param int|WP_Post|null $post Optional. Post ID or post object.
+ *
+ * @return WP_Post Parent post object.
+ */
+function get_parent_post( $post = null ) {
+        $wp_post = get_post( $post );
+        return ! empty( $wp_post->post_parent ) ? get_post( $wp_post->post_parent ) : null;
+}
+
+/**
+ * Whether the post has a parent post.
+ *
+ * @since 5.7.0
+ *
+ * @param int|WP_Post|null $post Optional. Post ID or post object.
+ *
+ * @return bool True is the post has a parent post, false otherwise.
+ */
+function has_parent_post( $post = null ) {
+        return (bool) get_parent_post( $post );
+}

tests/phpunit/tests/post/template.php

@@ -452 +452 @@
                 $this->assertRegExp( '/><li.*>|<\/li></U', $menu );
 
         }
+
+        /**
+         * @ticket 33045
+         */
+        public function test_get_parent_post() {
+                $post = array(
+                        'post_status'  => 'publish',
+                        'post_content' => rand_str(),
+                        'post_title'   => rand_str(),
+                        'post_type'    => 'page',
+                );
+
+                // Insert two initial posts.
+                $id_parent = wp_insert_post( $post );
+                $id_child  = wp_insert_post( $post );
+
+                // Test if child get_parent_post() post returns Null by default.
+                $parent = get_parent_post( $id_child );
+                $this->assertNull( $parent );
+
+                // Update child post with a parent.
+                wp_update_post(
+                        array(
+                                'ID'          => $id_child,
+                                'post_parent' => $id_parent,
+                        )
+                );
+
+                // Test if child get_parent_post() post returns the parent object.
+                $parent = get_parent_post( $id_child );
+                $this->assertSame( $id_parent, $parent->ID );
+        }
+
+        /**
+         * @ticket 33045
+         */
+        public function test_has_parent_post() {
+                $post = array(
+                        'post_status'  => 'publish',
+                        'post_content' => rand_str(),
+                        'post_title'   => rand_str(),
+                        'post_type'    => 'page',
+                );
+
+                // Insert two initial posts.
+                $id_parent = wp_insert_post( $post );
+                $id_child  = wp_insert_post( $post );
+
+                // Test if child has_parent_post() post returns False by default.
+                $parent = has_parent_post( $id_child );
+                $this->assertFalse( $parent );
+
+                // Update child post with a parent.
+                wp_update_post(
+                        array(
+                                'ID'          => $id_child,
+                                'post_parent' => $id_parent,
+                        )
+                );
+
+                // Test if child has_parent_post() returns True.
+                $parent = has_parent_post( $id_child );
+                $this->assertTrue( $parent );
+        }
 }