Gå til indhold

Miljø

Nogle gange er det nødvendigt kun at vise indhold i dine blokke, når de gengives i Gutenberg-editoren og ikke på frontend. Denne teknik er nyttig til at give brugerne hjælpsomme oplysninger og pladsholdere, hvis de nødvendige data endnu ikke er indtastet.

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

Forhåndsvisning

Blockstudio tilføjer endnu en miljøvariabel, som er nyttig for blokudviklere. $isPreview lader dig gengive indhold betinget i blokvinduet til forhåndsvisning, når markøren holdes over en blok i blokindsætteren.

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

Uden for skabeloner

$isEditor og $isPreview findes kun inde i skabelonen. Kode, der kører under den samme gengivelse, men uden for skabelonen, f.eks. en hjælpefunktion i temaet, der kaldes fra en skabelon, eller et filter som blockstudio/blocks/components/rich_text/render, kan kalde bs_is_editor() og bs_is_preview(). De returnerer de samme værdier, som skabelonen modtager.

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

Blok-tags gengiver altid frontend-markup, så inde i en blok, der gengives fra et blok-tag, returnerer begge funktioner false, ligesom $isEditor og $isPreview gør.