Liigu sisu juurde

Keskkond

Mõnikord tuleb sisu kuvada plokkides ainult siis, kui neid renderdatakse Gutenberg redaktoris, mitte kasutajaliideses. See võte on kasulik, kui soovite anda kasutajatele abiteavet ja kohatäiteid juhuks, kui vajalikud andmed pole veel sisestatud.

Redaktor

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

Eelvaade

Blockstudio lisab plokiarendajatele veel ühe kasuliku keskkonnamuutuja. $isPreview abil saab ploki eelvaateaknas sisu tingimuslikult renderdada, kui hõljutate kursorit ploki lisamise vaates ploki kohal.

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

Väljaspool malle

$isEditor ja $isPreview on saadaval ainult malli sees. Kood, mis käivitub sama renderdamise ajal, kuid väljaspool malli, näiteks mallist kutsutav teema abifunktsioon või filter nagu blockstudio/blocks/components/rich_text/render, saab kutsuda funktsioone bs_is_editor() ja bs_is_preview(). Need tagastavad samad väärtused, mille mall saab.

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

Plokisildid renderdavad alati esiotsa märgenduse, seega tagastavad mõlemad funktsioonid plokisildi kaudu renderdatud ploki sees väärtuse false, nagu ka $isEditor ja $isPreview.