انتقل إلى المحتوى

البيئة

من الضروري أحيانًا إظهار المحتوى في كتلِك داخل محرر Gutenberg فقط، دون عرضه في الواجهة الأمامية. تفيد هذه التقنية كثيرًا في تزويد المستخدمين بمعلومات وإشارات مفيدة عندما لا تكون البيانات اللازمة قد أُدخلت بعد.

المحرر

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

المعاينة

يضيف Blockstudio متغير بيئة آخر يفيد مطوري الكتل. يتيح لك $isPreview عرض المحتوى بشكل مشروط داخل نافذة معاينة الكتلة عند تمرير المؤشر فوق كتلة في أداة إدراج الكتل.

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

خارج القوالب

لا يتوفر $isEditor و$isPreview إلا داخل القالب. ويمكن للشيفرة التي تعمل أثناء العرض نفسه ولكن خارج القالب، مثل دالة مساعدة في القالب يستدعيها قالب عرض أو مرشح مثل blockstudio/blocks/components/rich_text/render، استدعاء bs_is_editor() وbs_is_preview(). وتعيد هاتان الدالتان القيم نفسها التي يتلقاها القالب.

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

تعرض وسوم الكتل دائمًا ترميز الواجهة الأمامية، لذا تعيد الدالتان داخل كتلة معروضة من وسم كتلة القيمة false، كما تفعل $isEditor و$isPreview.