Nastavenia
Blockstudio obsahuje výkonné rozhranie nastavení API, ktoré umožňuje nastavovať možnosti pomocou súboru blockstudio.json v priečinku témy a/alebo filtrov. Okrem toho môžu používatelia s príslušnými oprávneniami meniť nastavenia vizuálne v administračnej oblasti.
Cez JSON
Ak sa v priečinku témy nachádza súbor blockstudio.json, použije sa na nastavenie predvolených možností aktuálneho webu. K dispozícii je schéma JSON na overenie súboru a podporu automatického dopĺňania v IDE.
Súbor je voliteľný. Ak chýba, Blockstudio použije nastavenia uložené v administračnej oblasti spolu so vstavanými predvolenými hodnotami. Pridanie, zmena alebo odstránenie súboru sa zistí automaticky, takže nie je potrebné vymazať vyrovnávaciu pamäť ani súbor ručne znova načítať.
K dispozícii sú tieto vlastnosti:
{
"$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
}
}
Pomocou filtrov
Ďalšou možnosťou je použiť filter blockstudio/settings/${setting} a nastaviť možnosti pomocou PHP, čo poskytuje väčšiu flexibilitu.
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');
Možnosti nastavené pomocou filtra blockstudio/settings/${setting} majú prednosť pred možnosťami nastavenými pomocou súboru blockstudio.json. Oba spôsoby možno používať súčasne.
Hodnoty za behu sprístupňujú aj filtre blockstudio/performance/${setting} a jeden záverečný filter blockstudio/performance/config. Ten musí vrátiť platný konfiguračný objekt.
Poradie vrstiev zdrojov
Načíta sa každý zdroj a zlúči sa s ostatnými, pričom sa začína zdrojom s najnižšou prioritou:
- Vstavané predvolené hodnoty
- Nastavenia uložené cez administrátorskú UI (možnosť
blockstudio_settings) blockstudio.jsonv téme- Filtre
blockstudio/settings/*
blockstudio.json prepíše iba kľúče, ktoré deklaruje. Predtým úplne nahradil uložené nastavenia, takže po objavení súboru sa prestala uplatňovať nesúvisiaca hodnota uložená v administrácii; teraz sa použije ako ďalšia vrstva nad nimi. Druhou stranou je, že zastaraná hodnota uložená cez administrátorskú UI sa naďalej uplatňuje, kým súbor nedeklaruje daný kľúč alebo sa uložená hodnota neodstráni. Ak sa nastavenie správa inak, než uvádza súbor, skontrolujte uloženú vrstvu pomocou wp bs settings alebo Settings::get_raw(), ktoré vracia iba hodnoty výslovne deklarované aktívnym zdrojom JSON alebo zdrojom možností.
Čítanie nastavení z PHP
Blockstudio\Settings načíta aktívny zdroj, nahlási chybne formátované JSON a automaticky sa znova načíta pri zmene 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);
}
Použite Settings::get_raw(), keď integrácia potrebuje iba hodnoty výslovne deklarované v aktívnom zdroji JSON alebo v zdroji možností. Settings::fingerprint() vracia deterministickú identitu efektívnych nastavení. Dlho bežiace procesy môžu výslovne zavolať Settings::reload(), aby sa zmena súboru načítala okamžite. Bežný prístup kontroluje súbor najviac raz za sekundu v rámci požiadavky alebo dlho bežiaceho procesu PHP, a to aj pri úpravách, ktoré nemenia veľkosť súboru. Zmena nakonfigurovanej cesty sa prejaví pri ďalšom čítaní. Keď nie je aktívny žiadny súbor JSON, uložené nastavenia databázy sa počas tohto intervalu neoneskoria.
Rozpoznaný profil výkonu je k dispozícii cez Blockstudio\Runtime_Settings::current(). Podporuje cesty so lomkou aj bodkou:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Dostupné nastavenia
users
| Možnosť | Typ | Predvolené | Opis |
|---|---|---|---|
ids |
pole | [] |
ID používateľov s prístupom k editoru |
roles |
pole | [] |
Roly používateľov s prístupom k editoru |
assets
| Možnosť | Typ | Predvolené | Popis |
|---|---|---|---|
enqueue |
boolean | true |
Automaticky zaradiť prostriedky blokov do frontu |
reset.enabled |
boolean | false |
Odstrániť štýly základných blokov a použiť reset pomocných tried editora |
reset.fullWidth |
array | [] |
Typy príspevkov používajúce rozloženie editora na celú šírku |
minify.css |
boolean | false |
Minifikovať výstup CSS |
minify.js |
boolean | false |
Minifikovať výstup JS |
process.scss |
boolean | false |
Spracovať súbory SCSS |
output |
string | source |
Miesto zápisu skompilovaných prostriedkov: source alebo cache |
inlineLimit |
integer | 0 |
Počet bajtov externých štýlov blokov CSS vypísaných priamo na každej stránke |
output má predvolene hodnotu source, ktorá vytvorí priečinok _dist vedľa každého bloku. Nastavte ju na cache, ak chcete zapisovať skompilované zdroje do priečinka vyrovnávacej pamäte Blockstudio, aby strom zdrojov blokov zostal čistý a bolo možné ho nasadiť z nemenného checkoutu. Zdroje Blockstudio, ktoré už presmerovanie nepodporujú, sa bez ohľadu na toto nastavenie zapisujú do vyrovnávacej pamäte.
inlineLimit je pri hodnote 0 vypnuté, takže každý externý súbor so štýlmi si ponechá značku <link>. Ak chcete namiesto toho vypísať priamo na stránke najmenšie externé súbory so štýlmi blokov, nastavte počet bajtov; ich celková veľkosť sa musí zmestiť do zadaného limitu. 40000 je limit, ktorý WordPress core používa pre rovnaké pravidlo. Pozrite si časť Vkladanie malých súborov so štýlmi.
Keď je aktívne reset.enabled, Blockstudio kopíruje do plátna editora aj očistené hodnoty body_class z frontendu. Pomocou blockstudio/editor/canvas/body_class upravte zoznam tried platný iba v editore.
cache
| Možnosť | Typ | Predvolené | Opis |
|---|---|---|---|
enabled |
boolean | true |
Povoliť vyrovnávaciu pamäť súborov Blockstudio |
path |
reťazec | "blockstudio/cache" |
Cesta k vyrovnávacej pamäti, relatívna k WP_CONTENT_DIR alebo absolútna |
namespaceGrace |
integer | 86400 |
Počet sekúnd, počas ktorých sa vyradený menný priestor vyrovnávacej pamäte uchová pred odstránením |
Súbory vyrovnávacej pamäte sa predvolene zapisujú do wp-content/blockstudio/cache, mimo priečinka nahratých súborov. Relatívna cesta path sa vyhodnocuje vzhľadom na WP_CONTENT_DIR; absolútna cesta sa použije priamo. To umožňuje využívať hostiteľov, ktorí poskytujú vyhradený zapisovateľný zväzok pre vyrovnávaciu pamäť.
Keď je táto možnosť povolená, Blockstudio používa tento jediný koreňový priečinok pre zostavovacie dáta, vopred zostavené registračné údaje blokov, vyriešené zdroje editora, Tailwind CSS, vykreslené dokumenty, fragmenty ostrovov, statické predvykreslenia, grafové indexy, fronty a diagnostiku. Každý objekt je izolovaný podľa siete, webu, úplnej identity behu a rozsahu. Identity behu zahŕňajú Blockstudio, nastavenia, WordPress, PHP, aktívnu tému, aktívne doplnky, logické zdroje zisťovania, kontext hostiteľa a explicitné kontrolné súčty závislostí dodané operáciou, ktorá ich vlastní.
Zmeny obsahu, termínov, používateľov a metadát zneplatnia vyplnené možnosti polí, nie objavovanie štruktúry blokov ani skompilované súbory. Možnosti sa obnovujú samostatne, pod pevným zámkom cesty zostavenia. Súbor zmien, napríklad synchronizácia prekladu alebo import, sa zlúči: prvý zápis po období nečinnosti vyvolá okamžité obnovenie a posledný zápis v súbore sa prejaví po uplynutí tridsiatich sekúnd, pričom tento interval možno upraviť pomocou blockstudio/cache/populate_debounce. Metadáta, ktoré WordPress zapisuje len ako evidenciu, napríklad zámok úpravy príspevku, sa nepovažujú za zmenu; blockstudio/cache/populate_ignored_meta_keys tento zoznam rozširuje. Editor vždy načítava aktuálne možnosti, takže toto časové okno ovplyvňuje len možnosti z vyrovnávacej pamäte načítané pri vykreslení. Zdrojové súbory a nastavenia zostavenia naďalej bežným spôsobom zneplatňujú vyrovnávaciu pamäť štruktúry. Pri prepisovaní možností sa adresár vyrovnávacej pamäte pri každej zmene obsahu znovu neprehľadáva; pravidelné čistenie naďalej odstraňuje osirelé dočasné súbory. Identity behu špecifické pre jednotlivé jazyky zostávajú oddelené; viacero menných priestorov vyrovnávacej pamäte na viacjazyčnom webe samo osebe nedokazuje, že došlo k minutiu vyrovnávacej pamäte.
Aktivita žurnálu SQLite v dátovom adresári bloku db neodstráni metadáta bloku uložené vo vyrovnávacej pamäti. Zmeny v db.php, sledovaných zdrojových súboroch alebo v štruktúre zdrojových súborov a podadresárov dátového adresára naďalej zneplatňujú vyrovnávaciu pamäť.
Pri súbežnom opätovnom zostavovaní behu sa vyberie jeden zostavovateľ. Ostatné požiadavky čakajú najviac päť sekúnd a potom znova použijú naposledy platné metadáta blokov, ak ich zdrojové súbory a požadované skompilované zdroje stále existujú. Studená požiadavka bez bezpečných dát vráti HTTP 503 s Retry-After namiesto spustenia ďalšieho zostavenia. Filter blockstudio/cache/build_wait_budget upravuje dobu čakania v milisekundách pri štrukturálnom zostavovaní aj obnovovaní možností. Hostiteľ bez poradných zámkov súborov obnoví možnosti bez ochrany a aj tak ich zverejní, takže nasledujúca požiadavka ich nájde.
Neaktívne súbory .build.lock špecifické pre kľúč, ktoré zostali po starších verziách, sa zhromažďujú naprieč mennými priestormi vyrovnávacej pamäte tohto webu pomocou WP-Cron. Proces sa začne päť minút po aktualizácii a v rámci desaťsekundového limitu odstráni až 10,000 zámkov za minútu. wp bs cache status nahlási zostávajúci počet a wp bs cache cleanup okamžite spracuje nevybavené zámky, zatiaľ čo wp bs cache clear vymaže vyrovnávaciu pamäť behu. Ak je naplánovaná dávka oneskorená o viac než desať minút, pretože sa nespúšťa cron, požiadavky raz za hodinu skontrolujú obmedzený počet zámkov, aby sa čistenie nezaseklo. Nedávne alebo používané zámky zostanú nedotknuté a nové zámky s pevnou cestou sa nikdy neodstraňujú. Po vyčistení nevybavených zámkov tá istá dávka zhromaždí opustené menné priestory vyrovnávacej pamäte po uplynutí ich namespaceGrace, najviac raz za hodinu na každom webe, pričom sa zachová denný plánovaný interval. Lehota sa počíta od prvého skenovania, pri ktorom sa priestor označí za vyradený, nie od jeho najnovšieho súboru; priestor, ktorý je stále aktuálny pre ktorýkoľvek zo svojich rozsahov, sa nikdy neodstráni.
Interné čistenie vyrovnávacej pamäte nevolá filtre odstraňovania príloh WordPress. Hostitelia s vypnutým WP-Cron by mali naďalej spúšťať svoj bežný plánovaný proces cron; na vyčistenie nevybavených zámkov neodstraňujte bez rozmyslu aktívne súbory zámkov.
Filter nastavenia blockstudio/settings/cache/path mení nakonfigurovanú hodnotu. Ak chcete rozlíšiť cesty podľa nasadenia, filter blockstudio/cache/dir mení vyriešený základný priečinok:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Hostitelia, ktorých identita tenanta sa líši od ID siete/blogu WordPress, môžu filtrovať blockstudio/cache/site_key. Výsledok sa očistí a použije iba ako segment priečinka. blockstudio/cache/context zostáva správnym miestom na serializovateľný variant behu, ktorý musí meniť identity objektov.
themeDefaults
| Možnosť | Typ | Predvolené | Opis |
|---|---|---|---|
titleTag |
boolean | false |
Povoliť podporu značky názvu WordPress v téme |
suppressDirectoryUpdates |
boolean | false |
Odstrániť aktívne podtémy a nadradené témy z výsledkov aktualizácie priečinka |
Vzory naďalej používajú existujúce Blockstudio\Patterns API; tieto predvolené hodnoty nezavádzajú alternatívne rozhrania stránok ani vzorov.
performance
Profil compat ponecháva všeobecné správanie WordPress nezmenené. speed a strict zapínajú rovnaké predvolené hodnoty frontendu; každé podriadené nastavenie môže prepísať hodnotu profilu.
Nastavenia aktivácie sú registračné brány. Keď je voliteľná funkcia false,
Blockstudio nepripojí jej frontend, administráciu, editor, REST ani
plánované spätné volania. Vypnutím funkcie Early Serve alebo plánovaného zahrievania po jej použití sa raz vykoná príslušné čistenie; ďalšie požiadavky zostanú neaktívne.
| Možnosť | Typ | Predvolené nastavenie kompatibility | Predvolené nastavenie rýchlosti/prísnosti | Opis |
|---|---|---|---|---|
profile |
string | "compat" |
Nevzťahuje sa | compat, speed alebo strict |
wordpress.headNoise |
boolean | false |
true |
Odstráni všeobecné zisťovanie hlavičky a výstup emotikonov |
wordpress.embeds |
boolean | false |
true |
Odstráni zisťovanie oEmbed a skripty hostiteľa |
wordpress.xmlrpc |
boolean | false |
true |
Zakáže XML-RPC a pingbacky |
wordpress.editor |
boolean | false |
true |
Zakáže vzdialené plochy na zisťovanie editora |
wordpress.frontendAssets |
boolean | false |
true |
Odstráni všeobecné zdroje frontendu jadra |
wordpress.media |
boolean | false |
true |
Použije predvolené nastavenia výstupu obrázkov |
wordpress.heartbeat |
boolean | false |
true |
Obmedzí Heartbeat mimo editorov |
preload.links |
string | "off" |
"intent" |
Načíta dokumenty z rovnakého pôvodu vopred po zámere používateľa |
media.lazy |
boolean | false |
true |
Použije načítavač obrázkov Blockstudio |
media.skeleton |
boolean | false |
true |
Zobrazí vstavanú kostru načítavania |
media.metadata |
boolean | false |
true |
Deklaruje použitie assets/media.json |
media.rootMargin |
string | "300px" |
"300px" |
Okraj priesečníka pre lenivý načítavač |
measurement.enabled |
boolean | false |
false |
Povolí rozhrania API na meranie za behu |
measurement.queryMonitor |
boolean | false |
false |
Zahrnie požiadavky trvajúce aspoň 50ms |
measurement.headers |
boolean | false |
false |
Odošle hlavičky s hashom profilu a konfigurácie |
measurement.timings |
boolean | false |
false |
Odošle hlavičku s uplynutým časom behu |
staticPrerender.enabled |
boolean | false |
false |
Povolí ukladanie do vyrovnávacej pamäte HTML bezpečné pre anonymných používateľov |
staticPrerender.ttl |
integer | 86400 |
86400 |
Maximálny vek dokumentu vo vyrovnávacej pamäti v sekundách |
staticPrerender.invalidate |
string | "signature" |
"signature" |
Použije identitu signature alebo inkrementálnu identitu graph |
staticPrerender.earlyServe |
boolean | false |
false |
Poskytne bezpečné zásahy pred spustením WordPress |
staticPrerender.serveLoggedIn |
boolean | false |
false |
Umožní používateľom využívať zásahy z vyrovnávacej pamäte, nie ich vytvárať |
staticPrerender.dynamicPaths |
array | [] |
[] |
Prefixy ciest, ktoré musia zostať dynamické |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Hlavičky odpovede uložené spolu so zásahmi z vyrovnávacej pamäte a odosielané pri nich |
staticPrerender.warm.enabled |
boolean | false |
false |
Povolí trvalý naplánovaný front na predbežné zahriatie |
staticPrerender.warm.interval |
integer | 3600 |
3600 |
Interval zahrievania v sekundách |
staticPrerender.warm.concurrency |
integer | 2 |
2 |
Maximálny počet úloh spracovaných počas jedného priechodu zahrievania |
staticPrerender.warm.transport |
string | "http" |
"http" |
Použije http alebo renderer poskytnutý hostiteľom internal |
Statické predvykresľovanie zostáva vypnuté, pokiaľ ho výslovne nepovolíte. Ak je hlavný prepínač vypnutý, nezaregistrujú sa žiadne háčiky požiadaviek na predvykreslenie a vypnuté prepínače earlyServe a warm.enabled nezaregistrujú žiadne administrátorské ani cron háčiky. Režim podpisu používa pri bežných požiadavkách lacnú aktivovanú identitu. Režim grafu je určený na explicitné zostavenia: zaznamenáva závislosti zdrojov pre každú stránku, takže zmena jednej stránky nezneplatní nesúvisiace dokumenty. Ďalšie informácie o zahrievaní, nasadzovaní, skorom poskytovaní a bezpečnosti nájdete v časti Statické predvykresľovanie.
Merania sú dostupné programovo:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Keď sú hlavičky povolené, Blockstudio odosiela
X-Blockstudio-Performance-Profile,
X-Blockstudio-Performance-Config a voliteľne aj
X-Blockstudio-Performance-Time. Akcia
blockstudio/performance/measurement_enabled prijíma vyriešené
nastavenia behu.
Možnosti media riadia bs_media_image(), manifest assets/media.json
a lenivý načítavač frontendu. Pomocníka, tvorbu manifestu a správanie načítavača opisuje časť Médiá.
content
| Možnosť | Typ | Predvolená hodnota | Opis |
|---|---|---|---|
enabled |
boolean | false |
Povolí konfiguráciu Content Sync |
id |
string | "default" |
Menný priestor súborov obsahu uložený v synchronizovaných entitách |
path |
string | "content" |
Adresár súborov obsahu vzhľadom na tému |
includePageSyncManaged |
boolean | false |
Zahrnie príspevky spravované funkciou Page Sync bez prevzatia ich tela |
authors |
string | "ignore" |
Spracovanie autorov (ignore alebo login existujúceho používateľa) |
postTypes |
array | [] |
Povolené typy príspevkov |
meta.include |
array | [] |
Vzory glob pre meta kľúče, ktoré sa majú synchronizovať |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Vzory glob pre meta kľúče, ktoré sa majú vylúčiť |
meta.references |
object | {} |
Deklarované meta odkazy prepísané medzi ID a UID |
taxonomies |
array | [] |
Povolené registrované taxonómie pre termíny a vzťahy |
media |
string | "manifest" |
Správanie pri odkazoch na prílohy (manifest alebo none) |
Content Sync sa spravuje cez wp bs content a exportuje povolené príspevky,
postmeta a deklarované odkazy do prenosných súborov. Postup a formát súborov opisuje
časť Content Sync.
editor
| Možnosť | Typ | Predvolená hodnota | Opis |
|---|---|---|---|
formatOnSave |
boolean | false |
Formátuje block.json pri uložení |
assets |
array | [] |
Ďalšie zdroje načítané v editore |
markup |
boolean | false |
Povolí úpravu značiek |
tailwind
| Možnosť | Typ | Predvolená hodnota | Opis |
|---|---|---|---|
enabled |
boolean | false |
Povolí kompiláciu Tailwind CSS |
config |
string | "" |
Konfigurácia Tailwind v4 CSS-first |
Správanie kompilácie a formát konfigurácie CSS-first nájdete v časti Tailwind CSS.
blockTags
| Možnosť | Typ | Predvolená hodnota | Opis |
|---|---|---|---|
enabled |
boolean | false |
Povolí vykresľovanie značiek bs: na úrovni stránky v obsahu príspevkov a oblastiach widgetov |
allow |
array | [] |
Zoznam povolených vzorov názvov blokov; podporuje zástupné znaky fnmatch() |
deny |
array | [] |
Zoznam zakázaných vzorov názvov blokov; má prednosť pred allow |
prefixes |
object | {} |
Predpona na pomenovanie skratiek; každá hodnota je menný priestor alebo zoradené pole |
Vykresľovanie značiek na úrovni šablóny je vždy aktívne; tieto možnosti riadia nahrádzanie na úrovni stránky. Syntax značiek a pravidlá rozlišovania nájdete v časti Vykresľovanie.
ui
| Možnosť | Typ | Predvolená hodnota | Opis |
|---|---|---|---|
enabled |
boolean | false |
Zaregistruje pribalené komponenty bsui/* UI a ukážkové aplikácie app/* |
blockEditor
| Možnosť | Typ | Predvolená hodnota | Opis |
|---|---|---|---|
disableLoading |
boolean | false |
Vypne načítavanie blokov v editore |
enhance |
boolean | false |
Povolí funkcie umiestňovania kurzora a výberu v editore Blockstudio |
cssClasses |
array | [] |
URL štýlov, z ktorých sa získavajú triedy CSS na automatické dopĺňanie poľa tried |
cssVariables |
array | [] |
URL štýlov, z ktorých sa získavajú premenné CSS na automatické dopĺňanie poľa kódu |
blockEditor.blocks
Použite blockEditor.blocks na nastavenie pravidiel vkladania blokov pre celý projekt. allow a deny prijímajú názvy blokov a vzory so zástupnými znakmi, napríklad 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 zruší registráciu štýlov zaregistrovaných cez
register štýlov blokov WordPress PHP:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Pomocou blockEditor.patterns vypnete globálne zdroje vzorov a filtrujete
kategórie vzorov.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Pomocou blockEditor.media nastavíte pravidlá globálneho vkladania médií.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Možnosť | Typ | Predvolená hodnota | Opis |
|---|---|---|---|
grab.enabled |
boolean | false |
Povolí nástroj na výber prvkov na frontende |
perf |
boolean | false |
Povolí profilovanie výkonu pri každom načítaní stránky |
canvas.enabled |
boolean | false |
Povolí plátno |
canvas.adminBar |
boolean | true |
Pri zobrazení plátna ukáže panel správcu WordPress |
githooks
| Možnosť | Typ | Predvolená hodnota | Opis |
|---|---|---|---|
commit |
boolean | false |
Vygeneruje analytický pre-commit hook pri spustení blockstudio-githooks sync |
Informácie o tom, čo spúšťa vygenerovaný háčik a ako zostáva synchronizovaný, nájdete v časti spravovaný commit hook.
phpstan
| Možnosť | Typ | Predvolené | Popis |
|---|---|---|---|
preset |
reťazec | "base" |
Predvoľba analýzy, keď ju príkazový riadok nevyberie: base, theme, extreme-theme alebo wordpress-render |
configuration |
reťazec | "" |
Konfigurácia projektu PHPStan zahrnutá spolu s predvoľbou, načítaná z blockstudio.json |
roots |
pole | ["."] |
Koreňové priečinky tém analyzované kanonickým príkazom |
excludePaths |
pole | [] |
Ďalšie vylúčenia skenera vzhľadom na každý nakonfigurovaný koreňový priečinok |
maxFiles |
celé číslo | 10000 |
Maximálny počet súborov kontrolovaných skenerom tém |
blockTags |
objekt | {} |
Mapovania prvkov, aliasy značiek a scanPhp pre pravidlo značky značky bloku |
Tieto nastavenia riadia kanonický príkaz blockstudio-phpstan. Predvoľby, vrstvy a začlenenie nájdete v časti PHPStan.
ai
| Možnosť | Typ | Predvolená hodnota | Opis |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Vygeneruje súhrnný kontextový súbor blokov, nastavení, schém a dokumentácie pre nástroje LLM |
Register dokumentácie a úplný vygenerovaný text nájdete v časti Integrácia AI.
Povoľte a kombinujte pribalené bezhlavé komponenty UI predstavené vo verzii Blockstudio 7.3.