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

Dennis · 27 Ιουλίου 2026

Blockstudio 7.6

Το Blockstudio 7.6 επιτρέπει την ανάγνωση και απόδοση ενός έργου από το PHP και μεταφέρει τις προεπιλογές frontend παραγωγής στο blockstudio.json: απογραφή API, αυτόνομη απόδοση, βοηθητικές συναρτήσεις προτύπων για πολυμέσα και Tailwind, προφίλ επιδόσεων, έναν κατάλογο cache, στατική προαπόδοση με έγκαιρη εξυπηρέτηση, αυστηρότερα προφίλ ανάλυσης και παραγόμενα εργαλεία έργου για coding agents.

Δύο κλήσεις καλύπτουν το μεγαλύτερο μέρος της έκδοσης. Το Canvas::inventory() επιστρέφει κάθε σελίδα, block, μοτίβο, πρότυπο Site Editor, τμήμα προτύπου και ενσωματωμένο παράδειγμα UI που έχει καταχωρίσει ένα έργο. Το Render::document() επιστρέφει έτοιμο HTML για οποιοδήποτε από αυτά, μαζί με ακριβώς τα στοιχεία που χρησιμοποίησε η απόδοση.

Ενημέρωση 7.6.2: Οι σελίδες από αρχεία δεν συγχρονίζονται πλέον κατά τα συνήθη αιτήματα WordPress. Εκτελέστε το wp bs pages sync ή καλέστε το Blockstudio\Pages::reconcile() κατά την εφαρμογή αλλαγών πηγής. Η δρομολόγηση συλλογών και οι προεπιλογές του templateFor χρησιμοποιούν μόνιμα αποθηκευμένες ρυθμίσεις runtime, ενώ η ρητή συμφωνία αποφεύγει το προηγούμενο μεγάλο ερώτημα OR-meta για πολλές γλώσσες. Η επιλογή themeDefaults.syncPagesInDevelopment μικρής διάρκειας αφαιρέθηκε, επειδή ο συγχρονισμός σελίδων δεν εκτελείται πλέον από hooks αιτημάτων. Το Pages::init() χρησιμοποιείται πλέον μόνο κατά την αρχικοποίηση· οι ενσωματώσεις που περνούσαν το force πρέπει να χρησιμοποιούν το Pages::reconcile() ή το CLI. Το άνοιγμα του Canvas εξακολουθεί να εκτελεί μία ρητή, πιστοποιημένη συμφωνία για την απογραφή συγγραφής.

7.6.12 ενημέρωση: Τα φύλλα στυλ του επεξεργαστή αποκτούν πλέον πρόθεμα σε ένα μόνο πέρασμα επανεγγραφής, αντί για μεταγλώττιση SASS ανά στοιχείο, ώστε μια ψυχρή δημιουργία του επεξεργαστή σε ιστότοπο με πολλά blocks να μην κινδυνεύει πλέον να εξαντλήσει ένα περιορισμένο όριο μνήμης. Μια αποθηκευμένη στην προσωρινή μνήμη προ-αποδοσμένη σελίδα της οποίας το φύλλο στυλ Tailwind με κατακερματισμό περιεχομένου έχει εκκαθαριστεί αποδίδεται ξανά αντί να εμφανιστεί χωρίς στυλ, τόσο μέσω της προσωρινής μνήμης PHP όσο και μέσω του drop-in Early Serve. Τα γνωρίσματα block που γράφονται στο ανώτατο επίπεδο διαβάζονται κατά την απόδοση αντί να απορρίπτονται, οπότε το σχήμα Blockstudio που καταχωρίζεται στο WP_Block_Type τηρείται από προγραμματισμένους writers.

7.6.11 ενημέρωση: Η εγκατάσταση τεχνουργημάτων γραφήματος αντικαθιστά πλέον ατομικά το έγγραφο μιας διαδρομής όταν αλλάξει το αντίγραφο στο store με το ίδιο κλειδί, αφήνει ανέπαφα τα πανομοιότυπα έγγραφα και αναφέρει τις διαδρομές που προωθήθηκαν, αντικαταστάθηκαν, παραλείφθηκαν και διατηρήθηκαν μέσω του Static_Prerender_Early_Serve::last_promotion().

7.6.10 ενημέρωση: Οι επιτυχίες της προσωρινής μνήμης χρόνου εκτέλεσης εντοπίζουν πλέον αφαιρεμένα μεταγλωττισμένα στοιχεία ακόμη και μέσα στην καθυστέρηση αποσφαλμάτωσης της παρακολούθησης, ενώ οι επίπεδες προσωρινές μνήμες χρόνου εκτέλεσης πριν από την 7.6 απομονώνονται και διαγράφονται ατομικά σε παρτίδες cron με όριο μεγέθους. Τα καθολικά στοιχεία UI που περιλαμβάνονται στο πακέτο εκπέμπονται μία φορά ανά σελίδα. Το Early Serve σε λειτουργία γραφήματος μπορεί να εξυπηρετεί διαδρομές που αποδίδονται ζωντανά, εκτός του αναπτυγμένου χάρτη διαδρομών, από την προσωρινή μνήμη ταυτότητας. Το Tailwind μπορεί προαιρετικά να εκπέμπει το αρχείο προσωρινής μνήμης με κατακερματισμό περιεχομένου με tailwind.output: "link"· η ενσωματωμένη έξοδος παραμένει η προεπιλογή.

Εν συντομία:

  • Απογραφή έργου: Το Canvas::inventory() επιστρέφει κάθε καταχωρισμένη εγγραφή μαζί με τις πηγές της και σταθερή σειρά εμφάνισης.
  • Στοχευμένη επιλογή: Η ονομασία blocks και σελίδων περιορίζει τον εντοπισμό, τον συγχρονισμό, την απόδοση και τη μεταγλώττιση σε αυτές τις εγγραφές.
  • Αυτόνομη απόδοση: Το Blockstudio\Render επιστρέφει ολοκληρωμένο HTML για ένα block, μια σύνθεση ή ένα πλήρες έγγραφο.
  • Οικογένειες στοιχείων UI: Το Blockstudio\Ui ομαδοποιεί τη βιβλιοθήκη που περιλαμβάνεται στο πακέτο σε μία δημόσια οικογένεια ανά στοιχείο, με ένα παράδειγμα για καθεμία.
  • Σταθερές διαστάσεις εικόνας: Το bs_media_image() αποδίδει στοιχεία θέματος με πραγματικές διαστάσεις από ένα δημιουργημένο assets/media.json.
  • Βοηθητικές συναρτήσεις κλάσεων Tailwind: Τα bs_tw_merge() και bs_tw_variants() συνθέτουν κλάσεις στο PHP με συγχώνευση που λαμβάνει υπόψη τις συγκρούσεις.
  • Προφίλ επιδόσεων: Το performance.profile ενεργοποιεί μονομιάς τις προεπιλογές του frontend παραγωγής· οι τιμές των θυγατρικών ρυθμίσεων υπερισχύουν.
  • Πρόσβαση σε τυποποιημένες ρυθμίσεις: Το Settings::get_bool() και τα αντίστοιχά του διαβάζουν blockstudio.json με πραγματικούς τύπους και εμφανίζουν σφάλματα ανάλυσης.
  • Ένας κατάλογος προσωρινής μνήμης: Κάθε δημιουργημένο αρχείο βρίσκεται κάτω από το cache.path, με κλειδί μια ταυτότητα χρόνου εκτέλεσης.
  • Στατική προ-απόδοση: Ανώνυμα έγγραφα HTML μπορούν να αποθηκευτούν στην προσωρινή μνήμη, να ακυρωθούν μέσω ενός γράφου εξαρτήσεων και να προβληθούν πριν από την εκκίνηση του WordPress.
  • Προεπιλογές ανάλυσης: Τα theme, extreme-theme και wordpress-render επεκτείνουν το blockstudio/phpstan πέρα από τα πρότυπα block.
  • Διαχειριζόμενο άγκιστρο commit: Το blockstudio-githooks sync δημιουργεί και διαχειρίζεται ένα άγκιστρο pre-commit που εκτελεί την επιλεγμένη προεπιλογή.
  • Σύμβαση έργου: Το blockstudio-agents δημιουργεί ένα AGENTS.md που περιγράφει τι δημιουργεί το έργο, ποιες δυνατότητες ενεργοποιεί και τι επιβάλλει η προεπιλογή του.
  • Ευρετήριο τεκμηρίωσης: Το αρχείο περιβάλλοντος AI είναι πλέον ευρετήριο κάθε εγγράφου, του σκοπού του και των αναγνωριστικών που του ανήκουν.
  • Κανονικές ετικέτες block: Μια αυτόνομη εντολή ξαναγράφει συντομογραφίες προθεμάτων και ψευδωνύμων ως <bs:namespace-slug>, με δυνατότητα δοκιμαστικής εκτέλεσης.
  • Συμβατότητα από προεπιλογή: Τίποτα από τα παραπάνω δεν αλλάζει έναν ιστότοπο μέχρι να κατονομαστεί στο blockstudio.json.

Ανάγνωση και απόδοση ενός έργου

Απογραφή έργου

Το Canvas::inventory() επιστρέφει όλα όσα καταχωρίζει ένα έργο σε έναν απλό πίνακα, χωρίς να αποδώσει τίποτα.

PHP
use Blockstudio\Canvas;

$result = Canvas::inventory();

foreach ($result['inventory']['blocks'] as $block) {
    echo $block['name'] . "\n";
}

Οι εγγραφές ομαδοποιούνται ανά τύπο: pages, blocks, patterns, templates, parts και ui. Το order είναι η σταθερή σειρά εμφάνισης σε όλους τους τύπους, το sources αντιστοιχίζει κάθε εγγραφή στις διαδρομές προέλευσής της και τα warnings και errors συγκεντρώνουν προβλήματα ως δομημένες καταχωρίσεις.

Οι εγγραφές block περιλαμβάνουν τα id, name, title, source, path, provenance και ένα declaration έτοιμο για απόδοση. Οι εγγραφές σελίδων διατηρούν το source ως σταθερή ταυτότητα και το path ως το πρότυπο που αποδίδει.

Στοχευμένη επιλογή

Η ονομασία εγγραφών περιορίζει την εργασία, αντί να γίνεται φιλτράρισμα εκ των υστέρων.

PHP
$changed = Canvas::inventory([
    'blocks' => ['mytheme/hero'],
    'pages' => ['about'],
]);

Αυτό επιστρέφει ένα block και μία σελίδα. Τα patterns, templates, parts και ui επιστρέφουν κενά και οι πηγές τους δεν διαβάζονται, συγχρονίζονται, αποδίδονται ή μεταγλωττίζονται ποτέ.

Οι κανόνες είναι ακριβείς:

  • Χωρίς καθόλου κλειδιά τύπων, φορτώνονται όλοι οι τύποι.
  • Τα true, null ή "*" φορτώνουν όλες τις εγγραφές αυτού του τύπου.
  • Μια συμβολοσειρά ή λίστα αντιστοιχίζεται ακριβώς σε ID, όνομα, slug, διαδρομή ή διαδρομή πηγής.
  • Μια κενή συμβολοσειρά, μια κενή λίστα ή το false δεν φορτώνουν καμία εγγραφή αυτού του τύπου.
  • Μόλις υπάρχει οποιοδήποτε κλειδί τύπου, οι τύποι που παραλείπονται παραμένουν ανέγγιχτοι.

Αναγνωριστικά που δεν υπάρχουν πλέον επιστρέφονται κάτω από το deleted αντί να προκαλείται αποτυχία, και το τελικό σημείο ανανέωσης REST του Canvas εφαρμόζει τον ίδιο κανόνα στις παραμέτρους blocks και pages του.

Το Canvas::documents() δέχεται την ίδια επιλογή και προσθέτει ένα αποδοσμένο έγγραφο ανά εγγραφή. Οι επιλεγμένες σελίδες αποδίδονται σε αποκατεστημένο περιβάλλον frontend, ώστε οι συνθήκες ερωτημάτων, οι κλάσεις body, τα shortcodes, οι διατάξεις, οι ανακατευθύνσεις και οι συναρτήσεις enqueue να βλέπουν εκείνη τη σελίδα και όχι το αίτημα που ζήτησε την απόδοσή της.

Αυτόνομη απόδοση

Το Blockstudio\Render επιστρέφει αποδοσμένο HTML ως συμβολοσειρά, μέσω της ίδιας διαδικασίας που χρησιμοποιεί το frontend.

PHP
use Blockstudio\Render;

$html = Render::composition([
    'root' => 'mytheme/card',
    'data' => ['heading' => 'Example card'],
    'layers' => [
        ['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
    ],
]);

Υπάρχει από κάτω ένα σχήμα δήλωσης με τέσσερα κλειδιά: name, attributes, content και children. Τα root, data, inner, innerBlocks, layers και example είναι διευκολύνσεις εισόδου που το Render::normalize() ενσωματώνει σε αυτό. Τα παιδιά αποδίδονται αναδρομικά και η κακοσχηματισμένη είσοδος προκαλεί εξαίρεση που κατονομάζει το προβληματικό block.

Το Render::document() περιβάλλει την έξοδο με ένα πλήρες αυτόνομο έγγραφο HTML.

PHP
$document = Render::document('mytheme/hero', [
    'title' => 'Hero preview',
]);

echo $document['html'];

Το body είναι μόνο η έξοδος του block, το html το συναρμολογημένο έγγραφο, το blocks τα ονόματα των block που συνέβαλαν και το assets χωρίζει τη σήμανση σε head, footer, styles, scripts, modules, interactivity, ui και tailwind. Τα στοιχεία περιορίζονται σε όσα αποδόθηκαν, επομένως δεν εμφανίζονται ποτέ στοιχεία που αφορούν μόνο τον επεξεργαστή.

Το Render::document_from_html() περιβάλλει το HTML που αποδόθηκε αλλού, ενώ το Render::content() αποδίδει σειριοποιημένο περιεχόμενο block χωρίς έγγραφο. Καλέστε το Blockstudio\Batch_Render::reset() ανάμεσα σε έγγραφα μέσα στην ίδια διεργασία PHP· το Canvas::documents() το κάνει ήδη.

Οικογένειες στοιχείων UI

Το Blockstudio\Ui εκθέτει τη βιβλιοθήκη UI που περιλαμβάνεται στο πακέτο ως μία καταχώριση ανά δημόσιο στοιχείο αντί για λίστα εσωτερικών μερών.

Το Ui::inventory() επιστρέφει μία καταχώριση ανά οικογένεια, μαζί με το block ρίζας, τον τίτλο και τα block υλοποίησης που χρειάζεται. Το Ui::examples() προσθέτει μια ντετερμινιστική δήλωση ανά οικογένεια: οι προεπιλογές διατηρούνται, τα απαιτούμενα θυγατρικά επίπεδα τοποθετούνται κάτω από τους γονείς τους και προστίθεται σταθερό ενδεικτικό κείμενο όπου ένα πεδίο θα ήταν κενό. Αυτή η δήλωση είναι κανονική, επομένως περνά απευθείας στο Render::document().

Το Canvas ομαδοποιεί με τον ίδιο τρόπο. Τα UI που περιλαμβάνονται στο πακέτο εμφανίζονται κάτω από τον τύπο ui ως ένα παράδειγμα ανά οικογένεια, ενώ οι καταχωρίσεις υλοποίησης δεν εμφανίζονται στο blocks.

Οι οικογένειες έχουν σχεδιαστεί για σύνθεση: ένα select ανοίγει μέσα σε διάλογο, με το listbox να επικαλύπτει το στοιχείο ενεργοποίησης, τα μενού και τα combobox αγκυρώνονται με σταθερές συντεταγμένες προβολής που παραμένουν σωστές κατά την κύλιση, τα modal στοιβάζονται και κλείνουν με ένα Escape κάθε φορά, και κάθε υποσέλιδο συνθέτει το ίδιο στοιχείο ελέγχου κλεισίματος με μια παραλλαγή. Το πώς λειτουργούν αυτές οι συνδέσεις και οι αμετάβλητες συνθήκες που τις διατηρούν, εξηγούνται στο κεφάλαιο σύνθεσης· το /ui/examples παρουσιάζει τις συνθέσεις σε λειτουργία.

Βοηθητικές συναρτήσεις προτύπων

Σταθερές διαστάσεις εικόνας

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

PHP
<?php
echo bs_media_image([
    'src' => 'assets/images/hero.webp',
    'alt' => 'Hero',
]);

Η έξοδος είναι ένα figure.blockstudio-media με ενσωματωμένο aspect-ratio γύρω από ένα img που φέρει πραγματικά width, height, loading και decoding. Οι διαστάσεις προέρχονται από ένα δημιουργημένο assets/media.json, το οποίο γράφεται από το Blockstudio\Media_Metadata_Builder σε βήμα της διαδικασίας δημιουργίας ή με μη αυτόματο τρόπο.

Το src δέχεται μια διαδρομή σχετική με το θέμα, μια απόλυτη διαδρομή ή ένα πλήρες URL, ενώ το attachmentId καλύπτει εικόνες της βιβλιοθήκης πολυμέσων. Το eager παραλείπει τη νωχελική φόρτωση πάνω από το πρώτο τμήμα της σελίδας και το sources εκπέμπει ένα <picture>.

Όταν είναι ενεργοποιημένο το performance.media.lazy, το πραγματικό URL μεταφέρεται στο data-src πίσω από ένα σωστά διαστασιολογημένο σύμβολο κράτησης θέσης.

Βοηθητικές συναρτήσεις κλάσεων Tailwind

Τα bs_tw_merge() και bs_tw_variants() συνθέτουν κλάσεις Tailwind σε πρότυπα PHP, χρησιμοποιώντας τη μηχανή Blockstudio που ήδη περιλαμβάνει το πακέτο.

Το bs_tw_merge('px-2 text-sm', 'px-4') επιστρέφει text-sm px-4: το αντικρουόμενο px-2 απορρίπτεται και υπερισχύει η μεταγενέστερη τιμή. Γίνονται δεκτοί ένθετοι πίνακες τιμών κλάσεων.

Το bs_tw_variants() επιστρέφει μια μικρή κλήσιμη συνάρτηση για παραλλαγές στοιχείων:

PHP
$button = bs_tw_variants([
    'base' => 'inline-flex items-center',
    'variants' => [
        'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
    ],
    'defaultVariants' => ['size' => 'sm'],
]);

echo $button(['size' => 'lg', 'class' => 'rounded']);

Αυτό εκτυπώνει inline-flex items-center h-12 px-6 rounded. Υποστηρίζονται βασικές κλάσεις, παραλλαγές, προεπιλεγμένες παραλλαγές, σύνθετες παραλλαγές και ένα class ή className ανά κλήση.

Ρυθμίσεις παραγωγής

Προφίλ επιδόσεων

Το performance.profile ενεργοποιεί τις προεπιλογές του frontend παραγωγής από ένα σημείο.

JSON
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

Το compat είναι η προεπιλογή και δεν αλλάζει τίποτα. Τα speed και strict ενεργοποιούν το ίδιο σύνολο: αφαιρούνται από την κεφαλή οι πληροφορίες δημιουργού, emoji, τροφοδοσιών, ανακάλυψης και γειτονικών αναρτήσεων· αφαιρούνται οι πληροφορίες ανακάλυψης oEmbed και τα σενάρια του διακομιστή· απενεργοποιούνται τα XML-RPC, τα pingback και η απομακρυσμένη ανακάλυψη επεξεργαστή· αφαιρούνται τα γενικά στοιχεία frontend του πυρήνα· εφαρμόζονται οι προεπιλογές εξόδου εικόνας· περιορίζεται ο ρυθμός του Heartbeat εκτός των επεξεργαστών· γίνεται προφόρτωση εγγράφων ίδιας προέλευσης κατά την πρόθεση αιώρησης ή εστίασης· και χρησιμοποιείται ο φορτωτής εικόνων του Blockstudio.

Κάθε θυγατρική τιμή υπερισχύει του προφίλ, όπως κάνει παραπάνω το preload.links. Η αφαίρεση των στοιχείων frontend του πυρήνα είναι η πρώτη που πρέπει να δοκιμαστεί, επειδή μια σελίδα που εξαρτάται από αυτά θα παρουσιάσει εμφανή προβλήματα. Το Runtime_Settings::current() εμφανίζει το προφίλ που προκύπτει.

Το themeDefaults καλύπτει δύο εργασίες που διαφορετικά θα έπρεπε να υλοποιούν τα θέματα: τα titleTag και suppressDirectoryUpdates, ώστε το ενεργό θυγατρικό και γονικό θέμα να αποκρύπτονται από τα αποτελέσματα ενημερώσεων.

Πρόσβαση σε τυποποιημένες ρυθμίσεις

Το Blockstudio\Settings διαβάζει τις ρυθμίσεις με πραγματικούς τύπους αντί να επιστρέφει ό,τι περιείχε το JSON.

PHP
use Blockstudio\Settings;

$lazy = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
$roles = Settings::get_array('users/roles');

foreach (Settings::errors() as $error) {
    error_log($error);
}

Η κακοσχηματισμένη τιμή JSON αναφέρεται μέσω του Settings::errors() αντί να καταλήγει σε προεπιλογές. Το Settings::get_raw() επιστρέφει μόνο όσα δήλωσε η ενεργή πηγή, διαχωρίζοντας έτσι μια τιμή που ορίστηκε ως false από μια τιμή που δεν ορίστηκε ποτέ.

Το Settings::fingerprint() επιστρέφει μια σταθερή ταυτότητα για τις ισχύουσες ρυθμίσεις, και η πρόσβαση επαναφορτώνει τα δεδομένα όταν αλλάζει το blockstudio.json.

Ένας κατάλογος προσωρινής μνήμης

Κάθε δημιουργημένο αρχείο βρίσκεται πλέον κάτω από το cache.path, με προεπιλεγμένη τιμή wp-content/blockstudio/cache.

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

Τα ωφέλιμα φορτία δημιουργίας, τα δεδομένα καταχώρισης block, τα στοιχεία επεξεργαστή, τα μεταγλωττισμένα Tailwind CSS, τα έγγραφα απόδοσης, τα τμήματα island, τα στατικά HTML, τα ευρετήρια γραφήματος, οι ουρές προθέρμανσης και τα διαγνωστικά βρίσκονται όλα κάτω από αυτή τη ρίζα. Μια σχετική διαδρομή επιλύεται με αφετηρία το WP_CONTENT_DIR, ενώ μια απόλυτη διαδρομή την κατευθύνει σε έναν αποκλειστικό τόμο.

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

Οι ψυχρές δημιουργίες εκτελούνται μία φορά ταυτόχρονα: ένα αίτημα δημιουργεί και δημοσιεύει ατομικά το αποτέλεσμα, ενώ τα υπόλοιπα περιμένουν. Αν μια ανανέωση αποτύχει, συνεχίζει να προβάλλεται το τελευταίο έγκυρο αντικείμενο, ενώ η αποτυχία παραμένει ορατή, και το Blockstudio\Runtime_Cache::purge('tailwind') εκκαθαρίζει ένα πεδίο εφαρμογής.

Στατική προ-απόδοση

Η στατική προ-απόδοση αποθηκεύει στην προσωρινή μνήμη πλήρη ανώνυμα έγγραφα HTML και μπορεί να τα προβάλλει πριν από την εκκίνηση του WordPress. Είναι απενεργοποιημένη από προεπιλογή.

JSON
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}

Προϋποθέσεις επιλεξιμότητας

Επιλέξιμα είναι μόνο πλήρη ανώνυμα έγγραφα HTML. Παρακάμπτονται τα αιτήματα που δεν είναι GET, οι συμβολοσειρές ερωτημάτων, η διαχείριση, το REST, το Ajax, το cron, οι τροφοδοσίες, η αναζήτηση, οι προεπισκοπήσεις, τα αιτήματα που περιέχουν nonce, τα εξατομικευμένα cookie και κάθε διαδρομή κάτω από το dynamicPaths. Μια απόκριση μπορεί να εξαιρεθεί πλήρως με έναν δείκτη <!-- blockstudio:no-cache -->.

Η αντιστοίχιση διαδρομών τηρεί τα όρια, επομένως το /account καλύπτει το /account/orders αλλά όχι το /accounting.

Λειτουργίες υπογραφής και γραφήματος

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

Η λειτουργία graph προορίζεται για ρητά εργαλεία δημιουργίας και ανάπτυξης. Καταγράφει τις εξαρτήσεις πηγής κάθε σελίδας, ώστε ένα σχέδιο να αναδημιουργεί μόνο τις επηρεαζόμενες διευθύνσεις URL.

PHP
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
    $result = render_with_dependencies($url);

    Static_Prerender_Runtime::persist_built_response(
        $url,
        $result['html'],
        $result['files'],
        $result['virtualHashes']
    );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));

Πρώιμη εξυπηρέτηση

Όταν ενεργοποιηθεί το earlyServe, το Blockstudio διαχειρίζεται έναν μικρό χάρτη διαδρομών ανά ιστότοπο και ένα drop-in advanced-cache.php που μεταδίδει μια επιλέξιμη επιτυχία πριν από την εκκίνηση του WordPress, των προσθέτων ή του θέματος.

Δεν αντικαθιστά ποτέ ξένο χάρτη, drop-in ή δήλωση WP_CACHE. Ένα τεχνούργημα γραφήματος επαληθεύει κάθε αναφερόμενο αρχείο HTML πριν από την εναλλαγή του χάρτη, ώστε μια ανάπτυξη που δεν ολοκληρώθηκε να αφήνει ενεργό το προηγούμενο γράφημα. Οι εγγραφές πολλών ιστότοπων παραμένουν απομονωμένες ανά κεντρικό υπολογιστή, διαδρομή αρχικής σελίδας και αναγνωριστικό ιστότοπου.

Προθέρμανση και κατάσταση

Τρεις εντολές WP-CLI καλύπτουν την καθημερινή χρήση:

Κέλυφος
wp bs prerender warm
wp bs prerender status
wp bs prerender purge

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

Ανάλυση και εργαλεία agent

Προεπιλογές ανάλυσης

Το blockstudio/phpstan προσθέτει τρία επίπεδα πάνω από την ανάλυση block, καθώς και μία εντολή που εκτελεί το επίπεδο που επέλεξε το έργο.

Προεπιλογή Τι προσθέτει
base Την υπάρχουσα ανάλυση σχήματος, προτύπων, hook, ρυθμίσεων και API.
theme Ρίζες θέματος, κεφαλίδες στυλ, στοιχεία, περιορισμό εμβέλειας επιλογέων, προεπιλογές πεδίων και όρια επαναλήπτη.
extreme-theme PHPStan max, μη ασφαλές PHP, διαφυγή, Tailwind, JavaScript και ελέγχους Interactivity.
wordpress-render Ζωντανό probe απόδοσης που παρέχει ο καλών, επιπλέον του extreme-theme.

Οι προεπιλογές προέρχονται από το blockstudio.json, ώστε οι διαδραστικές εκτελέσεις, το CI και τα hook commit να μοιράζονται μία διαμόρφωση:

JSON
{
  "phpstan": {
    "preset": "theme",
    "roots": ["."],
    "excludePaths": ["fixtures/**"],
    "maxFiles": 10000
  }
}
Κέλυφος
vendor/bin/blockstudio-phpstan --root . -- --no-progress

Οι κωδικοί εξόδου είναι 0 σε επιτυχία, 1 για διαγνωστικά και 2 για μη έγκυρη χρήση. Το περίβλημα συνθέτει τη διαμόρφωσή του στον προσωρινό κατάλογο του συστήματος, ώστε να μη δημιουργείται διαμόρφωση, γραμμή βάσης ή προσωρινή μνήμη στο έργο, και αυξάνει το όριο μνήμης του PHPStan σε 1G.

Περιλαμβάνει επίσης έναν πάροχο BC Math, ώστε οι έλεγχοι JavaScript να μη χρειάζονται πλέον το ext-bcmath.

Διαχειριζόμενο άγκιστρο commit

Μία ρύθμιση και μία εντολή μετατρέπουν την επιλεγμένη προεπιλογή σε πύλη ελέγχου commit.

JSON
{
  "githooks": {
    "commit": true
  }
}
Κέλυφος
vendor/bin/blockstudio-githooks sync

Ο συγχρονισμός δημιουργεί το hook και μια εγγραφή ιδιοκτησίας στον κοινό κατάλογο του Git, κατευθύνει το core.hooksPath στον διαχειριζόμενο κατάλογο και συνδέει οποιοδήποτε pre-commit hook είχε ρυθμιστεί προηγουμένως. Το hook εντοπίζει το αποθετήριο και τη ρίζα του έργου κατά τη στιγμή του commit, ώστε να λειτουργούν οι συνδεδεμένες αναπτύξεις και οι διαδρομές που περιέχουν κενά.

Το hook εκτελεί μόνο το vendor/bin/blockstudio-phpstan· δεν μορφοποιεί ούτε ξαναγράφει ποτέ αρχεία. Αν ορίσετε το commit σε false και συγχρονίσετε ξανά ή εκτελέσετε το blockstudio-githooks remove, επαναφέρεται η καταγεγραμμένη διαδρομή του hook και διαγράφονται μόνο τα αρχεία που ανήκουν στο Blockstudio.

Σύμβαση έργου

Το blockstudio-agents δημιουργεί ένα AGENTS.md που δηλώνει πού βρίσκονται τα blocks, τι θεωρείται σελίδα σε αυτό το έργο, ποιες δυνατότητες είναι ενεργοποιημένες και τι θα απορρίψει ο αναλυτής.

Κέλυφος
vendor/bin/blockstudio-agents

Το έγγραφο προκύπτει από τα δεδομένα και δεν βασίζεται σε πρότυπο. Ένα θέμα με κεφαλίδα style.css, blocks και σελίδες που βασίζονται σε αρχεία αποκτά διαφορετική σύμβαση από ένα πρόσθετο που καταχωρίζει μόνο blocks, συμπεριλαμβάνοντας τα πλήθη, τους καταλόγους, τους χώρους ονομάτων και τις γλώσσες προτύπων που εντόπισε ο σαρωτής. Το blockstudio.json καθορίζει ποιες δυνατότητες εμφανίζονται, οπότε ένα έργο χωρίς στατική προ-απόδοση δεν θα τη δει να αναφέρεται.

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

Η ιδιοκτησία λειτουργεί όπως και για το hook commit. Αν ένα αρχείο δεν έχει τον δείκτη δημιουργίας, η αντικατάστασή του απορρίπτεται, εκτός αν το --force ορίζει διαφορετικά. Μια περιοχή σημειώσεων στο τέλος διατηρείται κατά την αναδημιουργία, το --check τερματίζει με 1 όταν η σύμβαση είναι παρωχημένη και το --stdout την εκτυπώνει χωρίς να αγγίξει το σύστημα αρχείων.

Ευρετήριο τεκμηρίωσης

Το blockstudio-llm.txt είναι πλέον ευρετήριο αντί για συνένωση. Κάθε δημοσιευμένο έγγραφο εμφανίζεται μία φορά, στην ενότητα και υποενότητά του, μαζί με τη διαδρομή του, το αρχείο προέλευσής του, μια σύντομη περιγραφή του σκοπού του και τα αναγνωριστικά που του ανήκουν: διαδρομές ρυθμίσεων, ονόματα hook, συναρτήσεις και κλάσεις PHP, καθώς και εντολές.

Text
## Docs / Dev / Inspection Tools

### Canvas
route: /docs/dev/canvas
file: docs/docs/dev/canvas.md
purpose: A visual workspace and public inventory API for Blockstudio content.
settings: dev/canvas/enabled, ui
hooks: blockstudio/settings/dev/canvas/admin_bar, blockstudio/settings/dev/canvas/enabled
php: Blockstudio\Canvas, Canvas::documents(), Canvas::inventory()

Ένας agent διαβάζει το ευρετήριο, εντοπίζει το μοναδικό έγγραφο που περιέχει το αναγνωριστικό που τον ενδιαφέρει και ανοίγει αυτό το έγγραφο. Η προηγούμενη συνένωση του μισού megabyte εξακολουθεί να δημιουργείται και να δημοσιεύεται στο /blockstudio-llm-full.txt· απλώς δεν είναι πλέον το πρώτο πράγμα που δίνεται σε κανέναν.

Κανονικές ετικέτες block

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

Με πρόθεμα brand για το theme-components και πρόθεμα ui για το bsui, αυτή η συντομογραφία:

HTML
<brand-card>
  <ui-input />
</brand-card>

σημαίνει το ίδιο με:

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

Τα προθέματα και τα ακριβή ψευδώνυμα εξακολουθούν να λειτουργούν και δεν έχουν καταργηθεί. Η εντολή δεν φορτώνει το WordPress και δεν γράφει τίποτα χωρίς το --apply:

Κέλυφος
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
  --root="$PWD" \
  --prefix-map=/tmp/prefixes.json \
  --known-blocks=/tmp/blocks.json \
  --report=/tmp/tag-migration.json \
  --dry-run

Το --prefix-map αντιστοιχίζει κάθε πρόθεμα στους χώρους ονομάτων του και το --known-blocks παραθέτει τα καταχωρισμένα ονόματα block. Η αναφορά καταγράφει αντιστοιχίσεις από παλαιές σε κανονικές ονομασίες, μετρήσεις εμφανίσεων, hash ανά αρχείο και ξεχωριστές λίστες για άγνωστες ετικέτες, αμφίσημα ψευδώνυμα και δυναμικές ετικέτες. Το --apply αρνείται να γράψει όσο υπάρχουν τέτοιες περιπτώσεις, εκτός αν δοθεί το --allow-unresolved.

Υποστηρίζονται ζευγαρωμένα, ένθετα και αυτοκλειόμενα στοιχεία σήμανσης, καθώς και κυριολεκτικές ετικέτες σε συμβολοσειρές PHP. Αλλάζουν μόνο τα ονόματα των ετικετών, μια δεύτερη εκτέλεση δεν επιφέρει αλλαγές και τα παραδείγματα μέσα σε σχόλια, μπλοκ κώδικα, <pre> ή <code> εμφανίζονται μόνο στην αναφορά.

Προεπιλεγμένη συμπεριφορά

Η εγκατάσταση της έκδοσης 7.6 δεν αλλάζει τίποτα από μόνη της.

Το προφίλ επιδόσεων είναι από προεπιλογή compat. Η έξοδος της κεφαλίδας, το oEmbed, τα XML-RPC, το Heartbeat, οι προεπιλογές εικόνων, η προφόρτωση συνδέσμων, η lazy loading και το <title> του frontend παραμένουν όπως τα άφησαν το WordPress και το θέμα.

Αυτά παραμένουν απενεργοποιημένα μέχρι να ενεργοποιηθούν: κάθε κλειδί performance.staticPrerender, performance.measurement, performance.media και themeDefaults, καθώς και τα githooks.commit, dev.canvas.enabled, ui.enabled, tailwind.enabled και blockTags.enabled. Όσο είναι απενεργοποιημένη η στατική προαπόδοση, δεν δημιουργεί αρχεία ούτε εγκαθιστά drop-in.

Τα Canvas και Render είναι παθητικά. Διαβάζουν τα υπάρχοντα μητρώα και αποδίδουν μόνο ό,τι ζητά ο καλών· κανένα από τα δύο δεν συνδέεται με την έξοδο του frontend ούτε καταχωρίζει διαδρομές. Η οθόνη διαχείρισης Canvas εξακολουθεί να απαιτεί τα dev.canvas.enabled και edit_posts.

Για αυστηρότερη ανάλυση, πρέπει να την ονομάσετε. Η εγκατάσταση του blockstudio/phpstan ενεργοποιεί μόνο τη βασική επέκταση και η κανονική εντολή εκτελεί το base, εκτός αν το έργο ορίσει ένα preset.

Για να δημιουργηθούν τα αρχεία, πρέπει να εκτελέσετε την αντίστοιχη εντολή. Το githooks.commit δεν κάνει τίποτα μέχρι να εκτελεστεί το blockstudio-githooks sync, ενώ το AGENTS.md δεν κάνει τίποτα μέχρι να εκτελεστεί το blockstudio-agents.

Αναβάθμιση από την έκδοση 7.5

Οι απαιτήσεις παραμένουν ίδιες: PHP 8.2 ή νεότερη έκδοση, WordPress 6.7 ή νεότερη έκδοση.

Κέλυφος
composer require blockstudio/blockstudio

Οι κρυφές μνήμες αναδημιουργούνται μία φορά. Η ταυτότητα χρόνου εκτέλεσης περιλαμβάνει την έκδοση Blockstudio, επομένως το πρώτο αίτημα μετά την αναβάθμιση ξεκινά χωρίς προσωρινά δεδομένα και τα παλιά αντικείμενα εκκαθαρίζονται. Η παλιά κρυφή μνήμη Tailwind στο wp-content/uploads/blockstudio/tailwind/cache μπορεί να διαγραφεί· ένα απόσπασμα κώδικα που χρησιμοποιούσε glob σε αυτήν θα πρέπει να καλεί το Blockstudio\Runtime_Cache::purge('tailwind').

Ο επίπεδος κατάλογος wp-content/blockstudio/cache/runtime πριν από την έκδοση 7.6 μετονομάζεται αυτόματα και απομακρύνεται από την ενεργή διαδρομή, ενώ διαγράφεται σταδιακά με πεπερασμένα περάσματα WP-Cron. Έτσι, δεν χρειάζεται να διαγραφούν μεγάλα δέντρα παλαιών αρχείων κλειδώματος κατά τη διάρκεια ενός αιτήματος ανάπτυξης.

Τα αρχεία που δημιουργούνται έχουν συγκεκριμένη θέση. Το assets/media.json ανήκει στον έλεγχο εκδόσεων ή σε ένα βήμα δημιουργίας. Ο χάρτης διαδρομών, το drop-in advanced-cache.php και η δήλωση WP_CACHE υπάρχουν μόνο όσο είναι ενεργοποιημένο το earlyServe, ενώ το άγκιστρο pre-commit μόνο όσο είναι συγχρονισμένο. Όλα τα υπόλοιπα αρχεία που δημιουργούνται βρίσκονται κάτω από το cache.path και μπορούν να διαγραφούν με ασφάλεια.

Δεν αφαιρέθηκε ούτε μετονομάστηκε τίποτα. Τα bs_render_block(), bs_block(), Blockstudio\Pages και Blockstudio\Patterns παραμένουν οι κανονικές επιφάνειες περιεχομένου που βασίζονται σε αρχεία.

Η επαναφορά γίνεται ανά λειτουργία. Τα performance.profile πίσω στο compat, τα staticPrerender.enabled στο false, τα githooks.commit στο false μαζί με ένα sync και τα cache.enabled στο false αναιρούν το καθένα ένα επίπεδο.

Μια εύλογη σειρά υιοθέτησης:

  1. Ορίστε το performance.profile σε speed και, στη συνέχεια, ελέγξτε την έξοδο της κεφαλίδας, τις ροές και τυχόν πρόσθετα που βασίζονται στο oEmbed ή στο XML-RPC.
  2. Δημιουργήστε το assets/media.json, μεταφέρετε τα πρότυπα στο bs_media_image() και έπειτα ενεργοποιήστε το performance.media.lazy.
  3. Ενεργοποιήστε το performance.staticPrerender με απενεργοποιημένο το earlyServe, επαληθεύστε τις επιτυχείς αντιστοιχίσεις με το wp bs prerender status και έπειτα ενεργοποιήστε το earlyServe.
  4. Εκτελέστε το blockstudio-phpstan --preset theme μέχρι να μην εμφανίζει προβλήματα, πριν βάλετε οποιοδήποτε preset πίσω από το githooks.commit.

Πού θα βρείτε τις λεπτομέρειες