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 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
{% 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 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
{% 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.
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.