Перейти до вмісту

Середовище

Іноді потрібно показувати вміст блоків лише тоді, коли вони відображаються в редакторі Gutenberg, але не у фронтенді. Це зручний спосіб надати користувачам корисну інформацію та заповнювачі, якщо потрібні дані ще не введено.

Редактор

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

Попередній перегляд

Blockstudio додає ще одну корисну змінну середовища для розробників блоків. $isPreview дає змогу умовно відображати вміст у вікні попереднього перегляду блока, коли курсор наведено на блок у списку вставлення блоків.

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

Поза шаблонами

$isEditor і $isPreview доступні лише всередині шаблону. Код, який виконується під час того самого рендерингу, але поза шаблоном, наприклад допоміжна функція теми, викликана із шаблону, або фільтр на кшталт blockstudio/blocks/components/rich_text/render, може викликати bs_is_editor() і bs_is_preview(). Вони повертають ті самі значення, що й шаблон.

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

Теги блоків завжди відображають розмітку фронтенду, тому всередині блоку, відображеного з тегу блоку, обидві функції повертають false, як і $isEditor та $isPreview.