Nastavení
Blockstudio nabízí výkonnou vrstvu nastavení API, která umožňuje definovat možnosti v souboru blockstudio.json ve složce šablony a/nebo pomocí filtrů. Uživatelé s příslušnými oprávněními mohou navíc nastavení měnit vizuálně v administraci.
Přes JSON
Pokud se ve složce šablony nachází soubor blockstudio.json, použije se k nastavení výchozích možností pro aktuální web. K dispozici je schéma JSON k ověření souboru a k podpoře automatického doplňování v IDE.
Soubor není povinný. Pokud chybí, Blockstudio použije nastavení uložená v administraci a svá vestavěná výchozí nastavení. Přidání, změna nebo odebrání souboru se rozpozná automaticky, takže není nutné mazat mezipaměť ani ručně obnovovat stránku.
K dispozici jsou následující 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
}
}
Přes filtry
Místo toho můžete použít filtr blockstudio/settings/${setting} a nastavit možnosti přes PHP s větší flexibilitou.
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é pomocí filtru blockstudio/settings/${setting} mají přednost před možnostmi nastavenými v souboru blockstudio.json. Oba způsoby lze použít současně.
Hodnoty za běhu zpřístupňují také filtry blockstudio/performance/${setting} a jeden
závěrečný filtr blockstudio/performance/config. Ten musí vracet platný
konfigurační objekt.
Jak se zdroje skládají
Načtou se všechny zdroje a sloučí se od nejnižší priority:
- Vestavěná výchozí nastavení
- Nastavení uložená přes UI administrace (možnost
blockstudio_settings) blockstudio.jsonv šabloně- Filtry
blockstudio/settings/*
blockstudio.json přepisuje pouze klíče, které definuje. Dříve zcela nahrazoval
uložená nastavení, takže hodnota uložená v administraci přestala platit,
jakmile se soubor objevil; nyní se přidává nad ně. Druhou stranou je, že
zastaralá hodnota uložená přes administraci UI se dál používá,
dokud soubor nedefinuje daný klíč nebo uloženou hodnotu neodstraníte. Pokud
se nastavení chová jinak, než uvádí soubor, zkontrolujte uloženou vrstvu pomocí
wp bs settings nebo Settings::get_raw(), které vrací pouze to, co aktivní zdroj JSON
nebo možností výslovně definoval.
Čtení nastavení z PHP
Blockstudio\Settings načte aktivní zdroj, nahlásí chybně formátované JSON a
automaticky se znovu načte při změně 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žijte Settings::get_raw(), pokud integrace potřebuje pouze hodnoty výslovně
určené aktivním zdrojem JSON nebo možností. Settings::fingerprint() vrací
deterministickou identitu efektivního nastavení. Dlouho běžící procesy mohou
výslovným zavoláním Settings::reload() okamžitě načíst změnu souboru. Běžný přístup
kontroluje soubor nejvýše jednou za sekundu v rámci požadavku nebo dlouho
běžícího procesu PHP, a to i při úpravách se stejnou velikostí. Změna
konfigurované cesty se projeví při příštím čtení. Pokud není aktivní žádný soubor
JSON, načtení uloženého nastavení z databáze toto okno nezpozdí.
Vyřešený profil výkonu je dostupný přes
Blockstudio\Runtime_Settings::current(). Podporuje cesty oddělené lomítkem nebo tečkou:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Dostupná nastavení
users
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
ids |
pole | [] |
ID uživatelů s přístupem k editoru |
roles |
pole | [] |
Uživatelské role s přístupem k editoru |
assets
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
enqueue |
boolean | true |
Automaticky zařadit prostředky bloků do fronty |
reset.enabled |
boolean | false |
Odebrat styly základních bloků a použít reset nástrojů editoru |
reset.fullWidth |
array | [] |
Typy příspěvků používající rozvržení editoru na celou šířku |
minify.css |
boolean | false |
Minifikovat výstup CSS |
minify.js |
boolean | false |
Minifikovat výstup JS |
process.scss |
boolean | false |
Zpracovávat soubory SCSS |
output |
string | source |
Umístění zkompilovaných prostředků: source nebo cache |
inlineLimit |
integer | 0 |
Počet bajtů externích stylů bloků CSS vložených přímo na stránku |
output má ve výchozím nastavení hodnotu source, která vytváří adresář _dist vedle každého bloku. Nastavte ji na cache, chcete-li ukládat zkompilované prostředky do adresáře mezipaměti Blockstudio, aby strom zdrojových souborů bloků zůstal čistý a bylo možné jej nasadit z neměnného checkoutu. Zdroje Blockstudio, které nelze zapisovat, se do mezipaměti přesměrovávají bez ohledu na toto nastavení.
inlineLimit je vypnuté při hodnotě 0, takže každý externí stylopis zachová svůj tag <link>. Nastavte počet bajtů, chcete-li místo toho vložit přímo na stránku nejmenší externí styly bloků, pokud jejich celková velikost nepřekročí tento limit. 40000 je limit, který WordPress používá pro stejné pravidlo. Další informace najdete v části Vkládání malých stylopisů.
Když je aktivní reset.enabled, Blockstudio také kopíruje vyčištěné hodnoty frontendových tříd body_class do plátna editoru. Seznam tříd používaný pouze v editoru upravte pomocí blockstudio/editor/canvas/body_class.
cache
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
enabled |
boolean | true |
Povolit mezipaměti založené na souborech Blockstudio |
path |
string | "blockstudio/cache" |
Cesta k mezipaměti, relativní k WP_CONTENT_DIR nebo absolutní |
namespaceGrace |
integer | 86400 |
Počet sekund, po které se vyřazený jmenný prostor mezipaměti uchovává před odstraněním |
Ve výchozím nastavení se soubory mezipaměti zapisují do wp-content/blockstudio/cache mimo adresář nahraných souborů. Relativní cesta path se určuje vzhledem k WP_CONTENT_DIR; absolutní cesta se použije přímo. Díky tomu lze využít hosting s vyhrazeným zapisovatelným svazkem mezipaměti.
Je-li tato možnost povolena, Blockstudio používá tento jediný kořenový adresář pro sestavené datové části, předem sestavená registrační data bloků, vyřešené prostředky editoru, Tailwind CSS, vykreslené dokumenty, fragmenty ostrovů, staticky předvykreslené stránky, indexy grafů, fronty a diagnostické údaje. Každý objekt je oddělen podle sítě, webu, úplné identity běhového prostředí a rozsahu. Identity běhového prostředí zahrnují Blockstudio, nastavení, WordPress, PHP, aktivní šablonu, aktivní pluginy, logické zdroje zjišťování, kontext hostitele a explicitní hash hodnoty závislostí dodané vlastníkem operace.
Změny obsahu, termínu, uživatele a metadat zneplatní naplněné možnosti polí, nikoli strukturální vyhledávání bloků nebo sestavené prostředky. Možnosti se obnovují samostatně pod zámkem pevně dané cesty sestavení. Série zápisů, například synchronizace překladů nebo import, se slučuje: první zápis po klidovém období spustí obnovení okamžitě a poslední zápis ze série se projeví po uplynutí třiceti sekund; interval lze upravit pomocí blockstudio/cache/populate_debounce. Metadata, která WordPress zapisuje jako evidenci, například zámek úprav příspěvku, se za změnu nepovažují; seznam rozšiřuje blockstudio/cache/populate_ignored_meta_keys. Editor vždy načítá aktuální možnosti, takže časové okno ovlivňuje pouze možnosti z mezipaměti načtené při vykreslení. Zdrojové soubory a nastavení sestavení zneplatňují strukturální mezipaměť běžným způsobem. Přepsání možností při každé změně obsahu znovu neprohledává adresář mezipaměti; pravidelné čištění stále odstraňuje osiřelé dočasné soubory. Identity běhu specifické pro jazyk zůstávají oddělené; více adresářů jmenných prostorů mezipaměti na vícejazyčném webu samo o sobě nedokazuje, že došlo k minutí mezipaměti.
Aktivita žurnálu SQLite uvnitř datového adresáře bloku db neodstraňuje metadata bloku z mezipaměti. Změny v db.php, sledovaných zdrojových souborech nebo ve struktuře zdrojových souborů a podadresářů datového adresáře mezipaměť nadále zneplatňují.
Při souběžném opětovném sestavení běhového prostředí je zvolen jeden proces, který sestavení provede. Ostatní požadavky čekají až pět sekund a poté znovu použijí poslední platná metadata bloků, pokud jejich zdrojové soubory a požadované zkompilované prostředky stále existují. Požadavek při studeném spuštění bez bezpečné datové části vrátí HTTP 503 s Retry-After místo spuštění dalšího sestavení. Filtr blockstudio/cache/build_wait_budget upravuje čekání v milisekundách pro strukturální sestavení i obnovu možností. Hostitel bez poradních zámků souborů obnoví možnosti bez ochrany a přesto je zveřejní, takže další požadavek zasáhne do mezipaměti.
Neaktivní soubory zámků .build.lock pro jednotlivé klíče, které zůstaly po starších verzích, se napříč jmennými prostory mezipaměti tohoto webu odstraňují pomocí WP-Cron. Čištění začne pět minut po aktualizaci a v rámci desetisekundového limitu odstraní až 10,000 zámků za minutu. wp bs cache status uvádí zbývající počet a wp bs cache cleanup okamžitě vyčistí nevyřízené zámky; wp bs cache clear vymaže běhovou mezipaměť. Pokud je naplánovaná dávka kvůli nefunkčnímu cron zpožděná o více než deset minut, požadavky jednou za hodinu projdou omezený počet zámků, aby se čištění nezastavilo. Nedávné nebo držené zámky zůstanou nedotčené a nové zámky pevné cesty se nikdy neodstraňují. Po vyčištění nevyřízených zámků stejná dávka odstraní opuštěné jmenné prostory mezipaměti, jakmile uplyne jejich namespaceGrace, nejvýše jednou za hodinu na web; čištění se spouští také jednou denně. Tato lhůta se počítá od prvního průchodu, který zjistí, že jmenný prostor byl vyřazen, nikoli od data jeho nejnovějšího souboru. Jmenný prostor, který je stále aktuální v kterémkoli ze svých rozsahů, se nikdy neodstraní.
Interní čištění mezipaměti nespouští filtry WordPress pro odstraňování příloh. Hostitelé s vypnutým WP-Cron by měli dál spouštět svůj obvyklý plánovaný pracovní proces cron; živé soubory zámků nemažte bez rozmyslu, abyste vyčistili nevyřízené zámky.
Filtr nastavení blockstudio/settings/cache/path mění nakonfigurovanou
hodnotu. Pro rozlišení cest podle nasazení použijte blockstudio/cache/dir,
který filtruje vyřešený základní adresář:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Hostitelé, u kterých se identita tenanta liší od ID sítě/blogu WordPress, mohou filtrovat blockstudio/cache/site_key. Výsledek se očistí a použije pouze jako část názvu adresáře. blockstudio/cache/context zůstává správným místem pro serializovatelnou variantu běhového prostředí, která musí změnit identity objektů.
themeDefaults
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
titleTag |
boolean | false |
Povolit podporu značky title v šabloně WordPress |
suppressDirectoryUpdates |
boolean | false |
Odebrat aktivní podřízené a nadřazené šablony z výsledků aktualizace adresářů |
Vzory nadále používají stávající Blockstudio\Patterns API; tato výchozí nastavení nepřidávají alternativní fasády stránek ani vzorů.
performance
Profil compat ponechává obecné chování WordPress beze změny. speed a strict povolují stejná volitelná výchozí nastavení frontendu; každé podřízené nastavení může hodnotu profilu přepsat.
Volitelná nastavení fungují jako podmínky registrace. Když je volitelná funkce false, Blockstudio nepřipojí její callbacky pro frontend, administraci, editor, REST ani plánované úlohy. Po vypnutí funkce Early Serve nebo plánovaného zahřívání se jednou provede úklid prostředků, které funkce spravovala; další požadavky už žádnou činnost neprovedou.
| Možnost | Typ | Výchozí hodnota v režimu kompatibility | Výchozí hodnota v režimu rychlosti/přísnosti | Popis |
|---|---|---|---|---|
profile |
string | "compat" |
Nepoužije se | compat, speed nebo strict |
wordpress.headNoise |
boolean | false |
true |
Odebere obecné objevování v hlavičce a výstup emoji |
wordpress.embeds |
boolean | false |
true |
Odebere objevování oEmbed a skripty hostitele |
wordpress.xmlrpc |
boolean | false |
true |
Zakáže XML-RPC a pingbacky |
wordpress.editor |
boolean | false |
true |
Zakáže vzdálené plochy pro objevování editoru |
wordpress.frontendAssets |
boolean | false |
true |
Odebere obecné prostředky jádra pro frontend |
wordpress.media |
boolean | false |
true |
Použije výchozí nastavení výstupu obrázků |
wordpress.heartbeat |
boolean | false |
true |
Omezí Heartbeat mimo editory |
preload.links |
string | "off" |
"intent" |
Po záměru uživatele přednačte dokumenty stejného původu |
media.lazy |
boolean | false |
true |
Použije načítání obrázků v Blockstudio |
media.skeleton |
boolean | false |
true |
Zobrazí vestavěnou kostru načítání |
media.metadata |
boolean | false |
true |
Deklaruje použití assets/media.json |
media.rootMargin |
string | "300px" |
"300px" |
Okraj průsečíku pro líné načítání |
measurement.enabled |
boolean | false |
false |
Povolí API pro měření za běhu |
measurement.queryMonitor |
boolean | false |
false |
Zahrne dotazy trvající alespoň 50ms |
measurement.headers |
boolean | false |
false |
Odešle hlavičky s hashem profilu a konfigurace |
measurement.timings |
boolean | false |
false |
Odešle hlavičku s dobou běhu |
staticPrerender.enabled |
boolean | false |
false |
Povolí ukládání do mezipaměti HTML bezpečné pro anonymní uživatele |
staticPrerender.ttl |
integer | 86400 |
86400 |
Maximální stáří dokumentu v mezipaměti v sekundách |
staticPrerender.invalidate |
string | "signature" |
"signature" |
Použije identitu signature nebo inkrementální graph |
staticPrerender.earlyServe |
boolean | false |
false |
Bezpečné výsledky poskytne ještě před spuštěním WordPress |
staticPrerender.serveLoggedIn |
boolean | false |
false |
Umožní uživatelům výsledky z mezipaměti používat, nikoli vytvářet |
staticPrerender.dynamicPaths |
array | [] |
[] |
Prefixy cest, které musí zůstat dynamické |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Hlavičky odpovědi ukládané spolu s výsledky a odesílané při jejich použití |
staticPrerender.warm.enabled |
boolean | false |
false |
Povolí trvalou plánovanou frontu zahřívání |
staticPrerender.warm.interval |
integer | 3600 |
3600 |
Interval zahřívání v sekundách |
staticPrerender.warm.concurrency |
integer | 2 |
2 |
Maximální počet úloh zpracovaných během jednoho průchodu zahřívání |
staticPrerender.warm.transport |
string | "http" |
"http" |
Použije http nebo renderer poskytovaný hostitelem internal |
Statické předběžné vykreslování zůstává vypnuté, dokud ho výslovně nepovolíte. Vypnutý hlavní přepínač neregistruje žádné háčky požadavků na předběžné vykreslování a vypnuté přepínače earlyServe a warm.enabled neregistrují žádné administrátorské ani háčky cron. Režim podpisu používá při běžných požadavcích levnou aktivovanou identitu. Režim grafu je určen pro explicitní sestavení: zaznamenává závislosti zdrojů jednotlivých stránek, takže změna jedné stránky nezneplatní nesouvisející dokumenty. Informace o zahřívání, nasazení, předčasném poskytování a bezpečnosti najdete v tématu Statické předběžné vykreslování.
Měření jsou dostupná programově:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Když jsou hlavičky povolené, Blockstudio odesílá X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config a případně X-Blockstudio-Performance-Time. Akce blockstudio/performance/measurement_enabled obdrží vyřešená nastavení běhového prostředí.
Možnosti media řídí bs_media_image(), manifest assets/media.json a líný načítač frontendu. Pomocnou funkci, generátor manifestu a chování načítače najdete v tématu Média.
content
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
enabled |
boolean | false |
Povolí konfiguraci Content Sync |
id |
string | "default" |
Jmenný prostor sady obsahu ukládaný do synchronizovaných entit |
path |
string | "content" |
Adresář souborů obsahu relativní k šabloně |
includePageSyncManaged |
boolean | false |
Zahrne příspěvky spravované Page Sync, aniž by převzala správu jejich obsahu |
authors |
string | "ignore" |
Zpracování autorů (ignore nebo login existujícího uživatele) |
postTypes |
array | [] |
Povolené typy příspěvků |
meta.include |
array | [] |
Glob vzory klíčů meta dat k synchronizaci |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Glob vzory klíčů meta dat k vyloučení |
meta.references |
object | {} |
Deklarované odkazy na meta data přepisované mezi ID a UID |
taxonomies |
array | [] |
Povolené registrované taxonomie pro výrazy a vztahy |
media |
string | "manifest" |
Chování odkazů na přílohy (manifest nebo none) |
Content Sync se spravuje prostřednictvím wp bs content a převádí povolené příspěvky, postmeta a deklarované odkazy na přenositelné soubory. Pracovní postup a formát souborů najdete v tématu Content Sync.
editor
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
formatOnSave |
boolean | false |
Při uložení formátuje block.json |
assets |
array | [] |
Další prostředky k načtení v editoru |
markup |
boolean | false |
Povolí úpravy značek |
tailwind
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
enabled |
boolean | false |
Povolí kompilaci Tailwind CSS |
config |
string | "" |
Konfigurace Tailwind v4 zaměřená na CSS |
Informace o chování kompilace a formátu konfigurace zaměřené na CSS najdete v tématu Tailwind CSS.
blockTags
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
enabled |
boolean | false |
Povolí vykreslování značek bs: na úrovni stránky v obsahu příspěvků a oblastech widgetů |
allow |
array | [] |
Seznam povolených vzorů názvů bloků; podporuje zástupné znaky fnmatch() |
deny |
array | [] |
Seznam zakázaných vzorů názvů bloků; má přednost před allow |
prefixes |
object | {} |
Prefix pro zkrácené názvy, každá hodnota je jmenný prostor nebo seřazené pole |
Vykreslování značek na úrovni šablony je vždy aktivní; tyto možnosti řídí nahrazování na úrovni stránky. Syntaxi značek a pravidla rozlišení najdete v tématu Vykreslování.
ui
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
enabled |
boolean | false |
Zaregistruje přibalené komponenty bsui/* UI a ukázkové aplikace app/* |
blockEditor
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
disableLoading |
boolean | false |
Zakáže načítání bloků v editoru |
enhance |
boolean | false |
Povolí funkce Blockstudio editoru při najetí a výběru |
cssClasses |
array | [] |
URL šablon stylů, ze kterých se extrahují třídy CSS pro automatické doplňování v poli tříd |
cssVariables |
array | [] |
URL šablon stylů, ze kterých se extrahují proměnné CSS pro automatické doplňování v poli kódu |
blockEditor.blocks
Pro zásady vkládání bloků v celém projektu použijte blockEditor.blocks. allow a deny přijímají názvy bloků a vzory se zástupnými znaky, napří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 ruší registraci stylů zaregistrovaných prostřednictvím registru stylů bloků PHP od WordPress:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Pomocí blockEditor.patterns zakažte globální zdroje vzorů a filtrujte kategorie vzorů.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Pro zásady vkládání médií v celém projektu použijte blockEditor.media.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
grab.enabled |
boolean | false |
Povolí nástroj pro výběr prvků ve frontendu |
perf |
boolean | false |
Povolí profiler výkonu při každém načtení stránky |
canvas.enabled |
boolean | false |
Povolí plátno |
canvas.adminBar |
boolean | true |
Při prohlížení plátna zobrazí administrátorský panel WordPress |
githooks
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
commit |
boolean | false |
Při spuštění blockstudio-githooks sync vytvoří předběžný potvrzovací háček určený pouze k analýze |
Informace o tom, co generovaný háček spouští a jak zůstává synchronizovaný, najdete v tématu Spravovaný potvrzovací háček.
phpstan
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
preset |
string | "base" |
Předvolba analýzy, pokud ji příkazový řádek neurčí: base, theme, extreme-theme nebo wordpress-render |
configuration |
string | "" |
Konfigurace projektu PHPStan zahrnutá vedle předvolby, určená z blockstudio.json |
roots |
array | ["."] |
Kořeny šablon analyzované kanonickým příkazem |
excludePaths |
array | [] |
Další vyloučení skeneru relativní ke každému nakonfigurovanému kořeni |
maxFiles |
integer | 10000 |
Maximální počet souborů kontrolovaných skenerem šablon |
blockTags |
object | {} |
Mapování prvků, aliasy značek a scanPhp pro pravidlo značek bloku |
Tato nastavení řídí kanonický příkaz blockstudio-phpstan. Předvolby, vrstvy a přijetí najdete v tématu PHPStan.
ai
| Možnost | Typ | Výchozí hodnota | Popis |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Vygeneruje kombinovaný kontextový soubor bloků, nastavení, schémat a dokumentace pro nástroje LLM |
Index dokumentace a celý vygenerovaný text najdete v tématu Integrace AI.
Povolte a kombinujte přibalené bezhlavé komponenty UI představené ve verzi Blockstudio 7.3.