is_customize_preview() WP 4.0.0

Срабатывает когда находимся в кастомайзере WordPress (визуальная настройка темы). Условный тег.

При базовом запросе среда кастомайзера не подгружается, вообще! Эта функция срабатывает всегда, когда подгружена среда кастомайзера — это означает, что:

• мы находимся в кастомайзере (страница админки)
• или мы отправили AJAX/POST/GET запрос на обновление страницы кастомайзера
• или мы отправили AJAX/POST/GET запрос на сохранение опций кастомайзера.

Использует глобальную переменную $wp_customize, которая содержит экземпляр класса WP_Customize_Manager.

Хуков нет.

Возвращает

true/false. true, если сайт просматривается через кастомайзер. false в противном случае.

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

$is_customize = is_customize_preview();

Примеры

#1 Пример Использования

if( is_customize_preview() ){
	// это кастомайзер
}

#2 Функция только для кастомайзера

Код функции будет выполняться только когда мы находимся в кастомайзере вордпресс.

function my_function(){
	// выходим если это не кастомайер
	if( ! is_customize_preview() )
		return;

	// код функции...
}

Заметки

• Global. WP_Customize_Manager. $wp_customize Customizer instance.

Список изменений

Код is_customize_preview() is customize preview ^{WP 5.6.2}

<?php
function is_customize_preview() {
	global $wp_customize;

	return ( $wp_customize instanceof WP_Customize_Manager ) && $wp_customize->is_preview();
}

Cвязанные функции

Из метки: Условные теги (типов страниц и запросов)

Еще из метки: Условные теги (все)

Еще из раздела: Настройки (кастомайзер)