Dennis · 14 ottobre 2026
Blockstudio 7.7
Blockstudio 7.7 aggiunge route virtuali per documenti senza un post WordPress, migliora le build di pre-generazione mirate e rende più affidabili la modifica e il rendering dei blocchi esistenti. Inoltre amplia i controlli dei tag dei blocchi di PHPStan e migliora l’accessibilità dei componenti UI inclusi.
Il flusso di lavoro basato sui file resta invariato. I blocchi vengono renderizzati dai rispettivi template e le pagine basate su file vengono modificate tramite una sincronizzazione esplicita CLI o API. Questa release non introduce la sincronizzazione automatica delle pagine durante le richieste dei visitatori o di amministrazione.
In breve:
- Route virtuali: servite una galleria di componenti, un catalogo o un altro documento completo senza creare un post né scrivere un gestore di reindirizzamento personalizzato.
- Build di pre-generazione mirate: le build HTTP registrano i file sorgente usati da ogni pagina, così una build successiva può renderizzare solo le route interessate.
- Conservazione della cache: mantenete disponibili i fogli di stile ritirati per le pagine in cache e ispezionate o ripulite le voci inutilizzate della mappa per la distribuzione anticipata.
- Affidabilità dell’editor: i blocchi selezionati insieme mantengono i propri valori; annulla e ripristina funzionano per RichText e i campi della barra laterale, e il contesto ereditato resta associato al blocco corretto.
- Fedeltà dei contenuti su file: elenchi annidati, elementi di sezione, HTML inline, shortcode e attributi con escape vengono preservati durante l’analisi e il rendering.
- Miglioramenti di PHPStan: tag con prefisso, alias, elementi di pagina mappati e variabili dei template vengono verificati rispetto alle definizioni del progetto.
- UI accessibile: i controlli espongono correttamente il proprio stato, le etichette attivano l’input corretto e i componenti di elenchi e tabelle usano una struttura HTML valida.
- Traduzioni: le traduzioni JavaScript installate vengono caricate nell’editor e nella panoramica di amministrazione, compresi i controlli dei campi che prima non erano tradotti.
Route virtuali
Alcune pagine derivano dai dati anziché da un post gestito dall’editor. Per esempio, un riferimento ai componenti potrebbe richiedere un proprio URL e titolo del documento, ma nessuna voce in wp_posts.
Registrate il documento con Blockstudio\Virtual_Routes:
add_action('init', function () {
Blockstudio\Virtual_Routes::register(
'components',
function () {
get_header();
echo bs_block([
'name' => 'mytheme/card',
'data' => ['heading' => 'Example card'],
]);
get_footer();
},
['title' => 'Component gallery']
);
});
La route serve /components/. Il relativo callback viene eseguito nel buffer di output di Blockstudio, perciò i blocchi renderizzati ricevono gli stili, gli script e gli asset UI inclusi, oltre all’output di Tailwind, tramite la normale pipeline. WordPress non trasforma la route corrispondente in un 404 né la reindirizza a un post.
Per una famiglia di URL, impostate prefix su true e fornite un callback match. Il callback riceve il percorso sotto la route e restituisce il valore richiesto dal renderer. Restituendo null o false, la richiesta viene lasciata a WordPress. Usate urls per elencare i percorsi che una build di pre-generazione statica deve includere. Per impostazione predefinita viene incluso il percorso di una singola route che non è un prefisso.
Virtual_Routes::urls() restituisce URL assoluti per le integrazioni che generano una sitemap. Non aggiunge automaticamente i documenti virtuali alla sitemap dei post di WordPress.
Consultate Route virtuali per la documentazione completa API e le opzioni.
Build di pre-generazione più precise
Le build in modalità grafo eseguite su HTTP ora registrano i file usati da ogni route: il template WordPress, i template e gli asset dei blocchi renderizzati, le definizioni e i layout delle pagine su file e le dipendenze aggiunte tramite blockstudio/render/dependencies.
Nella build successiva, build_plan() confronta queste dipendenze. La modifica di un template di blocco contrassegna le route dipendenti per il rendering, senza ricostruire tutte le pagine non correlate. Le modifiche alla configurazione condivisa continuano a incidere sull’intera build, mentre le route nuove o scadute vengono renderizzate come prima.
Le modifiche limitate al database non sono dipendenze da file. Se un deployment deve acquisire un’opzione, un post o un altro valore del database, occorre forzare una build o renderizzare esplicitamente gli URL interessati.
La release corregge anche le identità di build che cambiavano durante il primo rendering, le mappe obsolete per la distribuzione anticipata memorizzate nella cache degli opcode e gli URL validi esclusi solo perché il percorso contiene search o preview. Le richieste Markdown che usano Accept: text/markdown bypassano HTML memorizzata nella cache e le risposte pertinenti inviano Vary: Accept.
La pre-generazione statica ora rispetta i filtri registrati dal tema attivo quando decide se collegare i propri hook. Un tema può disattivare la funzionalità senza che una precedente consultazione delle impostazioni la lasci attiva.
Consultate Pre-generazione statica.
Conservazione e manutenzione della cache
Una pagina HTML memorizzata nella cache può rimanere disponibile oltre l’identità di runtime che ne ha compilato il foglio di stile. cache.namespaceGrace determina per quanto tempo i namespace ritirati restano disponibili da quando la pulizia ne rileva per la prima volta il ritiro:
{
"cache": {
"namespaceGrace": 777600
}
}
Questo esempio conserva i file ritirati per nove giorni. Il valore predefinito è un giorno. I namespace attivi e quelli che servono artefatti di pre-generazione distribuiti sono protetti dalla pulizia dei ritiri.
La mappa per la distribuzione anticipata include anche comandi di ispezione e pulizia:
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
Segnalano e rimuovono le voci relative a siti eliminati o directory mancanti. L’eliminazione di un sito multisito rimuove anche le relative voci. I documenti route mancanti vengono segnalati separatamente, senza causare la rimozione dell’intera voce di un sito valido.
Consultate Caching per le indicazioni sulla conservazione e manutenzione della mappa per i comandi.
Un editor più affidabile
La modifica di un blocco selezionato insieme ad altri ora aggiorna solo quel blocco. Al salvataggio ogni blocco conserva i propri contenuti, chiavi, metadati e blocchi, senza copiare gli attributi tra i blocchi selezionati.
I valori RichText risiedono direttamente negli attributi del blocco, quindi Gutenberg può includerli nelle operazioni di annullamento e ripristino. I campi della barra laterale partecipano alla stessa cronologia. InnerBlocks templateLock="false" viene passato come valore booleano effettivo e sblocca i contenuti anche quando un’area esterna è bloccata.
I pre-caricamenti iniziali ricevono l’ID e il tipo del post modificato, così i template possono leggere i metadati corretti al primo rendering. Blocchi figli identici sotto genitori diversi mantengono contesti ereditati distinti nei pre-caricamenti e nelle cache di rendering. Le modifiche agli attributi o al contesto durante una richiesta iniziale non lasciano più indietro l’anteprima.
Blockstudio inoltre smette di inserire elementi nascosti di marcatura del rendering tra le radici dei blocchi. I selettori di fratelli adiacenti, come .card + .card, ora rilevano le stesse relazioni tra elementi nell’editor e nel frontend, mentre le anteprime di rendering dell’editor e dell’inseritore restano separate.
Archiviazione più sicura delle opzioni a livello di sito
I campi basati su opzioni continuano a fornire valori a livello di sito, ma il salvataggio di un post non scrive più alla cieca ogni copia salvata di tali campi:
- I salvataggi di bozze, elementi in attesa, privati e programmati non scrivono opzioni del sito attive.
- I post pubblicati salvano i campi forniti che sono stati modificati in quella sessione di modifica.
- Il salvataggio del solo titolo di una vecchia copia non ripristina un valore del sito più recente.
- I campi mancanti e i blocchi rimossi non eliminano le opzioni esistenti.
- Un
nullesplicito rimuove un’opzione. Le stringhe vuote,false, zero e gli array vuoti restano valori validi.
Questo è il principale cambiamento di comportamento da verificare durante l’aggiornamento. Se un’integrazione usava un post privato o una bozza per aggiornare un’opzione attiva, scrivete esplicitamente quell’opzione oppure usate un post di configurazione pubblicato. L’archiviazione nei metadati del post non è interessata dalla restrizione ai post pubblicati.
Consultate Archiviazione per tutte le regole di salvataggio.
I contenuti dei file restano intatti
La pipeline da HTML ai blocchi conserva una parte maggiore della struttura scritta:
- Gli elenchi annidati diventano blocchi elenco interni all’elemento genitore. Le classi di elenchi ed elementi vengono preservate; gli elenchi semplici mantengono il comportamento precedente.
main,header,footer,articleeasidediventano blocchi di gruppo che preservano il proprio elemento, anziché diventare HTML grezzo che evita il rendering dei blocchi.- I paragrafi richtext mappati mantengono il markup inline, i paragrafi contenenti solo immagini vengono risolti nel blocco immagine mappato e i tag shortcode conservano i propri contenuti.
- Gli attributi con escape vengono decodificati e sottoposti a escape una sola volta, compresi quelli su
InnerBlocks,RichTexte sull’elementouseBlockProps. - I segni maggiore all’interno degli attributi tra virgolette di tag autochiudenti vengono accettati.
- Gli attributi globali HTML raggiungono la radice di un blocco Blockstudio se quest’ultimo non li dichiara come campi.
wp bs pages syncsegnala gli attributi memorizzati che non vengono renderizzati.
Le pagine basate su Blade, i pattern e i template dell’Editor del sito ora vengono renderizzati tramite Blockstudio\Blade_Renderer, con supporto per le versioni da illuminate/view 8 a 12. Tutti i file di estensione destinati allo stesso blocco vengono registrati; la priorità, i campi dei gruppi e gli elenchi di destinazioni rispettano lo schema documentato.
Vengono tracciate anche le dipendenze SCSS annidate. Modificando una parte importata da un’altra parte, cambia la versione del foglio di stile dipendente e viene attivata la ricompilazione.
Miglioramenti di PHPStan
Il pacchetto blockstudio/phpstan installato separatamente amplia la convalida dei tag dei blocchi includendo tag con prefisso e alias, elementi di pagina mappati, layout, blocchi UI inclusi e, facoltativamente, altre sorgenti PHP del progetto. La risoluzione dei namespace corrisponde a quella del runtime, compresi i namespace con trattini, e vengono accettati gli attributi globali inoltrati HTML.
Le variabili dei template dei blocchi, come $a, $block e $context, sono considerate definite da Blockstudio. I tipi dei campi vengono mantenuti con il coalescimento dei valori nulli e con isset() in PHPStan 2.3, mentre un template che assegna un proprio $a mantiene il tipo assegnato.
Queste modifiche sono incluse in blockstudio/phpstan 0.1.9. Aggiornate il pacchetto separatamente dal plugin; richiede PHPStan 2.1.47 o versione successiva:
composer require --dev blockstudio/phpstan:^0.1.9
Consultate PHPStan per la configurazione e i preset di analisi.
Accessibilità e traduzioni
I controlli UI inclusi espongono il proprio stato di espansione sul pulsante effettivo. Le etichette di checkbox, interruttori e pulsanti di opzione identificano e attivano i relativi controlli. Breadcrumb, paginazione, menu di navigazione e tabelle non inseriscono più elementi contenitore non validi tra gli elenchi o le tabelle e i loro elementi figli.
I pulsanti per mostrare o nascondere la password ne espongono lo stato premuto e hanno un’area cliccabile più ampia. Gli input accettano autocomplete e gli input per le password accettano un ID esplicito e un’etichetta accessibile. Le finestre del carosello possono ricevere il focus da tastiera e le animazioni di indicatori di caricamento e scheletri rispettano le preferenze di movimento ridotto.
L’editor e la panoramica di amministrazione caricano le traduzioni JavaScript installate per il dominio di testo blockstudio. I menu degli attributi e i segnaposto, le azioni dei popup di codice e i badge di immagini e file ora possono essere tradotti. Le stringhe prive di traduzione restano in inglese.
Consultate la libreria UI e la configurazione delle traduzioni.
Documentazione e aggiornamento
La documentazione aggiunge guide per i siti di documentazione, Content Sync, i template del Site Editor, i tag dei blocchi, le isole, i tipi di campi personalizzati, la distribuzione, il prerendering, la configurazione del registro, gli strumenti di analisi e le schermate dell’app UI. La guida alla migrazione ACF riflette la registrazione corrente di ACF e i Block Bindings.
Gli esempi di popolamento personalizzato ora usano il filtro supportato con dataset denominato e un solo argomento. La documentazione degli asset spiega l’ordine dei fogli di stile frontend e come caricare gli override del tema dopo il blocco CSS. Le installazioni per i collaboratori usano il pacchetto pubblico Font Awesome senza credenziali del registro.
PHP 8.2 e WordPress 6.7 restano i requisiti minimi. Le route virtuali e i nuovi comandi di manutenzione sono disponibili senza modificare le raccolte di pagine esistenti. Consultate sopra le regole di salvataggio dello storage delle opzioni, aggiornate il pacchetto PHPStan separato se lo usate e continuate a eseguire esplicitamente la sincronizzazione delle pagine come prima.
7.7.1 Follow-up
La patch 7.7.1 rende gli esiti della sincronizzazione più chiari e sicuri. Un’unione basata su chiavi che lascia invariato un articolo non crea più una revisione né aggiorna la data di modifica. Gli stati di pubblicazione esistenti vengono mantenuti, le sostituzioni del titolo e dello slug gestiti dai file vengono segnalate e le pagine bloccate o rimosse vengono indicate nel report CLI. Content Sync contrassegna i contenuti gestiti da Page Sync e conserva le copie di revisione esistenti. La patch protegge inoltre gli attributi gestiti da WordPress dagli ID di campo in conflitto e mantiene le classi dell’editor aggiunte da altri filtri.