Vai al contenuto

Impostazioni

Blockstudio include un potente API delle impostazioni, che consente di definire opzioni tramite un file blockstudio.json nella cartella del tema e/o tramite filtri. Inoltre, gli utenti autorizzati possono modificare visivamente le impostazioni nell’area di amministrazione.

Tramite JSON

Se nella cartella del tema è presente un file blockstudio.json, verrà usato per impostare le opzioni predefinite del sito corrente. È disponibile uno schema JSON per convalidare il file e agevolare il completamento automatico nell’IDE.

Il file è facoltativo. Se non è presente, Blockstudio usa le impostazioni salvate nell’area di amministrazione, aggiungendole ai valori predefiniti integrati. L’aggiunta, la modifica o la rimozione del file viene rilevata automaticamente: non serve svuotare la cache né ricaricare manualmente.

Sono disponibili le seguenti proprietà:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "users": {
    "ids": [],
    "roles": []
  },
  "assets": {
    "enqueue": true,
    "reset": {
      "enabled": false,
      "fullWidth": []
    },
    "minify": {
      "css": false,
      "js": false
    },
    "process": {
      "scss": false
    }
  },
  "cache": {
    "enabled": true,
    "path": "blockstudio/cache"
  },
  "themeDefaults": {
    "titleTag": false,
    "suppressDirectoryUpdates": false
  },
  "performance": {
    "profile": "compat",
    "wordpress": {
      "headNoise": false,
      "embeds": false,
      "xmlrpc": false,
      "editor": false,
      "frontendAssets": false,
      "media": false,
      "heartbeat": false
    },
    "preload": {
      "links": "off"
    },
    "media": {
      "lazy": false,
      "skeleton": false,
      "metadata": false,
      "rootMargin": "300px"
    },
    "measurement": {
      "enabled": false,
      "queryMonitor": false,
      "headers": false,
      "timings": false
    }
  },
  "content": {
    "enabled": false,
    "id": "default",
    "path": "content",
    "includePageSyncManaged": false,
    "authors": "ignore",
    "postTypes": [],
    "meta": {
      "include": [],
      "exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
      "references": {}
    },
    "taxonomies": [],
    "media": "manifest"
  },
  "editor": {
    "formatOnSave": false,
    "assets": [],
    "markup": false
  },
  "tailwind": {
    "enabled": false,
    "config": "",
    "output": "inline"
  },
  "blockTags": {
    "enabled": false,
    "allow": [],
    "deny": [],
    "prefixes": {}
  },
  "ui": {
    "enabled": false
  },
  "blockEditor": {
    "disableLoading": false,
    "enhance": false,
    "cssClasses": [],
    "cssVariables": [],
    "blocks": {
      "allow": [],
      "deny": [],
      "directory": true,
      "categories": {
        "allow": [],
        "deny": [],
        "rename": {},
        "order": []
      },
      "styles": {
        "deny": {}
      },
      "legacyWidgets": {
        "hide": []
      }
    },
    "patterns": {
      "core": true,
      "remote": true,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "allow": [],
        "deny": [],
        "rename": {},
        "order": []
      }
    },
    "media": {
      "openverse": true,
      "imageSizes": {
        "allow": [],
        "deny": []
      }
    }
  },
  "dev": {
    "grab": {
      "enabled": false
    },
    "perf": false,
    "canvas": {
      "enabled": false,
      "adminBar": true
    }
  },
  "githooks": {
    "commit": false
  },
  "phpstan": {
    "preset": "base",
    "configuration": "",
    "roots": ["."],
    "excludePaths": [],
    "maxFiles": 10000
  },
  "ai": {
    "enableContextGeneration": false
  }
}

Tramite filtri

In alternativa, potete usare il filtro blockstudio/settings/${setting} per impostare le opzioni tramite PHP, con maggiore flessibilità.

PHP
add_filter('blockstudio/settings/assets/enqueue', '__return_false');
add_filter('blockstudio/settings/editor/formatOnSave', '__return_true');
add_filter('blockstudio/settings/ui/enabled', '__return_true');
add_filter('blockstudio/settings/block_editor/patterns/remote', '__return_false');

Le opzioni impostate tramite il filtro blockstudio/settings/${setting} prevalgono su quelle definite nel file blockstudio.json. Potete usare entrambi i metodi insieme.

I valori di runtime espongono anche i filtri blockstudio/performance/${setting} e un filtro finale blockstudio/performance/config. Quest’ultimo deve restituire un oggetto di configurazione valido.

Come vengono sovrapposte le fonti

Ogni fonte viene caricata e unita, a partire da quella con priorità più bassa:

  1. Valori predefiniti integrati
  2. Impostazioni salvate tramite UI di amministrazione (l’opzione blockstudio_settings)
  3. blockstudio.json nel tema
  4. Filtri blockstudio/settings/*

blockstudio.json sovrascrive solo le chiavi che dichiara. In precedenza sostituiva interamente le impostazioni salvate: quando compariva il file, i valori salvati nell’area di amministrazione che non lo riguardavano smettevano di essere applicati. Ora si aggiunge a tali impostazioni. D’altro canto, un valore obsoleto salvato tramite UI continua ad essere applicato finché il file non dichiara quella chiave o il valore salvato non viene rimosso. Se un’impostazione si comporta diversamente da quanto indicato nel file, controllate il livello dei valori salvati con wp bs settings o Settings::get_raw(), che restituisce solo ciò che la fonte JSON o delle opzioni attiva ha dichiarato esplicitamente.

Leggere le impostazioni da PHP

Blockstudio\Settings carica la fonte attiva, segnala gli JSON malformati e si ricarica automaticamente quando blockstudio.json cambia:

PHP
use Blockstudio\Settings;

$enabled = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$roles = Settings::get_array('users/roles');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);

foreach (Settings::errors() as $error) {
    error_log($error);
}

Usate Settings::get_raw() quando un’integrazione necessita solo dei valori dichiarati esplicitamente nella sorgente JSON attiva o nelle opzioni. Settings::fingerprint() restituisce un’identità deterministica delle impostazioni effettive. I processi di lunga durata possono chiamare esplicitamente Settings::reload() per rilevare subito una modifica al file. L’accesso normale controlla il file al massimo una volta al secondo durante una richiesta o un processo PHP di lunga durata, incluso in caso di modifiche che non ne cambiano le dimensioni. La modifica del percorso configurato ha effetto alla lettura successiva. Se non è attivo alcun file JSON, le impostazioni salvate nel database non subiscono ritardi dovuti a questo intervallo.

Il profilo di prestazioni risolto è disponibile tramite Blockstudio\Runtime_Settings::current(). Supporta percorsi con barre o punti:

PHP
use Blockstudio\Runtime_Settings;

$runtime = Runtime_Settings::current();

if ($runtime->enabled('measurement/queryMonitor')) {
    $hash = $runtime->hash();
}

Impostazioni disponibili

users

Opzione Tipo Predefinito Descrizione
ids array [] ID utente con accesso all’editor
roles array [] Ruoli utente con accesso all’editor

assets

Opzione Tipo Predefinito Descrizione
enqueue booleano true Accodamento automatico degli asset dei blocchi
reset.enabled booleano false Rimuove gli stili dei blocchi core e applica il ripristino delle utilità dell’editor
reset.fullWidth array [] Tipi di post che usano il layout dell’editor a larghezza intera
minify.css booleano false Minimizza l’output di CSS
minify.js booleano false Minimizza l’output di JS
process.scss booleano false Elabora i file SCSS
output stringa source Percorso di scrittura degli asset compilati: source o cache
inlineLimit intero 0 Byte degli stili CSS esterni dei blocchi stampati inline per pagina

output usa source per impostazione predefinita, creando una directory _dist accanto a ogni blocco. Impostatela su cache per salvare invece le risorse compilate nella directory della cache Blockstudio, mantenendo così pulito l’albero dei sorgenti dei blocchi e consentendone la distribuzione da un checkout immutabile. Le fonti Blockstudio che non possono scrivere vengono già reindirizzate alla cache, indipendentemente da questa impostazione.

inlineLimit è disattivato su 0, quindi ogni foglio di stile esterno mantiene il proprio tag <link>. Impostatelo sul numero di byte per stampare inline i fogli di stile esterni più piccoli di una pagina, purché la loro dimensione totale resti entro quel limite. 40000 è il limite che WordPress core usa per la stessa regola. Consultate Inserire inline i fogli di stile piccoli.

Con reset.enabled attivo, Blockstudio copia anche i valori body_class sanificati del frontend nell’area di lavoro dell’editor. Usate blockstudio/editor/canvas/body_class per modificare l’elenco delle classi usate solo nell’editor.

cache

Opzione Tipo Predefinito Descrizione
enabled boolean true Attiva le cache basate su file Blockstudio
path string "blockstudio/cache" Percorso della cache, relativo a WP_CONTENT_DIR o assoluto
namespaceGrace integer 86400 Secondi per cui mantenere una cache ritirata prima della raccolta

Per impostazione predefinita, i file della cache vengono scritti in wp-content/blockstudio/cache, all’esterno della directory uploads. Un percorso path relativo viene risolto a partire da WP_CONTENT_DIR; un percorso assoluto viene usato direttamente. Ciò supporta gli host che forniscono un volume cache dedicato scrivibile.

Quando è attivo, Blockstudio usa questa unica directory radice per i dati di compilazione, i dati di registrazione precompilati dei blocchi, le risorse risolte dell’editor, Tailwind CSS, i documenti di rendering, i frammenti delle isole, i prerendering statici, gli indici dei grafi, le code e la diagnostica. Ogni oggetto è isolato per rete, sito, identità runtime completa e ambito. Le identità runtime comprendono Blockstudio, impostazioni, WordPress, PHP, il tema attivo, i plugin attivi, le fonti di rilevamento logiche, il contesto dell’host e gli hash delle dipendenze espliciti forniti dall’operazione proprietaria.

Le modifiche a contenuti, termini, utenti e metadati invalidano le scelte dei campi popolate, ma non l’individuazione strutturale dei blocchi né gli asset compilati. Le scelte si aggiornano separatamente, con un blocco sul percorso di compilazione fisso. Una raffica di scritture, ad esempio una sincronizzazione delle traduzioni o un’importazione, viene accorpata: la prima scrittura dopo un periodo di inattività aggiorna subito i dati, mentre l’ultima scrittura della raffica viene recepita una volta trascorsi trenta secondi, intervallo regolabile con blockstudio/cache/populate_debounce. I metadati che WordPress scrive come registrazioni di servizio, ad esempio il blocco delle modifiche al post, non vengono considerati modifiche; blockstudio/cache/populate_ignored_meta_keys estende questo elenco. L’editor interroga sempre le opzioni in tempo reale, quindi l’intervallo influisce solo sulle scelte in cache lette al momento del rendering. I file sorgente e le impostazioni di compilazione continuano a invalidare normalmente la cache strutturale. Sovrascrivere le scelte non comporta una nuova scansione della directory della cache a ogni modifica dei contenuti; la pulizia periodica continua a rimuovere i file temporanei orfani. Le identità di runtime specifiche per lingua restano isolate; la presenza di più directory di namespace della cache in un sito multilingue non indica, di per sé, un mancato riscontro nella cache.

L’attività del journal di SQLite all’interno della directory dati di un blocco db non elimina i metadati dei blocchi memorizzati nella cache. Le modifiche a db.php, ai file sorgente monitorati o alla struttura dei file sorgente e delle sottodirectory della directory dati continuano a invalidare la cache.

Durante le ricompilazioni runtime simultanee viene eletto un unico processo di compilazione. Le altre richieste attendono fino a cinque secondi, poi riutilizzano i metadati dei blocchi dell’ultima compilazione valida, se i relativi file sorgente e le risorse compilate necessarie esistono ancora. Una richiesta a freddo senza dati riutilizzabili in sicurezza restituisce HTTP 503 con Retry-After, invece di avviare un’altra compilazione. Il filtro blockstudio/cache/build_wait_budget regola l’attesa in millisecondi sia per le ricompilazioni strutturali sia per l’aggiornamento delle scelte. Un host senza blocchi consultivi sui file aggiorna le scelte senza protezione e le pubblica comunque, così la richiesta successiva trova i dati in cache.

I file .build.lock specifici per chiave, inattivi e lasciati da versioni precedenti vengono raccolti tra i namespace della cache di questo sito da WP-Cron, a partire da cinque minuti dopo l’aggiornamento e rimuovendo fino a 10,000 blocchi al minuto entro un limite di dieci secondi. wp bs cache status segnala il conteggio rimanente e wp bs cache cleanup svuota subito gli arretrati; wp bs cache clear svuota la cache runtime. Se un’esecuzione pianificata è in ritardo di oltre dieci minuti perché cron non viene eseguito, le richieste esaminano ogni ora un numero limitato di blocchi, così la pulizia non si arresta. I blocchi recenti o attivi vengono lasciati intatti e quelli nuovi sul percorso fisso non vengono mai raccolti. Una volta svuotati gli arretrati, la stessa operazione raccoglie i namespace della cache abbandonati quando è trascorso il relativo namespaceGrace, al massimo una volta all’ora per sito, mantenendo per questa operazione un’esecuzione giornaliera. Il periodo di tolleranza decorre dalla prima scansione che rileva il ritiro di un namespace, non dal suo file più recente; un namespace ancora attivo per uno qualsiasi dei suoi ambiti non viene mai raccolto. La pulizia interna della cache non attiva i filtri WordPress per l’eliminazione degli allegati. Gli host con WP-Cron disattivato devono continuare a eseguire il consueto processo pianificato cron; non eliminate indiscriminatamente i file di blocco attivi per svuotare gli arretrati.

Il filtro di impostazione blockstudio/settings/cache/path modifica il valore configurato. Per risolvere percorsi specifici per la distribuzione, blockstudio/cache/dir filtra la directory di base risolta:

PHP
add_filter('blockstudio/cache/dir', function (string $directory): string {
    return WP_CONTENT_DIR . '/cache/blockstudio';
});

Gli host la cui identità del tenant differisce dagli ID di rete o del blog di WordPress possono filtrare blockstudio/cache/site_key. Il risultato viene sanificato e usato solo come segmento di directory. blockstudio/cache/context resta il punto corretto per una variante runtime serializzabile che deve modificare le identità degli oggetti.

themeDefaults

Opzione Tipo Predefinito Descrizione
titleTag boolean false Attiva il supporto del tema per il tag title WordPress
suppressDirectoryUpdates boolean false Rimuove i temi figli e genitori attivi dai risultati degli aggiornamenti delle directory

I pattern continuano a usare l’esistente Blockstudio\Patterns API; questi valori predefiniti non introducono facciate alternative per pagine o pattern.

performance

Il profilo compat lascia invariato il comportamento generico di WordPress. speed e strict attivano gli stessi valori predefiniti facoltativi del frontend; ogni impostazione secondaria può sovrascrivere il valore del profilo.

Le impostazioni facoltative fungono da condizioni di registrazione. Quando una funzionalità facoltativa è false, Blockstudio non collega i callback frontend, di amministrazione, dell’editor, REST o pianificati di tale funzionalità. Se disattivate Early Serve o il riscaldamento pianificato dopo averli usati, viene eseguita una volta la pulizia associata; le richieste successive restano inattive.

Opzione Tipo Valore predefinito compatibilità Valore predefinito velocità/rigore Descrizione
profile stringa "compat" Non applicabile compat, speed oppure strict
wordpress.headNoise booleano false true Rimuove il rilevamento generico nell’head e l’output delle emoji
wordpress.embeds booleano false true Rimuove il rilevamento oEmbed e gli script dell’host
wordpress.xmlrpc booleano false true Disabilita XML-RPC e i pingback
wordpress.editor booleano false true Disabilita le superfici di rilevamento remoto dell’editor
wordpress.frontendAssets booleano false true Rimuove le risorse generiche del frontend di core
wordpress.media booleano false true Applica le impostazioni predefinite per l’output delle immagini
wordpress.heartbeat booleano false true Limita Heartbeat al di fuori degli editor
preload.links stringa "off" "intent" Precarica i documenti della stessa origine dopo un’intenzione dell’utente
media.lazy booleano false true Usa il caricatore di immagini di Blockstudio
media.skeleton booleano false true Mostra lo skeleton di caricamento integrato
media.metadata booleano false true Dichiara l’uso di assets/media.json
media.rootMargin stringa "300px" "300px" Margine di intersezione del caricatore lazy
measurement.enabled booleano false false Abilita le API di misurazione in fase di esecuzione
measurement.queryMonitor booleano false false Include le query che durano almeno 50ms
measurement.headers booleano false false Invia gli header con hash del profilo e della configurazione
measurement.timings booleano false false Invia l’header con il tempo trascorso in fase di esecuzione
staticPrerender.enabled booleano false false Abilita la memorizzazione nella cache HTML sicura per gli utenti anonimi
staticPrerender.ttl intero 86400 86400 Età massima in secondi dei documenti nella cache
staticPrerender.invalidate stringa "signature" "signature" Usa l’identità signature o quella incrementale graph
staticPrerender.earlyServe booleano false false Fornisce risultati sicuri prima dell’avvio di WordPress
staticPrerender.serveLoggedIn booleano false false Consente agli utenti di usare i risultati della cache, ma non di crearli
staticPrerender.dynamicPaths array [] [] Prefissi di percorso che devono restare dinamici
staticPrerender.replayHeaders array ["Link"] ["Link"] Header di risposta archiviati e inviati insieme ai risultati della cache
staticPrerender.warm.enabled booleano false false Abilita la coda pianificata persistente di riscaldamento
staticPrerender.warm.interval intero 3600 3600 Intervallo di riscaldamento in secondi
staticPrerender.warm.concurrency intero 2 2 Numero massimo di processi gestiti in un singolo ciclo di riscaldamento
staticPrerender.warm.transport stringa "http" "http" Usa http o un renderer fornito dall’host internal

Il prerendering statico rimane disabilitato a meno che non venga abilitato esplicitamente. Se l’interruttore principale è disabilitato, non vengono registrati hook di richiesta di prerendering; inoltre, gli interruttori disabilitati earlyServe e warm.enabled non registrano hook di amministrazione né hook cron. La modalità Signature usa un’identità attivata a basso costo nelle normali richieste. La modalità Graph è pensata per build esplicite: registra le dipendenze delle fonti per ogni pagina, così la modifica di una pagina non invalida i documenti non correlati. Consultate Prerendering statico per i dettagli su riscaldamento, distribuzione, erogazione anticipata e sicurezza.

Le misurazioni sono disponibili a livello programmatico:

PHP
use Blockstudio\Performance_Measurement;

$snapshot = Performance_Measurement::snapshot();

Quando gli header sono abilitati, Blockstudio invia X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config e, facoltativamente, X-Blockstudio-Performance-Time. L’azione blockstudio/performance/measurement_enabled riceve le impostazioni di runtime risolte.

Le opzioni media gestiscono bs_media_image(), il manifest assets/media.json e il caricatore lazy del frontend. Consultate Media per informazioni sulla funzione helper, il generatore del manifest e il comportamento del caricatore.

content

Opzione Tipo Predefinito Descrizione
enabled boolean false Abilita la configurazione di Content Sync
id string "default" Namespace del set di contenuti memorizzato nelle entità sincronizzate
path string "content" Directory dei file di contenuto relativa al tema
includePageSyncManaged boolean false Include i post gestiti da Page Sync senza acquisirne il contenuto
authors string "ignore" Gestione degli autori (ignore o login utente esistente)
postTypes array [] Tipi di post consentiti
meta.include array [] Pattern glob per le chiavi meta da sincronizzare
meta.exclude array ["_edit_lock", "_edit_last", "_wp_old_slug"] Pattern glob per le chiavi meta da escludere
meta.references object {} Riferimenti meta dichiarati, riscritti tra ID e UID
taxonomies array [] Tassonomie registrate consentite per termini e relazioni
media string "manifest" Comportamento dei riferimenti agli allegati (manifest o none)

Content Sync viene gestito tramite wp bs content e proietta post consentiti, postmeta e riferimenti dichiarati in file portabili. Consultate Content Sync per informazioni sul flusso di lavoro e sul formato dei file.

editor

Opzione Tipo Predefinito Descrizione
formatOnSave boolean false Formatta block.json al salvataggio
assets array [] Risorse aggiuntive da caricare nell’editor
markup boolean false Abilita la modifica del markup

tailwind

Opzione Tipo Predefinito Descrizione
enabled boolean false Abilita la compilazione di Tailwind CSS
config string "" Configurazione basata prima su Tailwind v4 CSS

Consultate Tailwind CSS per informazioni sul comportamento della compilazione e sul formato di configurazione basato prima su CSS.

blockTags

Opzione Tipo Predefinito Descrizione
enabled boolean false Abilita il rendering dei tag bs: a livello di pagina nel contenuto dei post e nelle aree widget
allow array [] Elenco consentito di pattern per i nomi dei blocchi; supporta i caratteri jolly fnmatch()
deny array [] Elenco di blocco di pattern per i nomi dei blocchi; prevale su allow
prefixes object {} Prefisso per i nomi abbreviati, con ogni valore che può essere un namespace o un array ordinato

Il rendering dei tag a livello di template è sempre attivo; queste opzioni controllano la sostituzione a livello di pagina. Consultate Rendering per la sintassi dei tag e le regole di risoluzione.

ui

Opzione Tipo Predefinito Descrizione
enabled boolean false Registra i componenti bsui/* UI inclusi e le app demo app/*

blockEditor

Opzione Tipo Predefinito Descrizione
disableLoading boolean false Disabilita il caricamento dei blocchi nell’editor
enhance boolean false Abilita gli strumenti al passaggio del mouse e di selezione nell’editor Blockstudio
cssClasses array [] URL dei fogli di stile da cui estrarre le classi CSS per il completamento automatico del campo delle classi
cssVariables array [] URL dei fogli di stile da cui estrarre le variabili CSS per il completamento automatico del campo del codice

blockEditor.blocks

Usate blockEditor.blocks per definire i criteri dell’inseritore di blocchi a livello di progetto. allow e deny accettano nomi di blocchi e pattern con caratteri jolly, come core/*.

JSON
{
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      },
      "legacyWidgets": {
        "hide": ["archives", "calendar"]
      }
    }
  }
}

blocks.styles.deny annulla la registrazione degli stili registrati tramite il registro degli stili di blocco WordPress’ PHP:

JSON
{
  "blockEditor": {
    "blocks": {
      "styles": {
        "deny": {
          "my-theme/card": ["outline"],
          "my-theme/media": ["framed"]
        }
      }
    }
  }
}

blockEditor.patterns

Usate blockEditor.patterns per disabilitare le fonti di pattern globali e filtrare le categorie di pattern.

JSON
{
  "blockEditor": {
    "patterns": {
      "core": false,
      "remote": false,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "deny": ["gallery"],
        "rename": {
          "featured": "Featured Layouts"
        },
        "order": ["featured", "buttons"]
      }
    }
  }
}

blockEditor.media

Usate blockEditor.media per definire i criteri dell’inseritore di media globale.

JSON
{
  "blockEditor": {
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"],
        "deny": ["medium_large"]
      }
    }
  }
}

dev

Opzione Tipo Predefinito Descrizione
grab.enabled boolean false Abilita lo strumento di selezione degli elementi nel frontend
perf boolean false Abilita il profilatore delle prestazioni a ogni caricamento della pagina
canvas.enabled boolean false Abilita la tela
canvas.adminBar boolean true Mostra la barra di amministrazione WordPress quando si visualizza la tela

githooks

Opzione Tipo Predefinito Descrizione
commit boolean false Genera un hook pre-commit di sola analisi quando viene eseguito blockstudio-githooks sync

Consultate l’hook di commit gestito per sapere cosa esegue l’hook generato e come rimane sincronizzato.

phpstan

Opzione Tipo Predefinito Descrizione
preset string "base" Preset di analisi se la riga di comando non ne seleziona uno: base, theme, extreme-theme o wordpress-render
configuration string "" Configurazione PHPStan del progetto inclusa insieme al preset, risolta da blockstudio.json
roots array ["."] Radici dei temi analizzate dal comando canonico
excludePaths array [] Esclusioni aggiuntive dello scanner relative a ciascuna radice configurata
maxFiles integer 10000 Numero massimo di file esaminati dallo scanner dei temi
blockTags object {} Mappature degli elementi, alias dei tag e scanPhp per la regola del tag block

Queste impostazioni gestiscono il comando canonico blockstudio-phpstan. Consultate PHPStan per informazioni su preset, livelli e adozione.

ai

Opzione Tipo Predefinito Descrizione
enableContextGeneration boolean false Genera un file di contesto combinato con blocchi, impostazioni, schemi e documentazione per gli strumenti LLM

Consultate Integrazione AI per l’indice della documentazione e il testo completo generato.

UI Componenti

Abilitate e componete i componenti headless UI inclusi, introdotti in Blockstudio 7.3.