Setări
Blockstudio include un API puternic pentru setări, care permite configurarea opțiunilor printr-un fișier blockstudio.json în dosarul temei și/sau prin filtre. În plus, utilizatorii autorizați pot modifica setările vizual, în zona de administrare.
Prin JSON
Dacă există un fișier blockstudio.json în dosarul temei, acesta va fi folosit pentru a seta opțiunile implicite ale site-ului curent. Este disponibilă o schemă JSON pentru validarea fișierului și pentru a facilita completarea automată într-un IDE.
Fișierul este opțional. În lipsa lui, Blockstudio folosește setările salvate în zona de administrare, împreună cu valorile implicite încorporate. Adăugarea, modificarea sau eliminarea fișierului este detectată automat, deci nu este necesară golirea cache-ului sau reîncărcarea manuală.
Sunt disponibile următoarele proprietăți:
{
"$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
}
}
Prin filtre
Alternativ, poți folosi filtrul blockstudio/settings/${setting} pentru a seta opțiuni prin PHP și a beneficia de mai multă flexibilitate.
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');
Opțiunile setate prin filtrul blockstudio/settings/${setting} le înlocuiesc pe cele setate prin fișierul blockstudio.json. Poți folosi ambele metode împreună.
Valorile la execuție expun și filtrele blockstudio/performance/${setting}, precum și un filtru
final blockstudio/performance/config. Acesta din urmă trebuie să returneze un obiect de configurare valid.
Ordinea surselor
Fiecare sursă este încărcată și combinată, începând cu cea cu prioritatea cea mai mică:
- Valori implicite încorporate
- Setări salvate prin UI de administrare (opțiunea
blockstudio_settings) blockstudio.jsondin temă- Filtrele
blockstudio/settings/*
blockstudio.json înlocuiește doar cheile pe care le declară. Înainte, înlocuia în întregime setările salvate, astfel că o valoare fără legătură, salvată în administrare, nu se mai aplica de îndată ce apărea fișierul; acum, valorile din fișier se adaugă peste acestea. Dezavantajul este că o valoare învechită, salvată prin UI de administrare, continuă să se aplice până când fișierul declară cheia respectivă sau valoarea salvată este eliminată. Când o setare se comportă diferit față de cum indică fișierul, verifică stratul de valori salvate cu wp bs settings sau Settings::get_raw(), care returnează doar ce a fost declarat explicit de sursa activă JSON sau de sursa de opțiuni.
Citirea setărilor din PHP
Blockstudio\Settings încarcă sursa activă, raportează JSON malformată și reîncarcă automat când se modifică blockstudio.json:
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);
}
Folosiți Settings::get_raw() când o integrare are nevoie doar de valorile declarate explicit de sursa JSON activă sau de sursa de opțiuni. Settings::fingerprint() returnează o identitate deterministă a setărilor efective. Procesele de lungă durată pot apela explicit Settings::reload() pentru a citi imediat o modificare a fișierului. Accesul normal verifică fișierul cel mult o dată pe secundă în cadrul unei cereri sau al unui proces PHP de lungă durată, inclusiv pentru modificări care păstrează aceeași dimensiune. Schimbarea căii configurate intră în vigoare la următoarea citire. Când nu este activ niciun fișier JSON, setările salvate în baza de date nu sunt întârziate de acest interval.
Profilul de performanță rezolvat este disponibil prin
Blockstudio\Runtime_Settings::current(). Acceptă căi cu bară oblică sau cu punct:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Setări disponibile
users
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
ids |
matrice | [] |
ID-urile utilizatorilor cu acces la editor |
roles |
matrice | [] |
Rolurile utilizatorilor cu acces la editor |
assets
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
enqueue |
boolean | true |
Adaugă automat în coadă resursele blocurilor |
reset.enabled |
boolean | false |
Elimină stilurile blocurilor de bază și aplică resetarea utilitarelor editorului |
reset.fullWidth |
array | [] |
Tipuri de postări care folosesc aspectul editorului pe toată lățimea |
minify.css |
boolean | false |
Minifică rezultatul CSS |
minify.js |
boolean | false |
Minifică rezultatul JS |
process.scss |
boolean | false |
Procesează fișierele SCSS |
output |
string | source |
Unde sunt scrise resursele compilate: source sau cache |
inlineLimit |
integer | 0 |
Numărul de octeți pentru resursele CSS externe ale blocurilor afișate în linie pe pagină |
output are implicit valoarea source, care creează un director _dist lângă fiecare
bloc. Seteaz-o la cache pentru a scrie resursele compilate în directorul cache Blockstudio, astfel încât arborele sursă al blocurilor să rămână curat și să poată fi implementat dintr-o versiune nemodificabilă. Sursele Blockstudio care nu pot scrie deja redirecționează rezultatul în cache, indiferent de această setare.
inlineLimit este dezactivat la 0, așa că fiecare foaie de stil externă își păstrează eticheta <link>. Setați-l la un număr de octeți pentru a afișa în linie cele mai mici foi de stil externe ale unei pagini, atât timp cât dimensiunea lor totală nu depășește acel număr. 40000 este limita pe care WordPress core o folosește pentru aceeași regulă. Consultați Foi de stil mici în linie.
Cu reset.enabled activ, Blockstudio copiază în canvasul editorului și valorile body_class sanitizate pentru partea vizibilă a site-ului. Folosește blockstudio/editor/canvas/body_class pentru a ajusta lista de clase folosită doar în editor.
cache
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
enabled |
boolean | true |
Activează cache-urile bazate pe fișiere Blockstudio |
path |
șir | "blockstudio/cache" |
Calea cache-ului, relativă la WP_CONTENT_DIR sau absolută |
namespaceGrace |
întreg | 86400 |
Numărul de secunde cât este păstrat un spațiu de nume retras din cache înainte de curățare |
În mod implicit, fișierele cache sunt scrise în wp-content/blockstudio/cache, în afara directorului de încărcări. O cale relativă path este rezolvată pornind de la WP_CONTENT_DIR; o cale absolută este folosită direct. Astfel sunt acceptate gazdele care oferă un volum dedicat, inscriptibil, pentru cache.
Când este activată, Blockstudio folosește această singură rădăcină pentru datele de compilare, datele de înregistrare precompilate ale blocurilor, resursele rezolvate ale editorului, Tailwind CSS, documentele de randare, fragmentele insulelor, paginile prerandate static, indexurile grafului, cozile și datele de diagnosticare. Fiecare obiect este izolat în funcție de rețea, site, identitatea completă la execuție și domeniu. Identitățile la execuție includ Blockstudio, setările, WordPress, PHP, tema activă, pluginurile active, sursele logice de descoperire, contextul gazdei și hash-urile explicite ale dependențelor furnizate de operația care deține obiectul.
Modificările de conținut, termeni, utilizatori și metadate invalidează opțiunile de câmp populate, nu descoperirea structurală a blocurilor sau resursele compilate. Opțiunile se actualizează separat, sub o blocare fixă a căii de compilare. Un val de scrieri, cum ar fi o sincronizare a traducerilor sau un import, este grupat: prima scriere după o perioadă de inactivitate declanșează actualizarea imediat, iar ultima scriere din val este reflectată o singură dată după treizeci de secunde, interval ajustabil cu blockstudio/cache/populate_debounce. Metadatele pe care WordPress le scrie ca evidență contabilă, cum ar fi blocarea editării după publicare, nu sunt considerate modificări; blockstudio/cache/populate_ignored_meta_keys extinde această listă. Editorul interoghează întotdeauna opțiunile în timp real, astfel că intervalul afectează doar opțiunile din cache citite la randare. Fișierele sursă și setările de compilare invalidează în continuare cache-ul structural în mod normal. Suprascrierea opțiunilor nu rescanează directorul cache la fiecare modificare de conținut; curățarea periodică elimină în continuare fișierele temporare orfane. Identitățile de execuție specifice limbii rămân izolate; existența mai multor directoare de spații de nume în cache pe un site multilingv nu este, în sine, o dovadă a unei ratări a cache-ului.
Activitatea jurnalului SQLite din directorul de date db al unui bloc nu elimină metadatele blocului din cache. Modificările aduse la db.php, fișierelor sursă monitorizate sau structurii fișierelor sursă și subdirectoarelor din directorul de date invalidează în continuare cache-ul.
Reconstruirile concurente ale mediului de execuție au un singur proces desemnat să compileze. Celelalte cereri așteaptă până la cinci secunde, apoi reutilizează metadatele blocurilor valide anterior, dacă fișierele sursă și resursele compilate necesare încă există. O cerere la rece, fără date utile sigure, returnează HTTP 503 cu Retry-After în loc să înceapă o altă compilare. Filtrul blockstudio/cache/build_wait_budget ajustează timpul de așteptare, în milisecunde, atât pentru reconstruirile structurale, cât și pentru reîmprospătarea opțiunilor. O gazdă fără blocări consultative ale fișierelor reîmprospătează opțiunile fără protecție și le publică totuși, astfel încât următoarea cerere le găsește în cache.
Fișierele .build.lock specifice unor chei inactive, rămase de la versiunile anterioare, sunt colectate în spațiile de nume cache ale acestui site de către WP-Cron, începând la cinci minute după actualizare și eliminând până la 10,000 de blocări pe minut, într-un interval de zece secunde. wp bs cache status raportează numărul rămas, iar wp bs cache cleanup golește imediat restanțele; wp bs cache clear golește cache-ul mediului de execuție. Dacă o sarcină programată întârzie cu peste zece minute deoarece cron nu se execută, cererile parcurg o dată pe oră un număr limitat de blocări, astfel încât procesul de golire să nu se blocheze. Blocările recente sau deținute sunt lăsate intacte, iar noile blocări cu cale fixă nu sunt niciodată colectate. După golirea restanțelor, aceeași sarcină colectează spațiile de nume cache abandonate după expirarea valorii namespaceGrace, cel mult o dată pe oră pentru fiecare site, și păstrează o execuție zilnică pentru aceasta. Perioada de grație începe la prima parcurgere care identifică un spațiu de nume retras, nu de la cel mai recent fișier al acestuia, iar un spațiu de nume care este încă activ pentru oricare dintre domeniile sale nu este niciodată colectat.
Curățarea internă a cache-ului nu apelează filtrele WordPress pentru ștergerea atașamentelor. Gazdele cu WP-Cron dezactivat trebuie să continue să ruleze procesul obișnuit cron programat; nu șterge la grămadă fișierele de blocare active pentru a goli restanțele.
Filtrul de setare blockstudio/settings/cache/path modifică valoarea configurată. Pentru rezolvarea căii specifice implementării, blockstudio/cache/dir filtrează directorul de bază rezolvat:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Gazdele a căror identitate de client diferă de ID-urile de rețea/blog WordPress pot filtra blockstudio/cache/site_key. Rezultatul este sanitizat și folosit doar ca segment de director. blockstudio/cache/context rămâne locul potrivit pentru o variantă serializabilă la execuție, care trebuie să modifice identitățile obiectelor.
themeDefaults
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
titleTag |
boolean | false |
Activează suportul temei WordPress pentru eticheta title |
suppressDirectoryUpdates |
boolean | false |
Elimină temele copil și părinte active din rezultatele actualizării directoarelor |
Modelele continuă să folosească Blockstudio\Patterns API existent; aceste valori implicite nu introduc interfețe alternative pentru pagini sau modele.
performance
Profilul compat lasă neschimbat comportamentul generic WordPress. speed și strict activează aceleași valori implicite opționale pentru partea vizibilă a site-ului; fiecare setare secundară poate înlocui valoarea profilului.
Setările opționale sunt porți de înregistrare. Când o funcție opțională este false, Blockstudio nu atașează callback-urile acelei funcții pentru partea vizibilă a site-ului, administrare, editor, REST sau programare. Dezactivarea funcției Early Serve sau a încălzirii programate după folosire efectuează o singură dată curățarea aferentă; cererile ulterioare nu fac nimic.
| Opțiune | Tip | Valoare implicită compatibilă | Valoare implicită pentru viteză/strict | Descriere |
|---|---|---|---|---|
profile |
șir | "compat" |
Nu se aplică | compat, speed sau strict |
wordpress.headNoise |
boolean | false |
true |
Elimină detectarea generică în head și ieșirea emoji |
wordpress.embeds |
boolean | false |
true |
Elimină detectarea oEmbed și scripturile gazdei |
wordpress.xmlrpc |
boolean | false |
true |
Dezactivează XML-RPC și pingback-urile |
wordpress.editor |
boolean | false |
true |
Dezactivează suprafețele de descoperire a editorului la distanță |
wordpress.frontendAssets |
boolean | false |
true |
Elimină resursele generice de bază pentru frontend |
wordpress.media |
boolean | false |
true |
Aplică valorile implicite pentru ieșirea imaginilor |
wordpress.heartbeat |
boolean | false |
true |
Limitează Heartbeat în afara editorilor |
preload.links |
șir | "off" |
"intent" |
Prefetch pentru documentele de aceeași origine după intenția utilizatorului |
media.lazy |
boolean | false |
true |
Folosește încărcătorul de imagini al Blockstudio |
media.skeleton |
boolean | false |
true |
Afișează scheletul de încărcare încorporat |
media.metadata |
boolean | false |
true |
Declară utilizarea assets/media.json |
media.rootMargin |
șir | "300px" |
"300px" |
Marginea de intersecție a încărcătorului leneș |
measurement.enabled |
boolean | false |
false |
Activează API-urile de măsurare la execuție |
measurement.queryMonitor |
boolean | false |
false |
Include interogările care durează cel puțin 50ms |
measurement.headers |
boolean | false |
false |
Trimite antete cu profilul și hash-ul configurației |
measurement.timings |
boolean | false |
false |
Trimite antetul cu timpul scurs de execuție |
staticPrerender.enabled |
boolean | false |
false |
Activează memorarea în cache HTML sigură pentru anonimi |
staticPrerender.ttl |
întreg | 86400 |
86400 |
Vârsta maximă a documentului din cache, în secunde |
staticPrerender.invalidate |
șir | "signature" |
"signature" |
Folosește identitatea signature sau incrementală graph |
staticPrerender.earlyServe |
boolean | false |
false |
Oferă rezultate sigure înainte de pornirea WordPress |
staticPrerender.serveLoggedIn |
boolean | false |
false |
Permite utilizatorilor să consume rezultate din cache, fără să le poată crea |
staticPrerender.dynamicPaths |
array | [] |
[] |
Prefixe de cale care trebuie să rămână dinamice |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Antete de răspuns stocate împreună cu rezultatele din cache și trimise la accesarea lor |
staticPrerender.warm.enabled |
boolean | false |
false |
Activează coada persistentă pentru încălzirea programată |
staticPrerender.warm.interval |
întreg | 3600 |
3600 |
Intervalul de încălzire, în secunde |
staticPrerender.warm.concurrency |
întreg | 2 |
2 |
Numărul maxim de lucrări procesate într-o rundă de încălzire |
staticPrerender.warm.transport |
șir | "http" |
"http" |
Folosește http sau un renderer furnizat de gazdă internal |
Pre-randarea statică rămâne dezactivată dacă nu este activată explicit. Un comutator principal dezactivat nu înregistrează niciun hook pentru solicitările de pre-randare, iar comutatoarele earlyServe și warm.enabled dezactivate nu înregistrează hook-uri de administrare sau cron. Modul semnătură folosește o identitate activată cu cost redus pentru solicitările obișnuite. Modul graf este destinat compilărilor explicite: înregistrează dependențele sursă pentru fiecare pagină, astfel încât modificarea unei pagini să nu invalideze documente fără legătură. Consultați Pre-randarea statică pentru detalii despre preîncălzire, implementare, servire timpurie și siguranță.
Măsurătorile sunt disponibile programatic:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Când antetele sunt activate, Blockstudio trimite
X-Blockstudio-Performance-Profile,
X-Blockstudio-Performance-Config și, opțional,
X-Blockstudio-Performance-Time. Acțiunea
blockstudio/performance/measurement_enabled primește setările de rulare rezolvate.
Opțiunile media controlează bs_media_image(), manifestul assets/media.json și încărcătorul leneș de frontend. Consultați Media pentru funcția auxiliară, generatorul manifestului și comportamentul încărcătorului.
content
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
enabled |
boolean | false |
Activează configurarea Content Sync |
id |
string | "default" |
Spațiul de nume al setului de conținut stocat pe entitățile sincronizate |
path |
string | "content" |
Directorul fișierelor de conținut relativ la temă |
includePageSyncManaged |
boolean | false |
Include articolele gestionate de Page Sync fără a le prelua corpul |
authors |
string | "ignore" |
Gestionarea autorului (ignore sau utilizator existent login) |
postTypes |
array | [] |
Tipuri de articole permise |
meta.include |
array | [] |
Modele glob pentru cheile meta de sincronizat |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Modele glob pentru cheile meta de exclus |
meta.references |
object | {} |
Referințe meta declarate, rescrise între ID-uri și UID-uri |
taxonomies |
array | [] |
Taxonomii înregistrate permise pentru termeni și relații |
media |
string | "manifest" |
Comportamentul referinței atașamentului (manifest sau none) |
Content Sync este gestionat prin wp bs content și proiectează articole permise, postmeta și referințe declarate în fișiere portabile. Consultați Content Sync pentru fluxul de lucru și formatul fișierelor.
editor
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
formatOnSave |
boolean | false |
Formatează block.json la salvare |
assets |
array | [] |
Resurse suplimentare de încărcat în editor |
markup |
boolean | false |
Activează editarea marcajelor |
tailwind
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
enabled |
boolean | false |
Activează compilarea Tailwind CSS |
config |
string | "" |
Configurație Tailwind v4 cu prioritate pentru CSS |
Consultați Tailwind CSS pentru comportamentul compilării și formatul configurației cu prioritate pentru CSS.
blockTags
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
enabled |
boolean | false |
Activează randarea etichetei bs: la nivel de pagină în conținutul articolelor și în zonele de widgeturi |
allow |
array | [] |
Listă de permisiuni pentru modele de nume de blocuri; acceptă caractere joker fnmatch() |
deny |
array | [] |
Listă de blocări pentru modele de nume de blocuri; are prioritate față de allow |
prefixes |
object | {} |
Prefix pentru formele scurte de nume; fiecare valoare este un spațiu de nume sau o matrice ordonată |
Randarea etichetelor la nivel de șablon este întotdeauna activă; aceste opțiuni controlează înlocuirea la nivel de pagină. Consultați Randare pentru sintaxa etichetelor și regulile de rezolvare.
ui
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
enabled |
boolean | false |
Înregistrează componentele bsui/* UI incluse și aplicațiile demonstrative app/* |
blockEditor
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
disableLoading |
boolean | false |
Dezactivează încărcarea blocurilor în editor |
enhance |
boolean | false |
Activează posibilitățile de trecere cu mouse-ul și selecție din editorul Blockstudio |
cssClasses |
array | [] |
URL-uri de foi de stil din care se extrag clasele CSS pentru completarea automată a câmpului de clase |
cssVariables |
array | [] |
URL-uri de foi de stil din care se extrag variabilele CSS pentru completarea automată a câmpului de cod |
blockEditor.blocks
Folosiți blockEditor.blocks pentru politica inseratorului de blocuri la nivelul întregului proiect. allow și deny acceptă nume de blocuri și modele cu caractere joker, precum 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 anulează înregistrarea stilurilor înregistrate prin registrul de stiluri de blocuri WordPress’
PHP:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Folosiți blockEditor.patterns pentru a dezactiva sursele globale de modele și a filtra categoriile de modele.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Folosiți blockEditor.media pentru politica globală a inseratorului media.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
grab.enabled |
boolean | false |
Activează instrumentul de selectare a elementelor din frontend |
perf |
boolean | false |
Activează profilul de performanță la fiecare încărcare a paginii |
canvas.enabled |
boolean | false |
Activează pânza |
canvas.adminBar |
boolean | true |
Afișează bara de administrare WordPress la vizualizarea pânzei |
githooks
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
commit |
boolean | false |
Generează un hook pre-commit doar pentru analiză când rulează blockstudio-githooks sync |
Consultați hook-ul de commit gestionat pentru a afla ce execută hook-ul generat și cum rămâne sincronizat.
phpstan
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
preset |
string | "base" |
Presetare de analiză dacă linia de comandă nu o selectează: base, theme, extreme-theme sau wordpress-render |
configuration |
string | "" |
Configurația PHPStan a proiectului inclusă alături de presetare, rezolvată din blockstudio.json |
roots |
array | ["."] |
Rădăcinile temelor analizate de comanda canonică |
excludePaths |
array | [] |
Excluderi suplimentare pentru scaner, raportate la fiecare rădăcină configurată |
maxFiles |
integer | 10000 |
Numărul maxim de fișiere inspectate de scanerul temei |
blockTags |
object | {} |
Mapări de elemente, aliasuri de etichete și scanPhp pentru regula etichetei de bloc |
Aceste setări controlează comanda canonică blockstudio-phpstan. Consultați PHPStan pentru presetări, straturi și adoptare.
ai
| Opțiune | Tip | Valoare implicită | Descriere |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Generează un fișier de context combinat cu blocuri, setări, scheme și documentație pentru instrumentele LLM |
Consultați Integrare AI pentru indexul documentației și textul complet generat.
Activați și combinați componentele headless incluse UI, introduse în Blockstudio 7.3.