İçeriğe geç

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

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

Ş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.

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