Към съдържанието

Среда

Понякога е необходимо съдържанието в блоковете ви да се показва само когато блокът се визуализира в редактора 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.