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à:
{
"$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à.
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:
- Valori predefiniti integrati
- Impostazioni salvate tramite UI di amministrazione (l’opzione
blockstudio_settings) blockstudio.jsonnel tema- 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:
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:
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:
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:
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/*.
{
"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:
{
"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.
{
"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.
{
"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.
Abilitate e componete i componenti headless UI inclusi, introdotti in Blockstudio 7.3.