get_page_uri( WP_Post|object|int $page )

Build the URI path for a page.


Description Description

Sub pages will be in the "directory" under the parent page post name.


Parameters Parameters

$page

(WP_Post|object|int) (Optional) Page ID or WP_Post object. Default is global $post.


Top ↑

Return Return

(string|false) Page URI, false on error.


Top ↑

Source Source

File: wp-includes/post.php

function get_page_uri( $page = 0 ) {
	if ( ! $page instanceof WP_Post ) {
		$page = get_post( $page );
	}

	if ( ! $page ) {
		return false;
	}

	$uri = $page->post_name;

	foreach ( $page->ancestors as $parent ) {
		$parent = get_post( $parent );
		if ( $parent && $parent->post_name ) {
			$uri = $parent->post_name . '/' . $uri;
		}
	}

	/**
	 * Filters the URI for a page.
	 *
	 * @since 4.4.0
	 *
	 * @param string  $uri  Page URI.
	 * @param WP_Post $page Page object.
	 */
	return apply_filters( 'get_page_uri', $uri, $page );
}

Top ↑

Changelog Changelog

Changelog
Version Description
4.6.0 The $page parameter was made optional.
1.5.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.