# 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.

[Riferimento ai tipi di campo](https://blockstudio.dev/it/docs/blocks/attributes/field-types/)

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.

[Esplora i componenti](https://blockstudio.dev/it/docs/blocks/react-components/)

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`.

[Linguaggi per i template](https://blockstudio.dev/it/docs/blocks/templating/blade/)

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`.

[Logica condizionale](https://blockstudio.dev/it/docs/blocks/attributes/conditional-logic/)

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`.

[Pattern di repeater](https://blockstudio.dev/it/guides/field-patterns/#repeater-patterns)

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.

[Campi personalizzati](https://blockstudio.dev/it/docs/blocks/attributes/custom-fields/)

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.

[Elaborazione delle risorse](https://blockstudio.dev/it/docs/blocks/assets/)

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`.

[Leggi la guida](https://blockstudio.dev/it/guides/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

[Passa a Plus](https://blockstudio.dev/it/plus/)
