Описание функции get_page_template()
Функция get_page_template() возвращает путь к файлу шаблона, который используется для отображения текущей страницы. Это позволяет темам и плагинам определять, какой шаблон используется для конкретной страницы и при необходимости изменять его.
Функция полезна для создания динамических страниц и обеспечения совместимости с пользовательскими шаблонами.
Параметры
$post
Тип: int|WP_Post
Обязательный: Нет
По умолчанию: null
Описание: ID или объект записи, для которой нужно получить шаблон
Возможные значения:
post: ID записи или объект WP_Post
Возвращаемое значение
Тип: string|null
Описание: Путь к файлу шаблона или null, если шаблон не найден
Возможные значения:
• Путь к файлу шаблона при успешном выполнении
• null, если для записи не назначен шаблон
Примеры использования
Базовый пример получения пути к шаблону текущей страницы
$template = get_page_template();
// Выводим путь к шаблону
echo $template;
Выводит путь к файлу шаблона, например: /wp-content/themes/mytheme/page-custom.php
Получение пути к шаблону для записи с заданным ID
$template = get_page_template(42);
// Выводим путь к шаблону записи с ID 42
echo $template;
Если шаблон не назначен, вернется null
Безопасность
Валидация входных данных: Функция проверяет, является ли параметр записью или ID
Санитизация: Параметры автоматически обрабатываются WordPress
Рекомендации: При выводе пути к шаблону используйте esc_url() для безопасного вывода
— Связанные функции
Получает шаблон для записи
Подключает файл шаблона часть
— Хуки
Фильтрует путь к шаблону страницы перед его возвращением
— Примечания
– Ограничения
Функция работает только для страниц и не учитывает другие типы записей
– Частые проблемы
- Возвращает null, если для страницы не задан шаблон
- Не учитывает настройки для пользовательских типов записей
