Vai al contenuto

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
<?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

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
<?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

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.

PHP
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.