Ugrás a tartalomhoz

Környezet

Néha csak akkor kell tartalmat megjeleníteni a blokkokban, amikor a Gutenberg szerkesztőben jelennek meg, a frontenden nem. Ezzel a technikával hasznos információkat és helyőrzőket jeleníthet meg a felhasználóknak, ha még nem adták meg a szükséges adatokat.

Szerkesztő

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

Előnézet

A Blockstudio egy másik hasznos környezeti változót biztosít a blokkfejlesztőknek. A $isPreview segítségével feltételesen jeleníthet meg tartalmat a blokkelőnézeti ablakban, amikor az egérmutatót a blokkbeszúró egyik blokkja fölé viszi.

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

Sablonokon kívül

A $isEditor és a $isPreview csak a sablonon belül létezik. A renderelés során, de a sablonon kívül futó kód, például a sablonból meghívott sablonsegédfüggvény vagy egy olyan szűrő, mint a blockstudio/blocks/components/rich_text/render, meghívhatja a bs_is_editor() és a bs_is_preview() függvényt. Ezek ugyanazokat az értékeket adják vissza, amelyeket a sablon kap.

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

A blokkcímkék mindig a webhely felületén megjelenő jelölést állítanak elő, ezért egy blokkcímkéből megjelenített blokkon belül mindkét függvény a false értéket adja vissza, akárcsak a $isEditor és a $isPreview.