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();

Примеры

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

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

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

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

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

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

Заметки

Global. WP_Customize_Manager. $wp_customize Customizer instance.

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

С версии 4.0.0

Введена.

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

wp-includes/theme.php

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

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