Ambiente
Às vezes, é necessário exibir conteúdo nos blocos somente quando eles são renderizados dentro do editor Gutenberg, e não no frontend. Essa técnica é muito útil para oferecer aos usuários informações úteis e espaços reservados caso os dados necessários ainda não tenham sido inseridos.
Editor
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 %}
Pré-visualização
Blockstudio adiciona outra variável de ambiente útil para quem desenvolve blocos. $isPreview permite renderizar conteúdo condicionalmente na janela de pré-visualização do bloco, quando o cursor passa sobre um bloco no inseridor de blocos.
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 %}
Fora dos templates
$isEditor e $isPreview existem apenas dentro do template. O código executado durante a mesma renderização, mas fora do template — como um helper do tema chamado por um template ou um filtro como blockstudio/blocks/components/rich_text/render — pode chamar bs_is_editor() e bs_is_preview(). Eles retornam os mesmos valores recebidos pelo template.
function theme_card_title(string $title): string {
if ($title === '' && bs_is_editor()) {
return '<span class="placeholder">Add a title</span>';
}
return esc_html($title);
}
As tags de bloco sempre renderizam a marcação do frontend, então, dentro de um bloco renderizado por uma tag de bloco, ambas as funções retornam false, assim como $isEditor e $isPreview.