Nastavitve
Blockstudio vključuje zmogljiv sistem nastavitev API, ki omogoča določanje možnosti z datoteko blockstudio.json v mapi teme in/ali s filtri. Poleg tega lahko pooblaščeni uporabniki vizualno spreminjajo nastavitve v skrbniškem območju.
Prek JSON
Če je v mapi teme datoteka blockstudio.json, bo uporabljena za določitev privzetih možnosti za trenutno spletno mesto. Na voljo je shema JSON za preverjanje datoteke in pomoč pri samodokončanju v IDE-ju.
Datoteka ni obvezna. Če je ni, Blockstudio uporabi nastavitve, shranjene v skrbniškem območju, poleg svojih vgrajenih privzetih vrednosti. Dodajanje, spreminjanje ali odstranjevanje datoteke se zazna samodejno, zato ni treba počistiti predpomnilnika ali ročno znova naložiti strani.
Na voljo so naslednje lastnosti:
{
"$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
}
}
Prek filtrov
Druga možnost je, da uporabite filter blockstudio/settings/${setting} za določanje možnosti prek PHP, kar zagotavlja več prilagodljivosti.
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, nastavljene s filtrom blockstudio/settings/${setting}, preglasijo tiste, nastavljene z datoteko blockstudio.json. Uporabite lahko oba načina hkrati.
Vrednosti med izvajanjem izpostavljajo tudi filtre blockstudio/performance/${setting} in še en
končni filter blockstudio/performance/config. Zadnji mora vrniti veljaven
konfiguracijski objekt.
Kako se viri združujejo
Vsak vir se naloži in združi, začenši z najnižjo prednostno ravnjo:
- Vgrajene privzete vrednosti
- Nastavitve, shranjene prek skrbniške UI (možnost
blockstudio_settings) blockstudio.jsonv temi- Filtri
blockstudio/settings/*
blockstudio.json preglasi samo ključe, ki jih določa. Prej je v celoti nadomestil
shranjene nastavitve, zato se nepovezana vrednost, shranjena v skrbniškem
območju, po pojavu datoteke ni več uporabljala; zdaj se uporabi nad njimi. Po drugi strani pa se zastarela vrednost,
shranjena prek skrbniške UI, še naprej uporablja, dokler datoteka ne določi tega
ključa ali dokler shranjena vrednost ni odstranjena. Če se nastavitev obnaša drugače, kot določa
datoteka, preverite shranjeno plast z wp bs settings ali
Settings::get_raw(), ki vrne samo tisto, kar je aktivni vir JSON ali možnosti
izrecno določil.
Branje nastavitev iz PHP
Blockstudio\Settings naloži aktivni vir, sporoči nepravilno oblikovan JSON in
se samodejno znova naloži, ko se spremeni 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);
}
Uporabite Settings::get_raw(), kadar integracija potrebuje samo vrednosti, izrecno določene v aktivnem JSON ali viru možnosti. Settings::fingerprint() vrne deterministično identiteto učinkovitih nastavitev. Dolgotrajno delujoči procesi lahko izrecno pokličejo Settings::reload(), da spremembo datoteke takoj zaznajo. Ob običajnem dostopu se datoteka preveri največ enkrat na sekundo znotraj zahteve ali dolgotrajno delujočega procesa PHP, tudi pri spremembah, ki ohranijo velikost. Sprememba nastavljene poti začne veljati pri naslednjem branju. Če datoteka JSON ni aktivna, shranjene nastavitve iz zbirke podatkov niso odložene zaradi tega časovnega okna.
Razrešeni profil zmogljivosti je na voljo prek
Blockstudio\Runtime_Settings::current(). Podpira poti z ločili poševnica ali pika:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Razpoložljive nastavitve
users
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
ids |
polje | [] |
ID-ji uporabnikov z dostopom do urejevalnika |
roles |
polje | [] |
Vloge uporabnikov z dostopom do urejevalnika |
assets
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
enqueue |
boolean | true |
Samodejno dodajanje sredstev blokov v čakalno vrsto |
reset.enabled |
boolean | false |
Odstrani sloge osnovnih blokov in uporabi ponastavitev pripomočkov urejevalnika |
reset.fullWidth |
array | [] |
Vrste objav, ki uporabljajo celozaslonsko postavitev urejevalnika |
minify.css |
boolean | false |
Minificiraj izhod CSS |
minify.js |
boolean | false |
Minificiraj izhod JS |
process.scss |
boolean | false |
Obdelaj datoteke SCSS |
output |
string | source |
Mesto zapisa prevedenih sredstev: source ali cache |
inlineLimit |
integer | 0 |
Število bajtov zunanjega bloka CSS, izpisanega v vrstici na stran |
output je privzeto nastavljen na source, kar ustvari mapo _dist ob vsakem bloku. Nastavite ga na cache, da se prevedena sredstva zapišejo v mapo predpomnilnika Blockstudio, s čimer drevo izvorne kode blokov ostane čisto in ga je mogoče uvesti iz nespremenljivega odjavljanja. Viri Blockstudio, ki ne morejo pisati v že preusmerjene datoteke, se ne glede na to nastavitev preusmerijo v predpomnilnik.
inlineLimit je pri 0 izklopljen, zato vsaka zunanja slogovna datoteka ohrani svojo oznako <link>. Nastavite ga na število bajtov, da se v vrstici izpišejo najmanjše zunanje slogovne datoteke blokov na strani, dokler njihova skupna velikost ne presega te vrednosti. 40000 je omejitev, ki jo za isto pravilo uporablja jedro WordPress. Glejte Vstavljanje majhnih slogovnih datotek v vrstico.
Ko je reset.enabled aktivna, Blockstudio v platno urejevalnika kopira tudi očiščene vrednosti body_class za sprednji del. Seznam razredov, ki velja samo za urejevalnik, lahko prilagodite z blockstudio/editor/canvas/body_class.
cache
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
enabled |
logična vrednost | true |
Omogoči predpomnilnike na podlagi datotek Blockstudio |
path |
niz | "blockstudio/cache" |
Pot predpomnilnika, relativna glede na WP_CONTENT_DIR ali absolutna |
namespaceGrace |
celo število | 86400 |
Število sekund, ki jih upokojeni imenski prostor predpomnilnika ostane na voljo pred čiščenjem |
Datoteke predpomnilnika se privzeto zapisujejo v wp-content/blockstudio/cache, zunaj mape za prenose. Relativna pot path se razreši glede na WP_CONTENT_DIR; absolutna pot se uporabi neposredno. To podpira gostitelje, ki zagotavljajo namenski zapisljiv nosilec za predpomnilnik.
Ko je omogočen, Blockstudio uporablja to eno korensko mapo za gradbene podatkovne pakete, vnaprej pripravljene podatke o registraciji blokov, razrešena sredstva urejevalnika, Tailwind CSS, dokumente izrisov, fragmente otočkov, statične predizrise, indekse grafov, čakalne vrste in diagnostiko. Vsak objekt je ločen glede na omrežje, spletno mesto, celotno identiteto izvajalnega okolja in obseg. Identiteta izvajalnega okolja zajema Blockstudio, nastavitve, WordPress, PHP, aktivno temo, aktivne vtičnike, logične vire odkrivanja, kontekst gostitelja in izrecne zgoščene vrednosti odvisnosti, ki jih zagotovi operacija, ki je zanje odgovorna.
Spremembe vsebine, izrazov, uporabnikov in metapodatkov razveljavijo izpolnjene izbire polj, ne pa strukturnega odkrivanja blokov ali prevedenih sredstev. Izbire se osvežujejo ločeno, pri čemer velja zaklep za fiksno pot gradnje. Niz zaporednih zapisov, na primer sinhronizacija prevodov ali uvoz, se združi: prvi zapis po obdobju mirovanja sproži takojšnjo osvežitev, zadnji zapis v nizu pa se upošteva po preteku tridesetih sekund; ta čas je mogoče prilagoditi z blockstudio/cache/populate_debounce. Metapodatki, ki jih WordPress zapisuje kot evidenco, na primer zaklep urejanja objave, se ne štejejo kot sprememba; blockstudio/cache/populate_ignored_meta_keys ta seznam razširja. Urejevalnik vedno poizveduje po trenutno veljavnih možnostih, zato časovno okno vpliva samo na predpomnjene izbire, prebrane ob izrisu. Izvorne datoteke in nastavitve gradnje še naprej običajno razveljavijo strukturni predpomnilnik. Pri prepisovanju izbir se ob vsaki spremembi vsebine ne pregleduje znova imenika predpomnilnika; redno čiščenje še vedno odstranjuje osirotele začasne datoteke. Identitete izvajalnega okolja za posamezne jezike ostanejo ločene; več imenikov imenskih prostorov predpomnilnika na večjezičnem spletnem mestu samo po sebi ne dokazuje, da je prišlo do izpada predpomnilnika.
Dnevniške dejavnosti SQLite znotraj podatkovnega imenika bloka db ne zavržejo predpomnjenih metapodatkov bloka. Spremembe db.php, nadzorovanih izvornih datotek ali strukture izvornih datotek in podimenikov v podatkovnem imeniku še vedno razveljavijo predpomnilnik.
Pri sočasni ponovni gradnji izvajalnega okolja je izbran en graditelj. Druge zahteve čakajo do pet sekund, nato pa znova uporabijo zadnje dobre metapodatke bloka, če njegove izvorne datoteke in zahtevana prevedena sredstva še obstajajo. Hladna zahteva brez varnega podatkovnega paketa vrne HTTP 503 z Retry-After, namesto da bi začela novo gradnjo. Filter blockstudio/cache/build_wait_budget prilagodi čas čakanja v milisekundah za strukturne ponovne gradnje in osvežitve izbir. Gostitelj brez svetovalnih zaklepov datotek osveži izbire brez zaščite in jih vseeno objavi, zato bo naslednja zahteva dosegla zadetek.
Nedejavne datoteke .build.lock za posamezne ključe, ki so jih pustile prejšnje različice, se v vseh imenskih prostorih predpomnilnika tega spletnega mesta odstranijo z WP-Cron. Čiščenje se začne pet minut po nadgradnji in v desetsekundnem časovnem okviru odstrani do 10,000 zaklepov na minuto. wp bs cache status poroča o preostalem številu, wp bs cache cleanup pa takoj izprazni zaostanek; wp bs cache clear počisti izvajalni predpomnilnik. Če je načrtovani paket zaradi neproženja cron več kot deset minut v zamudi, zahteve enkrat na uro pregledajo omejeno število zaklepov, da se čiščenje ne ustavi. Nedavni ali zasedeni zaklepi ostanejo nedotaknjeni, novi zaklepi z nespremenljivo potjo pa se nikoli ne odstranijo. Ko je zaostanek odpravljen, isti paket odstrani opuščene imenske prostore predpomnilnika, ko preteče njihov namespaceGrace, največ enkrat na uro za posamezno spletno mesto, in zanje ohranja dnevni sprožilec. Čas mirovanja se šteje od prvega pregleda, ki ugotovi, da je imenski prostor opuščen, ne od njegove najnovejše datoteke; imenski prostor, ki je še vedno aktualen za kateri koli obseg, se nikoli ne odstrani.
Notranje čiščenje predpomnilnika ne sproži filtrov WordPress za brisanje prilog.
Gostitelji z onemogočenim WP-Cron morajo še naprej izvajati običajni načrtovani delavec cron; za izpraznitev zaostanka ne brišite vseh aktivnih datotek zaklepanja.
Filter nastavitev blockstudio/settings/cache/path spremeni konfigurirano
vrednost. Za razreševanje poti, prilagojeno uvajanju, filter blockstudio/cache/dir
razreši osnovno mapo:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Gostitelji z identiteto najemnika, ki se razlikuje od ID-jev omrežja ali spletnika WordPress, lahko filtrirajo blockstudio/cache/site_key. Rezultat se očisti in uporabi samo kot segment imenika. blockstudio/cache/context ostaja pravo mesto za serializabilno različico izvajalnega okolja, ki mora spremeniti identitete objektov.
themeDefaults
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
titleTag |
logična vrednost | false |
Omogoči podporo teme za oznake naslovov WordPress |
suppressDirectoryUpdates |
logična vrednost | false |
Odstrani aktivne podrejene in nadrejene teme iz rezultatov posodobitev imenikov |
Vzorci še naprej uporabljajo obstoječo Blockstudio\Patterns API; te privzete vrednosti ne uvajajo drugih vmesnikov za strani ali vzorce.
performance
Profil compat pusti splošno vedenje WordPress nespremenjeno. speed in strict omogočata enake privzete nastavitve za sprednji del, ki se vključijo po izbiri; vsako podrejeno nastavitev je mogoče nastaviti drugače kot vrednost profila.
Nastavitve za izbirno uporabo so prehodi za registracijo. Ko je izbirna funkcija false, Blockstudio ne pripne povratnih klicev za njen sprednji del, skrbniško območje, urejevalnik, REST ali načrtovane naloge. Če po uporabi funkcije Early Serve ali načrtovanega predhodnega segrevanja onemogočite, se enkrat izvede čiščenje virov, ki jih upravljajo. Poznejše zahteve ne sprožijo nobenega dejanja.
| Možnost | Vrsta | Privzeto za združljivost | Privzeto za hitrost/strogo delovanje | Opis |
|---|---|---|---|---|
profile |
string | "compat" |
Ni na voljo | compat, speed ali strict |
wordpress.headNoise |
boolean | false |
true |
Odstrani splošno odkrivanje v glavi in izpis emodžijev |
wordpress.embeds |
boolean | false |
true |
Odstrani odkrivanje oEmbed in skripte gostitelja |
wordpress.xmlrpc |
boolean | false |
true |
Onemogoči XML-RPC in povratne objave |
wordpress.editor |
boolean | false |
true |
Onemogoči oddaljene površine za odkrivanje urejevalnika |
wordpress.frontendAssets |
boolean | false |
true |
Odstrani splošna sredstva jedra za sprednji del |
wordpress.media |
boolean | false |
true |
Uporabi privzete nastavitve izhoda slik |
wordpress.heartbeat |
boolean | false |
true |
Omeji Heartbeat zunaj urejevalnikov |
preload.links |
string | "off" |
"intent" |
Po nameri uporabnika vnaprej pridobi dokumente istega izvora |
media.lazy |
boolean | false |
true |
Uporabi nalagalnik slik v Blockstudio |
media.skeleton |
boolean | false |
true |
Prikaži vgrajen skelet med nalaganjem |
media.metadata |
boolean | false |
true |
Označi uporabo assets/media.json |
media.rootMargin |
string | "300px" |
"300px" |
Rob preseka za leno nalaganje |
measurement.enabled |
boolean | false |
false |
Omogoči API-je za merjenje med izvajanjem |
measurement.queryMonitor |
boolean | false |
false |
Vključi poizvedbe, ki trajajo vsaj 50ms |
measurement.headers |
boolean | false |
false |
Pošlji glave s profilom in zgoščeno vrednostjo konfiguracije |
measurement.timings |
boolean | false |
false |
Pošlji glavo s časom izvajanja |
staticPrerender.enabled |
boolean | false |
false |
Omogoči predpomnjenje HTML, varno za anonimne uporabnike |
staticPrerender.ttl |
integer | 86400 |
86400 |
Največja starost predpomnjenega dokumenta v sekundah |
staticPrerender.invalidate |
string | "signature" |
"signature" |
Uporabi identiteto signature ali inkrementalno graph |
staticPrerender.earlyServe |
boolean | false |
false |
Posreduj varne zadetke, še preden se zažene WordPress |
staticPrerender.serveLoggedIn |
boolean | false |
false |
Dovoli uporabnikom uporabo zadetkov iz predpomnilnika, nikoli pa njihovega ustvarjanja |
staticPrerender.dynamicPaths |
array | [] |
[] |
Predpone poti, ki morajo ostati dinamične |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Glave odziva, shranjene skupaj z zadetki iz predpomnilnika in poslane ob njihovi uporabi |
staticPrerender.warm.enabled |
boolean | false |
false |
Omogoči trajno načrtovano čakalno vrsto za ogrevanje |
staticPrerender.warm.interval |
integer | 3600 |
3600 |
Interval ogrevanja v sekundah |
staticPrerender.warm.concurrency |
integer | 2 |
2 |
Največje število opravil, obdelanih v enem prehodu ogrevanja |
staticPrerender.warm.transport |
string | "http" |
"http" |
Uporabite http ali izrisovalnik, ki ga zagotovi gostitelj internal |
Statično predizrisovanje ostane onemogočeno, razen če ga izrecno omogočite. Onemogočeno glavno stikalo ne registrira nobenih kavljev za zahteve predizrisovanja, onemogočeni stikali earlyServe in warm.enabled pa ne registrirata nobenih skrbniških kavljev ali kavljev cron. Način s podpisom pri običajnih zahtevah uporablja poceni aktivirano identiteto. Način grafa je namenjen izrecnim gradnjam: beleži odvisnosti izvornih datotek za posamezne strani, zato sprememba ene strani ne razveljavi nepovezanih dokumentov. Za podrobnosti o ogrevanju, uvajanju, zgodnjem streženju in varnosti glejte Statično predizrisovanje.
Meritve so na voljo programsko:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Ko so glave omogočene, Blockstudio pošlje
X-Blockstudio-Performance-Profile,
X-Blockstudio-Performance-Config in po želji
X-Blockstudio-Performance-Time. Dejanje
blockstudio/performance/measurement_enabled prejme razrešene
nastavitve izvajanja.
Možnosti media usmerjajo bs_media_image(), manifest assets/media.json
in leni nalagalnik za sprednji del. Za pomočnik, graditelj manifesta in delovanje nalagalnika glejte Mediji.
content
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
enabled |
logična vrednost | false |
Omogoči konfiguracijo Content Sync |
id |
niz | "default" |
Imenski prostor nabora vsebine, shranjen v sinhroniziranih entitetah |
path |
niz | "content" |
Imenik z datotekami vsebine glede na temo |
includePageSyncManaged |
logična vrednost | false |
Vključi objave, ki jih upravlja Page Sync, ne da bi prevzel njihovo vsebino |
authors |
niz | "ignore" |
Ravnanje z avtorji (ignore ali obstoječi uporabnik login) |
postTypes |
polje | [] |
Seznam dovoljenih vrst objav |
meta.include |
polje | [] |
Vzorci glob za sinhronizacijo ključev metapodatkov |
meta.exclude |
polje | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Vzorci glob za izključitev ključev metapodatkov |
meta.references |
objekt | {} |
Deklarirane reference metapodatkov, prepisane med ID-ji in UID-ji |
taxonomies |
polje | [] |
Seznam dovoljenih registriranih taksonomij za izraze in razmerja |
media |
niz | "manifest" |
Obnašanje referenc na priloge (manifest ali none) |
Content Sync se upravlja prek wp bs content in izvozi dovoljene objave,
postmeta ter deklarirane reference v prenosljive datoteke. Za potek dela in obliko datotek glejte
Content Sync.
editor
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
formatOnSave |
logična vrednost | false |
Ob shranjevanju oblikuj block.json |
assets |
polje | [] |
Dodatna sredstva za nalaganje v urejevalniku |
markup |
logična vrednost | false |
Omogoči urejanje označevalnega jezika |
tailwind
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
enabled |
logična vrednost | false |
Omogoči prevajanje Tailwind CSS |
config |
niz | "" |
Konfiguracija po načelu Tailwind v4 CSS |
Za delovanje prevajanja in obliko konfiguracije po načelu CSS glejte Tailwind CSS.
blockTags
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
enabled |
logična vrednost | false |
Omogoči izrisovanje oznak bs: na ravni strani v vsebini objav in območjih gradnikov |
allow |
polje | [] |
Seznam dovoljenih vzorcev imen blokov; podpira nadomestne znake fnmatch() |
deny |
polje | [] |
Seznam prepovedanih vzorcev imen blokov; ima prednost pred allow |
prefixes |
objekt | {} |
Predpona za kratke zapise, vsaka vrednost pa je imenski prostor ali urejeno polje |
Izrisovanje oznak na ravni predloge je vedno aktivno; te možnosti nadzorujejo zamenjavo na ravni strani. Za pravila označevanja in razreševanja glejte Izrisovanje.
ui
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
enabled |
logična vrednost | false |
Registriraj priložene komponente bsui/* UI in predstavitvene aplikacije app/* |
blockEditor
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
disableLoading |
logična vrednost | false |
Onemogoči nalaganje blokov v urejevalniku |
enhance |
logična vrednost | false |
Omogoči možnosti za pomik kazalca in izbiro v urejevalniku Blockstudio |
cssClasses |
polje | [] |
URL-ji slogovnih datotek, iz katerih se pridobijo razredi CSS za samodokončevanje polja razredov |
cssVariables |
polje | [] |
URL-ji slogovnih datotek, iz katerih se pridobijo spremenljivke CSS za samodokončevanje polja kode |
blockEditor.blocks
Za pravilnik vstavljalnika blokov za celoten projekt uporabite blockEditor.blocks. allow in deny sprejemata imena blokov in vzorce z nadomestnimi znaki, kot je 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 odregistrira sloge, registrirane prek registra slogov blokov WordPress:
PHP
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Z blockEditor.patterns onemogočite globalne vire vzorcev in filtrirate
kategorije vzorcev.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Za globalni pravilnik vstavljalnika predstavnosti uporabite blockEditor.media.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
grab.enabled |
logična vrednost | false |
Omogoči zajemalnik elementov na sprednjem delu |
perf |
logična vrednost | false |
Omogoči profilirnik zmogljivosti ob vsakem nalaganju strani |
canvas.enabled |
logična vrednost | false |
Omogoči platno |
canvas.adminBar |
logična vrednost | true |
Med ogledom platna prikaži skrbniško vrstico WordPress |
githooks
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
commit |
logična vrednost | false |
Ustvari kavelj za preverjanje pred potrditvijo, ki izvaja samo analizo, ko se zažene blockstudio-githooks sync |
Za informacije o tem, kaj izvaja ustvarjeni kavelj in kako ostaja usklajen, glejte upravljani kavelj za potrditev.
phpstan
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
preset |
niz | "base" |
Prednastavitev analize, če je ukazna vrstica ne izbere: base, theme, extreme-theme ali wordpress-render |
configuration |
niz | "" |
Konfiguracija projekta PHPStan, vključena poleg prednastavitve in razrešena iz blockstudio.json |
roots |
polje | ["."] |
Korenine tem, ki jih analizira kanonični ukaz |
excludePaths |
polje | [] |
Dodatne izključitve pregledovalnika glede na vsako nastavljeno korenino |
maxFiles |
celo število | 10000 |
Največje število datotek, ki jih pregleda pregledovalnik tem |
blockTags |
objekt | {} |
Preslikave elementov, vzdevki oznak in scanPhp za pravilo oznake pravilo blokovne oznake |
Te nastavitve usmerjajo kanonični ukaz blockstudio-phpstan. Za prednastavitve, plasti in uvedbo glejte PHPStan.
ai
| Možnost | Vrsta | Privzeto | Opis |
|---|---|---|---|
enableContextGeneration |
logična vrednost | false |
Ustvari združeno kontekstno datoteko z bloki, nastavitvami, shemami in dokumentacijo za orodja LLM |
Za kazalo dokumentacije in celotno ustvarjeno besedilo glejte Integracija AI.
Omogočite in sestavite priložene brezglavne komponente UI, uvedene v različici Blockstudio 7.3.