Vai al contenuto

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.

block.json
{
  "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.

index.php
<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.

index.twig
<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>

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.

block.json
{
  "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" }
        ]]
      }
    ]
  }
}

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.

block.json
{
  "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" }
        ]
      }
    ]
  }
}

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.

fields/cta/field.json
{
  "name": "cta",
  "title": "Call to action",
  "attributes": [
    { "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
    { "id": "url", "type": "link", "label": "Button URL" }
  ]
}

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.

script.js
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.

blockstudio.json
{
  "blockTags": {
    "enabled": true,
    "prefixes": {
      "acme": ["acme"],
      "ui": ["acme-ui"]
    },
    "deny": ["acme-ui/admin-*"]
  }
}

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.

Plus

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