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