Seaded
Blockstudio sisaldab võimsat seadete API, mis võimaldab määrata valikuid teemakaustas oleva blockstudio.json faili ja/või filtrite kaudu. Lisaks saavad lubatud kasutajad haldusalas seadeid visuaalselt muuta.
JSON kaudu
Kui teemakaustas on fail blockstudio.json, kasutatakse seda praeguse saidi vaikevalikute määramiseks. Faili valideerimiseks ja IDE-s automaattäite võimaldamiseks on saadaval JSON skeem.
Fail on valikuline. Kui seda pole, kasutab Blockstudio haldusalas salvestatud seadeid lisaks sisseehitatud vaikeväärtustele. Faili lisamine, muutmine või eemaldamine tuvastatakse automaatselt, seega pole vahemälu tühjendamine ega käsitsi uuesti laadimine vajalik.
Saadaval on järgmised atribuudid:
{
"$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
}
}
Filtrite kaudu
Teise võimalusena saate suurema paindlikkuse huvides määrata valikud PHP kaudu, kasutades filtrit blockstudio/settings/${setting}.
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');
Filtriga blockstudio/settings/${setting} määratud valikud alistavad failis blockstudio.json määratud valikud. Mõlemat meetodit saab kasutada koos.
Käitusaegsed väärtused pakuvad ka blockstudio/performance/${setting} filtreid ja üht viimast blockstudio/performance/config filtrit. Viimane peab tagastama kehtiva konfiguratsiooniobjekti.
Kuidas allikad kihistuvad
Kõik allikad laaditakse ja liidetakse, alustades madalaima prioriteediga allikast:
- Sisseehitatud vaikeväärtused
- Haldusliidese kaudu salvestatud seaded UI (valik
blockstudio_settings) - Teemas olev
blockstudio.json blockstudio/settings/*filtrid
blockstudio.json alistab ainult need võtmed, mille ta määratleb. Varem asendas see salvestatud seaded täielikult, mistõttu faili ilmumisel lakkas rakendumast mõni sõltumatu haldusalas salvestatud väärtus; nüüd lisatakse see nende peale. Teine külg on see, et haldusliidese kaudu salvestatud aegunud väärtus UI jääb rakenduma, kuni failis määratletakse vastav võti või salvestatud väärtus eemaldatakse. Kui seade käitub teisiti, kui failis kirjas, kontrollige salvestatud kihti käsuga wp bs settings või Settings::get_raw(), mis tagastab ainult selle, mille aktiivne allikas JSON või valikute allikas on sõnaselgelt määratlenud.
Seadete lugemine allikast PHP
Blockstudio\Settings laadib aktiivse allika, annab teada vigasest JSON-ist ning laadib automaatselt uuesti, kui blockstudio.json muutub:
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);
}
Kasutage Settings::get_raw(), kui integratsioon vajab ainult aktiivses JSON-s või suvandite allikas selgesõnaliselt deklareeritud väärtusi. Settings::fingerprint() tagastab deterministliku tõhusa seadistuse identifikaatori. Pikalt töötavad protsessid saavad failimuudatuse viivitamatuks lugemiseks kutsuda sõnaselgelt Settings::reload(). Tavapärase juurdepääsu korral kontrollitakse faili päringu või pikalt töötava PHP protsessi jooksul maksimaalselt kord sekundis, ka siis, kui muudetud fail on sama suurusega. Seadistatud tee muutmine jõustub järgmisel lugemisel. Kui ükski JSON fail pole aktiivne, ei lükata salvestatud andmebaasiseadistuste lugemist selle ajavahemiku võrra edasi.
Lahendatud jõudlusprofiil on saadaval atribuudi Blockstudio\Runtime_Settings::current() kaudu. See toetab kaldkriipsu või punktiga teid:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Saadaolevad seaded
users
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
ids |
massiiv | [] |
Redaktorile juurdepääsu omavate kasutajate ID-d |
roles |
massiiv | [] |
Redaktorile juurdepääsu omavad kasutajarollid |
assets
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
enqueue |
boolean | true |
Lisa ploki varad automaatselt järjekorda |
reset.enabled |
boolean | false |
Eemalda tuumiku plokistiilid ja rakenda redaktori utiliitide lähtestus |
reset.fullWidth |
array | [] |
Postituse tüübid, mis kasutavad täislaiuses redaktori paigutust |
minify.css |
boolean | false |
Minimeeri CSS väljund |
minify.js |
boolean | false |
Minimeeri JS väljund |
process.scss |
boolean | false |
Töötle SCSS faile |
output |
string | source |
Kompileeritud varade salvestuskoht: source või cache |
inlineLimit |
integer | 0 |
Välise ploki CSS baitide arv, mis prinditakse igal lehel tekstisiseselt |
output vaikeväärtus on source, mis loob iga ploki kõrvale kataloogi _dist. Määrake selle väärtuseks cache, et salvestada kompileeritud varad hoopis Blockstudio vahemälukataloogi. Nii jääb plokkide lähtekoodipuu puhtaks ja muutmatusest välja registreeritud koodikogust juurutatavaks. Allikate Blockstudio puhul kirjutatakse varad suunamisest sõltumata alati vahemällu.
inlineLimit on asukohas 0 välja lülitatud, mistõttu jääb igale välisele laaditabelile selle <link> silt. Määrake selle väärtuseks baitide arv, et printida lehe väikseimad välised laaditabelid hoopis tekstisiseselt, kui nende kogumaht jääb selle arvu piiresse. 40000 on sama reegli jaoks tuumiku kasutatav piirang WordPress. Vt jaotist Väikeste laaditabelite lisamine teksti.
Kui reset.enabled on aktiivne, kopeerib Blockstudio redaktori lõuendile ka puhastatud esiosa body_class väärtused. Kasutage blockstudio/editor/canvas/body_class, et kohandada ainult redaktoris kasutatavate klasside loendit.
cache
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
enabled |
tõeväärtus | true |
Luba Blockstudio failipõhised vahemälud |
path |
string | "blockstudio/cache" |
Vahemälu asukoht, suhteline WP_CONTENT_DIR suhtes või absoluutne |
namespaceGrace |
täisarv | 86400 |
Mitu sekundit hoida kasutuselt kõrvaldatud vahemälunimeruumi enne koristamist |
Vaikimisi kirjutatakse vahemälufailid asukohta wp-content/blockstudio/cache, üleslaadimiste kataloogist väljapoole. Suhteline path lahendatakse lähtepunktiga WP_CONTENT_DIR; absoluutset teed kasutatakse otse. See sobib majutusteenustega, mis pakuvad eraldi kirjutatavat vahemälu köidet.
Kui see on lubatud, kasutab Blockstudio seda üht juurkataloogi koosteväljundite, eelehitatud plokkide registreerimisandmete, lahendatud redaktorivarade, Tailwind CSS, renderdusdokumentide, saarefragmentide, staatiliste eeltöötluste, graafiindeksite, järjekordade ja diagnostika jaoks. Iga objekt eraldatakse võrgu, saidi, täieliku käituskeskkonna identiteedi ja skoobi järgi. Käituskeskkonna identiteet hõlmab väärtusi Blockstudio, seadeid, WordPress, PHP, aktiivset teemat, aktiivseid pluginaid, loogilisi avastamisallikaid, hosti konteksti ja toimingu omaniku antud selgesõnalisi sõltuvuste räsi.
Sisu-, termini-, kasutaja- ja metaandmete muudatused muudavad täidetud välja-valikud kehtetuks, kuid ei mõjuta struktuursete plokkide tuvastamist ega kompileeritud varasid. Valikud värskendatakse eraldi, fikseeritud koosteteekonna lukustuse all. Järjestikused kirjutused, näiteks tõlgete sünkroonimine või import, koondatakse: esimene kirjutus pärast vaikset perioodi käivitab värskenduse kohe ja viimane kirjutus kajastub pärast kolmekümne sekundi möödumist. Seda aega saab muuta sättega blockstudio/cache/populate_debounce. Metaandmed, mida WordPress kirjutab arvestuse pidamiseks, näiteks postituse muutmise lukk, ei lähe muudatusena arvesse; blockstudio/cache/populate_ignored_meta_keys täiendab seda loendit. Redaktor pärib alati aktiivseid valikuid, seega mõjutab ajavahemik ainult renderdamise ajal loetavaid vahemällu salvestatud valikuid. Lähtefailid ja koostesätted muudavad struktuurse vahemälu tavapäraselt kehtetuks. Valikute ülekirjutamine ei skanni iga sisumuudatuse korral vahemälukataloogi uuesti; perioodiline puhastamine eemaldab endiselt orvuks jäänud ajutised failid. Keelepõhised käitusaja identiteedid jäävad eraldatuks; mitme vahemälu nimeruumide kataloogi olemasolu mitmekeelsel saidil ei tõenda iseenesest vahemälu möödumist.
SQLite päevikukirjed ploki db andmekataloogis ei tühista ploki metaandmete vahemällu salvestamist. Muudatused asukohas db.php, jälgitavates lähtefailides või andmekataloogi lähtefailide ja alamkataloogide struktuuris muudavad vahemälu endiselt kehtetuks.
Samaaegsetel käituskeskkonna taasloomistel valitakse üks koostaja. Teised päringud ootavad kuni viis sekundit ja kasutavad seejärel viimast toimivat plokimetaandmestikku, kui selle lähtefailid ning vajalikud kompileeritud varad on endiselt olemas. Külm päring, mille jaoks puudub ohutu väljund, tagastab HTTP 503 koos väärtusega Retry-After, selle asemel et käivitada uut koostet. Filter blockstudio/cache/build_wait_budget määrab nii struktuuri taasloomiste kui ka valikute värskendamise ooteaja millisekundites. Hosti puhul, mis ei toeta nõuandvaid faililukke, värskendatakse valikuid lukustamata ja avaldatakse need ikkagi, nii et järgmine päring leiab need vahemälust.
Varasemate versioonide jäetud jõudeolekus olevad võtmespetsiifilised .build.lock failid kogutakse saidi kõigist vahemälunimeruumidest funktsiooniga WP-Cron. Kogumine algab viis minutit pärast uuendust ja eemaldab kuni 10,000 lukku minutis, kasutades selleks kuni kümme sekundit. wp bs cache status teatab allesjäänud arvu ja wp bs cache cleanup tühjendab järjekorra kohe; wp bs cache clear tühjendab käituskeskkonna vahemälu. Kui ajastatud töötlus hilineb üle kümne minuti, sest cron ei käivitu, skannivad päringud kord tunnis piiratud arvu lukke, et tühjendamine ei seiskuks. Hiljutised või hoitavad lukud jäetakse puutumata ning uusi kindla teega lukke ei koguta kunagi. Kui järjekord on tühjendatud, kogub sama töötlus mahajäetud vahemälunimeruumid pärast nende namespaceGrace möödumist. Seda tehakse saidi kohta kõige rohkem kord tunnis ning selleks jäetakse alles igapäevane käivitus. Ajapikendus algab esimesest skannimisest, mis tuvastab nimeruumi kasutuselt kõrvaldatuna, mitte selle uusima faili loomise hetkest. Nimeruumi, mis on mõne skoobi jaoks endiselt aktiivne, ei koguta kunagi.
Sisemine vahemälu puhastamine ei käivita manuste kustutamise filtreid WordPress. Hosti puhul, kus WP-Cron on keelatud, peab tavapärane ajastatud cron töötlus endiselt käima; ärge kustutage järjekorra tühjendamiseks valimatult aktiivseid lukufaile.
Seadistusfilter blockstudio/settings/cache/path muudab seadistatud väärtust. Juurutuspõhise teelahenduse jaoks filtreerib blockstudio/cache/dir lahendatud baaskataloogi:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Hostid, mille rentniku identiteet erineb võrgu või ajaveebi ID-dest WordPress, saavad filtreerida väärtust blockstudio/cache/site_key. Tulemus puhastatakse ja seda kasutatakse ainult kataloogitee segmendina. Jadastatava käitusvariandi jaoks, mis peab muutma objektide identiteete, on õige koht endiselt blockstudio/cache/context.
themeDefaults
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
titleTag |
tõeväärtus | false |
Luba WordPress tiitlisildi teematoetus |
suppressDirectoryUpdates |
tõeväärtus | false |
Eemalda aktiivsed alam- ja ülemteemad kataloogi uuendamise tulemustest |
Mustrid kasutavad jätkuvalt olemasolevat Blockstudio\Patterns API; need vaikeväärtused ei lisa alternatiivseid lehe- ega mustrifassaade.
performance
Profiil compat jätab üldise käitumise WordPress muutmata. speed ja strict lubavad sama valikulise esiosa vaikekonfiguratsiooni; iga alamseade saab profiili väärtuse alistada.
Valikulised seaded on registreerimisväravad. Kui valikuline funktsioon on false, ei lisa Blockstudio selle funktsiooni esiosa-, haldus-, redaktori-, REST- ega ajastatud tagasihelistusi. Kui Early Serve või ajastatud soojendamine pärast kasutamist välja lülitada, teeb see ühe korra ära enda hallatava puhastuse; edaspidised päringud ei tee midagi.
| Valik | Tüüp | Ühilduvuse vaikeväärtus | Kiiruse/ranguse vaikeväärtus | Kirjeldus |
|---|---|---|---|---|
profile |
string | "compat" |
Pole kohaldatav | compat, speed või strict |
wordpress.headNoise |
boolean | false |
true |
Eemalda üldine päise tuvastamine ja emotikonide väljund |
wordpress.embeds |
boolean | false |
true |
Eemalda oEmbed-i tuvastamine ja hosti skriptid |
wordpress.xmlrpc |
boolean | false |
true |
Keela XML-RPC ja pingbackid |
wordpress.editor |
boolean | false |
true |
Keela kaugredaktori tuvastuspinnad |
wordpress.frontendAssets |
boolean | false |
true |
Eemalda üldised tuuma esiotsa varad |
wordpress.media |
boolean | false |
true |
Rakenda piltide väljundi vaikeväärtused |
wordpress.heartbeat |
boolean | false |
true |
Piira Heartbeati kasutamist väljaspool redaktoreid |
preload.links |
string | "off" |
"intent" |
Eellaadi samalt päritolult dokumente pärast kasutaja tegevust |
media.lazy |
boolean | false |
true |
Kasuta Blockstudio pildilaadurit |
media.skeleton |
boolean | false |
true |
Kuva sisseehitatud laadimise kohatäide |
media.metadata |
boolean | false |
true |
Teata assets/media.json kasutamisest |
media.rootMargin |
string | "300px" |
"300px" |
Laaduri lõikumisvahemik |
measurement.enabled |
boolean | false |
false |
Luba käitusaja mõõtmis-API-d |
measurement.queryMonitor |
boolean | false |
false |
Kaasa päringud, mis kestavad vähemalt 50ms |
measurement.headers |
boolean | false |
false |
Saada profiili ja konfiguratsiooni räsi päised |
measurement.timings |
boolean | false |
false |
Saada käitusaja kestuse päis |
staticPrerender.enabled |
boolean | false |
false |
Luba anonüümsust säilitav HTML vahemällu salvestamine |
staticPrerender.ttl |
integer | 86400 |
86400 |
Vahemällu salvestatud dokumendi maksimaalne vanus sekundites |
staticPrerender.invalidate |
string | "signature" |
"signature" |
Kasuta signature või järkjärgulist graph identiteeti |
staticPrerender.earlyServe |
boolean | false |
false |
Esita turvalised vahemälutabamused enne, kui WordPress käivitub |
staticPrerender.serveLoggedIn |
boolean | false |
false |
Luba kasutajatel vahemälutabamusi kasutada, kuid mitte luua |
staticPrerender.dynamicPaths |
array | [] |
[] |
Teeprefiksid, mis peavad jääma dünaamiliseks |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Vahemälutabamustega salvestatavad ja nende korral saadetavad vastuse päised |
staticPrerender.warm.enabled |
boolean | false |
false |
Luba püsiv ajastatud soojendamisjärjekord |
staticPrerender.warm.interval |
integer | 3600 |
3600 |
Soojendamise intervall sekundites |
staticPrerender.warm.concurrency |
integer | 2 |
2 |
Ühe soojenduskorraga töödeldavate tööde maksimaalne arv |
staticPrerender.warm.transport |
string | "http" |
"http" |
Kasuta http või hosti pakutavat internal renderdajat |
Staatiline eelrenderdamine jääb keelatuks, kuni seda pole sõnaselgelt lubatud. Keelatud pealüliti ei registreeri eelrenderdamise päringuhaake ning keelatud lülitid earlyServe ja warm.enabled ei registreeri admini- ega cron-haake. Allkirjarežiim kasutab tavaliste päringute korral odavat aktiveeritud identiteeti. Graafirežiim on mõeldud selgesõnalisteks järkudeks: see salvestab iga lehe lähteandmete sõltuvused, nii et ühe lehe muutmine ei tühista seosetute dokumentide kehtivust. Vt Staatiline eelrenderdamine soojendamise, juurutamise, varajase esitamise ja ohutuse üksikasju.
Mõõtmised on saadaval programmiliselt:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Kui päised on lubatud, saadab Blockstudio päised X-Blockstudio-Performance-Profile,
X-Blockstudio-Performance-Config ja soovi korral ka X-Blockstudio-Performance-Time. Tegevus blockstudio/performance/measurement_enabled saab lahendatud käitusajasätted.
Valikud media juhivad bs_media_image()-i, assets/media.json-manifesti ja esikülje laisklaadurit. Abifunktsiooni, manifestikoosturi ja laaduri käitumise kohta vt Meedia.
content
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
enabled |
boolean | false |
Luba Content Synci konfiguratsioon |
id |
string | "default" |
Sünkroonitud olemitele salvestatav sisukogumi nimeruum |
path |
string | "content" |
Teemaga seotud sisufailide kataloog |
includePageSyncManaged |
boolean | false |
Kaasa Page Synci hallatavad postitused nende sisu omamata |
authors |
string | "ignore" |
Autori käsitlemine (ignore või olemasoleva kasutaja login) |
postTypes |
array | [] |
Lubatud postitusetüübid |
meta.include |
array | [] |
Meta-võtmete sünkroonitavate glob-mustrid |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Välistatavate meta-võtmete glob-mustrid |
meta.references |
object | {} |
Määratud meta-viited, mis kirjutatakse ID-de ja UID-de vahel ümber |
taxonomies |
array | [] |
Lubatud registreeritud taksonoomiad terminite ja seoste jaoks |
media |
string | "manifest" |
Manuseviite käitumine (manifest või none) |
Content Synci hallatakse valiku wp bs content kaudu ning see ekspordib lubatud postitused,
postituse metaandmed ja määratud viited teisaldatavatesse failidesse. Vt
Content Sync töövoo ja failivormingu kohta.
editor
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
formatOnSave |
boolean | false |
Vorminda salvestamisel block.json |
assets |
array | [] |
Täiendavad varad, mis redaktorisse laadida |
markup |
boolean | false |
Luba märgistuse muutmine |
tailwind
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
enabled |
boolean | false |
Luba Tailwind CSS kompileerimine |
config |
string | "" |
Tailwind-i v4 CSS-i põhine konfiguratsioon |
Vt Tailwind CSS kompileerimise käitumise ja CSS-i põhise konfiguratsioonivormingu kohta.
blockTags
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
enabled |
boolean | false |
Luba lehepõhine bs:-siltide renderdamine postituse sisus ja vidinate aladel |
allow |
array | [] |
Plokinimede mustrite lubatud loend; toetab fnmatch() metamärke |
deny |
array | [] |
Plokinimede mustrite keelatud loend; on ülimuslik valiku allow suhtes |
prefixes |
object | {} |
Lühivormide nimeruumide prefiks; iga väärtus on nimeruum või järjestatud massiiv |
Malli tasemel siltide renderdamine on alati aktiivne; need valikud juhivad lehe tasemel asendamist. Siltide süntaksi ja lahendusreeglite kohta vt Renderdamine.
ui
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
enabled |
boolean | false |
Registreeri komplekti kuuluvad bsui/* UI komponendid ja app/* näidisrakendused |
blockEditor
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
disableLoading |
boolean | false |
Keela plokkide laadimine redaktoris |
enhance |
boolean | false |
Luba Blockstudio redaktoris hõljutamise ja valimise juhtnupud |
cssClasses |
array | [] |
Stiililehe URL-id, kust eraldada CSS klassid klassivälja automaatseks täitmiseks |
cssVariables |
array | [] |
Stiililehe URL-id, kust eraldada CSS muutujad koodivälja automaatseks täitmiseks |
blockEditor.blocks
Kasuta valikut blockEditor.blocks kogu projekti ploki lisaja reeglite määramiseks. allow ja deny aktsepteerivad plokinimesid ja metamärgiga mustreid, näiteks 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 tühistab registreeritud stiilide registreeringu, mille allikaks oli WordPress-i PHP-plokistiilide register:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Kasuta valikut blockEditor.patterns globaalsete mustriallikate keelamiseks ja mustrikategooriate filtreerimiseks.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Kasuta valikut blockEditor.media globaalsete meedia lisaja reeglite määramiseks.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
grab.enabled |
boolean | false |
Luba esikülje elementide valija |
perf |
boolean | false |
Luba jõudlusprofiil igal lehe laadimisel |
canvas.enabled |
boolean | false |
Luba lõuend |
canvas.adminBar |
boolean | true |
Kuva lõuendi vaatamisel WordPress adminiriba |
githooks
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
commit |
boolean | false |
Loo ainult analüüsi tegev eelkinnituse haak, kui käivitub blockstudio-githooks sync |
Vt hallatav sissekandehaak, et teada saada, mida loodud haak käivitab ja kuidas see sünkroonis püsib.
phpstan
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
preset |
string | "base" |
Analüüsi eelseadistus, kui käsurealt pole seda valitud: base, theme, extreme-theme või wordpress-render |
configuration |
string | "" |
Projekti PHPStan konfiguratsioon, mis kaasatakse koos eelseadistusega ja lahendatakse asukohast blockstudio.json |
roots |
array | ["."] |
Kanoonilise käsu analüüsitavad teemajuured |
excludePaths |
array | [] |
Täiendavad skanneri välistused iga seadistatud juure suhtes |
maxFiles |
integer | 10000 |
Teemaskanneri uuritavate failide maksimumarv |
blockTags |
object | {} |
Elemendivastendused, sildialias’ed ja scanPhp plokisildi reegli jaoks |
Need sätted juhivad kanoonilist käsku blockstudio-phpstan. Eelseadistuste, kihtide ja kasutuselevõtu kohta vt PHPStan.
ai
| Valik | Tüüp | Vaikeväärtus | Kirjeldus |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Loo plokkidest, sätetest, skeemidest ja dokumentatsioonist koondatud kontekstifail LLM-tööriistadele |
Dokumentatsiooni registri ja kogu loodud teksti kohta vt AI-lõiming.
Luba ja kombineeri komplekti kuuluvaid peata UI komponente, mis võeti kasutusele versioonis Blockstudio 7.3.