Nustatymai
Blockstudio turi galingą nustatymų API, leidžiantį nustatyti parinktis naudojant blockstudio.json failą temos aplanke ir (arba) filtrus. Be to, teises turintys naudotojai gali keisti nustatymus vizualiai administravimo srityje.
Per JSON
Jei temos aplanke yra blockstudio.json failas, jis bus naudojamas numatytosioms dabartinės svetainės parinktims nustatyti. Failo tikrinimui ir automatinio užbaigimo palaikymui IDE aplinkoje galima naudoti JSON schemą.
Šis failas neprivalomas. Jei jo nėra, Blockstudio naudoja administravimo srityje išsaugotus nustatymus ir savo įtaisytąsias numatytąsias reikšmes. Failo pridėjimas, keitimas ar pašalinimas aptinkamas automatiškai, todėl nereikia išvalyti talpyklos ar perkrauti rankiniu būdu.
Galimos šios savybės:
{
"$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
}
}
Per filtrus
Arba galite naudoti filtrą blockstudio/settings/${setting} ir nustatyti parinktis per PHP, kad turėtumėte daugiau lankstumo.
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');
Per filtrą blockstudio/settings/${setting} nustatytos parinktys turi pirmenybę prieš nustatytas faile blockstudio.json. Abu būdus galima naudoti kartu.
Vykdymo metu pasiekiami ir blockstudio/performance/${setting} filtrai, taip pat vienas
baigiamasis filtras blockstudio/performance/config. Pastarasis turi grąžinti galiojantį
konfigūracijos objektą.
Kaip sluoksniuojami šaltiniai
Kiekvienas šaltinis įkeliamas ir sujungiamas, pradedant mažiausio prioriteto šaltiniu:
- Įtaisytosios numatytosios reikšmės
- Administravimo srityje išsaugoti nustatymai UI (parinktis
blockstudio_settings) - Temoje esantis
blockstudio.json - Filtrai
blockstudio/settings/*
blockstudio.json pakeičia tik tas raktų reikšmes, kurias apibrėžia. Anksčiau jis visiškai pakeisdavo išsaugotus nustatymus, tad vos atsiradus failui, nustodavo galioti nesusijusi administravimo srityje išsaugota reikšmė; dabar failo nustatymai taikomi virš jų. Kita vertus, pasenusi reikšmė, išsaugota administravimo srityje per UI, lieka galioti, kol failas apibrėžia tą raktą arba išsaugota reikšmė pašalinama. Jei nustatymas veikia kitaip, nei nurodyta faile, patikrinkite išsaugotų nustatymų sluoksnį naudodami wp bs settings arba Settings::get_raw(); šis grąžina tik tai, ką aiškiai apibrėžė aktyvus JSON arba parinkčių šaltinis.
Nustatymų skaitymas iš PHP
Blockstudio\Settings įkelia aktyvų šaltinį, praneša apie netaisyklingą JSON ir automatiškai įkelia iš naujo, kai pasikeičia 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);
}
Naudokite Settings::get_raw(), kai integracijai reikia tik aktyvaus JSON arba parinkčių šaltinio aiškiai deklaruotų reikšmių. Settings::fingerprint() grąžina deterministinį efektyvių nustatymų identifikatorių. Ilgai veikiančiuose procesuose galima aiškiai iškviesti Settings::reload(), kad failo pakeitimas būtų pastebėtas iškart. Įprastos prieigos metu failas patikrinamas ne dažniau kaip kartą per sekundę užklausos arba ilgai veikiančiame PHP procese, įskaitant atvejus, kai redaguoto failo dydis nepasikeičia. Konfigūruoto kelio pakeitimas įsigalioja kitą kartą skaitant. Jei aktyvaus JSON failo nėra, šis intervalas neatideda duomenų bazėje išsaugotų nustatymų nuskaitymo.
Nustatytas našumo profilis pasiekiamas per
Blockstudio\Runtime_Settings::current(). Palaikomi keliai su pasviruoju brūkšniu arba tašku:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Galimi nustatymai
users
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
ids |
masyvas | [] |
Naudotojų ID, turintys prieigą prie redaktoriaus |
roles |
masyvas | [] |
Naudotojų vaidmenys, turintys prieigą prie redaktoriaus |
assets
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
enqueue |
loginis | true |
Automatiškai įtraukti blokų išteklius į eilę |
reset.enabled |
loginis | false |
Pašalinti pagrindinius blokų stilius ir pritaikyti redaktoriaus paslauginių klasių nustatymą iš naujo |
reset.fullWidth |
masyvas | [] |
Įrašų tipai, kuriuose naudojamas viso pločio redaktoriaus išdėstymas |
minify.css |
loginis | false |
Sumažinti CSS išvesties dydį |
minify.js |
loginis | false |
Sumažinti JS išvesties dydį |
process.scss |
loginis | false |
Apdoroti SCSS failus |
output |
eilutė | source |
Kur įrašomi sukompiliuoti ištekliai: source arba cache |
inlineLimit |
sveikasis skaičius | 0 |
Į eilutę įterpiamų išorinių blokų CSS baitų skaičius kiekviename puslapyje |
output numatytoji reikšmė yra source; taip šalia kiekvieno bloko sukuriamas katalogas _dist. Nustatykite cache, kad sukompiliuoti ištekliai būtų įrašomi į Blockstudio talpyklos katalogą ir bloko šaltinio medis liktų švarus bei tinkamas diegti iš nekintamos kopijos. Šaltiniai Blockstudio ir taip negali rašyti į nurodytą vietą, todėl visada nukreipiami į talpyklą, neatsižvelgiant į šį nustatymą.
inlineLimit pagal numatytuosius nustatymus išjungta 0, todėl kiekviena išorinė stiliaus lentelė išlaiko savo <link> žymą. Vietoj to nustatykite baitų skaičių, kad mažiausios puslapio išorinės blokų stiliaus lentelės būtų įterptos į puslapį, jei jų bendras dydis neviršija šio skaičiaus. 40000 yra riba, kurią tai pačiai taisyklei naudoja WordPress. Žr. Mažų stiliaus lentelių įterpimas.
Kai aktyvus reset.enabled, Blockstudio į redaktoriaus drobę taip pat nukopijuoja išvalytas išorinės sąsajos body_class reikšmes. Redaktoriuje naudojamų klasių sąrašą koreguokite su blockstudio/editor/canvas/body_class.
cache
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
enabled |
loginė | true |
Įjungti failais pagrįstas Blockstudio talpyklas |
path |
eilutė | "blockstudio/cache" |
Talpyklos kelias, santykinis su WP_CONTENT_DIR arba absoliutus |
namespaceGrace |
sveikasis skaičius | 86400 |
Kiek sekundžių po pašalinimo išlaikyti seną talpyklos vardų sritį prieš ją išvalant |
Pagal numatytuosius nustatymus talpyklos failai įrašomi į wp-content/blockstudio/cache, už įkėlimų katalogo ribų. Santykinis path sprendžiamas nuo WP_CONTENT_DIR, o absoliutus kelias naudojamas tiesiogiai. Taip palaikomi serveriai, kuriuose yra atskiras įrašomas talpyklos diskas.
Įjungus, Blockstudio šiame pagrindiniame kataloge saugo kūrimo duomenis, iš anksto paruoštus blokų registracijos duomenis, išspręstus redaktoriaus išteklius, Tailwind CSS, atvaizdavimo dokumentus, salų fragmentus, statinius išankstinio atvaizdavimo rezultatus, grafų indeksus, eiles ir diagnostikos duomenis. Kiekvienas objektas atskiriamas pagal tinklą, svetainę, visą vykdymo aplinkos tapatybę ir apimtį. Vykdymo aplinkos tapatybė apima Blockstudio, nustatymus, WordPress, PHP, aktyvią temą, aktyvius papildinius, loginius aptikimo šaltinius, pagrindinio kompiuterio kontekstą ir operacijos savininko pateiktas aiškias priklausomybių maišos reikšmes.
Turinio, termino, naudotojo ir metaduomenų pakeitimai panaikina užpildytus laukų pasirinkimus, bet nepaveikia struktūrinių blokų paieškos ar sukompiliuotų išteklių. Pasirinkimai atnaujinami atskirai, taikant fiksuoto kūrimo kelio užraktą. Keli iš eilės atliekami įrašymai, pavyzdžiui, vertimų sinchronizavimas ar importavimas, sujungiami: pirmasis įrašymas po ramybės laikotarpio atnaujina pasirinkimus iš karto, o paskutinis šios sekos įrašymas atsispindi praėjus trisdešimčiai sekundžių; šį laiką galima keisti naudojant blockstudio/cache/populate_debounce. Metaduomenys, kuriuos WordPress įrašo kaip apskaitos duomenis, pavyzdžiui, įrašo redagavimo užraktą, nelaikomi pakeitimu; blockstudio/cache/populate_ignored_meta_keys papildo šį sąrašą. Redaktorius visada užklausia naujausių parinkčių, todėl šis laikotarpis turi įtakos tik atvaizdavimo metu skaitomiems podėlyje saugomiems pasirinkimams. Šaltinio failai ir kūrimo nustatymai kaip įprasta panaikina struktūrinį podėlį. Perrašant pasirinkimus, podėlio katalogas nenuskaitomas kaskart pasikeitus turiniui; periodiškai vykdomas valymas vis tiek pašalina našlaičiais tapusius laikinuosius failus. Konkrečiai kalbai būdingos vykdymo aplinkos tapatybės išlieka atskirtos; kelios podėlio vardų srities direktorijos daugiakalbėje svetainėje savaime nereiškia, kad podėlis praleistas.
SQLite žurnalo įrašai bloko db duomenų direktorijoje nepanaikina podėlyje saugomų bloko metaduomenų. Pakeitimai, susiję su db.php, stebimais šaltinio failais arba duomenų direktorijos šaltinio failų ir pakatalogių struktūra, vis tiek panaikina podėlį.
Lygiagrečiai atkuriant vykdymo aplinką išrenkamas vienas kūrimo procesas. Kitos užklausos laukia iki penkių sekundžių, tada pakartotinai naudoja paskutinius tinkamus blokų metaduomenis, jei jų šaltinio failai ir reikalingi sukompiliuoti ištekliai vis dar yra. Šaltoji užklausa, neturinti saugių duomenų, grąžina HTTP 503 su Retry-After, o ne pradeda kitą kūrimo procesą. Filtras blockstudio/cache/build_wait_budget nustato laukimo trukmę milisekundėmis tiek atkuriant struktūrą, tiek atnaujinant pasirinkimus. Serveryje be patariamųjų failų užraktų pasirinkimai atnaujinami be apsaugos, bet vis tiek paskelbiami, todėl kita užklausa juos ras.
Ankstesnių versijų palikti nenaudojami konkretaus rakto .build.lock failai pašalinami iš visų šios svetainės talpyklos vardų sričių, naudojant WP-Cron; procesas pradedamas praėjus penkioms minutėms po naujinimo ir per dešimties sekundžių laikotarpį kas minutę pašalinama iki 10,000 užraktų. wp bs cache status pateikia likusių užraktų skaičių, o wp bs cache cleanup iškart išvalo eilę; wp bs cache clear išvalo vykdymo aplinkos talpyklą. Jei suplanuotas paketas vėluoja daugiau nei dešimt minučių, nes neveikia cron, užklausos kartą per valandą patikrina ribotą skaičių užraktų, kad valymas neužstrigtų. Naujausi ar laikomi užraktai neliečiami, o nauji fiksuoto kelio užraktai niekada nešalinami. Išvalius eilę, tame pačiame pakete pašalinamos ir apleistos talpyklos vardų sritys, kai sueina jų namespaceGrace; tai daroma ne dažniau kaip kartą per valandą kiekvienai svetainei, o procesui palaikyti kasdien paliekamas suplanuotas paleidimas. Laikotarpis skaičiuojamas nuo pirmojo patikrinimo, aptikus pašalintą vardų sritį, o ne nuo naujausio jos failo; vis dar naudojama bent vienos apimties vardų sritis niekada nešalinama.
Vidinis talpyklos valymas nekviečia WordPress priedų trynimo filtrų.
Serveriuose, kuriuose WP-Cron išjungtas, įprastas suplanuotas cron darbinis procesas turi veikti toliau; nešalinkite visų aktyvių užraktų failų vien tam, kad išvalytumėte eilę.
Nustatymo filtras blockstudio/settings/cache/path pakeičia sukonfigūruotą reikšmę. Jei kelią reikia nustatyti konkrečiai diegimo aplinkai, naudokite blockstudio/cache/dir filtrą išspręstam pagrindiniam katalogui:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Serveriai, kurių nuomininko tapatybė skiriasi nuo WordPress tinklo ar tinklaraščio ID, gali filtruoti blockstudio/cache/site_key. Rezultatas išvalomas ir naudojamas tik kaip katalogo segmento pavadinimas. blockstudio/cache/context išlieka tinkama vieta serializuojamam vykdymo aplinkos variantui, kuris turi pakeisti objektų tapatybes.
themeDefaults
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
titleTag |
loginė | false |
Įjungti WordPress temos palaikymą pavadinimo žymai |
suppressDirectoryUpdates |
loginė | false |
Pašalinti aktyvias antrines ir pagrindines temas iš katalogo naujinimų rezultatų |
Šablonai ir toliau naudoja esamą Blockstudio\Patterns API; šios numatytosios reikšmės nesukuria alternatyvių puslapių ar šablonų sąsajų.
performance
Profilis compat nekeičia bendrojo WordPress veikimo. speed ir strict įjungia tas pačias pasirenkamas išorinės sąsajos numatytąsias reikšmes; kiekvienas antrinis nustatymas gali pakeisti savo profilio reikšmę.
Pasirenkami nustatymai yra registracijos sąlygos. Kai pasirenkama funkcija yra false, Blockstudio neprijungia jos išorinės sąsajos, administravimo, redaktoriaus, REST ar suplanuotų atgalinių iškvietimų. Išjungus „Early Serve“ arba suplanuotą įšilimą, prieš tai panaudojus šią funkciją, vieną kartą atliekamas jai skirtas išvalymas; vėlesnės užklausos nieko nedaro.
| Parinktis | Tipas | Suderinamumo numatytoji reikšmė | Greičio ir griežto režimo numatytoji reikšmė | Aprašymas |
|---|---|---|---|---|
profile |
string | "compat" |
Netaikoma | compat, speed arba strict |
wordpress.headNoise |
boolean | false |
true |
Pašalinti bendrąją antraštės aptikimo ir jaustukų išvestį |
wordpress.embeds |
boolean | false |
true |
Pašalinti oEmbed aptikimą ir prieglobos scenarijus |
wordpress.xmlrpc |
boolean | false |
true |
Išjungti XML-RPC ir pingbacks |
wordpress.editor |
boolean | false |
true |
Išjungti nuotolinio redaktoriaus aptikimo sąsajas |
wordpress.frontendAssets |
boolean | false |
true |
Pašalinti bendruosius pagrindinius priekinės dalies išteklius |
wordpress.media |
boolean | false |
true |
Taikyti numatytuosius vaizdų išvesties nustatymus |
wordpress.heartbeat |
boolean | false |
true |
Riboti Heartbeat dažnį ne redaktoriuose |
preload.links |
string | "off" |
"intent" |
Iš anksto gauti tos pačios kilmės dokumentus po naudotojo veiksmo |
media.lazy |
boolean | false |
true |
Naudoti Blockstudio vaizdų įkėliklį |
media.skeleton |
boolean | false |
true |
Rodyti integruotą įkėlimo karkasą |
media.metadata |
boolean | false |
true |
Deklaruoti assets/media.json naudojimą |
media.rootMargin |
string | "300px" |
"300px" |
Atidėtojo įkėliklio susikirtimo paraštė |
measurement.enabled |
boolean | false |
false |
Įjungti veikimo metu naudojamas matavimo API |
measurement.queryMonitor |
boolean | false |
false |
Įtraukti užklausas, trunkančias bent 50ms |
measurement.headers |
boolean | false |
false |
Siųsti profilio ir konfigūracijos maišos antraštes |
measurement.timings |
boolean | false |
false |
Siųsti veikimo trukmės antraštę |
staticPrerender.enabled |
boolean | false |
false |
Įjungti anoniminiams naudotojams saugų HTML spartinimą podėlyje |
staticPrerender.ttl |
integer | 86400 |
86400 |
Maksimalus podėlyje saugomo dokumento amžius sekundėmis |
staticPrerender.invalidate |
string | "signature" |
"signature" |
Naudoti signature arba laipsniškai kintančią graph tapatybę |
staticPrerender.earlyServe |
boolean | false |
false |
Pateikti saugius podėlio rezultatus prieš paleidžiant WordPress |
staticPrerender.serveLoggedIn |
boolean | false |
false |
Leisti naudotojams naudoti podėlio rezultatus, bet jų nekaupti |
staticPrerender.dynamicPaths |
array | [] |
[] |
Kelių prefiksai, kurie turi išlikti dinaminiai |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Atsakymo antraštės, saugomos kartu su podėlio rezultatais ir siunčiamos juos pateikus |
staticPrerender.warm.enabled |
boolean | false |
false |
Įjungti patvarią suplanuotą pašildymo eilę |
staticPrerender.warm.interval |
integer | 3600 |
3600 |
Pašildymo intervalas sekundėmis |
staticPrerender.warm.concurrency |
integer | 2 |
2 |
Didžiausias vieno pašildymo etapo apdorojamų užduočių skaičius |
staticPrerender.warm.transport |
string | "http" |
"http" |
Naudoti http arba prieglobos teikėjo pateiktą internal atvaizduoklį |
Statinis išankstinis generavimas lieka išjungtas, nebent jis aiškiai įjungiamas. Išjungtas
pagrindinis jungiklis neužregistruoja jokių išankstinio generavimo užklausų kabliukų, o išjungti earlyServe
ir warm.enabled jungikliai neužregistruoja jokių administravimo ar cron kabliukų. Parašo režimas įprastose užklausose naudoja
nebrangią aktyvuotą tapatybę. Grafų režimas skirtas aiškiai inicijuojamoms versijoms kurti: jis įrašo kiekvieno puslapio šaltinio priklausomybes, todėl pakeitus vieną puslapį nesugadinami nesusiję dokumentai. Informacijos apie apšildymą,
diegimą, ankstyvą pateikimą ir saugą rasite Statinio išankstinio generavimo puslapyje.
Matavimus galima gauti programiškai:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Kai antraštės įjungtos, Blockstudio siunčia
X-Blockstudio-Performance-Profile,
X-Blockstudio-Performance-Config ir pasirinktinai
X-Blockstudio-Performance-Time. Veiksmas
blockstudio/performance/measurement_enabled gauna išspręstus
vykdymo aplinkos nustatymus.
Parinktys media valdo bs_media_image(), assets/media.json
manifestą ir sąsajos tingiojo įkėlimo įrankį. Pagalbinės funkcijos,
manifesta kūrimo įrankio ir įkėlimo veikimo aprašą rasite puslapyje Medija.
content
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
enabled |
boolean | false |
Įjungti turinio sinchronizavimo konfigūraciją |
id |
string | "default" |
Sinchronizuotuose objektuose saugoma turinio rinkinio vardų sritis |
path |
string | "content" |
Su tema susietas turinio failų katalogas |
includePageSyncManaged |
boolean | false |
Įtraukti „Page Sync“ valdomus įrašus, neperimant jų turinio |
authors |
string | "ignore" |
Autorių tvarkymas (ignore arba esamas naudotojo login) |
postTypes |
array | [] |
Leidžiamų įrašų tipų sąrašas |
meta.include |
array | [] |
Sinchronizuojamų meta raktų globalieji šablonai |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Neįtraukiamų meta raktų globalieji šablonai |
meta.references |
object | {} |
Deklaruotos meta nuorodos, perrašomos tarp ID ir UID |
taxonomies |
array | [] |
Leidžiamų registruotų taksonomijų terminams ir ryšiams sąrašas |
media |
string | "manifest" |
Priedo nuorodos veiksena (manifest arba none) |
Turinio sinchronizavimas valdomas per wp bs content ir eksportuoja leidžiamus įrašus,
įrašo meta duomenis ir deklaruotas nuorodas į perkeliamus failus. Darbo eigą ir failo
formatą rasite puslapyje Turinio sinchronizavimas.
editor
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
formatOnSave |
boolean | false |
Formatuoti block.json įrašant |
assets |
array | [] |
Papildomi ištekliai, įkeliami redaktoriuje |
markup |
boolean | false |
Įjungti žymėjimo redagavimą |
tailwind
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
enabled |
boolean | false |
Įjungti Tailwind CSS kompiliavimą |
config |
string | "" |
Tailwind v4 konfigūracija, kurioje pirmiausia naudojamas CSS |
Kompiliavimo veikimo ir konfigūracijos formato, kuriame pirmiausia naudojamas CSS, aprašą rasite puslapyje Tailwind CSS.
blockTags
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
enabled |
boolean | false |
Įjungti puslapio lygmens bs: žymų atvaizdavimą įrašų turinyje ir valdiklių srityse |
allow |
array | [] |
Leidžiamų blokų pavadinimų šablonų sąrašas; palaikomos fnmatch() pakaitos |
deny |
array | [] |
Draudžiamų blokų pavadinimų šablonų sąrašas; turi pirmenybę prieš allow |
prefixes |
object | {} |
Priešdėlis trumpiniams priskirti vardų sričiai; kiekviena reikšmė yra vardų sritis arba surikiuotas masyvas |
Šablonų lygmens žymų atvaizdavimas visada aktyvus; šios parinktys valdo pakeitimą puslapio lygmeniu. Žymų sintaksę ir sprendimo taisykles rasite puslapyje Atvaizdavimas.
ui
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
enabled |
boolean | false |
Registruoti komplekte esančius bsui/* UI komponentus ir app/* demonstracines programas |
blockEditor
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
disableLoading |
boolean | false |
Išjungti blokų įkėlimą redaktoriuje |
enhance |
boolean | false |
Įjungti Blockstudio redaktoriaus užvedimo ir pasirinkimo valdiklius |
cssClasses |
array | [] |
Stilių lentelių URL, iš kurių ištraukiamos CSS klasės klasės lauko automatinio užbaigimo funkcijai |
cssVariables |
array | [] |
Stilių lentelių URL, iš kurių ištraukiami CSS kintamieji kodo lauko automatinio užbaigimo funkcijai |
blockEditor.blocks
Naudokite blockEditor.blocks viso projekto blokų įterpimo politikai nustatyti. allow ir deny priima blokų pavadinimus ir pakaitos šablonus, pvz., 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 išregistruoja stilius, užregistruotus per WordPress’
PHP blokų stilių registrą:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Naudokite blockEditor.patterns, kad išjungtumėte visuotinius šablonų šaltinius ir filtruotumėte
šablonų kategorijas.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Naudokite blockEditor.media visuotinio medijos įterpimo politikai nustatyti.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
grab.enabled |
boolean | false |
Įjungti sąsajos elementų fiksavimo įrankį |
perf |
boolean | false |
Įjungti našumo profiliavimo įrankį kiekvieno puslapio įkėlimo metu |
canvas.enabled |
boolean | false |
Įjungti drobę |
canvas.adminBar |
boolean | true |
Rodant drobę, rodyti WordPress administravimo juostą |
githooks
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
commit |
boolean | false |
Kai vykdoma blockstudio-githooks sync, generuoti tik analizę atliekantį išankstinio patvirtinimo kabliuką |
Apie tai, ką vykdo sugeneruotas kabliukas ir kaip jis sinchronizuojamas, skaitykite puslapyje valdomas įrašymo kabliukas.
phpstan
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
preset |
string | "base" |
Analizės išankstinis nustatymas, kai komandinė eilutė nepasirenka jokio: base, theme, extreme-theme arba wordpress-render |
configuration |
string | "" |
Projekto PHPStan konfigūracija, įtraukiama kartu su išankstiniu nustatymu ir nustatoma pagal blockstudio.json |
roots |
array | ["."] |
Temos šakniniai katalogai, analizuojami kanonine komanda |
excludePaths |
array | [] |
Papildomos skaitytuvo išimtys, taikomos kiekvienam sukonfigūruotam šakniniam katalogui |
maxFiles |
integer | 10000 |
Didžiausias temų skaitytuvo tikrinamų failų skaičius |
blockTags |
object | {} |
Elementų susiejimai, žymų pseudonimai ir scanPhp, skirti blokų žymų taisyklei |
Šie nustatymai valdo kanoninę komandą blockstudio-phpstan. Išankstinius nustatymus, sluoksnius ir pritaikymą rasite puslapyje PHPStan.
ai
| Parinktis | Tipas | Numatytoji reikšmė | Aprašymas |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Generuoti bendrą blokų, nustatymų, schemų ir dokumentacijos konteksto failą LLM įrankiams |
Dokumentacijos rodyklę ir visą sugeneruotą tekstą rasite puslapyje DI integracija.
Įjunkite ir komponuokite komplekte esančius bemodulius UI komponentus, pristatytus Blockstudio 7.3 versijoje.