Saltar al contenido

Entorno

A veces es necesario mostrar contenido en los bloques solo cuando se representan dentro del editor Gutenberg, y no en el frontend. Esta técnica resulta muy útil para ofrecer información y marcadores de posición a los usuarios si aún no se han introducido los datos necesarios.

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

Vista previa

Blockstudio añade otra variable de entorno útil para quienes desarrollan bloques. $isPreview permite mostrar contenido de forma condicional en la ventana de vista previa del bloque cuando se pasa el cursor sobre un bloque en el insertador de bloques.

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

Fuera de las plantillas

$isEditor y $isPreview solo existen dentro de la plantilla. El código que se ejecuta durante la misma representación, pero fuera de la plantilla, como un helper del tema llamado desde una plantilla o un filtro como blockstudio/blocks/components/rich_text/render, puede llamar a bs_is_editor() y bs_is_preview(). Devuelven los mismos valores que recibe la plantilla.

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

Las etiquetas de bloque siempre representan el marcado del frontend, así que dentro de un bloque representado desde una etiqueta de bloque ambas funciones devuelven false, al igual que $isEditor y $isPreview.