Treci la conținut

Mediu

Uneori este necesar să afișați conținutul blocurilor doar când sunt randate în editorul Gutenberg, nu și în frontend. Această tehnică este foarte utilă pentru a le oferi utilizatorilor informații și substituenți utili atunci când datele necesare nu au fost încă introduse.

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 %}

Previzualizare

Blockstudio adaugă o altă variabilă de mediu utilă pentru dezvoltatorii de blocuri. $isPreview vă permite să randați condiționat conținutul în fereastra de previzualizare a blocului, când treceți cu cursorul peste un bloc în inseratorul de blocuri.

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 %}

În afara șabloanelor

$isEditor și $isPreview există numai în interiorul șablonului. Codul care rulează în timpul aceleiași randări, dar în afara șablonului, cum ar fi un helper de temă apelat dintr-un șablon sau un filtru precum blockstudio/blocks/components/rich_text/render, poate apela bs_is_editor() și bs_is_preview(). Acestea returnează aceleași valori ca cele primite de șablon.

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);
}

Etichetele de bloc redau întotdeauna marcajul frontend, așadar într-un bloc randat dintr-o etichetă de bloc, ambele funcții returnează false, la fel ca $isEditor și $isPreview.