is_page_template()

Определяет, использует ли текущая запись шаблон страницы
Функция WordPress
INT 2.5.0
WordPress Icon

Описание функции

Функция is_page_template() используется для определения, использует ли текущий пост шаблон страницы.

Она проверяет, соответствует ли текущий шаблон страницы одному из указанных шаблонов. Если текущий шаблон страницы совпадает с указанным, функция возвращает true, в противном случае — false.

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

is_page_template( string|string[] $template = '' ): bool

Функция is_page_template() принимает один параметр:

  • $template (строка или массив строк) — конкретное имя файла шаблона или массив шаблонов для сравнения. По умолчанию: пустая строка.

Функция возвращает true, если текущий пост использует указанный шаблон страницы, и false в противном случае.

<?php
// Проверяем, использует ли текущий пост шаблон страницы "about.php"
if ( is_page_template( 'about.php' ) ) {
    // Код, который будет выполнен, если текущий пост использует шаблон "about.php"
    // ...
} else {
    // Код, который будет выполнен, если текущий пост не использует шаблон "about.php"
    // ...
}
// Проверяем, использует ли текущий пост один из шаблонов страницы из массива
if ( is_page_template( array( 'template1.php', 'template2.php' ) ) ) {
    // Код, который будет выполнен, если текущий пост использует один из указанных шаблонов
    // ...
} else {
    // Код, который будет выполнен, если текущий пост не использует ни один из указанных шаблонов
    // ...
}
?>

Примеры использования

Проверка наличия шаблона страницы


$page_template = get_page_template_slug();
if ( $page_template ) {
    echo 'Шаблон страницы: ' . $page_template;
} else {
    echo 'Шаблон страницы не определен.';
}

В этом примере мы используем функцию get_page_template_slug() для получения имени файла текущего шаблона страницы. Затем мы проверяем, определено ли имя файла шаблона, и выводим соответствующее сообщение.

Проверка соответствия шаблона страницы


if ( is_page_template( 'template-custom.php' ) ) {
    echo 'Текущая страница использует шаблон template-custom.php.';
} else {
    echo 'Текущая страница не использует шаблон template-custom.php.';
}

В этом примере мы используем функцию is_page_template() для проверки, использует ли текущая страница шаблон с именем «template-custom.php». В зависимости от результата проверки выводится соответствующее сообщение.

Определение текущего шаблона страницы


$page_template = get_page_template();
if ( $page_template ) {
    echo 'Текущий шаблон страницы: ' . $page_template;
} else {
    echo 'Текущий шаблон страницы не определен.';
}

В этом примере мы используем функцию get_page_template() для получения полного пути к текущему шаблону страницы. Затем мы проверяем, определен ли путь к шаблону, и выводим соответствующее сообщение.

Вопросы и ответы

Как определить, использует ли текущий пост шаблон страницы?

Функция is_page_template() позволяет определить, использует ли текущий пост шаблон страницы.

Для этого необходимо передать в качестве параметра название шаблона или массив названий шаблонов, которые нужно проверить.

Функция возвращает true, если текущий пост использует указанный шаблон, и false в противном случае.

Как проверить, использует ли текущий пост определенный шаблон страницы?

Для проверки, использует ли текущий пост определенный шаблон страницы, необходимо вызвать функцию is_page_template() и передать в качестве параметра название шаблона.

Например, чтобы проверить, использует ли текущий пост шаблон «template-custom.php», можно использовать следующий код:


if ( is_page_template( 'template-custom.php' ) ) {
    // Код, который будет выполнен, если текущий пост использует шаблон "template-custom.php"
} else {
    // Код, который будет выполнен, если текущий пост не использует шаблон "template-custom.php"
}

Как узнать, использует ли текущий пост шаблон страницы?

Чтобы узнать, использует ли текущий пост шаблон страницы, можно вызвать функцию is_page_template() без параметров.

Например, следующий код позволяет проверить, использует ли текущий пост какой-либо шаблон страницы:


if ( is_page_template() ) {
    // Код, который будет выполнен, если текущий пост использует шаблон страницы
} else {
    // Код, который будет выполнен, если текущий пост не использует шаблон страницы
}

Как определить, использует ли текущий пост конкретный шаблон страницы?

Функция is_page_template() позволяет определить, использует ли текущий пост конкретный шаблон страницы.

Для этого необходимо передать название шаблона в качестве параметра $template. Функция вернет true, если текущий пост использует указанный шаблон, и false в противном случае.


if ( is_page_template( 'template-about.php' ) ) {
    // Код, который будет выполнен, если текущий пост использует шаблон "template-about.php"
}

Как проверить, использует ли текущий пост определенный файл шаблона страницы?

Функция is_page_template() также позволяет проверить, использует ли текущий пост определенный файл шаблона страницы.

Для этого необходимо передать массив названий шаблонов в качестве параметра $template. Функция вернет true, если текущий пост использует хотя бы один из указанных шаблонов, и false в противном случае.


if ( is_page_template( array( 'template-about.php', 'template-contact.php' ) ) ) {
    // Код, который будет выполнен, если текущий пост использует шаблон "template-about.php" или "template-contact.php"
}

Функция is_page_template() в WordPress позволяет определить, использует ли текущий пост один из нескольких шаблонов страницы. Она принимает имя файла шаблона или массив имен файлов в качестве параметра и возвращает булево значение. Эта функция полезна для создания условий, основанных на шаблонах страницы, и позволяет разработчикам WordPress более гибко управлять отображением контента на сайте.

Связанные элементы

  • Функция get_page_template(): Возвращает путь к текущему шаблону страницы.
  • Функция get_page_templates(): Возвращает массив доступных шаблонов страницы.
  • Хук theme_page_templates: Позволяет добавить или изменить доступные шаблоны страницы.
  • Хук pre_get_posts: Позволяет изменить параметры запроса перед выполнением запроса к базе данных.
  • Класс WP_Theme: Предоставляет информацию о текущей активной теме WordPress.
  • Класс WP_Query: Используется для выполнения запросов к базе данных WordPress, включая поиск страниц с определенным шаблоном.
Обсуждение