is_customize_preview() │ WP 4.0.0

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

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

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

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

1 раз — 0.000014 сек (очень быстро) | 50000 раз — 0.01 сек (скорость света) | PHP 7.1.0, WP 4.7

Хуков нет.

Возвращает

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

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

$is_customize = is_customize_preview();

Примеры

0

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

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

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

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

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

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

Заметки

  • Global. WP_Customize_Manager. $wp_customize Customizer instance.

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

С версии 4.0.0 Введена.

Код is_customize_preview() WP 6.9

wp-includes/theme.php 
function is_customize_preview() {
	global $wp_customize;

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

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

Условные теги (все)

Настройки (кастомайзер)