Umgebung
Manchmal müssen Inhalte in deinen Blöcken ausschließlich dann angezeigt werden, wenn sie im Gutenberg-Editor und nicht im Frontend gerendert werden. So kannst du Benutzern hilfreiche Informationen und Platzhalter anzeigen, wenn die erforderlichen Daten noch nicht eingegeben wurden.
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 %}
Vorschau
Blockstudio fügt eine weitere Umgebungsvariable hinzu, die für Blockentwickler nützlich ist. Mit $isPreview kannst du Inhalte bedingt im Blockvorschaufenster rendern, wenn du im Block-Inserter auf einen Block zeigst.
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 %}
Außerhalb von Templates
$isEditor und $isPreview sind nur innerhalb des Templates verfügbar. Code, der während desselben Rendervorgangs außerhalb des Templates ausgeführt wird, etwa ein vom Template aufgerufener Theme-Helper oder ein Filter wie blockstudio/blocks/components/rich_text/render, kann bs_is_editor() und bs_is_preview() aufrufen. Sie geben dieselben Werte zurück, die auch das Template erhält.
function theme_card_title(string $title): string {
if ($title === '' && bs_is_editor()) {
return '<span class="placeholder">Add a title</span>';
}
return esc_html($title);
}
Block-Tags geben immer Frontend-Markup aus. Daher geben beide Funktionen innerhalb eines Blocks, der über ein Block-Tag gerendert wird, false zurück, ebenso wie $isEditor und $isPreview.