Indstillinger
Blockstudio indeholder en avanceret indstillingsfunktion API, der gør det muligt at angive indstillinger via en blockstudio.json-fil i temamappen og/eller via filtre. Derudover kan autoriserede brugere visuelt ændre indstillingerne i administrationsområdet.
Via JSON
Hvis der findes en blockstudio.json-fil i temamappen, bruges den til at angive standardindstillingerne for det aktuelle websted. Et JSON-skema er tilgængeligt til validering af filen og til at hjælpe med autofuldførelse i et IDE.
Filen er valgfri. Uden den bruger Blockstudio indstillinger, der er gemt i administrationsområdet, oven i de indbyggede standardindstillinger. Tilføjelse, ændring eller fjernelse af filen registreres automatisk, så det er ikke nødvendigt at rydde cachen eller genindlæse manuelt.
Følgende egenskaber er tilgængelige:
{
"$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
}
}
Via filtre
Alternativt kan du bruge filteret blockstudio/settings/${setting} til at angive indstillinger via PHP og få større fleksibilitet.
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');
Indstillinger angivet via filteret blockstudio/settings/${setting} tilsidesætter dem, der er angivet via filen blockstudio.json. De to metoder kan bruges sammen.
Runtimeværdier stiller også blockstudio/performance/${setting}-filtre og ét afsluttende blockstudio/performance/config-filter til rådighed. Sidstnævnte skal returnere et gyldigt konfigurationsobjekt.
Sådan sammenlægges kilderne
Alle kilder indlæses og sammenflettes, fra laveste prioritet først:
- Indbyggede standardindstillinger
- Indstillinger gemt via administrationens UI (indstillingen
blockstudio_settings) blockstudio.jsoni temaetblockstudio/settings/*-filtre
blockstudio.json tilsidesætter kun de nøgler, den angiver. Tidligere erstattede den de gemte indstillinger helt, så en ikke-relateret værdi gemt via administrationen holdt op med at gælde, så snart filen blev tilføjet; nu lægges den oven i dem. Ulempen er, at en forældet værdi gemt via administrationens UI fortsat gælder, indtil filen angiver den pågældende nøgle, eller den gemte værdi fjernes. Hvis en indstilling opfører sig anderledes end angivet i filen, kan du kontrollere det gemte lag med wp bs settings eller Settings::get_raw(), som kun returnerer det, den aktive kilde til JSON eller indstillinger udtrykkeligt har angivet.
Læs indstillinger fra PHP
Blockstudio\Settings indlæser den aktive kilde, rapporterer fejlformateret JSON og genindlæses automatisk, når blockstudio.json ændres:
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);
}
Brug Settings::get_raw(), når en integration kun har brug for værdier, der er
angivet eksplicit i den aktive JSON eller i indstillingskilden. Settings::fingerprint() returnerer
en deterministisk identitet for de effektive indstillinger. Langvarige processer kan kalde
Settings::reload() eksplicit for straks at indlæse en filændring. Ved normal adgang
tjekkes filen højst én gang i sekundet inden for en forespørgsel eller langvarig PHP-
proces, også ved ændringer, der bevarer filstørrelsen. Ændring af den konfigurerede sti træder i kraft
ved næste læsning. Når ingen JSON-fil er aktiv, forsinkes gemte databaseindstillinger ikke af dette tidsrum.
Den fastlagte ydeevneprofil er tilgængelig via Blockstudio\Runtime_Settings::current(). Den understøtter stiangivelser med skråstreg eller punktum:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Tilgængelige indstillinger
users
| Indstilling | Type | Standard | Beskrivelse |
|---|---|---|---|
ids |
array | [] |
Bruger-id’er med editoradgang |
roles |
array | [] |
Brugerroller med editoradgang |
assets
| Indstilling | Type | Standard | Beskrivelse |
|---|---|---|---|
enqueue |
boolean | true |
Sæt automatisk blokaktiver i kø |
reset.enabled |
boolean | false |
Fjern kerneblokkenes typografier, og anvend editorens værktøjsnulstilling |
reset.fullWidth |
array | [] |
Indlægstyper, der bruger editorlayoutet i fuld bredde |
minify.css |
boolean | false |
Minificér CSS-output |
minify.js |
boolean | false |
Minificér JS-output |
process.scss |
boolean | false |
Behandl SCSS-filer |
output |
string | source |
Hvor kompilerede aktiver skrives: source eller cache |
inlineLimit |
integer | 0 |
Bytes ekstern blok-CSS, der udskrives inline pr. side |
output er som standard source, som opretter en _dist-mappe ved siden af hver blok. Angiv cache for i stedet at skrive kompilerede ressourcer i cachemappen Blockstudio, så blokkens kildetræ forbliver rent og kan udrulles fra en uforanderlig checkout. Kilder Blockstudio kan ikke skrive til den placering og omdirigeres altid til cachen, uanset denne indstilling.
inlineLimit er deaktiveret ved 0, så alle eksterne typografiark beholder deres <link>-tag. Sæt værdien til et antal bytes for i stedet at udskrive sidens mindste eksterne bloktypografiark inline, så længe deres samlede størrelse holder sig inden for dette antal. 40000 er grænsen, som WordPress bruger til samme regel. Se
Inline små typografiark.
Når reset.enabled er aktiv, kopierer Blockstudio også rensede frontendværdier for body_class ind i editorens lærred. Brug blockstudio/editor/canvas/body_class til at justere listen over klasser, der kun gælder for editoren.
cache
| Indstilling | Type | Standard | Beskrivelse |
|---|---|---|---|
enabled |
boolean | true |
Aktivér filbaserede Blockstudio-cacher |
path |
string | "blockstudio/cache" |
Cacheplacering, relativ til WP_CONTENT_DIR eller absolut |
namespaceGrace |
integer | 86400 |
Antal sekunder, en udfaset cacheplads bevares før oprydning |
Som standard skrives cachefiler til wp-content/blockstudio/cache, uden for mappen uploads. En relativ path fortolkes ud fra WP_CONTENT_DIR; en absolut sti bruges direkte. Det understøtter værter, der stiller en dedikeret skrivbar cachevolumen til rådighed.
Når funktionen er aktiveret, bruger Blockstudio denne fælles rodmappe til byggeindhold, forudbyggede blokregistreringsdata, fastlagte editorressourcer, Tailwind CSS, renderingsdokumenter, øfragmenter, statiske forhåndsrenderinger, grafindekser, køer og diagnosticering. Hvert objekt isoleres efter netværk, websted, fuld runtimeidentitet og omfang. Runtimeidentiteter omfatter Blockstudio, indstillinger, WordPress, PHP, det aktive tema, aktive plugins, logiske opdagelseskilder, værtskonksten og eksplicitte afhængighedshashværdier angivet af den ansvarlige handling.
Ændringer i indhold, termer, brugere og metadata ugyldiggør udfyldte feltvalg, men ikke strukturel blokopdagelse eller kompilerede aktiver. Valgene opdateres separat under en fast lås på build-stien. En række skrivninger, f.eks. en synkronisering af oversættelser eller en import, samles: Den første skrivning efter en stille periode udløser straks en opdatering, og den sidste skrivning i rækken afspejles, når der er gået tredive sekunder, hvilket kan justeres med blockstudio/cache/populate_debounce. Metadata, som WordPress skriver som bogføring, f.eks. låsen for redigering af indlæg, tæller ikke som en ændring; blockstudio/cache/populate_ignored_meta_keys udvider denne liste. Editorens forespørgsler bruger altid liveindstillinger, så tidsvinduet påvirker kun cachelagrede valg, der læses ved gengivelse. Kildefiler og buildindstillinger ugyldiggør stadig den strukturelle cache som normalt. Overskrivning af valg scanner ikke cachemappen igen ved hver indholdsændring; regelmæssig oprydning fjerner stadig forældreløse midlertidige filer. Sprogspecifikke runtime-identiteter forbliver isolerede; flere cache-navnerumsmapper på et flersproget websted er ikke i sig selv tegn på et cache-miss.
SQLite-journalaktivitet i en bloks db-datamappe fjerner ikke cachelagrede blokmetadata. Ændringer i db.php, overvågede kildefiler eller datamappens struktur af kildefiler og undermapper ugyldiggør stadig cachen.
Ved samtidige runtimegenopbygninger vælges én bygger. Andre forespørgsler venter i op til fem sekunder og genbruger derefter senest fungerende blokmetadata, hvis kildefilerne og de nødvendige kompilerede ressourcer stadig findes. En kold forespørgsel uden en sikker nyttelast returnerer HTTP 503 med Retry-After i stedet for at starte endnu en bygning. Filteret blockstudio/cache/build_wait_budget justerer ventetiden i millisekunder for både strukturelle genopbygninger og opdateringer af valgmuligheder. En vært uden rådgivende fillåse opdaterer valgmuligheder uden lås og udgiver dem stadig, så næste forespørgsel rammer cachen.
Inaktive nøglespecifikke .build.lock-filer fra tidligere versioner indsamles på tværs af dette websteds cachepladser af WP-Cron. Oprydningen starter fem minutter efter opgraderingen og fjerner op til 10,000 låse i minuttet inden for en tidsramme på ti sekunder. wp bs cache status rapporterer det resterende antal, og wp bs cache cleanup tømmer straks køen, mens wp bs cache clear rydder runtimecachen. Hvis en planlagt kørsel er mere end ti minutter forsinket, fordi cron ikke kører, gennemgår forespørgsler en begrænset mængde låse én gang i timen, så oprydningen ikke går i stå. Nylige eller låste filer lades urørt, og de nye låse med faste stier indsamles aldrig. Når køen er tømt, indsamler samme kørsel forladte cachepladser, når deres namespaceGrace er udløbet, højst én gang i timen pr. websted, og opretholder en daglig kørsel til dette formål. Fristen regnes fra den første gennemgang, der finder en cacheplads udfaset, ikke fra dens nyeste fil, og en cacheplads, der stadig er aktuel for et af sine omfang, indsamles aldrig.
Intern oprydning af cachen udløser ikke filtre til sletning af WordPress-vedhæftninger. Værter med WP-Cron deaktiveret bør fortsat køre deres sædvanlige planlagte cron-arbejder; slet ikke alle aktive låsefiler for at tømme køen.
Indstillingsfilteret blockstudio/settings/cache/path ændrer den konfigurerede værdi. Til udrulningsspecifik opløsning af stier filtrerer blockstudio/cache/dir den fastlagte basismappe:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Værter med en tenantidentitet, der afviger fra WordPress-netværks- eller blog-id’er, kan filtrere blockstudio/cache/site_key. Resultatet renses og bruges kun som et mappesegment. blockstudio/cache/context er fortsat det rette sted til en serialiserbar runtimevariant, der skal ændre objektidentiteter.
themeDefaults
| Indstilling | Type | Standard | Beskrivelse |
|---|---|---|---|
titleTag |
boolean | false |
Aktivér temaunderstøttelse af WordPress-titelmærker |
suppressDirectoryUpdates |
boolean | false |
Fjern aktive undertemaer og overordnede temaer fra resultater af mappeopdateringer |
Mønstre bruger fortsat den eksisterende Blockstudio\Patterns API; disse standardindstillinger indfører ikke alternative side- eller mønsterfacader.
performance
Profilen compat lader den generiske WordPress-adfærd være uændret. speed og strict aktiverer de samme valgfri frontendstandarder; hver underindstilling kan tilsidesætte profilens værdi.
Valgfrie indstillinger fungerer som registreringsporte. Når en valgfri funktion er false, tilknytter Blockstudio ikke funktionens frontend-, administrations-, editor-, REST- eller planlagte callbacks. Hvis Early Serve eller planlagt opvarmning deaktiveres efter brug, udføres den tilhørende oprydning én gang; senere forespørgsler gør ingenting.
| Indstilling | Type | Kompatibilitetsstandard | Hastigheds-/streng standard | Beskrivelse |
|---|---|---|---|---|
profile |
string | "compat" |
Ikke relevant | compat, speed eller strict |
wordpress.headNoise |
boolean | false |
true |
Fjern generisk head-registrering og emoji-output |
wordpress.embeds |
boolean | false |
true |
Fjern oEmbed-registrering og værtsscripts |
wordpress.xmlrpc |
boolean | false |
true |
Deaktiver XML-RPC og pingbacks |
wordpress.editor |
boolean | false |
true |
Deaktiver fjernredigeringens registreringsflader |
wordpress.frontendAssets |
boolean | false |
true |
Fjern generiske frontend-aktiver fra kernen |
wordpress.media |
boolean | false |
true |
Anvend standardindstillinger for billedoutput |
wordpress.heartbeat |
boolean | false |
true |
Begræns Heartbeat uden for editorer |
preload.links |
string | "off" |
"intent" |
Forhåndshent dokumenter fra samme oprindelse efter brugerens handling |
media.lazy |
boolean | false |
true |
Brug Blockstudios billedindlæser |
media.skeleton |
boolean | false |
true |
Vis det indbyggede indlæsningsskelet |
media.metadata |
boolean | false |
true |
Erklær brug af assets/media.json |
media.rootMargin |
string | "300px" |
"300px" |
Skæringsmargen for lazy-loader |
measurement.enabled |
boolean | false |
false |
Aktivér API’er til måling ved kørsel |
measurement.queryMonitor |
boolean | false |
false |
Medtag forespørgsler, der tager mindst 50ms |
measurement.headers |
boolean | false |
false |
Send headers med profil- og konfigurationshash |
measurement.timings |
boolean | false |
false |
Send header med den forløbne køretid |
staticPrerender.enabled |
boolean | false |
false |
Aktivér anonymt sikker HTML-caching |
staticPrerender.ttl |
integer | 86400 |
86400 |
Maksimal alder for cachede dokumenter i sekunder |
staticPrerender.invalidate |
string | "signature" |
"signature" |
Brug identiteten signature eller inkrementel graph |
staticPrerender.earlyServe |
boolean | false |
false |
Server sikre cachehits, før WordPress starter |
staticPrerender.serveLoggedIn |
boolean | false |
false |
Tillad brugere at forbruge, men aldrig oprette, cachehits |
staticPrerender.dynamicPaths |
array | [] |
[] |
Stipræfikser, der skal forblive dynamiske |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Svarheaders, der gemmes med og sendes ved cachehits |
staticPrerender.warm.enabled |
boolean | false |
false |
Aktivér den vedvarende planlagte warm-kø |
staticPrerender.warm.interval |
integer | 3600 |
3600 |
Warm-interval i sekunder |
staticPrerender.warm.concurrency |
integer | 2 |
2 |
Maksimalt antal jobs behandlet pr. warm-kørsel |
staticPrerender.warm.transport |
string | "http" |
"http" |
Brug http eller en renderer leveret af værten internal |
Statisk prerendering er fortsat deaktiveret, medmindre det udtrykkeligt aktiveres. En deaktiveret hovedkontakt registrerer ingen hooks til prerendering, og de deaktiverede kontakter earlyServe og warm.enabled registrerer ingen admin- eller cron-hooks. Signaturtilstand bruger en billig aktiveret identitet ved almindelige forespørgsler. Graf-tilstand er beregnet til eksplicitte builds: Den registrerer kildeafhængigheder pr. side, så ændring af én side ikke ugyldiggør uvedkommende dokumenter. Se Statisk prerendering for detaljer om opvarmning, udrulning, tidlig levering og sikkerhed.
Målinger er tilgængelige programmatisk:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Når headere er aktiveret, sender Blockstudio X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config og eventuelt X-Blockstudio-Performance-Time. Handlingen blockstudio/performance/measurement_enabled modtager de løste runtime-indstillinger.
Indstillingerne for media styrer bs_media_image(), manifestet assets/media.json og lazy-loaderen til frontend. Se Medier for hjælperen, manifestbyggeren og loaderens funktion.
content
| Valgmulighed | Type | Standardværdi | Beskrivelse |
|---|---|---|---|
enabled |
boolean | false |
Aktivér Content Sync-konfiguration |
id |
string | "default" |
Navneområde for indholdssæt, der gemmes på synkroniserede enheder |
path |
string | "content" |
Mappe til indholdsfiler relativt til temaet |
includePageSyncManaged |
boolean | false |
Medtag indlæg, der administreres af Page Sync, uden at overtage deres indhold |
authors |
string | "ignore" |
Forfatterhåndtering (ignore eller eksisterende bruger, login) |
postTypes |
array | [] |
Tilladte indlægstyper |
meta.include |
array | [] |
Glob-mønstre for meta-nøgler, der skal synkroniseres |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Glob-mønstre for meta-nøgler, der skal udelades |
meta.references |
object | {} |
Erklærede metareferencer, der omskrives mellem ID’er og UID’er |
taxonomies |
array | [] |
Tilladte registrerede taksonomier for termer og relationer |
media |
string | "manifest" |
Håndtering af bilagsreferencer (manifest eller none) |
Content Sync administreres via wp bs content og eksporterer tilladte indlæg,
postmeta og erklærede referencer til flytbare filer. Se
Content Sync for arbejdsgangen og filformatet.
editor
| Valgmulighed | Type | Standardværdi | Beskrivelse |
|---|---|---|---|
formatOnSave |
boolean | false |
Formatér block.json ved lagring |
assets |
array | [] |
Yderligere aktiver, der skal indlæses i editoren |
markup |
boolean | false |
Aktivér redigering af markup |
tailwind
| Valgmulighed | Type | Standardværdi | Beskrivelse |
|---|---|---|---|
enabled |
boolean | false |
Aktivér Tailwind CSS-kompilering |
config |
string | "" |
Tailwind v4-først-konfiguration CSS |
Se Tailwind CSS for kompileringsadfærd og konfigurationsformatet, hvor CSS kommer først.
blockTags
| Valgmulighed | Type | Standardværdi | Beskrivelse |
|---|---|---|---|
enabled |
boolean | false |
Aktivér gengivelse af sidetags bs: i indlægsindhold og widgetområder |
allow |
array | [] |
Tilladelsesliste over bloknavnemønstre; understøtter jokertegn, fnmatch() |
deny |
array | [] |
Blokeringsliste over bloknavnemønstre; har forrang for allow |
prefixes |
object | {} |
Præfiks til navneområder for genveje; hver værdi er et navneområde eller en ordnet liste |
Gengivelse af tags på skabelonniveau er altid aktiv; disse indstillinger styrer udskiftning på sideniveau. Se Gengivelse for tagsyntaksen og reglerne for opløsning.
ui
| Valgmulighed | Type | Standardværdi | Beskrivelse |
|---|---|---|---|
enabled |
boolean | false |
Registrér de medfølgende bsui/*-komponenter til UI samt demoapps til app/* |
blockEditor
| Valgmulighed | Type | Standardværdi | Beskrivelse |
|---|---|---|---|
disableLoading |
boolean | false |
Deaktiver indlæsning af blokke i editoren |
enhance |
boolean | false |
Aktivér Blockstudio-editorens muligheder for fremhævning ved markør og valg |
cssClasses |
array | [] |
URL’er til stylesheets, hvorfra CSS-klasser udtrækkes til autofuldførelse i klassefeltet |
cssVariables |
array | [] |
URL’er til stylesheets, hvorfra CSS-variabler udtrækkes til autofuldførelse i kodefeltet |
blockEditor.blocks
Brug blockEditor.blocks til at styre blokindsætterens politik for hele projektet. allow og deny accepterer bloknavne og jokertegnsmønstre som 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 afregistrerer styles, der blev registreret via WordPresss
register til blokstyles PHP:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Brug blockEditor.patterns til at deaktivere globale kilder til mønstre og filtrere
mønstrekategorier.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Brug blockEditor.media til at styre politikken for den globale medieindsætter.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Valgmulighed | Type | Standardværdi | Beskrivelse |
|---|---|---|---|
grab.enabled |
boolean | false |
Aktivér elementvælgeren i frontend |
perf |
boolean | false |
Aktivér ydeevneprofileren ved hver sideindlæsning |
canvas.enabled |
boolean | false |
Aktivér lærredet |
canvas.adminBar |
boolean | true |
Vis adminlinjen WordPress, når lærredet vises |
githooks
| Valgmulighed | Type | Standardværdi | Beskrivelse |
|---|---|---|---|
commit |
boolean | false |
Generér en pre-commit-hook, der kun analyserer, når blockstudio-githooks sync kører |
Se den administrerede commit-hook for at se, hvad den genererede hook kører, og hvordan den holdes synkroniseret.
phpstan
| Valgmulighed | Type | Standardværdi | Beskrivelse |
|---|---|---|---|
preset |
string | "base" |
Analyseforudindstilling, når kommandolinjen ikke vælger en: base, theme, extreme-theme eller wordpress-render |
configuration |
string | "" |
Projektets PHPStan-konfiguration, der medtages sammen med forudindstillingen, hentet fra blockstudio.json |
roots |
array | ["."] |
Temarødder, der analyseres af den kanoniske kommando |
excludePaths |
array | [] |
Yderligere scannerudelukkelser relativt til hver konfigureret rod |
maxFiles |
integer | 10000 |
Maksimalt antal filer, der gennemgås af temascaneren |
blockTags |
object | {} |
Elementtilknytninger, tagaliaser og scanPhp for reglen for bloktags |
Disse indstillinger styrer den kanoniske kommando blockstudio-phpstan. Se
PHPStan for forudindstillinger, lag og ibrugtagning.
ai
| Valgmulighed | Type | Standardværdi | Beskrivelse |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Generér en samlet kontekstfil med blokke, indstillinger, skemaer og dokumentation til LLM-værktøjer |
Se AI-integration for dokumentationsindekset og den fulde genererede tekst.
Aktivér og sammensæt de medfølgende headless-komponenter til UI, som blev introduceret i Blockstudio 7.3.