Retrieves a page given its path.
Parameters
$page_pathstringrequired- Page path.
$outputstringoptional- The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which correspond to a WP_Post object, an associative array, or a numeric array, respectively.
Default:
OBJECT $post_typestring|arrayoptional- Post type or array of post types. Default
'page'.Default:
'page'
Source
function get_page_by_path( $page_path, $output = OBJECT, $post_type = 'page' ) {
global $wpdb;
$last_changed = wp_cache_get_last_changed( 'posts' );
$hash = md5( $page_path . serialize( $post_type ) );
$cache_key = "get_page_by_path:$hash:$last_changed";
$cached = wp_cache_get( $cache_key, 'post-queries' );
if ( false !== $cached ) {
// Special case: '0' is a bad `$page_path`.
if ( '0' === $cached || 0 === $cached ) {
return;
} else {
return get_post( $cached, $output );
}
}
$page_path = rawurlencode( urldecode( $page_path ) );
$page_path = str_replace( '%2F', '/', $page_path );
$page_path = str_replace( '%20', ' ', $page_path );
$parts = explode( '/', trim( $page_path, '/' ) );
$parts = array_map( 'sanitize_title_for_query', $parts );
$escaped_parts = esc_sql( $parts );
$in_string = "'" . implode( "','", $escaped_parts ) . "'";
if ( is_array( $post_type ) ) {
$post_types = $post_type;
} else {
$post_types = array( $post_type, 'attachment' );
}
$post_types = esc_sql( $post_types );
$post_type_in_string = "'" . implode( "','", $post_types ) . "'";
$sql = "
SELECT ID, post_name, post_parent, post_type
FROM $wpdb->posts
WHERE post_name IN ($in_string)
AND post_type IN ($post_type_in_string)
";
$pages = $wpdb->get_results( $sql, OBJECT_K );
$revparts = array_reverse( $parts );
$found_id = 0;
foreach ( (array) $pages as $page ) {
if ( $page->post_name === $revparts[0] ) {
$count = 0;
$p = $page;
/*
* Loop through the given path parts from right to left,
* ensuring each matches the post ancestry.
*/
while ( 0 !== (int) $p->post_parent && isset( $pages[ $p->post_parent ] ) ) {
++$count;
$parent = $pages[ $p->post_parent ];
if ( ! isset( $revparts[ $count ] ) || $parent->post_name !== $revparts[ $count ] ) {
break;
}
$p = $parent;
}
if ( 0 === (int) $p->post_parent
&& count( $revparts ) === $count + 1
&& $p->post_name === $revparts[ $count ]
) {
$found_id = $page->ID;
if ( $page->post_type === $post_type ) {
break;
}
}
}
}
// We cache misses as well as hits.
wp_cache_set( $cache_key, $found_id, 'post-queries' );
if ( $found_id ) {
return get_post( $found_id, $output );
}
return null;
}
Changelog
| Version | Description |
|---|---|
| 2.1.0 | Introduced. |
Page Path
This is the equivalent of the
pagenamequery, as in:index.php?pagename=parent-page/sub-page.Code for the above could be written as (assuming
parent-page/sub-pageis actually the path to a page):For non-hierarchical custom post types, you need to use just the slug in tandem with the
post_typeparameter.The functions
basename()anduntrailingslashit()are handy for grabbing the last part of the URL for this:As per scottb79, it is correct that the function checks for the post type supplied (Page by default) and Attachment by default.
This function will add the Attachment post type to any instances where the post type is passed as a string. Due to the following code:
If you truly only want to return the item path from only the post type supplied.
It needs to be passed as an array like this:
This issue was found when an attachment sotred in the database had the same path as the page we wanted to retrieve.
The attachment having a lower Post ID it is returned first.
If you don’t specify a
post_type,it searches bothpageandattachment.If you want only
page, pass it via the third parameter.:array( 'page' )get_page_by_path( '/about/', OBJECT, array('page') );It is also a quite slow query, especially if you have a lot of images in the site, hence it is really recommended to do force only the ‘page’ post_type.