get_page_by_path() — получает объект поста / страницы по ярлыку

В случае успеха функция возвращает объект/массив, содержащий всю информацию о странице. Полный список параметров возвращаемого объекта можно посмотреть здесь.

get_page_by_path($page_path, $output = OBJECT, $post_type = 'page')

$page_path

(строка) ярлык страницы. Если страница имеет родительскую, тогда нужно указать и её ярлык тоже: parent_page_slug/page_slug.

$output

(строка) в каком виде нужно получить результат — OBJECT (объект поста), ARRAY_N (нумерованный массив) или ARRAY_A (ассоциативный массив).

$post_type

(строка) тип поста, для которого применяем функцию, по умолчанию — тип page (страницы).

Примеры

Во всех примерах мы будем выводить заголовок страницы, но результат каждый раз будет достигаться по-разному.

Простой пример — получаем объект страницы и вытаскиваем из него заголовок:

$page = get_page_by_path('my-page');
echo $page->post_title;

Теперь функция возвращает не объект, а ассоциативный массив:

$page = get_page_by_path('my-page', ARRAY_A);
echo $page['post_title'];

Давайте предположим, что наша станица ещё имеет и родительский элемент, тогда:

$page = get_page_by_path('my_parent_page/my-page');
echo $page->post_title;

Применим функцию get_page_by_path() для записей WordPress:

$my_post = get_page_by_path('my-page', OBJECT, 'post');
echo $my_post->post_title;