Ortam
Bazen bloklarınızdaki içeriğin yalnızca Gutenberg düzenleyicisinde görüntülenirken gösterilmesi, önyüzde gösterilmemesi gerekir. Bu yöntem, gerekli veriler henüz girilmemişse kullanıcılara yararlı bilgiler ve yer tutucular sunmak için oldukça kullanışlıdır.
Düzenleyici
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 %}
Önizleme
Blockstudio, blok geliştiricileri için kullanışlı olacak başka bir ortam değişkeni ekler. $isPreview, blok ekleyicide bir bloğun üzerine gelindiğinde blok önizleme penceresindeki içeriği koşullu olarak görüntülemenizi sağlar.
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 %}
Şablonların dışında
$isEditor ve $isPreview yalnızca şablonun içinde bulunur. Şablondan çağrılan bir tema yardımcısı veya blockstudio/blocks/components/rich_text/render gibi bir filtre gibi, aynı oluşturma sırasında ancak şablonun dışında çalışan kodlar bs_is_editor() ve bs_is_preview() çağrısını yapabilir. Bunlar, şablona iletilen değerlerin aynısını döndürür.
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 etiketleri her zaman ön yüz işaretlemesini oluşturur; bu nedenle blok etiketinden oluşturulan bir bloğun içinde her iki işlev de false döndürür; $isEditor ve $isPreview de aynı şekilde davranır.