get_post_ancestors( int|WP_Post $post )
Retrieve ancestors of a post.
Parameters
- $post
-
(Required) Post ID or post object.
Return
(array) Ancestor IDs or empty array if none are found.
Source
File: wp-includes/post.php
function get_post_ancestors( $post ) {
$post = get_post( $post );
if ( ! $post || empty( $post->post_parent ) || $post->post_parent == $post->ID )
return array();
$ancestors = array();
$id = $ancestors[] = $post->post_parent;
while ( $ancestor = get_post( $id ) ) {
// Loop detection: If the ancestor has been seen before, break.
if ( empty( $ancestor->post_parent ) || ( $ancestor->post_parent == $post->ID ) || in_array( $ancestor->post_parent, $ancestors ) )
break;
$id = $ancestors[] = $ancestor->post_parent;
}
return $ancestors;
}
Changelog
Version | Description |
---|---|
WP-2.5.0 | Introduced. |