Iestatījumi
Blockstudio ietver jaudīgu iestatījumu API, kas ļauj iestatīt opcijas, izmantojot blockstudio.json failu savas tēmas mapē un/vai filtrus. Turklāt lietotāji ar atļaujām var vizuāli mainīt iestatījumus administrēšanas sadaļā.
Ar JSON
Ja tēmas mapē ir blockstudio.json fails, tas tiks izmantots, lai iestatītu pašreizējās vietnes noklusējuma opcijas. Ir pieejama JSONshēma, kas pārbauda failu un palīdz automātiski pabeigt kodu IDE.
Šis fails nav obligāts. Ja tā nav, Blockstudio izmanto administrēšanas sadaļā saglabātos iestatījumus kopā ar iebūvētajiem noklusējuma iestatījumiem. Faila pievienošana, maiņa vai noņemšana tiek noteikta automātiski, tāpēc kešatmiņa nav jādzēš un lapa nav manuāli jāpārlādē.
Pieejami šādi rekvizīti:
{
"$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
}
}
Ar filtriem
Varat arī izmantot filtru blockstudio/settings/${setting}, lai iestatītu opcijas, izmantojot PHP, un iegūtu lielāku elastību.
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');
Ar filtru blockstudio/settings/${setting} iestatītās opcijas aizstās tās, kas iestatītas failā blockstudio.json. Abas metodes var izmantot kopā.
Izpildlaika vērtības nodrošina arī blockstudio/performance/${setting} filtrus un vienu gala filtru blockstudio/performance/config. Tam jāatgriež derīgs konfigurācijas objekts.
Kā tiek apvienoti avoti
Katrs avots tiek ielādēts un apvienots, sākot ar zemāko prioritāti:
- Iebūvētie noklusējuma iestatījumi
- Administrēšanas sadaļā UI saglabātie iestatījumi (opcija
blockstudio_settings) - Tēmas
blockstudio.json blockstudio/settings/*filtri
blockstudio.json aizstāj tikai tās atslēgas, ko tas deklarē. Agrāk tas pilnībā aizstāja saglabātos iestatījumus, tāpēc, tiklīdz fails parādījās, nesaistīta administrēšanas sadaļā saglabāta vērtība vairs netika lietota; tagad faila vērtības tiek piemērotas virs tām. Taču administrēšanas sadaļā UI saglabāta novecojusi vērtība turpina darboties, līdz fails deklarē attiecīgo atslēgu vai saglabātā vērtība tiek noņemta. Ja iestatījums darbojas citādi, nekā norādīts failā, pārbaudiet saglabāto slāni ar wp bs settings vai Settings::get_raw(), kas atgriež tikai to, ko aktīvais JSON vai opciju avots ir skaidri deklarējis.
Iestatījumu nolasīšana no PHP
Blockstudio\Settings ielādē aktīvo avotu, ziņo par nederīgu JSON un automātiski atkārtoti ielādējas, kad mainās 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);
}
Izmantojiet Settings::get_raw(), ja integrācijai nepieciešamas tikai vērtības, kas ir skaidri deklarētas aktīvajā JSON vai opciju avotā. Settings::fingerprint() atgriež deterministisku efektīvo iestatījumu identifikatoru. Ilgstoši darbojošies procesi var tieši izsaukt Settings::reload(), lai nekavējoties nolasītu faila izmaiņas. Parastās piekļuves laikā fails tiek pārbaudīts ne biežāk kā reizi sekundē vienā pieprasījumā vai ilgstoši darbojošā PHP procesā, tostarp, ja fails ir mainīts, bet tā izmērs palicis nemainīgs. Konfigurētā ceļa maiņa stājas spēkā nākamajā lasīšanas reizē. Ja aktīva JSON faila nav, šis intervāls nekavē saglabātos datubāzes iestatījumus.
Atrisinātajam veiktspējas profilam var piekļūt, izmantojot Blockstudio\Runtime_Settings::current(). Tas atbalsta ceļus ar slīpsvītrām vai punktiem:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Pieejamie iestatījumi
users
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
ids |
masīvs | [] |
Lietotāju ID ar redaktora piekļuvi |
roles |
masīvs | [] |
Lietotāju lomas ar redaktora piekļuvi |
assets
| Opcija | Veids | Noklusējums | Apraksts |
|---|---|---|---|
enqueue |
Būla vērtība | true |
Automātiski iekļaut bloku resursus rindā |
reset.enabled |
Būla vērtība | false |
Noņemt kodola bloku stilus un lietot redaktora utilītu atiestatījumu |
reset.fullWidth |
Masīvs | [] |
Ierakstu veidi, kuros izmantot pilna platuma redaktora izkārtojumu |
minify.css |
Būla vērtība | false |
Samazināt CSS izvadi |
minify.js |
Būla vērtība | false |
Samazināt JS izvadi |
process.scss |
Būla vērtība | false |
Apstrādāt SCSS failus |
output |
Virkne | source |
Kur tiek rakstīti kompilētie resursi: source vai cache |
inlineLimit |
Vesels skaitlis | 0 |
Vienā lapā iekļauto ārējo bloku CSS baitu skaits |
output noklusējuma vērtība ir source, kas blakus katram blokam izveido mapi _dist. Iestatiet vērtību uz cache, lai kompilētos resursus rakstītu Blockstudio kešatmiņas mapē un bloku avota koks būtu tīrs un izvietojams no nemaināmas koda kopijas. Avoti Blockstudio, kuros nevar rakstīt, neatkarīgi no šī iestatījuma jau tagad tiek novirzīti uz kešatmiņu.
inlineLimit ir izslēgts pie 0, tāpēc katra ārējā stila lapa saglabā savu <link> tagu. Iestatiet baitu skaitu, lai tā vietā lapas mazākās ārējās bloka stila lapas ievietotu iekļauti, ja vien to kopējais izmērs nepārsniedz šo skaitu. 40000 ir ierobežojums, ko WordPress core izmanto tam pašam noteikumam. Skatiet Iekļaut mazas stila lapas.
Ja ir aktīvs reset.enabled, Blockstudio redaktora kanvā iekopē arī attīrītās priekšgala body_class vērtības. Izmantojiet blockstudio/editor/canvas/body_class, lai pielāgotu tikai redaktorā izmantoto klašu sarakstu.
cache
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
enabled |
loģiskā vērtība | true |
Iespējot kešatmiņas, kuru pamatā ir Blockstudio faili |
path |
virkne | "blockstudio/cache" |
Kešatmiņas ceļš: relatīvs pret WP_CONTENT_DIR vai absolūts |
namespaceGrace |
vesels skaitlis | 86400 |
Sekundes, cik ilgi saglabā novecojušu kešatmiņas nosaukumvietu pirms tās tīrīšanas |
Pēc noklusējuma kešatmiņas faili tiek rakstīti mapē wp-content/blockstudio/cache, ārpus augšupielāžu mapes. Relatīvs path tiek noteikts attiecībā pret WP_CONTENT_DIR; absolūts ceļš tiek izmantots tieši. Tas ir piemērots mitināšanas pakalpojumiem, kas nodrošina atsevišķu rakstāmu kešatmiņas sējumu.
Ja šī funkcija ir iespējota, Blockstudio izmanto šo vienīgo saknes mapi būvēšanas datiem, iepriekš sagatavotiem bloku reģistrācijas datiem, atrisinātiem redaktora resursiem, Tailwind CSS, renderēšanas dokumentiem, salu fragmentiem, statiskām iepriekš renderētām lapām, grafu indeksiem, rindām un diagnostikas datiem. Katrs objekts ir izolēts pēc tīkla, vietnes, pilnas izpildlaika identitātes un tvēruma. Izpildlaika identitātes ietver Blockstudio, iestatījumus, WordPress, PHP, aktīvo tēmu, aktīvos spraudņus, loģiskos atklāšanas avotus, mitinātāja kontekstu un skaidri norādītas atkarību jaucējvērtības, ko nodrošina attiecīgā darbība.
Satura, terminu, lietotāju un metadatu izmaiņas padara nederīgas aizpildītās lauku izvēles, bet ne strukturālo bloku noteikšanu vai kompilētos resursus. Izvēles tiek atjauninātas atsevišķi, izmantojot fiksētu būvēšanas ceļa bloķētāju. Vairāki strauji secīgi ieraksti, piemēram, tulkojumu sinhronizācija vai imports, tiek apvienoti: pirmais ieraksts pēc klusuma perioda uzreiz atsvaidzina izvēles, un pēdējais ieraksts šajā sērijā tiek atspoguļots pēc trīsdesmit sekundēm; šo laiku var mainīt ar blockstudio/cache/populate_debounce. Metadati, ko WordPress ieraksta kā uzskaites datus, piemēram, pēc rediģēšanas iestatītā bloķēšana, netiek uzskatīti par izmaiņām; blockstudio/cache/populate_ignored_meta_keys paplašina šo sarakstu. Redaktors vienmēr vaicā aktuālās opcijas, tāpēc šis laika periods ietekmē tikai renderēšanas brīdī nolasītās kešotās izvēles. Avota faili un būvēšanas iestatījumi joprojām parastajā veidā padara nederīgu strukturālo kešatmiņu. Izvēļu pārrakstīšana neizraisa kešatmiņas direktorija atkārtotu skenēšanu pēc katrām satura izmaiņām; periodiska tīrīšana joprojām dzēš pamestos pagaidu failus. Konkrētai valodai paredzētās izpildlaika identitātes paliek izolētas; vairākas kešatmiņas nosaukumvietas direktorijas daudzvalodu vietnē pašas par sevi neliecina, ka kešatmiņa nav izmantota.
SQLite žurnāla darbības bloka db datu direktorijā neizdzēš kešotos bloka metadatus. Izmaiņas db.php, uzraudzītajos avota failos vai datu direktorijas avota failu un apakšdirektoriju struktūrā joprojām padara kešatmiņu nederīgu.
Vienlaicīgas izpildlaika pārbūves laikā tiek ievēlēts viens būvētājs. Pārējie pieprasījumi gaida līdz piecām sekundēm un pēc tam izmanto pēdējos derīgos bloku metadatus, ja to avota faili un nepieciešamie kompilētie resursi joprojām pastāv. Auksts pieprasījums bez droši izmantojamiem datiem atgriež HTTP 503 ar Retry-After, nevis sāk vēl vienu būvēšanu. Filtrs blockstudio/cache/build_wait_budget pielāgo gaidīšanas laiku milisekundēs gan strukturālajām pārbūvēm, gan izvēļu atsvaidzināšanai. Mitinātājs bez konsultatīvām failu slēdzenēm atsvaidzina izvēles bez aizsardzības un tik un tā tās publicē, tāpēc nākamais pieprasījums izmanto kešatmiņu.
Iepriekšējo versiju atstātās neaktīvās, konkrētai atslēgai paredzētās .build.lock datnes tiek savāktas visās šīs vietnes kešatmiņas nosaukumvietās, izmantojot WP-Cron. Tīrīšana sākas piecas minūtes pēc jaunināšanas un desmit sekunžu laikā noņem līdz 10,000 slēdzenēm minūtē. wp bs cache status parāda atlikušo skaitu, wp bs cache cleanup nekavējoties iztukšo atlikumu, bet wp bs cache clear iztīra izpildlaika kešatmiņu. Ja plānotā partija kavējas vairāk nekā desmit minūtes, jo cron nedarbojas, pieprasījumi reizi stundā pārmeklē ierobežotu skaitu slēdzeņu, lai tīrīšana neapstātos. Nesen izmantotās vai aizņemtās slēdzenes tiek atstātas neskartas, un jaunās fiksētā ceļa slēdzenes nekad netiek savāktas. Kad atlikums ir iztukšots, tā pati partija savāc pamestās kešatmiņas nosaukumvietas, kad ir pagājis to namespaceGrace; katrā vietnē tas notiek ne biežāk kā reizi stundā, un šai darbībai tiek saglabāts dienas cikls. Atļautais laiks tiek skaitīts no pirmās pārbaudes, kurā nosaukumvieta konstatēta kā novecojusi, nevis no tās jaunākā faila izveides; nosaukumvieta, kas joprojām ir aktuāla kādā no tās tvērumiem, nekad netiek savākta.
Iekšējā kešatmiņas tīrīšana neizsauc WordPress pielikumu dzēšanas filtrus. Mitinātājiem, kuros WP-Cron ir atspējots, jāturpina darbināt ierastais plānotais cron darbprocess; neizdzēsiet bez izšķirības aktīvās slēdzeņu datnes, lai iztukšotu atlikumu.
Iestatījuma filtrs blockstudio/settings/cache/path maina konfigurēto vērtību. Lai atrisinātu izvietošanai specifiskus ceļus, filtrs blockstudio/cache/dir atrisina pamata direktoriju:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Mitinātāji, kuros nomnieka identitāte atšķiras no WordPress tīkla/vietnes ID, var filtrēt blockstudio/cache/site_key. Rezultāts tiek attīrīts un izmantots tikai kā direktorijas segments. blockstudio/cache/context joprojām ir īstā vieta serializējamai izpildlaika variācijai, kurai jāmaina objektu identitātes.
themeDefaults
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
titleTag |
loģiskā vērtība | false |
Iespējot WordPress tēmas atbalstu title tagam |
suppressDirectoryUpdates |
loģiskā vērtība | false |
Noņemt aktīvās bērntēmas un vecāktēmas no direktoriju atjauninājumu rezultātiem |
Rakstos joprojām tiek izmantots esošais Blockstudio\Patterns API; šie noklusējuma iestatījumi nerada alternatīvas lapu vai rakstu fasādes.
performance
Profils compat nemaina vispārīgo WordPress darbību. speed un strict iespējo tos pašus izvēles priekšgala noklusējuma iestatījumus; katrs bērniestatījums var pārrakstīt sava profila vērtību.
Izvēles iestatījumi ir reģistrācijas vārti. Ja neobligāta funkcija ir false, Blockstudio nepievieno šīs funkcijas priekšgala, administrēšanas, redaktora, REST vai plānotos atzvanus. Pēc Early Serve vai plānotās iesildīšanas izmantošanas to atspējošana vienreiz veic attiecīgo tīrīšanu; turpmākie pieprasījumi paliek neaktīvi.
| Opcija | Tips | Saderības noklusējums | Ātruma/strict noklusējums | Apraksts |
|---|---|---|---|---|
profile |
virkne | "compat" |
Nav piemērojams | compat, speed vai strict |
wordpress.headNoise |
Būla vērtība | false |
true |
Noņemt vispārīgo galvenes noteikšanu un emocijzīmju izvadi |
wordpress.embeds |
Būla vērtība | false |
true |
Noņemt oEmbed noteikšanu un saimniekdatora skriptus |
wordpress.xmlrpc |
Būla vērtība | false |
true |
Atspējot XML-RPC un pingback pieprasījumus |
wordpress.editor |
Būla vērtība | false |
true |
Atspējot attālās redaktora noteikšanas saskarnes |
wordpress.frontendAssets |
Būla vērtība | false |
true |
Noņemt vispārīgos WordPress priekšgala resursus |
wordpress.media |
Būla vērtība | false |
true |
Lietot attēlu izvades noklusējuma iestatījumus |
wordpress.heartbeat |
Būla vērtība | false |
true |
Ierobežot Heartbeat ārpus redaktoriem |
preload.links |
virkne | "off" |
"intent" |
Pēc lietotāja darbības priekšielādēt tās pašas izcelsmes dokumentus |
media.lazy |
Būla vērtība | false |
true |
Izmantot Blockstudio attēlu ielādētāju |
media.skeleton |
Būla vērtība | false |
true |
Rādīt iebūvēto ielādes skeletu |
media.metadata |
Būla vērtība | false |
true |
Deklarēt assets/media.json izmantošanu |
media.rootMargin |
virkne | "300px" |
"300px" |
Slinkās ielādes krustpunkta mala |
measurement.enabled |
Būla vērtība | false |
false |
Iespējot izpildlaika mērīšanas API |
measurement.queryMonitor |
Būla vērtība | false |
false |
Iekļaut vaicājumus, kas aizņem vismaz 50ms |
measurement.headers |
Būla vērtība | false |
false |
Sūtīt profila un konfigurācijas jaucējvērtības galvenes |
measurement.timings |
Būla vērtība | false |
false |
Sūtīt pagājušā izpildlaika galveni |
staticPrerender.enabled |
Būla vērtība | false |
false |
Iespējot anonīmiem lietotājiem drošu HTML kešatmiņu |
staticPrerender.ttl |
vesels skaitlis | 86400 |
86400 |
Dokumenta maksimālais vecums kešatmiņā sekundēs |
staticPrerender.invalidate |
virkne | "signature" |
"signature" |
Izmantot signature vai pakāpenisku graph identitāti |
staticPrerender.earlyServe |
Būla vērtība | false |
false |
Apkalpot drošus kešatmiņas trāpījumus, pirms tiek palaists WordPress |
staticPrerender.serveLoggedIn |
Būla vērtība | false |
false |
Atļaut lietotājiem izmantot, bet ne veidot kešatmiņas trāpījumus |
staticPrerender.dynamicPaths |
masīvs | [] |
[] |
Ceļu prefiksi, kuriem jāsaglabā dinamiska darbība |
staticPrerender.replayHeaders |
masīvs | ["Link"] |
["Link"] |
Atbildes galvenes, kas tiek saglabātas un nosūtītas kopā ar kešatmiņas trāpījumiem |
staticPrerender.warm.enabled |
Būla vērtība | false |
false |
Iespējot pastāvīgu ieplānotu iesildīšanas rindu |
staticPrerender.warm.interval |
vesels skaitlis | 3600 |
3600 |
Iesildīšanas intervāls sekundēs |
staticPrerender.warm.concurrency |
vesels skaitlis | 2 |
2 |
Maksimālais darbu skaits vienā iesildīšanas reizē |
staticPrerender.warm.transport |
virkne | "http" |
"http" |
Izmantot http vai saimniekdatora nodrošinātu internal renderētāju |
Statiskā iepriekšējā renderēšana paliek atspējota, ja vien tā nav skaidri iespējota. Ja galvenais slēdzis ir atspējots, netiek reģistrēti iepriekšējās renderēšanas pieprasījumu āķi, un atspējotie earlyServe un warm.enabled slēdži nereģistrē administrēšanas vai cron āķus. Paraksta režīmā parastos pieprasījumos tiek izmantota lēta aktivizēta identitāte. Grafu režīms paredzēts skaidri palaistām būvēm: tas reģistrē katras lapas avota atkarības, lai vienas lapas maiņa nepadarītu nederīgus nesaistītus dokumentus. Informāciju par iesildīšanu, izvietošanu, agrīnu apkalpošanu un drošību skatiet sadaļā Statiskā iepriekšējā renderēšana.
Mērījumi ir pieejami programmatiski:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Kad galvenes ir iespējotas, Blockstudio nosūta
X-Blockstudio-Performance-Profile,
X-Blockstudio-Performance-Config un pēc izvēles
X-Blockstudio-Performance-Time. Darbība
blockstudio/performance/measurement_enabled saņem atrisinātos
izpildlaika iestatījumus.
media opcijas vada bs_media_image(), assets/media.json manifestu un priekšgala slinko ielādētāju. Palīgfunkciju, manifesta veidotāju un ielādētāja darbību skatiet sadaļā Multivide.
content
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
enabled |
boolean | false |
Iespējot Content Sync konfigurāciju |
id |
string | "default" |
Satura kopas nosaukumvieta, kas saglabāta sinhronizētajās entītijās |
path |
string | "content" |
Tēmai relatīva satura failu mape |
includePageSyncManaged |
boolean | false |
Iekļaut Page Sync pārvaldītās ziņas, nepārņemot to pamattekstu |
authors |
string | "ignore" |
Autora apstrāde (ignore vai esoša lietotāja login) |
postTypes |
array | [] |
Atļauto ziņu tipu saraksts |
meta.include |
array | [] |
Glob raksti sinhronizējamo meta atslēgu atlasei |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Glob raksti izslēdzamo meta atslēgu atlasei |
meta.references |
object | {} |
Deklarētas meta atsauces, kas pārrakstītas starp ID un UID |
taxonomies |
array | [] |
Atļauto reģistrēto taksonomiju saraksts terminiem un attiecībām |
media |
string | "manifest" |
Pielikuma atsauces uzvedība (manifest vai none) |
Content Sync tiek pārvaldīts ar wp bs content, un tas eksportē atļautās ziņas,
postmeta un deklarētās atsauces uz pārnesamiem failiem. Darbplūsmu un faila
formātu skatiet sadaļā Content Sync.
editor
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
formatOnSave |
boolean | false |
Formatēt block.json saglabājot |
assets |
array | [] |
Papildu resursi, kas jāielādē redaktorā |
markup |
boolean | false |
Iespējot iezīmējuma rediģēšanu |
tailwind
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
enabled |
boolean | false |
Iespējot Tailwind CSS kompilāciju |
config |
string | "" |
Tailwind v4 CSS konfigurācija ar pirmo … |
Kompilācijas darbību un konfigurācijas formātu ar pirmo CSS skatiet: Tailwind CSS.
blockTags
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
enabled |
boolean | false |
Iespējot lapas līmeņa bs: tagu renderēšanu ziņas saturā un logrīku apgabalos |
allow |
array | [] |
Bloku nosaukumu rakstu atļaušanas saraksts; atbalsta fnmatch() aizstājējzīmes |
deny |
array | [] |
Bloku nosaukumu rakstu aizliegšanas saraksts; tam ir priekšroka pār allow |
prefixes |
object | {} |
Prefikss saīsinājumu nosaukumvietām; katra vērtība ir nosaukumvieta vai sakārtots masīvs |
Veidnes līmeņa tagu renderēšana vienmēr ir aktīva; šīs opcijas nosaka aizstāšanu lapas līmenī. Tagu sintaksi un atrisināšanas noteikumus skatiet sadaļā Renderēšana.
ui
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
enabled |
boolean | false |
Reģistrēt komplektā iekļautos bsui/* UI komponentus un app/* demonstrācijas lietotnes |
blockEditor
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
disableLoading |
boolean | false |
Atspējot bloku ielādi redaktorā |
enhance |
boolean | false |
Iespējot Blockstudio redaktora norādes, kas saistītas ar novietošanu un atlasi |
cssClasses |
array | [] |
Stila lapu URL, no kurām iegūt CSS klases klašu lauka automātiskajai pabeigšanai |
cssVariables |
array | [] |
Stila lapu URL, no kurām iegūt CSS mainīgos koda lauka automātiskajai pabeigšanai |
blockEditor.blocks
Izmantojiet blockEditor.blocks projekta līmeņa bloku ievietošanas politikai. allow un deny pieņem bloku nosaukumus un aizstājējzīmju rakstus, piemēram, 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 atceļ stilus, kas reģistrēti, izmantojot WordPress
PHP bloku stilu reģistru:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Izmantojiet blockEditor.patterns, lai atspējotu globālos rakstu avotus un filtrētu
rakstu kategorijas.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Izmantojiet blockEditor.media globālajai multivides ievietotāja politikai.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
grab.enabled |
boolean | false |
Iespējot priekšgala elementu atlasītāju |
perf |
boolean | false |
Iespējot veiktspējas profilu katrā lapas ielādē |
canvas.enabled |
boolean | false |
Iespējot audeklu |
canvas.adminBar |
boolean | true |
Rādīt WordPress administrēšanas joslu audekla skatā |
githooks
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
commit |
boolean | false |
Ģenerēt tikai analīzei paredzētu pirms-commit āķi, kad darbojas blockstudio-githooks sync |
Informāciju par ģenerētā āķa darbību un tā sinhronizācijas uzturēšanu skatiet sadaļā pārvaldītais commit āķis.
phpstan
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
preset |
string | "base" |
Analīzes sākotnējais iestatījums, ja komandrindā nav izvēlēts neviens: base, theme, extreme-theme vai wordpress-render |
configuration |
string | "" |
Projekta PHPStan konfigurācija, kas iekļauta kopā ar sākotnējo iestatījumu un atrisināta no blockstudio.json |
roots |
array | ["."] |
Tēmu saknes, ko analizē kanoniskā komanda |
excludePaths |
array | [] |
Papildu skenera izņēmumi attiecībā pret katru konfigurēto sakni |
maxFiles |
integer | 10000 |
Maksimālais failu skaits, ko pārbauda tēmu skeneris |
blockTags |
object | {} |
Elementu kartējumi, tagu aizstājvārdi un scanPhp bloka taga noteikumam |
Šie iestatījumi vada kanonisko komandu blockstudio-phpstan. Sākotnējos iestatījumus, slāņus un ieviešanu skatiet sadaļā PHPStan.
ai
| Opcija | Tips | Noklusējums | Apraksts |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Ģenerēt apvienotu konteksta failu ar blokiem, iestatījumiem, shēmām un dokumentāciju LLM rīkiem |
Dokumentācijas rādītāju un pilnu ģenerēto tekstu skatiet sadaļā MI integrācija.
Iespējojiet un apvienojiet komplektā iekļautos bezgalvas UI komponentus, kas ieviesti Blockstudio 7.3.