Окружение
Иногда необходимо показывать содержимое блоков только при отображении внутри редактора Gutenberg, но не на внешней стороне сайта. Этот прием полезен, чтобы показывать пользователям подсказки и заполнители, если нужные данные еще не введены.
Редактор
PHP
<?php if ($isEditor) : ?>
This content is only going to be rendered inside the editor.
<?php else : ?>
This content is only going to be rendered on the frontend.
<?php endif; ?>
Twig
{% if isEditor %}
This content is only going to be rendered inside the editor.
{% else %}
This content is only going to be rendered on the frontend.
{% endif %}
Предварительный просмотр
Blockstudio добавляет еще одну полезную переменную окружения для разработчиков блоков. $isPreview позволяет условно отображать содержимое в окне предварительного просмотра блока при наведении на блок в списке блоков.
PHP
<?php if ($isPreview) : ?>
This content is only going to be rendered inside the block preview.
<?php else : ?>
This content is only going to be rendered on the frontend and editor.
<?php endif; ?>
Twig
{% if isPreview %}
This content is only going to be rendered inside the block preview.
{% else %}
This content is only going to be rendered on the frontend and editor.
{% endif %}
За пределами шаблонов
$isEditor и $isPreview доступны только внутри шаблона. Код, выполняющийся в ходе того же рендеринга, но вне шаблона, например функция темы, вызванная из шаблона, или фильтр вроде blockstudio/blocks/components/rich_text/render, может вызывать bs_is_editor() и bs_is_preview(). Они возвращают те же значения, что получает шаблон.
function theme_card_title(string $title): string {
if ($title === '' && bs_is_editor()) {
return '<span class="placeholder">Add a title</span>';
}
return esc_html($title);
}
Теги блоков всегда выводят разметку интерфейса, поэтому внутри блока, отрисованного тегом блока, обе функции возвращают false, как и $isEditor и $isPreview.