Preskočiť na obsah

Prostredie

Niekedy je potrebné zobrazovať obsah blokov iba vtedy, keď sa vykresľujú v editore Gutenberg, a nie na frontende. Tento postup je veľmi užitočný na zobrazenie užitočných informácií a zástupných symbolov, ak ešte neboli zadané potrebné údaje.

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

Ukážka

Blockstudio pridáva ďalšiu premennú prostredia užitočnú pre vývojárov blokov. $isPreview umožňuje podmienene vykresliť obsah v okne ukážky bloku, keď ukážete kurzorom na blok v zozname blokov.

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

Mimo šablón

$isEditor a $isPreview existujú iba v šablóne. Kód, ktorý sa spúšťa počas toho istého vykresľovania, ale mimo šablóny, napríklad pomocná funkcia témy volaná zo šablóny alebo filter ako blockstudio/blocks/components/rich_text/render, môže zavolať bs_is_editor() a bs_is_preview(). Vrátia rovnaké hodnoty, aké dostáva šablóna.

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

Značky blokov vždy vykresľujú značky na frontende, takže v bloku vykreslenom zo značky bloku obe funkcie vrátia false, rovnako ako $isEditor a $isPreview.