Ga naar de inhoud

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

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

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.

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

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.