Описание функции get_page_template_slug()
Функция get_page_template_slug() возвращает слаг шаблона для заданной страницы. Она используется для получения информации о том, какой шаблон страницы применяется к конкретной записи. Это полезно для разработки тем и плагинов, когда необходимо определить, какой шаблон использован.
Функция актуальна при работе с произвольными шаблонами страниц, которые могут быть добавлены пользователями или разработчиками
Параметры
$post
Тип: int|WP_Post
Обязательный: Да
По умолчанию: null
Описание: ID или объект WP_Post страницы, для которой нужно получить слаг шаблона
Возможные значения:
type: ID страницы или объект WP_Post
Возвращаемое значение
Тип: string|null
Описание: Слаг шаблона страницы или null, если шаблон не установлен
Возможные значения:
• Слаг шаблона (например, ‘custom-template’)
• null если шаблон не задан
Примеры использования
Базовый пример получения слага шаблона страницы по ID
$template_slug = get_page_template_slug(42);
// Вывод слага шаблона
echo $template_slug; // 'custom-template'
Возвращает ‘custom-template’ если установлен соответствующий шаблон
Получение слага шаблона с использованием объекта WP_Post
$post = get_post(42);
$template_slug = get_page_template_slug($post);
// Вывод слага шаблона
echo $template_slug;
Работает так же, как и с ID
Безопасность
Валидация входных данных: Параметр post проходит валидацию на корректность
Санитизация: Нет необходимости в дополнительной очистке, так как функция работает с ID или объектом
Рекомендации: Убедитесь, что переданный ID существует и является страницей
— Связанные функции
Получает метаданные для поста, включая дополнительные данные о шаблоне
Возвращает полный путь к файлу шаблона страницы
— Хуки
Фильтрует путь к шаблону страницы перед возвратом
— Примечания
– Ограничения
Работает только с постами типа ‘page’
– Частые проблемы
- Возвращает null, если шаблон не назначен
- Неправильный ID может привести к ошибкам
