Zum Inhalt springen

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

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

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.

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

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.