Omgeving
Soms moet je inhoud in je blokken alleen weergeven wanneer ze in de Gutenberg-editor worden weergegeven, en niet aan de frontend. Dit is handig om gebruikers nuttige informatie en tijdelijke aanduidingen te geven als de benodigde gegevens nog niet zijn ingevuld.
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 %}
Voorbeeldweergave
Blockstudio voegt een andere omgevingsvariabele toe die van pas komt voor blokontwikkelaars. Met $isPreview kun je voorwaardelijk inhoud weergeven in het voorbeeldvenster van een blok wanneer je in de blokkiezer de muisaanwijzer op een blok houdt.
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 %}
Buiten templates
$isEditor en $isPreview bestaan alleen binnen de template. Code die tijdens dezelfde weergave buiten de template wordt uitgevoerd, zoals een themahelper die vanuit een template wordt aangeroepen of een filter zoals blockstudio/blocks/components/rich_text/render, kan bs_is_editor() en bs_is_preview() aanroepen. Deze retourneren dezelfde waarden als de template ontvangt.
function theme_card_title(string $title): string {
if ($title === '' && bs_is_editor()) {
return '<span class="placeholder">Add a title</span>';
}
return esc_html($title);
}
Blocktags geven altijd frontend-markup weer. Daarom retourneren beide functies false binnen een block dat vanuit een blocktag wordt weergegeven, net als $isEditor en $isPreview.