Ambiente
A volte è necessario mostrare contenuti nei blocchi solo quando vengono renderizzati nell’editor Gutenberg, e non nel frontend. Questa tecnica è molto utile per fornire agli utenti informazioni e segnaposto quando i dati necessari non sono ancora stati inseriti.
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 %}
Anteprima
Blockstudio aggiunge un’altra variabile d’ambiente utile per chi sviluppa blocchi. $isPreview consente di visualizzare contenuti in modo condizionale nella finestra di anteprima del blocco quando si passa il cursore su un blocco nell’inseritore.
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 %}
Fuori dai template
$isEditor e $isPreview esistono solo all’interno del template. Il codice eseguito durante lo stesso rendering ma al di fuori del template, ad esempio un helper del tema richiamato da un template o un filtro come blockstudio/blocks/components/rich_text/render, può chiamare bs_is_editor() e bs_is_preview(). Restituiscono gli stessi valori ricevuti dal 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);
}
I tag dei blocchi generano sempre il markup del frontend, quindi all’interno di un blocco renderizzato da un tag del blocco entrambe le funzioni restituiscono false, come fanno $isEditor e $isPreview.