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