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

Προγραμματιστική απόδοση

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

Το Blockstudio προσφέρει δύο τρόπους προγραμματιστικής απόδοσης μπλοκ:

  • Συναρτήσεις PHP: bs_render_block και bs_block για απόδοση από κώδικα PHP
  • Ετικέτες HTML: ετικέτες <bs:block-name> που αντικαθίστανται από την έξοδο του μπλοκ σε οποιοδήποτε σημείο της σελίδας

Υποστηρίζονται όλες οι ειδικές λειτουργίες του Blockstudio, όπως τα ενσωματωμένα στυλ, τα script και τα περιορισμένα στυλ.

Τα Νησιά λειτουργούν και μέσω αυτών των διαδρομών απόδοσης. Ένα δυναμικό νησί που αποδίδεται με bs_render_block(), bs_block() ή ετικέτα μπλοκ επιστρέφει τον ίδιο δείκτη συμβόλου κράτησης θέσης με ένα μπλοκ που αποδίδεται από το περιεχόμενο ανάρτησης. Ο χρόνος εκτέλεσης του frontend εισάγεται όταν αυτός ο δείκτης υπάρχει στην απόκριση.

Δομημένοι συνδυασμοί και πλήρη έγγραφα

Για εργαλεία μεγάλης διάρκειας ζωής, προεπισκοπήσεις, εξαγωγές και συλλογές στοιχείων, χρησιμοποιήστε το Blockstudio\Render API με έκδοση. Δέχεται μία δήλωση ή μια ταξινομημένη λίστα και αποδίδει χωρίς echo:

PHP
use Blockstudio\Render;

$composition = [
  'root' => 'theme/card',
  'example' => [
    'data' => [
      'heading' => 'Example card',
    ],
    'layers' => [
      [
        'name' => 'theme/button',
        'data' => [
          'label' => 'Continue',
        ],
      ],
    ],
  ],
];

$normalized = Render::normalize($composition);
$html = Render::composition($composition);
$document = Render::document($composition, [
  'title' => 'Component preview',
  'contentElement' => 'main',
  'contentClasses' => ['component-preview'],
]);

Η κανονική κανονικοποιημένη δήλωση έχει τέσσερα κλειδιά:

PHP
[
  'name' => 'theme/card',
  'attributes' => [],
  'content' => '',
  'children' => [],
]

Τα data, inner, innerBlocks, root, layers και example είναι βολικές μορφές εισαγωγής και αφαιρούνται κατά την κανονικοποίηση. Οι εμφωλευμένες δηλώσεις αποδίδονται αναδρομικά μέσω της ίδιας διοχέτευσης Blockstudio.

Το Render::document() επιστρέφει schemaVersion, html, body, blocks, assets, warnings και errors. Η τιμή assets διαχωρίζει τα head, footer, styles, scripts, modules, interactivity, ui και tailwind. Η λίστα μπλοκ και τα στοιχεία ενεργητικού περιλαμβάνουν τις εξαρτήσεις που αναφέρονται στα επιλεγμένα πρότυπα, αλλά αποκλείουν άσχετα στοιχεία και στοιχεία που αφορούν μόνο τον επεξεργαστή.

Τα πλήρη έγγραφα μπορούν να ορίσουν τα bodyClasses/bodyAttributes και, προαιρετικά, να περιβάλουν το αποδιδόμενο σώμα με τα contentElement, contentClasses και contentAttributes. Το περίβλημα περιορίζεται σε ασφαλές όνομα στοιχείου· το επιστρεφόμενο body παραμένει το αποδιδόμενο περιεχόμενο χωρίς περίβλημα. Οι επιλογές head και footer προσθέτουν έμπιστη σήμανση εγγράφου στις αντίστοιχες θέσεις και περιλαμβάνονται στο σύνολο των στοιχείων ενεργητικού που επιστρέφεται.

Για να δημιουργήσετε ένα έγγραφο γύρω από το HTML που έχει ήδη αποδοθεί, δώστε τα γνωστά ονόματα των βασικών μπλοκ του:

PHP
$document = Render::document_from_html(
  $rendered_html,
  ['theme/hero', 'theme/button'],
  ['title' => 'Homepage preview']
);

Χρησιμοποιήστε το Render::content() για σειριοποιημένο περιεχόμενο μπλοκ WordPress. Οι καταναλωτές που αποδίδουν πολλά ανεξάρτητα έγγραφα σε ένα αίτημα πρέπει να καλούν το Blockstudio\Batch_Render::reset() ανάμεσά τους· το Canvas::documents() το κάνει αυτόματα.

Απόδοση εκτός σελίδας

Το Blockstudio τοποθετεί ένα σχόλιο <!--blockstudio/namespace/slug--> πριν από κάθε block που αποδίδει. Σε μια σελίδα frontend, το buffer διαβάζει αυτά τα σχόλια για να εντοπίσει τα block που υπάρχουν, φορτώνει τα στοιχεία τους και αφαιρεί τα σχόλια πριν σταλεί η απόκριση.

Το αποτέλεσμα που δεν περνά από αυτό το buffer διατηρεί τα σχόλια. Αυτό ισχύει για αποκρίσεις REST, ροές, χειριστές AJAX και HTML που αποθηκεύετε ή στέλνετε αλλού μετά από do_blocks(), Render::content() ή bs_render_block(). Χρησιμοποιήστε το bs_strip_render_markers() για να τα αφαιρέσετε:

PHP
$html = bs_strip_render_markers(do_blocks($post->post_content));

Η συνάρτηση αφαιρεί τα σχόλια των καταχωρισμένων block Blockstudio και αφήνει όλα τα υπόλοιπα ανέπαφα, συμπεριλαμβανομένων άλλων σχολίων HTML. Εντοπίζει τους ίδιους δείκτες που αφαιρεί το buffer της σελίδας. Καλέστε την μετά την καταχώριση των block (από το init και έπειτα).

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

Η αφαίρεση των σχολίων δεν προσθέτει στοιχεία. Τα αρχεία block CSS και JavaScript εισάγονται μόνο από το buffer της σελίδας. Χρησιμοποιήστε το bs_block_assets() ή το Render::document() όταν τα χρειάζεται και ο καταναλωτής.

Επιθεώρηση block

Χρησιμοποιήστε το bs_block_fields() μετά την καταχώριση των block (από το init και έπειτα) για να λάβετε τους επιλυμένους ορισμούς πεδίων χωρίς να διαβάσετε εσωτερικά μητρώα:

PHP
$fields = bs_block_fields('theme/card');

if ($fields === null) {
  // Unknown block, or not a Blockstudio block.
}

Η επιστρεφόμενη τιμή είναι ο καταχωρισμένος πίνακας ορισμών πεδίων, συμπεριλαμβανομένων των φίλτρων attributes, των ανεπτυγμένων προσαρμοσμένων πεδίων, των παρακάμψεων και των ένθετων ομάδων, καρτελών και repeaters. Ένα block Blockstudio χωρίς πεδία επιστρέφει []. Το αποτέλεσμα είναι αντίγραφο: αν το αλλάξετε, δεν αλλάζει το καταχωρισμένο block.

Αυτοί είναι ορισμοί, όχι αποθηκευμένες τιμές. Για να επικυρώσετε αποθηκευμένη σήμανση, χρησιμοποιήστε το bs_validate_block() αντί να συντηρείτε ξεχωριστό περιηγητή πεδίων. Για να περιγράψετε τις τιμές που δέχεται ένα μπλοκ, χρησιμοποιήστε το bs_block_schema(). Τα γνωρίσματα που ανήκουν στο WordPress παραμένουν ξεχωριστά.

Τα πεδία που προστίθενται από τις επεκτάσεις δεν αποτελούν μέρος του bs_block_fields(). Χρησιμοποιήστε το bs_block_extension_fields() για να τα λάβετε. Αντιστοιχίζει τις επεκτάσεις με βάση το όνομα block, επομένως λειτουργεί και για τα βασικά και τα πρόσθετα block τρίτων:

PHP
$fields = array_merge(
  bs_block_fields('core/paragraph') ?? [],
  bs_block_extension_fields('core/paragraph')
);

Η επιστρεφόμενη τιμή παραθέτει τους ορισμούς πεδίων κάθε αντίστοιχης επέκτασης, με τη σειρά καταχώρισής τους και με την ίδια δομή όπως το bs_block_fields(). Για block στο οποίο δεν αντιστοιχεί καμία επέκταση επιστρέφεται []. Οι τιμές των επεκτάσεων αποθηκεύονται στο ίδιο αντικείμενο attrs.blockstudio.attributes με τις τιμές των πεδίων του ίδιου του block, επομένως όλα τα ID μοιράζονται έναν χώρο ονομάτων. Αν δύο επεκτάσεις ορίσουν το ίδιο ID, επιστρέφονται και οι δύο ορισμοί και επεξεργάζονται την ίδια τιμή· κατά την απόδοση εφαρμόζεται ο ορισμός της επέκτασης που καταχωρίστηκε αργότερα.

Για να διαβάσετε τις τιμές ενός αποθηκευμένου block όπως τις λαμβάνει το πρότυπό του, χρησιμοποιήστε το bs_block_values().

Χρησιμοποιήστε το bs_block_assets() για να επιθεωρήσετε τα εντοπισμένα CSS και JavaScript του block. Για μια πλήρη προεπισκόπηση εγγράφου, συμπεριλαμβανομένων των ένθετων block και των κοινόχρηστων εξαρτήσεων χρόνου εκτέλεσης, χρησιμοποιήστε το Render::document() όπως περιγράφεται παραπάνω.

Επικύρωση αποθηκευμένων τιμών

Χρησιμοποιήστε το bs_validate_block() μετά την καταχώριση των block (από το init και έπειτα) για να ελέγξετε τα χαρακτηριστικά block που δημιουργήθηκαν προγραμματιστικά ή εισήχθησαν, πριν τα αποθηκεύσετε:

PHP
$block = parse_blocks($content)[0];
$findings = bs_validate_block($block['blockName'], $block['attrs']);

if ($findings === null) {
  // No Blockstudio fields or matching extensions apply.
} elseif ($findings === []) {
  // No stored-value problems were found.
} else {
  // Review the findings before saving.
}

Περάστε ολόκληρο τον πίνακα attrs, όχι μόνο το blockstudio.attributes. Μια απόδοση Blockstudio δέχεται επίσης δηλωμένα πεδία στο ανώτερο επίπεδο, ενώ οι ένθετες τιμές υπερισχύουν όταν παρέχονται και οι δύο μορφές. Οι επεκτάσεις βασικών και πρόσθετων block τρίτων διαβάζουν μόνο το blockstudio.attributes. Ένα κενό block Blockstudio είναι διαχειριζόμενο και επιστρέφει [], όχι null.

Η επικύρωση είναι ρητή και μόνο για ανάγνωση. Δεν αποδίδει πρότυπα, δεν αλλάζει τιμές, δεν αποθηκεύει αναρτήσεις, δεν αναζητά πολυμέσα και δεν εκτελεί callbacks συμπλήρωσης. Δεν εκτελείται αυτόματα κατά την αποθήκευση, τον συγχρονισμό σελίδων ή την απόδοση. Δεν είναι απολυμαντής, έλεγχος εξουσιοδότησης ή έλεγχος ύπαρξης συνημμένου.

Κάθε εύρημα περιέχει τα εξής σταθερά κλειδιά:

PHP
[
  'code' => 'unknown_option',
  'path' => 'steps/1/style',
  'source' => 'block',
  'message' => 'This value is not among the field options.',
  'value' => 'c',
  'expected' => ['a', 'b'],
]

Χρησιμοποιήστε το code στα εργαλεία, όχι το μεταφρασμένο message. Το source είναι block ή extension. Οι διαδρομές χρησιμοποιούν κλειδιά αποθήκευσης και δείκτες γραμμών repeater ή επιλογών με αρίθμηση από το μηδέν, χωρίς αρχική κάθετο. Τα κυριολεκτικά ~ και / σε ένα κλειδί διαφεύγονται ως ~0 και ~1. Μια ομάδα ανώτατου επιπέδου προσθέτει πρόθεμα στα θυγατρικά της πεδία (cta_title), ενώ οι ανώνυμες ομάδες και οι καρτέλες δεν προσθέτουν επίπεδο. Ο builder δεν υποστηρίζει ομάδες με ID μέσα σε άλλη ομάδα ή σε repeater, επομένως τα κλειδιά τους δεν γίνονται δεκτά. Τα πεδία μηνυμάτων δεν έχουν αποθηκευμένη τιμή. Ένα πεδίο αρχείων επιτρέπει το συνοδευτικό του <id>__size. Στη ρίζα ενός μπλοκ Blockstudio, τα κλειδιά διαχείρισης και τα καθολικά χαρακτηριστικά HTML που προωθούνται στο αποδιδόμενο στοιχείο δεν θεωρούνται άγνωστα πεδία. Αυτό δεν επιτρέπει αυθαίρετα κλειδιά σε γραμμές repeater ή επεκτάσεις βασικών μπλοκ.

Κώδικας Σημασία expected
unknown_field Κανένα πεδίο που διατηρείται δεν δηλώνει αυτό το κλειδί αποθήκευσης. Γνωστά κλειδιά αποθήκευσης.
unknown_option Μια επιλογή δεν περιλαμβάνεται στις γνωστές επιλογές. Επιτρεπόμενες τιμές επιλογών.
wrong_type Η αποθηκευμένη μορφή δεν υποστηρίζεται από το πεδίο. Αναμενόμενη οικογένεια ή τύπος αποθήκευσης.
too_few_rows, too_many_rows Ένα υπάρχον repeater είναι εκτός του min ή του max. Το όριο γραμμών.
definition_conflict Οι ισχύοντες ορισμοί για ένα κλειδί απαιτούν διαφορετικές μορφές αποθήκευσης. Πηγή και τύπος πεδίου κάθε ορισμού.
shadowed_value Μια εμφωλευμένη τιμή αντικαθιστά διαφορετική τιμή πεδίου ανώτατου επιπέδου. Η εμφωλευμένη τιμή που επικρατεί.
extension_top_level Το πρότυπο μπορεί να διαβάσει μια τιμή ανώτατου επιπέδου, αλλά οι δεσμεύσεις επεκτάσεων όχι. Η απαιτούμενη διαδρομή του κάτω από το blockstudio/attributes.
unknown_attribute Ένα κλειδί ανώτατου επιπέδου ενός μπλοκ Blockstudio δεν διαβάζεται από τη διαδρομή απόδοσης και απορρίπτεται. Καταχωρισμένα ονόματα χαρακτηριστικών, πεδία επεκτάσεων και blockstudio.
missing_container Τα attributes, disabled, name ή editor είναι αποθηκευμένα στο ανώτατο επίπεδο και λείπει το blockstudio. Η απαιτούμενη διαδρομή του κάτω από το blockstudio.
invalid_container Το blockstudio ή το blockstudio.attributes δεν είναι αντικείμενο. object.

Το μήνυμα ενός ευρήματος unknown_field αναφέρει το πλησιέστερο κλειδί αποθήκευσης στο ίδιο επίπεδο, όταν απέχει έως τρεις επεξεργασίες· αυτός είναι ο κανόνας που χρησιμοποιούν οι άγνωστες ρυθμίσεις: This storage key is not declared by the block or its extensions. Did you mean "title"? Το expected εξακολουθεί να παραθέτει κάθε γνωστό κλειδί. Η αντιστοίχιση αγνοεί πεζά και κεφαλαία και εξετάζει μόνο κλειδιά αποθήκευσης από εκείνο το κοντέινερ. Τα μηνύματα είναι μεταφρασμένα· οι ενσωματώσεις θα πρέπει να χρησιμοποιούν τα code, path και expected αντί να αναλύουν το κείμενο του μηνύματος.

Ένα κλειδί ανώτατου επιπέδου ενός μπλοκ Blockstudio που δεν είναι καταχωρισμένο χαρακτηριστικό (τα πεδία του, τα χαρακτηριστικά που προσθέτει το WordPress για τα supports, lock και metadata), ούτε πεδίο αντίστοιχης επέκτασης, ούτε blockstudio, ούτε κλειδί διαχείρισης ή προωθούμενο χαρακτηριστικό HTML, απορρίπτεται πριν εκτελεστεί το πρότυπο. Ένα τέτοιο κλειδί, για παράδειγμα ένα λανθασμένα πληκτρολογημένο ID πεδίου ή ένα αντικείμενο τιμών αποθηκευμένο χωρίς το περιτύλιγμα blockstudio, δημιουργεί εύρημα, επειδή το μπλοκ αποδίδεται χωρίς αυτήν την τιμή. Τα μπλοκ που περιέχουν μόνο πεδία επεκτάσεων δεν ελέγχονται για κλειδιά ανώτατου επιπέδου.

Οι αποδεκτές μορφές ακολουθούν την απόδοση: οι πολλαπλές επιλογές και τα πλαίσια ελέγχου μπορούν να περιέχουν λίστα, ένα αντικείμενο επιλογής ή εισαγόμενη βαθμωτή τιμή, συμπεριλαμβανομένου του αριθμητικού μηδενός. Γίνονται δεκτές αριθμητικές συμβολοσειρές για αριθμούς. Τα αρχεία μπορούν να περιέχουν ID συνημμένων, αντικείμενα ID, λίστες ή συμβολοσειρές αναφοράς. Οι τιμές συνδέσμων και εικονιδίων πρέπει να είναι αντικείμενα· οι προσαρμοσμένοι τύποι πεδίων χρησιμοποιούν τον καταχωρισμένο τύπο χαρακτηριστικού τους. Ένα πεδίο attributes περιέχει μια λίστα ζευγών με μη κενό όνομα attribute και βαθμωτή τιμή value· διατηρούνται προαιρετικά μεταδεδομένα όπως το data.media.

Το WordPress επικυρώνει τα καταχωρισμένα χαρακτηριστικά ανώτατου επιπέδου πριν από την απόδοση, και έτσι μπορεί να απορρίψει μια μορφή που γίνεται δεκτή μέσα στο blockstudio.attributes. Για παράδειγμα, μια τιμή ραδιοκουμπιού "a" λειτουργεί στο εμφωλευμένο αντικείμενο, αλλά απορρίπτεται στο ανώτατο επίπεδο, όπου ο καταχωρισμένος τύπος της είναι object. Μια τέτοια τιμή δημιουργεί wrong_type. Χρησιμοποιήστε το εμφωλευμένο αντικείμενο για την ίδια μορφή αποθήκευσης που γράφει ο επεξεργαστής.

Τα πεδία που λείπουν δεν είναι υποχρεωτικά. Οι κενές εμφωλευμένες τιμές (null, false, '', []) και τα απενεργοποιημένα πεδία δεν δημιουργούν σφάλματα τιμών. Ένα ρητά κενό repeater εξακολουθεί να ελέγχεται ως προς το min· ένα repeater που απουσιάζει ή είναι απενεργοποιημένο δεν ελέγχεται. Μια κενή τιμή ανώτατου επιπέδου αναφέρεται αν το WordPress την απορρίψει και επαναφέρει μια μη κενή προεπιλεγμένη τιμή. Η ίδια τιμή στο εμφωλευμένο αντικείμενο μπορεί να την εκκαθαρίσει. Αναφέρονται διενέξεις ορισμών ακόμη και όταν το κλειδί δεν έχει αποθηκευμένη τιμή.

Οι στατικές επιλογές και οι επιλογές populate που έχουν ήδη επιλυθεί κατά την καταχώριση ελέγχονται χωρίς να κληθεί ξανά το populate. Οι απομακρυσμένες επιλογές fetch και τα ορίσματα populate που περιέχουν {attributes.*} παραλείπονται. Οι τιμές χρώματος και διαβάθμισης μπορούν να είναι προσαρμοσμένες, εκτός αν έχει οριστεί το disableCustomColors ή το disableCustomGradients. Αυτός ο έλεγχος αφορά τις αποθηκευμένες τιμές, όχι τα default, fallback ή τους κανόνες επικύρωσης του επεξεργαστή.

Τα αντίστοιχα πεδία επεκτάσεων συμπεριλαμβάνονται για κάθε μπλοκ στο οποίο εφαρμόζονται. Κατά την απόδοση, οι μεταγενέστεροι ορισμοί υπερισχύουν μέσα στο μπλοκ ή στις επεκτάσεις του στη ρίζα. Το πεδίο του ίδιου του μπλοκ και ένα πεδίο επέκτασης παραμένουν ξεχωριστοί ορισμοί του ίδιου κλειδιού και ισχύουν και τα δύο. Στις γραμμές repeater, η απόδοση διαβάζει το πρώτο πεδίο με αντίστοιχο ID από κάθε πηγή, επομένως ισχύουν οι επιλογές και τα όριά του. Οι διπλότυποι ορισμοί διατηρούνται για τη διάγνωση διενέξεων: οι ασύμβατες μορφές αποθήκευσης δημιουργούν definition_conflict, ακόμη κι όταν ένας μεταγενέστερος διπλότυπος ορισμός δεν διαβάζεται κατά την απόδοση.

Η συνάρτηση ελέγχει ένα μπλοκ. Περάστε από τα μπλοκ ενός εγγράφου με το innerBlocks όταν το επικυρώνετε· τα συγχρονισμένα μοτίβα και άλλες αναφορές δεν επεκτείνονται αυτόματα. Η εντολή wp bs blocks validate διατρέχει τα μπλοκ μίας ή περισσότερων αναρτήσεων και αναφέρει τις διαδρομές των μπλοκ.

Οι ιστότοποι με προσαρμοσμένο επιλυτή κατά τον χρόνο απόδοσης μπορούν να προσαρμόσουν τα ευρήματα χωρίς να αλλάξουν τα αποθηκευμένα δεδομένα:

PHP
add_filter('blockstudio/blocks/attributes/validate', function($findings, $name, $attrs) {
  if ($name !== 'my-theme/card') {
    return $findings;
  }

  return array_values(array_filter($findings, function($finding) {
    return !($finding['path'] === 'customReference' && $finding['code'] === 'wrong_type');
  }));
}, 10, 3);

Να επιστρέφετε πάντα μια λίστα ευρημάτων· η επιστροφή του [] αποδέχεται το μπλοκ. Αυτό το φίλτρο εκτελείται μόνο για διαχειριζόμενα μπλοκ, ποτέ για το αποτέλεσμα του null.

Περιγραφή αποθηκευμένων τιμών

Χρησιμοποιήστε το bs_block_schema() μετά την καταχώριση του μπλοκ (init ή μεταγενέστερη έκδοση) για να περιγράψετε τις τιμές που αποθηκεύει ένα μπλοκ, για παράδειγμα για να δημιουργήσετε σήμανση μπλοκ σε ένα εργαλείο ή σε μια ενσωμάτωση AI, ή για να ελέγξετε την είσοδο σε μια διαδρομή REST:

PHP
$schema = bs_block_schema('theme/card');

if ($schema === null) {
  // No Blockstudio fields or matching extensions apply.
}

Το αποτέλεσμα είναι ένα Schema JSON του αντικειμένου που αποθηκεύεται στο attrs.blockstudio.attributes. Καλύπτει τα πεδία του μπλοκ και τα πεδία αντίστοιχων επεκτάσεων, με τα κλειδιά αποθήκευσης που χρησιμοποιεί η επικύρωση: μια ομάδα ανώτατου επιπέδου προσθέτει πρόθεμα στα θυγατρικά της πεδία, οι ανώνυμες ομάδες και οι καρτέλες δεν προσθέτουν επίπεδο, ενώ ένα πεδίο αρχείων προσθέτει το συνοδευτικό του <id>__size. Οι επαναλήπτες είναι λίστες αντικειμένων γραμμών με minItems και maxItems από τα min και max. Το additionalProperties είναι false στη ρίζα αποθήκευσης πεδίων και στις γραμμές επαναλήπτη. Τα πεδία με τιμή αντικειμένου, όπως οι σύνδεσμοι και τα προσαρμοσμένα αντικείμενα, μπορούν να έχουν τα δικά τους μεταδεδομένα. Ένα μπλοκ χωρίς πεδία δεν έχει properties, επομένως μόνο ένα κενό αντικείμενο ταιριάζει.

Κάθε πεδίο περιγράφεται σε κανονική μορφή που δέχεται το bs_validate_block():

Πεδίο Schema
text, textarea, richtext, wysiwyg, code, date, datetime, unit, classes, html-tag, block Συμβολοσειρά.
number, range Αριθμός, με minimum και maximum από τα min και max.
toggle Boolean.
select, radio, checkbox Τιμή επιλογής ή λίστα τιμών επιλογών για τα checkbox και multiple, με enum.
color, gradient Συμβολοσειρά, με enum όταν έχει οριστεί το disableCustomColors ή το disableCustomGradients.
token Λίστα συμβολοσειρών.
files Μη αρνητικό ακέραιο αναγνωριστικό συνημμένου ή λίστα αναγνωριστικών με multiple.
link Αντικείμενο με url, title και opensInNewTab· απαιτείται το url.
icon Αντικείμενο με set, subSet και icon· απαιτούνται τα set και icon.
attributes Λίστα αντικειμένων με μη κενό attribute και βαθμωτό value.
repeater Λίστα αντικειμένων γραμμών.
Προσαρμοσμένοι τύποι πεδίων Ο καταχωρισμένος τύπος γνωρίσματος.

Το enum παραθέτει τις επιλογές που ελέγχει η επικύρωση: στατικές επιλογές και επιλογές συμπλήρωσης που έχουν ήδη επιλυθεί κατά την καταχώριση. Οι απομακρυσμένες επιλογές fetch και τα ορίσματα συμπλήρωσης που περιέχουν {attributes.*} δεν έχουν enum. Ένα κλειδί με ορισμούς διαφορετικών σχημάτων αποθήκευσης παραλείπεται, επειδή η επικύρωση αναφέρει κάθε τιμή που είναι αποθηκευμένη σε αυτό. Όταν ένα πεδίο μπλοκ και ένα πεδίο επέκτασης χρησιμοποιούν το ίδιο κλειδί, το enum παραθέτει τις τιμές που δέχονται και τα δύο. Οι κοινόχρηστοι επαναλήπτες συνδυάζουν τα θυγατρικά τους πεδία και εφαρμόζουν τα αυστηρότερα όρια γραμμών και από τους δύο ορισμούς. Μέσα στις γραμμές επαναλήπτη εφαρμόζεται το πρώτο πεδίο με αντίστοιχο αναγνωριστικό σε κάθε πηγή, όπως και στην απόδοση. Ένα ρητά ορισμένο πεδίο με όνομα <id>__size υπερισχύει του συνοδευτικού μεγέθους αρχείου που προστίθεται αυτόματα.

Όταν ένα κλειστό πεδίο δεν έχει διαθέσιμες επιλογές ή δύο εφαρμοστέα σύνολα επιλογών δεν έχουν κοινές επιλογές, η κανονική τιμή του είναι null για μία επιλογή ή μια κενή λίστα για πολλές επιλογές. Μια κενή λίστα επιλογών δεν μετατρέπει το πεδίο σε πεδίο χωρίς περιορισμούς. Οι απομακρυσμένες επιλογές και οι επιλογές που εξαρτώνται από γνωρίσματα παραμένουν ανοιχτές.

Το label ενός πεδίου γίνεται title, το help του γίνεται description και το default του διατηρείται ως σχολιασμός. Το ίδιο το title του schema είναι ο τίτλος του μπλοκ. Τα πεδία δεν είναι ποτέ υποχρεωτικά και η λογική υπό συνθήκη δεν αποτελεί μέρος του schema.

Οι περιορισμοί χρησιμοποιούν μόνο λέξεις-κλειδιά που ελέγχει το rest_validate_value_from_schema(), ώστε το schema να λειτουργεί αυτούσιο ως schema εισόδου μιας διαδρομής REST ή μιας δυνατότητας:

PHP
$values = $block['attrs']['blockstudio']['attributes'] ?? [];
$schema = bs_block_schema($block['blockName']);
if ($schema !== null) {
  $result = rest_validate_value_from_schema($values, $schema);
}

Το σχήμα περιγράφει μία φόρμα ανά πεδίο· η επικύρωση δέχεται επίσης εισαγόμενες μορφές, όπως αντικείμενα επιλογών, αριθμητικές συμβολοσειρές και αντικείμενα ID. Δεν αντικαθιστά το bs_validate_block(): οι συγκρούσεις ορισμών είναι προβλήματα ρύθμισης και μπορούν να εξακολουθούν να εμφανίζουν ευρήματα, ακόμη κι όταν το αντικρουόμενο κλειδί παραλείπεται. Τα φίλτρα επικύρωσης μπορούν επίσης να επιβάλλουν κανόνες ειδικούς για κάθε ιστότοπο. Χρησιμοποιήστε το bs_validate_block() για να ελέγξετε το αποθηκευμένο περιεχόμενο. Οι ιστότοποι με προσαρμοσμένο επιλυτή κατά την απόδοση μπορούν να προσαρμόσουν το σχήμα με το φίλτρο blockstudio/blocks/attributes/schema.

PHP Συναρτήσεις

Χωρίς δεδομένα

Στην απλούστερη μορφή της, η συνάρτηση δέχεται μία τιμή, δηλαδή το ID του μπλοκ που πρέπει να αποδοθεί στη σελίδα.

PHP
bs_render_block('blockstudio/cta');

Με δεδομένα

Για να αποδώσετε το μπλοκ με προσαρμοσμένα δεδομένα, πρέπει να χρησιμοποιήσετε έναν πίνακα αντί για μία μεμονωμένη τιμή ως πρώτη παράμετρο. Η τιμή του κλειδιού data θα μεταβιβαστεί στη μεταβλητή $attributes και $a μέσα στο πρότυπο του μπλοκ.

PHP
bs_render_block([
  'id' => 'blockstudio/cta',
  'data' => [
    'title' => 'My title',
    'subtitle' => 'My subtitle',
  ],
]);

Ένθεση

Τα μπλοκ μπορούν να εμφωλεύονται μεταξύ τους με τη συνάρτηση bs_block σε συνδυασμό με την ισχυρή μεταβλητή $content μέσα στα πρότυπα των μπλοκ σας.

PHP
<div>
  <h1><?php echo $a['title']; ?></h1>
  <p><?php echo $a['subtitle']; ?></p>
  <?php echo $content; ?>
</div>
PHP
echo bs_block([
  'id' => 'blockstudio/cta',
  'data' => [
    'title' => 'My title',
    'subtitle' => 'My subtitle',
  ],
  'content' => bs_block([
    'id' => 'blockstudio/button',
    'data' => [
      'text' => 'Button Text',
    ]
  ])
]);

Το μπλοκ κουμπιού θα αποδοθεί στη θέση της μεταβλητής $content μέσα στο πρότυπο του μπλοκ.

Τα ενσωματωμένα μπλοκ που αποδίδονται με bs_render_block() ή bs_block() παράγουν πάντα HTML επιλυμένα για το frontend, ακόμη κι όταν το γονικό μπλοκ αποδίδει εκείνη τη στιγμή προεπισκόπηση επεξεργαστή. Τα ψευδοσυστατικά προτύπων, όπως τα <RichText /> και <InnerBlocks />, επιλύονται πριν επιστραφεί το ενσωματωμένο μπλοκ.

Πολλαπλές θέσεις περιεχομένου

Μπορείτε επίσης να δημιουργήσετε πολλές θέσεις περιεχομένου, κάνοντας απλώς τη μεταβλητή $content συσχετιστικό πίνακα και καλώντας τα αντίστοιχα κλειδιά της στη συνάρτηση bs_block.

PHP
<div>
  <?php echo $content['beforeContent']; ?>
  <h1><?php echo $a['title']; ?></h1>
  <p><?php echo $a['subtitle']; ?></p>
  <?php echo $content['afterContent']; ?>
</div>
PHP
echo bs_block([
  'id' => 'blockstudio/cta',
  'data' => [
    'title' => 'My title',
    'subtitle' => 'My subtitle',
  ],
  'content' => [
    'beforeContent' => bs_block([
      'id' => 'blockstudio/badge',
      'data' => ['text' => 'Before Content']
    ]),
    'afterContent' => bs_block([
      'id' => 'blockstudio/button',
      'data' => ['text' => 'Button Text']
    ])
  ]
]);

Ετικέτες μπλοκ

Ενσωματώστε οποιοδήποτε μπλοκ με σύνταξη ετικέτας HTML. Υποστηρίζονται δύο μορφές:

HTML
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />

Και οι δύο αποδίδουν το ίδιο μπλοκ. Η σύνταξη <bs:> μετατρέπει την παύλα σε διαχωριστικό namespace (το acme-hero γίνεται acme/hero). Οι παύλες δοκιμάζονται από αριστερά προς τα δεξιά και υπερισχύει ο πρώτος καταχωρισμένος υποψήφιος, επομένως επιλύονται και τα namespaces που περιέχουν παύλες: το <bs:acme-ui-button> δοκιμάζει το acme/ui-button και μετά το acme-ui/button. Η σύνταξη <block> δέχεται ολόκληρο το όνομα του μπλοκ ως χαρακτηριστικό name.

Λειτουργούν τόσο τα μπλοκ Blockstudio όσο και τα βασικά μπλοκ του WordPress. Τα μπλοκ Blockstudio αποδίδονται μέσω ολόκληρης της ροής επεξεργασίας (πρότυπα, Tailwind, στοιχεία). Τα βασικά μπλοκ αποδίδονται μέσω του συστήματος απόδοσης μπλοκ του WordPress, χρησιμοποιώντας τους ενσωματωμένους αποδότες μπλοκ.

Πώς λειτουργεί

Η συμπεριφορά των ετικετών μπλοκ εξαρτάται από το σημείο όπου εμφανίζονται:

Στα πρότυπα μπλοκ και στο περιεχόμενο αναρτήσεων, οι ετικέτες αντικαθίστανται από αποδομένα HTML κατά την εκτέλεση. Το αποτέλεσμα είναι η τελική σήμανση του μπλοκ που αναφέρεται, ενσωματωμένη απευθείας στη σελίδα. Δεν υπάρχει μπλοκ WordPress στον επεξεργαστή για αυτές. Αποτελούν αποκλειστικά μηχανισμό απόδοσης.

Στις Σελίδες, Μοτίβα και Πρότυπα ιστότοπου, οι ετικέτες μετατρέπονται σε εγγενή μπλοκ WordPress πριν συγχρονιστεί η πηγή του αρχείου ή καταχωριστεί με το WordPress. Έτσι, τα μπλοκ εμφανίζονται στον επεξεργαστή, μπορούν να τροποποιηθούν όπου το επιτρέπει ο προορισμός και ακολουθούν ολόκληρο τον κύκλο ζωής μπλοκ του WordPress. Η σύνταξη ετικετών είναι συντομογραφία για τον ορισμό περιεχομένου μπλοκ σε αρχεία προτύπων.

Αυτή η διάκριση έχει σημασία: οι ετικέτες μπλοκ στα πρότυπα παράγουν έξοδο, ενώ στις σελίδες, τα μοτίβα και τα Πρότυπα ιστότοπου παράγουν εγγενή μπλοκ.

Στα πρότυπα μπλοκ

Οι ετικέτες μπλοκ αποδίδονται αυτόματα μέσα στα πρότυπα Twig και PHP. Δεν απαιτείται ρύθμιση. Αυτό περιλαμβάνει τις συντάξεις <bs:> και <block>, καθώς και οποιεσδήποτε καταχωρισμένες ετικέτες προθέματος και ψευδωνύμου, ώστε ένα πρότυπο να μπορεί να τις παράγει απευθείας αντί να καλεί το bs_render_block(). Η έξοδος αποδίδεται HTML, ενσωματωμένη απευθείας στην έξοδο του προτύπου του μπλοκ:

Twig
<div class="my-page">
  <bs:mytheme-card title="Featured" />
  <block name="core/separator" />
  <bs:core-paragraph>Rendered by WordPress</bs:core-paragraph>
  <block name="core/heading" level="2">Also WordPress</block>
  <theme-card title="Prefix shorthand" />
</div>

Στο περιεχόμενο αναρτήσεων

Η απόδοση σε επίπεδο σελίδας (περιεχόμενο αναρτήσεων, περιοχές γραφικών στοιχείων) είναι προαιρετική:

JSON
{
  "blockTags": {
    "enabled": true
  }
}

Ή μέσω φίλτρου:

PHP
add_filter('blockstudio/settings/block_tags/enabled', '__return_true');

Σύνταξη

Ετικέτες χωρίς κλείσιμο:

HTML
<bs:mytheme-cta title="Get started" variant="primary" />
<block name="core/separator" />

Ζευγαρωμένες ετικέτες με εσωτερικό περιεχόμενο:

HTML
<bs:mytheme-section layout="wide">
  <p>Content inside the block.</p>
</bs:mytheme-section>

<block name="core/group">
  <block name="core/paragraph">Inside a group.</block>
</block>

Μπορείτε να συνδυάζετε ελεύθερα τις μορφές. Οι δύο συντάξεις μπορούν να εμφωλεύονται η μία μέσα στην άλλη:

HTML
<bs:mytheme-section>
  <block name="core/heading" level="2">Title</block>
  <bs:mytheme-card title="Features" />
  <block name="core/paragraph">Description text.</block>
</bs:mytheme-section>

Συντομογραφίες προθεμάτων

Οι ετικέτες μπλοκ μπορούν επίσης να χρησιμοποιούν συντομογραφίες προθεμάτων ειδικές για το έργο. Καταχωρίστε ένα πρόθεμα με ένα ή περισσότερα namespaces και το Blockstudio επιλύει το <prefix-slug> στο πρώτο καταχωρισμένο μπλοκ με τη συγκεκριμένη σειρά namespaces:

PHP
add_filter('blockstudio/block_tags/prefixes', function($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});
HTML
<theme-card title="Homepage" />
<theme-button label="Get started" />
<theme-ui-feature-matrix />

Με το παραπάνω παράδειγμα, το <theme-card> επιλύεται στο theme-components/card, το <theme-button> επιστρέφει στο bsui/button όταν το theme-components/button δεν είναι καταχωρισμένο και το <theme-ui-feature-matrix> επιλύεται στο theme-components/ui-feature-matrix.

Τα προθέματα μπορούν επίσης να συνδυάζονται. Όταν μια ετικέτα με πρόθεμα δεν επιλύεται απευθείας και το υπόλοιπο slug είναι από μόνο του καταχωρισμένη ετικέτα προθέματος, η επίλυση γίνεται αναδρομικά, ώστε ένα πρόθεμα επωνυμίας να μπορεί να βασίζεται σε πρόθεμα namespace:

PHP
add_filter('blockstudio/block_tags/prefixes', function($prefixes) {
  $prefixes['theme'] = ['theme-components'];
  $prefixes['ui'] = ['bsui'];

  return $prefixes;
});
HTML
<theme-ui-input />

Το <theme-ui-input> δεν έχει μπλοκ theme-components/ui-input, οπότε περνά στο πρόθεμα ui και επιλύεται ως bsui/input. Οι άμεσες αντιστοιχίσεις υπερισχύουν πάντα της ένθετης επίλυσης και οι κανόνες αποδοχής ή απόρριψης εφαρμόζονται στο τελικό μπλοκ που επιλύθηκε.

Μπορείτε επίσης να διαμορφώσετε προθέματα στο blockstudio.json:

JSON
{
  "blockTags": {
    "prefixes": {
      "theme": ["theme-components", "bsui"]
    }
  }
}

Τα προθέματα πρέπει να αποτελούνται από πεζά γράμματα ή αριθμούς, να ξεκινούν με γράμμα και να μην περιέχουν παύλες. Τα ρητά ψευδώνυμα από το blockstudio/block_tags/tag_aliases υπερισχύουν της επίλυσης προθεμάτων. Οι άγνωστες ετικέτες με πρόθεμα παραμένουν αμετάβλητες.

Οι ετικέτες προθεμάτων και ψευδωνύμων εξακολουθούν να υποστηρίζονται ως ευκολίες σύνταξης. Η κανονική, φορητή γραφή είναι πάντα <bs:namespace-slug>, επειδή καταγράφει το πραγματικό όνομα του μπλοκ χωρίς να εξαρτάται από φίλτρα του έργου:

HTML
<bs:theme-components-card />
<bs:bsui-input />

Τα παραδείγματα Blockstudio, τα διαγνωστικά που δημιουργούνται και η προγραμματική έξοδος χρησιμοποιούν αυτήν την κανονική γραφή. Τα έργα που θέλουν να καταργήσουν μια παλαιότερη μορφή συντομογραφίας μπορούν να χρησιμοποιήσουν την αυτόνομη μετεγκατάσταση κανονικών ετικετών, που εκτελεί πρώτα δοκιμαστική λειτουργία, χωρίς να εκκινήσουν το WordPress.

Βασικά μπλοκ

Μπορεί να χρησιμοποιηθεί οποιοδήποτε μπλοκ διαθέτει καταχωρισμένο αποδότη:

HTML
<bs:core-paragraph>A paragraph</bs:core-paragraph>
<bs:core-heading level="2">A heading</bs:core-heading>
<bs:core-separator />
<bs:core-image url="photo.jpg" alt="Photo" />
<bs:core-buttons>
  <bs:core-button url="/about">About</bs:core-button>
</bs:core-buttons>

Ή με σύνταξη <block>:

HTML
<block name="core/group">
  <block name="core/columns">
    <block name="core/column">
      <block name="core/paragraph">Left column</block>
    </block>
    <block name="core/column">
      <block name="core/paragraph">Right column</block>
    </block>
  </block>
</block>

Λίστες αποδοχής και απόρριψης

Καθορίστε ποια μπλοκ μπορούν να αποδίδονται μέσω ετικετών:

JSON
{
  "blockTags": {
    "enabled": true,
    "allow": ["mytheme/*", "core/*"],
    "deny": ["mytheme/internal-*"]
  }
}

Το allow περιορίζει την απόδοση μόνο στα μοτίβα που ταιριάζουν. Το deny εξαιρεί τα μοτίβα που ταιριάζουν και έχει προτεραιότητα. Και τα δύο υποστηρίζουν χαρακτήρες μπαλαντέρ * μέσω του fnmatch(). Ισχύουν και για τις δύο συντάξεις, τόσο στην απόδοση σε επίπεδο προτύπου όσο και σε επίπεδο σελίδας.

Φίλτρα: blockstudio/block_tags/allow και blockstudio/block_tags/deny.

Προώθηση χαρακτηριστικών HTML

Τα χαρακτηριστικά με πρόθεμα data- προωθούνται στο ριζικό στοιχείο του αποδιδόμενου μπλοκ. Προωθούνται επίσης τα χαρακτηριστικά με πρόθεμα html-, αφού αφαιρεθεί το πρόθεμα. Λειτουργεί και με τις δύο συντάξεις. Ένα χαρακτηριστικό προώθησης αντικαθιστά την υπάρχουσα τιμή του ριζικού στοιχείου αντί να συγχωνεύεται μαζί της, επομένως το html-class αντικαθιστά τις ίδιες τις κλάσεις του μπλοκ.

Ένα μπλοκ Blockstudio τοποθετεί επίσης στο ριζικό στοιχείο τα καθολικά χαρακτηριστικά που δεν δηλώνει ως πεδία: id, style, role, title, lang, dir, hidden, tabindex και κάθε χαρακτηριστικό aria-*. Ένα δηλωμένο πεδίο υπερισχύει πάντα, επομένως ένα μπλοκ με πεδίο title λαμβάνει την τιμή στο $a['title']. Τα προωθημένα στυλ περνούν από το safecss_filter_attr(), το φίλτρο WordPress εφαρμόζεται στα χαρακτηριστικά στυλ στο περιεχόμενο αναρτήσεων και αυτά προστίθενται σε στυλ που έχει ήδη ορίσει το πρότυπο.

Οι τιμές χαρακτηριστικών είναι HTML, επομένως οι οντότητες αποκωδικοποιούνται μία φορά κατά την ανάλυση της ετικέτας: το title="Tom &amp; Jerry" φτάνει στο πρότυπο ως Tom & Jerry και γίνεται ξανά διαφυγή στην έξοδο. Οι τιμές σε εισαγωγικά μπορούν να περιέχουν >, όπως οι παραλλαγές Tailwind και οι επιλογείς κίνησης, τόσο σε ετικέτες χωρίς κλείσιμο όσο και σε ζευγαρωμένες.

Οποιοδήποτε άλλο χαρακτηριστικό που δεν δηλώνεται από το μπλοκ, συμπεριλαμβανομένου του class, δεν φτάνει ποτέ στο HTML. Όταν είναι ενεργοποιημένο το WP_DEBUG, το Blockstudio αναφέρει κάθε τέτοιο χαρακτηριστικό μία φορά ανά αίτημα μέσω του _doing_it_wrong(). Δηλώστε ένα πεδίο γι’ αυτό ή γράψτε το ως χαρακτηριστικό data-, aria- ή html-.

HTML
<bs:mytheme-card
  title="My Card"
  html-class="featured-card"
  html-id="main-card"
  data-analytics="card-click"
/>

<block name="core/paragraph" html-class="highlight" data-section="intro">
  Highlighted paragraph.
</block>

Προσαρμοσμένοι αποδότες

Καταχωρίστε προσαρμοσμένους αποδότες μπλοκ για πρόσθετους τύπους μπλοκ. Οι αποδότες δέχονται έναν πίνακα χαρακτηριστικών και μια συμβολοσειρά εσωτερικού περιεχομένου και επιστρέφουν έναν πίνακα μπλοκ WordPress:

PHP
add_filter('blockstudio/block_tags/builders', function ($builders, $parser) {
    $builders['myplugin/custom-block'] = function (array $attrs, string $inner_content) {
        $html = '<div class="my-block">' . $inner_content . '</div>';
        return [
            'blockName'    => 'myplugin/custom-block',
            'attrs'        => $attrs,
            'innerBlocks'  => [],
            'innerHTML'    => $html,
            'innerContent' => [$html],
        ];
    };
    return $builders;
}, 10, 2);

Για μπλοκ περιέκτη που χρειάζεται να αναλύσει το εσωτερικό περιεχόμενο σε θυγατρικά μπλοκ, προσθέστε μια δεύτερη καταχώριση μέσα στο ίδιο φίλτρο:

PHP
$builders['myplugin/wrapper'] = function (array $attrs, string $inner_content) {
    $inner_blocks = Blockstudio\Block_Tags::parse_inner_blocks($inner_content);
    $content = ['<div class="my-wrapper">'];
    foreach ($inner_blocks as $block) {
        $content[] = null;
    }
    $content[] = '</div>';
    return [
        'blockName'    => 'myplugin/wrapper',
        'attrs'        => $attrs,
        'innerBlocks'  => $inner_blocks,
        'innerHTML'    => '<div class="my-wrapper"></div>',
        'innerContent' => $content,
    ];
};

Το blockstudio/block_tags/builders εφαρμόζεται τόσο στις ετικέτες μπλοκ όσο και στα προσαρμοσμένα μπλοκ που επιλέγονται μέσω του blockstudio/parser/element_mapping. Αυτό είναι το κατάλληλο hook όταν ένα μπλοκ έργου με αντιστοίχιση στοιχείου πρέπει να μεταφέρει το εσωτερικό κείμενο σε πεδίο Blockstudio ή να κατασκευάσει έναν προσαρμοσμένο πίνακα μπλοκ.

Τα blockstudio/block_tags/renderers και blockstudio/parser/renderers λαμβάνουν το ίδιο μητρώο και την ίδια μορφή callback. Παραμένουν διαθέσιμα για συμβατότητα και τελικές παρακάμψεις σε επίπεδο αναλυτή. Τα φίλτρα εκτελούνται με την εξής σειρά:

  1. blockstudio/block_tags/builders
  2. blockstudio/block_tags/renderers
  3. blockstudio/parser/renderers

Ένα μεταγενέστερο φίλτρο μπορεί να αντικαταστήσει έναν αποδότη που έχει καταχωρίσει προηγούμενο φίλτρο.

Προγραμματική χρήση

Εφαρμόστε την απόδοση ετικετών σε οποιαδήποτε συμβολοσειρά από το PHP:

PHP
$html = apply_filters('blockstudio/block_tags/render', $content);

Συστατικά

Οι ετικέτες μπλοκ συνδυάζονται καλά με τα Συστατικά. Τα συστατικά είναι μπλοκ που αποδίδονται μόνο προγραμματικά και δεν εμφανίζονται ποτέ στον επεξεργαστή.

HTML
<bs:mytheme-card title="My Card" description="Card content." />

Αναλυτής

Οι ετικέτες μπλοκ επεξεργάζονται από έναν ελαφρύ σαρωτή συμβολοσειρών που αντικαθιστά το DOMDocument. Ο αναλυτής χειρίζεται τόσο τη σύνταξη <bs:> όσο και την <block>, ετικέτες με εμφώλευση ίδιου ονόματος μέσω παρακολούθησης βάθους, τιμές χαρακτηριστικών σε εισαγωγικά και αναδρομικά μπλοκ περιέκτη. Είναι ειδικά σχεδιασμένος για αυτήν τη χρήση, έχει καλύτερες επιδόσεις σε δοκιμές από τα DOMDocument και WordPress του WP_HTML_Tag_Processor και αποφεύγει τα γνωστά προβλήματα του DOMDocument με την αφαίρεση προθεμάτων namespace και τη μετατροπή χαρακτηριστικών σε πεζά.

Για τα Σελίδες, Μοτίβα και Πρότυπα ιστότοπου, ο ίδιος αναλυτής χειρίζεται επίσης ακατέργαστα στοιχεία HTML (<p>, <div>, <h1> κ.λπ.), αντιστοιχίζοντάς τα στα αντίστοιχα βασικά μπλοκ WordPress.

Όταν μια αντιστοίχιση στοιχείου συνδέει το <p> με καταχωρισμένο μπλοκ Blockstudio εκτός βασικών μπλοκ, το οποίο δηλώνει χαρακτηριστικό richtext content, το εσωτερικό HTML δρομολογείται αυτόματα σε αυτό το χαρακτηριστικό content, συμπεριλαμβανομένων ενσωματωμένων ετικετών όπως τα code και img που αντιστοιχίζονται σε στοιχεία σε επίπεδο μπλοκ. Μια παράγραφος που έχει ως μοναδικό θυγατρικό στοιχείο μια εικόνα γίνεται το μπλοκ στο οποίο αντιστοιχίζεται το <img>. Οι εμφωλευμένες ετικέτες μπλοκ ή τα HTML επιπέδου μπλοκ εξακολουθούν να υπάγονται στην κανονική ανάλυση εσωτερικών μπλοκ. Το <block name="core/shortcode"> διατηρεί το κείμενο του shortcode ως περιεχόμενο του μπλοκ.