Vai al contenuto

Dennis · 7 febbraio 2026

Introducing Blockstudio 7

Blockstudio 7 è arrivato. È la release più importante nella storia del progetto: una riscrittura completa dell’intera codebase da zero. Ogni classe, ogni hook, ogni riga di codice è stata ricostruita da zero, con particolare attenzione agli standard moderni di PHP, agli standard di programmazione WordPress e alla manutenibilità a lungo termine.

Ma non si tratta solo di un refactoring. Blockstudio 7 introduce importanti nuove funzionalità, come pagine e pattern basati su file, un sistema di archiviazione dei metadati dei post, l’integrazione con SEO e un nuovissimo parser da HTML a blocchi che rende tutto possibile. Inoltre, Blockstudio ora è completamente gratuito e open source.

Vediamo tutte le novità.

Gratuito e open source

Lavoro a Blockstudio dal 2020 e negli anni ho pubblicato decine di release. Chi lo ha usato lo ha apprezzato, ma trovare un mercato adatto per un framework commerciale WordPress per blocchi è sempre stato difficile.

A cambiare le cose sono stati gli LLM. Gli assistenti di programmazione basati sull’IA sono ormai abbastanza bravi da scrivere codice per i blocchi, ma hanno bisogno di strutture pulite e basate su file. Il markup dei blocchi di WordPress è disordinato: commenti HTML serializzati con attributi JSON incorporati, mescolati alla struttura del DOM. È difficile da gestire per le persone e ancora di più per gli LLM.

L’approccio di Blockstudio basato prima sui file è sempre stato pensato per semplificare le cose: una block.json e un template PHP in una cartella. Niente voci nel database, niente React, nessuna fase di build. Con v7 questa filosofia si spinge ancora oltre. Il parser da HTML a blocchi consente di scrivere HTML semplice e convertirlo automaticamente in markup valido per i blocchi. Tutto resta nel filesystem. Le uniche scritture nel database sono le sincronizzazioni delle pagine richieste esplicitamente tramite PHP API o CLI, che si basano sui template dei file.

Rendere Blockstudio open source è il passo successivo naturale. Più gli LLM vengono addestrati sul codice di Blockstudio, meglio diventano nel generarlo. Una codebase aperta, documentazione aperta e un file di contesto IA predefinito contesto IA utilizzabile da qualsiasi strumento: è così che si crea l’ambiente migliore per lo sviluppo WordPress assistito dall’IA.

Il plugin completo è disponibile su GitHub per essere usato, copiato e migliorato da chiunque. Niente chiavi di licenza, paywall o funzionalità bloccate.

Nuove funzionalità

Pagine basate su file

È una delle novità più importanti della versione 7.0. Ora potete definire intere pagine WordPress come template di file che si sincronizzano con il database come contenuto nativo a blocchi quando avviate la sincronizzazione delle pagine API o CLI.

Create una cartella con un page.json e un file template:

JSON
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
PHP
<div class="about-page">
  <h1>About Us</h1>
  <p>Welcome to our site.</p>
</div>

Eseguite wp bs pages sync per fare in modo che Blockstudio analizzi il HTML trasformandolo in blocchi WordPress e crei o aggiorni la pagina nel database.

Unione dei blocchi tramite chiave

Quando si sincronizzano i template, le modifiche degli utenti verrebbero normalmente sovrascritte. L’attributo key risolve il problema preservando i contenuti degli utenti tra una sincronizzazione e l’altra:

HTML
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>

I blocchi con chiavi corrispondenti mantengono i contenuti modificati dagli utenti quando il template viene aggiornato. I blocchi senza chiavi vengono sostituiti completamente.

Associazione dei blocchi

In alternativa alle chiavi, potete usare i Block Bindings API integrati nel core di WordPress per collegare direttamente i blocchi ai metadati dei post. Non è una funzionalità di Blockstudio, ma una WordPress API nativa. Blockstudio si limita a passare l’attributo metadata al markup del blocco generato. I contenuti vengono salvati nei metadati anziché nel markup dei blocchi, quindi la sincronizzazione dei template non elimina mai le modifiche degli utenti. I dati sono anche interrogabili tramite WP_Query e disponibili attraverso REST API.

HTML
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>

Entrambi gli approcci si possono usare nello stesso template.

Controlli di modifica

Le pagine supportano blockEditingMode e templateLock per controllare cosa possono modificare gli utenti:

JSON
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}

Questa impostazione blocca la struttura della pagina, consentendo comunque agli utenti di modificare testo e contenuti multimediali. I singoli elementi possono sovrascrivere l’impostazione a livello di pagina con un attributo blockEditingMode nel template.

Associazione agli ID dei post

Usate postId per associare un template di pagina a un post WordPress esistente, evitando pagine duplicate e assicurando che il template aggiorni sempre il post corretto:

JSON
{
  "name": "home",
  "title": "Home",
  "postId": 2
}

Per tutti i dettagli, consultate la Documentazione delle pagine.

Pattern basati su file

Come per le pagine, ora potete definire i pattern dei blocchi come template di file. Scrivete il pattern in HTML e Blockstudio lo converte in markup per i blocchi e lo registra come pattern di blocchi nativo di WordPress. I pattern compaiono nell’inseritore di blocchi e gli utenti possono inserirli ovunque.

JSON
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
HTML
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>

A differenza delle pagine, i pattern non creano voci nel database. Vengono registrati in memoria a ogni caricamento della pagina. Consultate la Documentazione dei pattern.

Parser da HTML a blocchi

Le pagine e i pattern si basano sul nuovo parser HTML, che converte i template standard HTML in markup per i blocchi WordPress. Gestisce automaticamente i blocchi contenitore, come gruppi e colonne, e i blocchi foglia, come paragrafi e titoli. Il parser usa un’architettura di rendering basata su trait, facile da estendere per supportare altri tipi di blocco tramite il filtro blockstudio/parser/renderers:

PHP
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
    $renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
        $content = $parser->get_inner_html( $element );
        $html    = '<div class="acme-hero">' . $content . '</div>';

        return array(
            'blockName'    => 'acme/hero',
            'attrs'        => $attrs,
            'innerBlocks'  => array(),
            'innerHTML'    => $html,
            'innerContent' => array( $html ),
        );
    };

    return $renderers;
}, 10, 2 );

Una volta registrato, potete usare il blocco in qualsiasi template di pagina o pattern:

HTML
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>

Archiviazione

Ora i campi possono salvare i propri valori nei metadati dei post o nelle opzioni del sito, oltre che negli attributi dei blocchi. È una novità importante:

JSON
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}

Con i valori nei metadati dei post, potete:

  • Interrogare i post in base ai valori dei campi usando WP_Query e meta_query
  • Accedere ai dati dei campi tramite REST API per configurazioni headless
  • Condividere i dati con altri plugin, ad esempio gli strumenti SEO, e con i livelli di caching

Potete anche salvare i valori nella tabella delle opzioni per impostazioni globali valide per tutto il sito:

JSON
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}

Consultate la Documentazione dello storage per tutte le informazioni su API.

Campi personalizzati

Ora le definizioni dei campi riutilizzabili possono essere condivise tra più blocchi. Definite una volta un insieme di campi, poi richiamatelo da qualsiasi blocco. In questo modo evitate ripetizioni quando più blocchi condividono la stessa struttura dei campi.

Create un field.json nella directory di blockstudio:

JSON
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}

Poi richiamatelo da qualsiasi blocco usando il prefisso custom/:

JSON
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}

La proprietà idStructure aggiunge il prefisso a ogni ID di campo, quindi heading diventa hero_heading. Potete anche sovrascrivere le singole proprietà dei campi per ogni istanza con la chiave overrides.

Consultate la Documentazione dei campi personalizzati.

Tailwind CSS v4

Il supporto Tailwind è stato completamente ricostruito per v4. Invece di compilare lato client tramite CDN e salvare su disco al salvataggio del post, secondo l’approccio v6, Blockstudio 7 compila Tailwind lato server a ogni richiesta frontend tramite TailwindPHP. Niente Node.js, niente CLI, nessuna fase di build.

La compilazione usa una cache basata sui candidati: Blockstudio estrae tutti i nomi delle classi CSS dal HTML finale, li ordina e ne calcola l’hash insieme alla configurazione CSS, quindi cerca un file nella cache. Le stesse classi producono la stessa corrispondenza nella cache, anche quando cambia il contenuto HTML circostante, come nonce, timestamp e contenuto dinamico.

La configurazione usa la sintassi v4 di Tailwind, basata prima sul CSS. Definite temi personalizzati e classi di utilità direttamente nel vostro blockstudio.json o tramite il filtro blockstudio/tailwind/css:

PHP
add_filter('blockstudio/tailwind/css', function ($css) {
  return $css . '
    @theme {
      --color-brand: #4f46e5;
    }

    @layer utilities {
      .container-narrow {
        max-width: 48rem;
        margin-inline: auto;
      }
    }
  ';
});

Nell’editor dei blocchi, uno script CDN Tailwind incluso nel pacchetto offre un’anteprima in tempo reale mentre scrivete. Il tipo di campo classes fornisce il completamento automatico per tutte le utility Tailwind. Il frontend usa sempre il CSS compilato lato server, inserito come tag di stile inline prima di </head>.

Consultate la documentazione di Tailwind per la configurazione completa.

Interattività API

Blockstudio ora supporta la WordPress Interactivity API. Abilitatela nel vostro block.json:

JSON
{
  "blockstudio": {
    "interactivity": true
  }
}

Aggiungete le direttive data-wp-* al template:

PHP
<div useBlockProps
     data-wp-interactive="myBlock"
     data-wp-context='{ "isOpen": false }'>
  <button data-wp-on--click="actions.toggle"
          data-wp-bind--aria-expanded="context.isOpen">
    Toggle
  </button>
  <div data-wp-bind--hidden="!context.isOpen">
    This content is toggled by the button.
  </div>
</div>

E create un script.js con la logica del vostro store:

JavaScript
import { store, getContext } from '@wordpress/interactivity';

store('myBlock', {
  actions: {
    toggle: () => {
      const context = getContext();
      context.isOpen = !context.isOpen;
    },
  },
});

Blockstudio gestisce l’importmap, il caricamento dei moduli e l’elaborazione delle direttive sia nel frontend sia nell’editor dei blocchi. I blocchi che usano solo direttive dichiarative con data-wp-context, come data-wp-bind--hidden o data-wp-text, funzionano senza alcun JavaScript. È supportato anche lo stato lato server tramite wp_interactivity_state() nel frontend.

Consultate la Documentazione dell’interattività per la configurazione completa.

Analisi dei contenuti SEO

I blocchi Blockstudio sono dinamici, quindi per impostazione predefinita i plugin SEO non possono vedere il contenuto dei loro campi. Blockstudio 7 risolve il problema integrandosi automaticamente con Yoast SEO, Rank Math e SEOPress. I valori di testo dei campi text, textarea, richtext, wysiwyg e link, incluse le righe dei repeater annidati, vengono estratti e passati all’analisi dei contenuti di ogni plugin. I plugin SEO possono così analizzare correttamente il contenuto dei blocchi per valutarne la densità delle parole chiave, la leggibilità e altre metriche. Non è necessaria alcuna configurazione.

Righe predefinite dei repeater

Ora i campi repeater supportano la proprietà default con un array di righe precompilate. Quando si inserisce un blocco, il repeater viene popolato con le righe specificate e i relativi valori, sia nell’editor sia nel frontend:

JSON
{
  "id": "features",
  "type": "repeater",
  "label": "Features",
  "default": [
    { "title": "Fast", "icon": "bolt" },
    { "title": "Secure", "icon": "shield" }
  ],
  "attributes": [
    { "id": "title", "type": "text", "label": "Title" },
    { "id": "icon", "type": "text", "label": "Icon" }
  ]
}

La proprietà min funziona anche con i valori predefiniti a livello di campo: se un repeater ha min: 3 e i suoi campi interni hanno valori default, le righe generate automaticamente vengono precompilate con tali valori invece di restare vuote.

Miglioramenti e correzioni

  • min dei repeater con valori predefiniti dei campi: le righe minime generate automaticamente ora usano i valori predefiniti dei campi sia nel frontend sia nell’editor
  • Stili dell’editor Tailwind: Tailwind CSS compilato viene ora inserito nell’iframe dell’editor dei blocchi insieme a CDN, così le regole @apply personalizzate e la configurazione del tema funzionano nell’editor
  • File di contesto IA AI context file: blockstudio-llm.txt è stato ricostruito come file statico assemblato dalla documentazione completa v7 e dagli schemi JSON deduplicati (circa 48k token), al posto della generazione dinamica da v6
  • Finestra separata per i campi di codice: ora il campo di codice può essere aperto in una finestra separata, con annullamento/ripristino indipendenti ed evidenziazione della sintassi JavaScript
  • Compilazione lato server di Tailwind v4: consultate la sezione Tailwind sopra
  • Versione 3 di API: ora i blocchi vengono visualizzati correttamente nell’editor in iframe, incluso l’editor del sito e le anteprime responsive
  • Notazione con punto per gli asset: convenzione di denominazione più pulita per i suffissi degli asset (*.inline.css, *.editor.js, *.scoped.css)
  • Corretto un avviso bs_render_block() di WP_Block_Supports durante l’uso di useBlockProps
  • Corretto il mancato rispetto dei valori predefiniti al primo caricamento da parte dei campi condizionali
  • Corretta la rimozione dei simboli del dollaro dai contenuti <RichText /> nel frontend
  • Corretta la funzionalità populate per consentirne l’uso con tassonomie registrate da altri plugin
  • Corretto l’errore optionsPopulate null nei contesti WPML

Dietro le quinte

Riscrittura completa

Non è un refactoring né una ripulitura. Ogni classe è stata riscritta da zero. Il risultato è una codebase più pulita e modulare, più facile da mantenere ed estendere.

PHP moderno

Blockstudio 7 richiede PHP 8.2+ e usa dichiarazioni di tipo moderne in tutto il codice.

Modifiche incompatibili

Essendo un aggiornamento di versione principale, la 7.0 include diverse modifiche incompatibili. La maggior parte prevede alternative compatibili con le versioni precedenti, ma è consigliabile consultarle prima di aggiornare. Per una guida completa alla migrazione, consultate la documentazione di migrazione v7.

I nomi degli hook ora usano snake_case

Tutti gli hook PHP sono stati rinominati da camelCase a snake_case, in linea con le convenzioni del core WordPress:

PHP
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
    return ['my-stylesheet'];
});

// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
    return ['my-stylesheet'];
});

I vecchi nomi camelCase funzionano ancora, ma consigliamo di aggiornarli.

Il valore predefinito dell’interruttore del campo è disattivato

La proprietà switch ora è impostata su false per impostazione predefinita invece che su true. In v6, ogni campo aveva un interruttore invisibile sul bordo sinistro, attivo per impostazione predefinita. In v7, l’interruttore è facoltativo e usa un’icona a forma di occhio visibile nell’etichetta del campo. Se facevate affidamento sul comportamento predefinito dell’interruttore, aggiungete "switch": true alle definizioni dei campi.

I nomi dei file degli asset usano la notazione con punto

Ora i suffissi degli asset usano i punti invece dei trattini (style.inline.css invece di style-inline.css). La vecchia notazione con trattino continua a funzionare, ma da ora in poi si consiglia quella con il punto.

Prefisso di importazione npm

Ora le importazioni dei moduli ES usano npm: invece di blockstudio/:

JavaScript
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";

// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";

Il prefisso blockstudio/ è ancora supportato per garantire la compatibilità con le versioni precedenti.

Funzionalità rimosse

Area di amministrazione ed editor di codice. La pagina delle impostazioni di amministrazione WordPress e l’editor di codice integrato per i blocchi sono stati rimossi. Ora tutta la configurazione avviene tramite i filtri blockstudio.json e PHP, quindi la configurazione è sotto controllo di versione insieme ai blocchi.

L’editor di codice era utile nelle versioni precedenti per visualizzare l’anteprima dei blocchi, ma non ha mai raggiunto la parità con un vero ambiente di sviluppo. Negli anni diverse funzionalità del plugin sono rimaste in sospeso perché non era possibile supportarle nell’editor autonomo. Inoltre, non avrebbe mai potuto sostituire un IDE completo. Rimuoverlo consente al plugin di concentrarsi interamente sullo sviluppo basato su file, senza compromessi.

Chiave di licenza. Non è più necessaria. Blockstudio è gratuito e open source.

Libreria di blocchi. La libreria integrata “Blockstudio Elements” (Gallery, Slider, Image Comparison, Code, Icon) è stata rimossa. Si trattava di blocchi di esempio predefiniti forniti con il plugin. Se li usavate, copiate le cartelle dei blocchi da v6 alla directory blockstudio del vostro tema.

Per iniziare

Installate Blockstudio 7 e create il vostro primo blocco in pochi minuti. Consultate la Guida introduttiva per una procedura guidata passo per passo oppure la guida alla migrazione v7 se state aggiornando da v6.

Il codice sorgente completo è disponibile su GitHub. Sono benvenute segnalazioni di problemi, PR e feedback.