WordPress.org

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Справочник по функциям/get page by title

Эта страница помечена как незавершённая. Вы можете помочь проекту, дополнив её.

Описание

Возвращает запись по ее названию. Если записей с таким названием больше одного, то возвращается запись с наиболее меньшим ID.

Because this function uses the MySQL '=' comparison the $page_title will usually be matched as case insensitive with default collating.

Использование


<?php 
  get_page_by_title
$page_title$output$post_type );
?>

Параметры

$page_title
(string) (required) Название страницы
Default: None
$output
(string) (optional) Формат возвращаемых функцией данных. Один из трех вариантов OBJECT, ARRAY_N, или ARRAY_A.
Default: OBJECT
$post_type
(string) (optional) Тип записи.
Default: page

Возвращаемые значения

(mixed) 
OBJECT, ARRAY_N, or ARRAY_A.

NULL если записи не найдены.

Примеры

Поиск ID страницы для исключения из списка wp_list_pages

Этот пример возвращает объект $page для страницы названной "About". Затем элемент $page->ID используется для исключения сраницы About из списка страниц.

<?php 
$page = get_page_by_title( 'About' );
wp_list_pages( 'exclude=' . $page->ID );
?>

Как найти ID страницы по названию и зменить ее the_content()

В этом примере мы ищем id страницы "Sample Page" и заменяем ее содержимое the_content() текстом "Hello World!"

function my_content($content) {
    $page = get_page_by_title( 'Sample Page' );
    
    if ( is_page($page->ID) )
        $content = "Hello World!";
        return $content;
}

add_filter('the_content', 'my_content');

Примечания

  • Используется глобальная переменная: (object) $wpdb

История изменений

  • С версии: 2.1.0
  • 3.0.0: Добавлен параметр $post_type.

Исходный код

Функция get_page_by_title() располагается в wp-includes/post.php.

Схожее

Page Tags: get_all_page_ids(), get_ancestors(), get_page(), get_page_link(), get_page_by_path(), get_page_by_title(), get_page_children(), get_page_hierarchy(), get_page_uri(), get_pages(), is_page(), page_uri_index(), wp_list_pages(), wp_page_menu()

См. также содержание справочника по функциям и список тегов шаблонов.