Μετάβαση στο περιεχόμενο

Περιβάλλον

Μερικές φορές χρειάζεται να εμφανίζεται περιεχόμενο στα μπλοκ σας μόνο όταν αποδίδονται μέσα στον επεξεργαστή Gutenberg και όχι στο frontend. Αυτή η τεχνική είναι πολύ χρήσιμη για την παροχή χρήσιμων πληροφοριών και ενδεικτικών κειμένων στους χρήστες, όταν δεν έχουν ακόμη εισαχθεί τα απαραίτητα δεδομένα.

Επεξεργαστής

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

Οι ετικέτες block αποδίδουν πάντα σήμανση frontend, επομένως μέσα σε ένα block που αποδίδεται από ετικέτα block και οι δύο συναρτήσεις επιστρέφουν false, όπως και τα $isEditor και $isPreview.