Функция wp_is_block_theme() в WordPress с примерами

Функция wp_is_block_theme() в WordPress используется для определения, является ли активная тема блочной (то есть созданной с использованием редактора блоков Гутенберг). Это важная проверка для разработчиков тем и плагинов, которые хотят адаптироваться к различным типам тем и предоставить соответствующий функционал.

wp_is_block_theme(): bool

Возвращаемое значение

Функция возвращает true, если активная тема является блочной, и false, если это не так.

Как работает функция

Чтобы определить, является ли тема блочной, wp_is_block_theme() проверяет наличие следующих файлов относительно корня темы:

• /block-templates/index.html
• /templates/index.html

Если хотя бы один из этих файлов существует, тема считается блочной. С версии 5.9 в WordPress появилась возможность создавать шаблоны тем, полностью состоящие из блоков.

Пример 1: Проверка, является ли текущая тема блочной

Вот простой пример того, как использовать wp_is_block_theme() для проверки, является ли активная тема блочной:

if ( wp_is_block_theme() ) {
    echo "Текущая тема блочная.";
} else {
    echo "Текущая тема не является блочной.";
}

Этот код выводит сообщение, сообщающее пользователю, блочная ли текущая тема.

Пример 2: Условная загрузка стилей или скриптов

Вы также можете использовать эту функцию для условной загрузки стилей или скриптов в зависимости от того, является ли тема блочной. Например:

function my_theme_enqueue_scripts() {
    if ( wp_is_block_theme() ) {
        // Загрузить стили для блочной темы
        wp_enqueue_style( 'block-theme-style', get_template_directory_uri() . '/block-style.css' );
    } else {
        // Загрузить стили для классической темы
        wp_enqueue_style( 'classic-theme-style', get_template_directory_uri() . '/classic-style.css' );
    }
}

add_action( 'wp_enqueue_scripts', 'my_theme_enqueue_scripts' );

В этом примере, в зависимости от типа темы, будут загружаться разные файлы стилей.

Пример 3: Адаптация шаблонов

Вы можете использовать wp_is_block_theme() для адаптации шаблонов вашей темы. Например, если вы хотите отобразить разные шаблоны для блочных и классических тем, вы можете сделать это следующим образом:

if ( wp_is_block_theme() ) {
    // Включить шаблон для блочной темы
    get_template_part( 'template-parts/block-template' );
} else {
    // Включить шаблон для классической темы
    get_template_part( 'template-parts/classic-template' );
}

Этот код позволяет гибко управлять выводом контента в зависимости от типа темы.

Заключение

Функция wp_is_block_theme() является полезным инструментом для разработчиков тем и плагинов, позволяя легко определять, является ли активная тема блочной. Это позволяет адаптировать функциональность и пользовательский интерфейс в зависимости от типа темы, что значительно улучшает опыт пользователей и разработчиков.