Blocchi personalizzati in 3 file
Niente JavaScript, niente fase di build, niente codice boilerplate.
Definire i campi in JSON
Aggiungete una chiave blockstudio a block.json. Definite gli attributi con tipi come text, toggle e color. Blockstudio genera automaticamente l’editor UI, con tipi di campo 27, dagli input di testo ai repeater e agli editor di codice, oltre ai tipi di campo che registrate voi.
Il supporto completo allo schema JSON offre completamento automatico e convalida in VS Code, PhpStorm e in tutti gli editor compatibili.
Ogni campo può impostare un default per i nuovi blocchi e un fallback che il template riceve quando il campo è vuoto.
{
"name": "starter/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "id": "showCta", "type": "toggle", "label": "Show CTA" },
{ "id": "background", "type": "color", "label": "Background" }
]
}
}Flusso di lavoro con 3 file
block.json per i campi, un template per il markup e un foglio di stile facoltativo.
React in PHP
RichText, InnerBlocks e useBlockProps funzionano direttamente in PHP, Twig o Blade.
SCSS e Tailwind
Usate CSS, SCSS o Tailwind. SCSS supporta percorsi di importazione e un preambolo condiviso; modificando una parte annidata, vengono ricompilati tutti i file che la importano.
27 tipi di campo
Testo, colore, immagine, ripetitore, selezione, editor di codice e altro, configurabili in JSON.
JSON Schema
Completamento automatico e convalida in VS Code, PhpStorm e negli editor compatibili.
Tre linguaggi per i template
PHP, Twig e Blade condividono le stesse variabili e gli stessi componenti.
Importazioni npm
Importa pacchetti in script.js; in produzione vengono caricati localmente e nell’editor tramite CDN.
Interactivity API
Attiva l’Interactivity API di WordPress con un solo flag.
Componenti React nei template PHP
Usa <RichText /> per la modifica inline e HTML del frontend statico, <InnerBlocks /> per i blocchi annidati e useBlockProps per il wrapper, tutto in un unico template.
Nell’editor diventano veri componenti React. Nel frontend vengono visualizzati come HTML lato server, senza inviare JavaScript ai visitatori.
<div useBlockProps class="container">
<RichText
class="text-xl font-semibold"
tag="h1"
attribute="headline"
placeholder="Enter headline"
/>
<?php if ($a['showCta']): ?>
<a href="<?= esc_url($a['ctaUrl']) ?>">
<?= esc_html($a['ctaLabel']) ?>
</a>
<?php endif; ?>
<InnerBlocks class="mt-4 p-4 border" />
</div>Scrivi in PHP, Twig o Blade
Usate il linguaggio dei template che conoscete. PHP funziona subito, Twig viene eseguito una volta installato Timber e Blade viene eseguito su illuminate/view da 8 a 12 tramite Blockstudio\Blade_Renderer. Variabili, componenti e comportamento restano invariati.
$a (attributi), $b (blocco), $c (contesto) e $innerBlocks sono disponibili in ogni linguaggio.
Anche i template Twig ricevono l’intero contesto Timber. Blade esegue anche il rendering di pagine, pattern e template dell’Editor del sito. Il vecchio wrapper jenssegers/blade non funziona con illuminate/view 10 e versioni successive, quindi usate invece Blade_Renderer.
<div useBlockProps class="card">
<RichText tag="h2" attribute="title" placeholder="Card title" />
{% if a.image %}
<img src="{{ a.image.url|esc_url }}"
alt="{{ a.image.alt|esc_attr }}" />
{% endif %}
<div class="card__body">{{ a.description|esc_html }}</div>
<InnerBlocks allowedBlocks='["core/button"]' />
</div><div useBlockProps class="card">
<RichText tag="h2" attribute="title" placeholder="Card title" />
@if ($a['description'])
<div class="card__body">{{ $a['description'] }}</div>
@endif
<InnerBlocks allowedBlocks='["core/button"]' />
</div>Logica condizionale e opzioni dinamiche
Mostra e nascondi i campi con operatori come ==, !=, includes, empty e confronti. Combina le condizioni con la logica OR.
Le opzioni possono dipendere da un altro campo. Inserite {attributes.post_type.value} negli argomenti di popolamento e l’elenco si ricarica quando cambia quel campo. Aggiungete fetch: true per cercare gli articoli mentre l’editor digita.
Condividete un unico elenco di opzioni tra i blocchi con type: custom e il filtro blockstudio/blocks/attributes/populate, e registrate le vostre condizioni globali, ad esempio una verifica dell’acquisto, tramite blockstudio/blocks/conditions.
{
"name": "starter/posts",
"title": "Posts",
"blockstudio": {
"attributes": [
{
"id": "post_type",
"type": "select",
"label": "Post type",
"options": [
{ "value": "page", "label": "Pages" },
{ "value": "post", "label": "Posts" }
]
},
{
"id": "selected_post",
"type": "select",
"label": "Post",
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "{attributes.post_type.value}" }
}
},
{
"id": "style",
"type": "select",
"label": "Style",
"populate": { "type": "custom", "custom": "cardStyles" },
"conditions": [[
{ "type": "purchasedProduct", "operator": "==", "value": "yes" }
]]
}
]
}
}add_filter('blockstudio/blocks/attributes/populate', function ($options) {
$options['cardStyles'] = [
['value' => 'light', 'label' => 'Light'],
['value' => 'dark', 'label' => 'Dark'],
];
return $options;
});
add_filter('blockstudio/blocks/conditions', function ($conditions) {
$conditions['purchasedProduct'] = user_has_purchased(123) ? 'yes' : 'no';
return $conditions;
});Repeater facili da gestire
Impostate min e max, avviate i nuovi blocchi con default righe e comprimete quelle esistenti con minimized. textMinimized assegna a una riga compressa l’etichetta di uno dei suoi campi, ad esempio un nome.
Le righe accettano tutti i tipi di campo tranne le schede, inclusi i repeater annidati. Una condizione all’interno di una riga controlla un campo esterno con "context": "main", mentre <RichText /> e <MediaPlaceholder /> modificano una singola riga quando il loro attribute punta a repeaterId[index].fieldId.
{
"name": "starter/team",
"title": "Team",
"blockstudio": {
"attributes": [
{
"id": "members",
"type": "repeater",
"label": "Team members",
"min": 1,
"max": 12,
"minimized": true,
"textMinimized": { "id": "name", "fallback": "Team member" },
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "bio", "type": "richtext", "label": "Bio" }
]
}
]
}
}<div useBlockProps class="team">
<?php foreach ($a['members'] as $index => $member): ?>
<article>
<h3><?= esc_html($member['name']) ?></h3>
<RichText
tag="p"
attribute="members[<?= $index ?>].bio"
placeholder="Short bio"
/>
</article>
<?php endforeach; ?>
</div>Set di campi riutilizzabili
Definite un gruppo di campi una sola volta in un field.json e richiamatelo da qualsiasi blocco con "type": "custom/cta". I campi vengono inseriti direttamente, così i template li leggono come qualsiasi altro attributo.
Riutilizzate lo stesso set con un idStructure, ad esempio hero_{id}, e modificate etichette, valori predefiniti o condizioni per ciascun blocco con overrides. Il tipo di campo block fa lo stesso con un intero blocco: espande direttamente i campi del blocco e restituisce il relativo HTML renderizzato.
{
"name": "cta",
"title": "Call to action",
"attributes": [
{ "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
{ "id": "url", "type": "link", "label": "Button URL" }
]
}{
"name": "starter/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{
"type": "custom/cta",
"idStructure": "secondary_{id}",
"overrides": {
"label": { "default": "Contact us" }
}
},
{
"id": "card",
"type": "block",
"block": "starter/card",
"idStructure": "card_{id}"
}
]
}
}Moduli ES senza fase di build
Aggiungi script.js e verrà caricato come modulo ES. Importa i pacchetti npm con il prefisso npm: e Blockstudio li scarica localmente per la produzione.
L’editor offre un’anteprima immediata, mentre il frontend usa moduli locali senza dipendenze esterne, accodati una sola volta.
Anche i fogli di stile si importano allo stesso modo. import "npm:swiper@11.0.0/swiper.min.css" scarica il file e lo accoda una sola volta per versione, anche se viene usato da più blocchi.
import Swiper from "npm:swiper@11.0.0";
import "npm:swiper@11.0.0/swiper.min.css";
for (const el of document.querySelectorAll(".swiper")) {
new Swiper(el, {
slidesPerView: 3,
spaceBetween: 20,
loop: true,
});
}Tag dei blocchi oltre i template
Mappate un prefisso breve a uno spazio dei nomi in blockstudio.json, oppure un tag a un blocco tramite un filtro alias, e <acme-card> esegue il rendering di acme/card. Attivate blockTags.enabled per eseguire il rendering dei tag nei contenuti degli articoli e nei widget, limitandolo ai pattern allow e deny.
Gli attributi data-* raggiungono l’elemento radice del blocco, mentre gli attributi html-* arrivano lì senza prefisso. Aggiungete i vostri generatori di tag con blockstudio/block_tags/builders e riscrivete le abbreviazioni nella forma portabile <bs:acme-card> con il comando migrate-block-tags.
{
"blockTags": {
"enabled": true,
"prefixes": {
"acme": ["acme"],
"ui": ["acme-ui"]
},
"deny": ["acme-ui/admin-*"]
}
}<div useBlockProps class="acme-features">
<acme-card
title="Fast"
text="Rendered on the server."
data-track="card"
/>
<ui-button label="Get started" href="/start" html-id="start" />
</div>Tipi di campo personalizzati
Registra un controllo di campo personalizzato e usalo come un campo integrato.
Blocchi isola
Memorizza l’intera pagina nella cache e visualizza un blocco nella richiesta del visitatore.
Registrazione condizionale
Registrate un blocco solo per un tipo di contenuto, un ruolo utente o un’altra condizione globale, oppure ignoratelo se manca un plugin necessario o la versione richiesta.
Metadati degli articoli e opzioni
Memorizza i valori nei metadati degli articoli o nelle opzioni, insieme agli attributi dei blocchi.
Logica condizionale
Mostra i campi in base ai valori, usando uguaglianza, inclusione, assenza di valore e confronti.
Popolamento dinamico
Compila le scelte da articoli, utenti, termini, funzioni o API.
Override
Impostate override: true con il nome di un blocco condiviso per unire gli attributi in base all’id, sostituire le risorse con file omonimi e cambiare il template. I template Twig possono sovrascrivere singoli blocchi con extends.
Varianti
Dichiarate le varianti in block.json per preimpostare i valori dei campi e nascondete con hidden il campo che le determina.
Componenti
Impostate component: true per un blocco che esegue il rendering solo da PHP o dai tag dei blocchi. Mantiene campi, template, risorse e Tailwind, ma non appare mai nell’inserter.
Regole di InnerBlocks
Consentite blocchi con token namespace/*, category: e @theme, cambiate il template interno da un’opzione select e rimuovete il wrapper sul frontend con un filtro.
Risorse dei campi di codice
Con asset: true, un campo di codice trasforma l’input dell’editor in CSS, SCSS o JavaScript per quel blocco, circoscritto all’istanza tramite %selector%.
Asset in base al nome del file
*.view.js viene caricato solo sul frontend; i prefissi global-, admin- e block-editor- caricano un file rispettivamente su ogni pagina, in wp-admin o nell’editor dei blocchi.
Icone e cartelle dei blocchi
Assegnate a un blocco un’icona SVG personalizzata o HTML, cambiate il percorso di ricerca con il filtro blockstudio/path e aggiungete cartelle con Blockstudio\Build::init().
Valori ACF e Meta Box
I template ricevono $post_id, quindi get_field() e rwmb_get_value() leggono l’articolo modificato; refreshOn aggiorna l’anteprima dopo il salvataggio.
Contesto di Query Loop
All’interno di un Query Loop, $block[‘context’][‘postId’] segue l’elemento corrente, mentre $block[‘postId’] rimane l’articolo visualizzato.
WPML
wp bs wpml config scrive wpml-config.xml, che contrassegna i campi di testo come traducibili; le immagini salvate nei campi vengono incluse nei processi di traduzione di WPML, insieme ai testi alternativi e alle didascalie.
Il kit ufficiale di estensioni
Template di siti premium, istruzioni di sistema per l’AI e una community privata Discord. Acquisto una tantum, aggiornamenti a vita.
- Oltre 500 modelli di siti
- Istruzioni di sistema per l’AI
- Aggiornamenti a vita
- Community privata di Discord