Описание функции is_customize_preview()
Функция is_customize_preview() проверяет, находится ли сайт в режиме предварительного просмотра кастомизации. Этот режим позволяет пользователям видеть изменения, внесенные в настройки темы и виджеты, прежде чем они будут опубликованы. Функция используется в темах и плагинах для условного отображения контента или стилей, связанных с кастомизацией.
Используется в основном для адаптации интерфейса и управления отображением элементов в режиме кастомизации
Возвращаемое значение
Тип: boolean
Описание: Возвращает true, если сайт находится в режиме кастомизации, иначе false
Возможные значения:
• true — если находится в режиме предварительного просмотра кастомизации
• false — если не находится в режиме кастомизации
Примеры использования
Показ сообщения, если активен режим предварительного просмотра
if ( is_customize_preview() ) {
echo 'Предварительный просмотр кастомизации активен
';
}
Сообщение будет видно только при активном режиме кастомизации
Добавление стилей только в режиме кастомизации
if ( is_customize_preview() ) {
wp_enqueue_style( 'customizer-preview-style', get_stylesheet_directory_uri() . '/customizer-preview.css' );
}
Стили будут загружены только во время кастомизации
Безопасность
Валидация входных данных: Нет параметров для валидации, так как функция не принимает аргументов
Санитизация: Не требуется, так как функция не обрабатывает входные данные
Рекомендации: Используйте is_customize_preview() для предотвращения вывода конфиденциальной информации в режиме кастомизации
— Связанные функции
Проверяет, находится ли пользователь в административной панели
Фильтр для регистрации кастомизируемых элементов
— Примечания
– Ограничения
Функция не возвращает дополнительной информации, только состояние
– Частые проблемы
- Некорректное отображение элементов при использовании вне кастомизации
- Необходимо учитывать кэширование, если элементы зависят от режима кастомизации