Beállítások
A Blockstudio hatékony beállítási API rendszert tartalmaz, amellyel egy blockstudio.json fájlban, a téma mappájában és/vagy szűrők segítségével állíthatja be a lehetőségeket. Emellett a megfelelő jogosultsággal rendelkező felhasználók az adminisztrációs felületen vizuálisan is módosíthatják a beállításokat.
A JSON segítségével
Ha a téma mappájában található blockstudio.json fájl, akkor az aktuális webhely alapértelmezett beállításainak megadására szolgál. A fájl ellenőrzésére és az IDE-k automatikus kiegészítésének támogatására egy JSON séma áll rendelkezésre.
A fájl nem kötelező. Ha nincs jelen, a Blockstudio az adminisztrációs felületen mentett beállításokat használja a beépített alapértékek mellett. A fájl hozzáadását, módosítását vagy eltávolítását a rendszer automatikusan észleli, ezért nincs szükség a gyorsítótár ürítésére vagy kézi újratöltésre.
A következő tulajdonságok érhetők el:
{
"$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
}
}
Szűrők használatával
Másik lehetőségként a blockstudio/settings/${setting} szűrővel, PHP segítségével is beállíthatja a lehetőségeket, nagyobb rugalmasságot biztosítva.
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');
A blockstudio/settings/${setting} szűrővel beállított lehetőségek felülírják a blockstudio.json fájlban megadottakat. A két módszer együtt is használható.
A futásidejű értékekhez blockstudio/performance/${setting} szűrők és egy utolsó blockstudio/performance/config szűrő is tartozik. Az utóbbinak érvényes konfigurációs objektumot kell visszaadnia.
A források rétegeinek működése
A rendszer minden forrást betölt és összevon, a legalacsonyabb prioritásúval kezdve:
- Beépített alapértékek
- Az adminisztrációs UI felületen mentett beállítások (a
blockstudio_settingsopció) blockstudio.jsona témábanblockstudio/settings/*szűrők
A blockstudio.json csak az általa megadott kulcsokat írja felül. Korábban teljes egészében lecserélte a mentett beállításokat, ezért amint megjelent a fájl, a tőle független, adminisztrációs felületen mentett értékek érvényüket vesztették; mostantól ezekre épül. Ennek az a következménye, hogy az adminisztrációs UI felületen mentett elavult érték mindaddig érvényben marad, amíg a fájl nem adja meg az adott kulcsot, vagy el nem távolítja a mentett értéket. Ha egy beállítás máshogy működik, mint amit a fájl tartalmaz, ellenőrizze a mentett réteget a wp bs settings vagy a Settings::get_raw() segítségével; ezek csak azt adják vissza, amit az aktív JSON vagy a beállításforrás kifejezetten megadott.
Beállítások beolvasása innen: PHP
A Blockstudio\Settings betölti az aktív forrást, jelzi a hibás JSON értékeket, és automatikusan újratöltődik, ha megváltozik a 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);
}
A Settings::get_raw() használatával csak az aktív JSON vagy a beállításforrás által kifejezetten deklarált értékek kérhetők le. A Settings::fingerprint() determinisztikus azonosítót ad vissza a tényleges beállításokhoz. Hosszú ideig futó folyamatok a Settings::reload() kifejezett meghívásával azonnal beolvashatják a fájl változását. Normál hozzáféréskor a fájl ellenőrzése kérésenként vagy hosszú ideig futó PHP folyamatonként legfeljebb másodpercenként egyszer történik, az azonos méretű módosításokat is beleértve. A konfigurált útvonal módosítása a következő olvasáskor lép életbe. Aktív JSON fájl hiányában a mentett adatbázis-beállításokra ez az időablak nem vonatkozik.
A feloldott teljesítményprofil a Blockstudio\Runtime_Settings::current() segítségével érhető el. Perjeles vagy pontozott útvonalakat is támogat:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Elérhető beállítások
users
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
ids |
tömb | [] |
Szerkesztői hozzáféréssel rendelkező felhasználói azonosítók |
roles |
tömb | [] |
Szerkesztői hozzáféréssel rendelkező felhasználói szerepkörök |
assets
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
enqueue |
boolean | true |
Blokk-erőforrások automatikus sorba állítása |
reset.enabled |
boolean | false |
Az alapértelmezett blokksztilusok eltávolítása és a szerkesztő segédstílusainak alaphelyzetbe állítása |
reset.fullWidth |
array | [] |
Teljes szélességű szerkesztőelrendezést használó bejegyzéstípusok |
minify.css |
boolean | false |
A CSS kimenetének tömörítése |
minify.js |
boolean | false |
A JS kimenetének tömörítése |
process.scss |
boolean | false |
SCSS fájlok feldolgozása |
output |
string | source |
A lefordított erőforrások írási helye: source vagy cache |
inlineLimit |
integer | 0 |
Az oldalanként soron belül kiírt külső blokk-CSS bájtban megadva |
A output alapértelmezése source, ami minden blokk mellé egy _dist könyvtárat hoz létre. Állítsa cache értékre, ha a lefordított eszközöket inkább a Blockstudio gyorsítótár-könyvtárban szeretné tárolni; így a blokk forrásfája tiszta marad, és változtathatatlan munkakönyvtárból is telepíthető. A források Blockstudio beállítástól függetlenül átirányítják a mentést a gyorsítótárba.
A inlineLimit ki van kapcsolva a 0 értéknél, ezért minden külső stíluslap megőrzi a saját <link> címkéjét. Állítson be egy bájtokban megadott értéket, ha ehelyett az oldal legkisebb külső blokksztiluslapjait szeretné soron belül kiíratni, amíg összméretük nem haladja meg ezt az értéket. A 40000 az a korlát, amelyet a WordPress core ugyanerre a szabályra használ. Lásd: Kis stíluslapok soron belüli beillesztése.
Ha a reset.enabled aktív, a Blockstudio a megtisztított, frontendhez tartozó body_class értékeket is átmásolja a szerkesztővászonra. A csak a szerkesztőre érvényes osztálylista módosításához használja a blockstudio/editor/canvas/body_class lehetőséget.
cache
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
enabled |
logikai | true |
A Blockstudio fájlalapú gyorsítótárak engedélyezése |
path |
karakterlánc | "blockstudio/cache" |
Gyorsítótár-útvonal, relatív a(z) WP_CONTENT_DIR helyhez vagy abszolút |
namespaceGrace |
egész szám | 86400 |
Másodpercek száma, ameddig a megszüntetett gyorsítótár-névtér megmarad a törlés előtt |
Alapértelmezés szerint a gyorsítótárfájlok ide kerülnek: wp-content/blockstudio/cache, a feltöltési könyvtáron kívül. A relatív path értéket a rendszer innen oldja fel: WP_CONTENT_DIR; az abszolút útvonalat közvetlenül használja. Ez támogatja azokat a tárhelyszolgáltatókat, amelyek külön írható gyorsítótár-kötetet biztosítanak.
Ha engedélyezve van, a Blockstudio ezt az egyetlen gyökérkönyvtárat használja a build-adatokhoz, az előre elkészített blokkok regisztrációs adataihoz, a feloldott szerkesztői eszközökhöz, a Tailwind CSS értékekhez, a renderelési dokumentumokhoz, a szigettöredékekhez, a statikus előzetes renderelésekhez, a gráfindexekhez, a várólistákhoz és a diagnosztikához. Minden objektumot elkülönít hálózat, webhely, teljes futásidejű identitás és hatókör szerint. A futásidejű identitások magukban foglalják a Blockstudio értéket, a beállításokat, a WordPress, a PHP értéket, az aktív témát, az aktív bővítményeket, a logikai felderítési forrásokat, a környezetet, valamint a tulajdonos művelet által megadott explicit függőségi kivonatokat.
A tartalom, a kifejezések, a felhasználók és a metaadatok módosítása érvényteleníti a feltöltött mezőválasztásokat, de a blokkok szerkezeti felderítését és a lefordított eszközöket nem. A választások külön, rögzített buildútvonal-zár mellett frissülnek. Az egymást követő írási műveletek, például egy fordítás szinkronizálása vagy importálása összevonódnak: a nyugalmi időszak utáni első írás azonnali frissítést indít, a sorozat utolsó írása pedig harminc másodperc elteltével jelenik meg; ez az időtartam a blockstudio/cache/populate_debounce segítségével módosítható. Az olyan metaadat-módosítások, amelyeknél a WordPress könyvelési célú írásokat végez, például a bejegyzés szerkesztési zárolása, nem számítanak változásnak; a blockstudio/cache/populate_ignored_meta_keys bővíti ezt a listát. A szerkesztő mindig az élő beállításokat kérdezi le, ezért ez az időablak csak a megjelenítéskor beolvasott gyorsítótárazott választásokra van hatással. A forrásfájlok és a buildbeállítások továbbra is a megszokott módon érvénytelenítik a szerkezeti gyorsítótárat. A választások felülírása miatt a rendszer nem vizsgálja át minden tartalommódosításnál a gyorsítótár könyvtárát; az időszakos tisztítás továbbra is eltávolítja az árva ideiglenes fájlokat. A nyelvspecifikus futásidejű identitások elkülönülnek; a több gyorsítótárnévtér-könyvtár jelenléte egy többnyelvű webhelyen önmagában nem utal gyorsítótár-találat hiányára.
A SQLite naplózási tevékenysége egy blokk db adatkönyvtárán belül nem törli a gyorsítótárazott blokkmetaadatokat. A db.php, a figyelt forrásfájlok, valamint az adatkönyvtár forrásfájl- és alkönyvtár-struktúrájának változásai továbbra is érvénytelenítik a gyorsítótárat.
A futásidejű párhuzamos újraépítéseknél egyetlen kijelölt folyamat végez buildet. A többi kérés legfeljebb öt másodpercet vár, majd újra felhasználja a legutóbbi érvényes blokkmetaadatokat, ha a forrásfájlok és a szükséges lefordított eszközök még léteznek. Ha egy üres gyorsítótárú kéréshez nincs biztonságosan használható adat, a rendszer Retry-After értékkel HTTP 503 ad vissza, ahelyett hogy újabb buildet indítana. A blockstudio/cache/build_wait_budget szűrő ezredmásodpercben állítja be a várakozást mind a szerkezeti újraépítéseknél, mind a választékok frissítésénél. Tanácsadó fájlzárolást nem támogató tárhelynél a választékok védelem nélkül frissülnek és közzétételre kerülnek, így a következő kérés már a gyorsítótárból szolgálható ki.
A korábbi verziókból visszamaradt, üresjáratban lévő, kulcsspecifikus .build.lock fájlokat a rendszer e webhely gyorsítótárnévterei között a WP-Cron segítségével gyűjti össze. A folyamat a frissítést követő ötödik percben indul, és tíz másodperces keretben percenként legfeljebb 10,000 zárolást távolít el. A wp bs cache status jelzi a hátralévő darabszámot, a wp bs cache cleanup azonnal feldolgozza a hátralékot, a wp bs cache clear pedig üríti a futásidejű gyorsítótárat. Ha egy ütemezett köteg több mint tízperces késésben van, mert a cron nem fut le, a kérések óránként egy korlátozott számú zárolást törölnek, hogy a feldolgozás ne akadjon el. A rendszer békén hagyja a friss vagy zárolt fájlokat, az új, rögzített útvonalú zárolásokat pedig soha nem törli. A hátralék feldolgozása után ugyanez a köteg összegyűjti az elhagyott gyorsítótárnévtereket, ha lejárt a hozzájuk tartozó namespaceGrace; ez webhelyenként legfeljebb óránként egyszer történik, és a folyamat napi ütemezésben is lefut. A türelmi idő attól az első ellenőrzéstől számítódik, amely a névteret megszüntetettnek találja, nem pedig a legújabb fájl keletkezésétől; a rendszer soha nem törli azokat a névtereket, amelyek bármely hatókörben még aktuálisak.
A belső gyorsítótár-tisztítás nem hívja meg a WordPress melléklet-törlési szűrőket. Ha a tárhelyen a WP-Cron le van tiltva, továbbra is futtassa a szokásos ütemezett cron feldolgozót; ne törölje válogatás nélkül az aktív zárolási fájlokat a hátralék eltávolításához.
A blockstudio/settings/cache/path beállításszűrő módosítja a konfigurált értéket. A telepítésfüggő útvonal-feloldáshoz a blockstudio/cache/dir szűrő a feloldott alapkönyvtárat módosítja:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Azok a tárhelyek, ahol a bérlőazonosító eltér a WordPress hálózati/blogazonosítóktól, a blockstudio/cache/site_key szűrővel módosíthatják az értéket. Az eredmény megtisztítás után csak könyvtárnévként használható. A blockstudio/cache/context marad a megfelelő hely olyan szerializálható futásidejű változathoz, amelynek módosítania kell az objektumazonosítókat.
themeDefaults
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
titleTag |
logikai | false |
A WordPress címsorcímke-téma támogatásának engedélyezése |
suppressDirectoryUpdates |
logikai | false |
Az aktív gyermek- és szülőtémák eltávolítása a könyvtárfrissítési eredményekből |
A minták továbbra is a meglévő Blockstudio\Patterns API megoldást használják; ezek az alapértékek nem vezetnek be alternatív oldal- vagy mintafacádokat.
performance
A compat profil változatlanul hagyja az általános WordPress működését. A speed és a strict ugyanazokat a választható frontend-alapértékeket engedélyezi; minden gyermekbeállítás felülírhatja a profilhoz tartozó értékét.
A választható beállítások regisztrációs kapuk. Ha egy opcionális funkció false, a Blockstudio nem csatolja hozzá a funkció frontend-, adminisztrációs, szerkesztői, REST vagy ütemezett visszahívásait. Az Early Serve vagy az ütemezett előmelegítés letiltásakor a saját takarításuk egyszer lefut; a későbbi kérések már nem végeznek műveletet.
| Beállítás | Típus | Kompatibilitási alapértelmezés | Sebesség/szigorú alapértelmezés | Leírás |
|---|---|---|---|---|
profile |
string | "compat" |
Nem alkalmazható | compat, speed vagy strict |
wordpress.headNoise |
boolean | false |
true |
Az általános head-felderítés és az emoji-kimenet eltávolítása |
wordpress.embeds |
boolean | false |
true |
Az oEmbed-felderítés és a gazdagép szkriptjeinek eltávolítása |
wordpress.xmlrpc |
boolean | false |
true |
A XML-RPC és a pingbackek letiltása |
wordpress.editor |
boolean | false |
true |
A távoli szerkesztő felderítési felületeinek letiltása |
wordpress.frontendAssets |
boolean | false |
true |
Az általános core frontend-eszközök eltávolítása |
wordpress.media |
boolean | false |
true |
Képmegjelenítési alapértékek alkalmazása |
wordpress.heartbeat |
boolean | false |
true |
A Heartbeat korlátozása a szerkesztőkön kívül |
preload.links |
string | "off" |
"intent" |
Azonos eredetű dokumentumok előzetes betöltése felhasználói szándék után |
media.lazy |
boolean | false |
true |
A Blockstudio képbetöltőjének használata |
media.skeleton |
boolean | false |
true |
A beépített betöltési váz megjelenítése |
media.metadata |
boolean | false |
true |
A assets/media.json használatának deklarálása |
media.rootMargin |
string | "300px" |
"300px" |
A lusta betöltő metszési margója |
measurement.enabled |
boolean | false |
false |
Futtatókörnyezeti mérési API-k engedélyezése |
measurement.queryMonitor |
boolean | false |
false |
A legalább 50ms időt igénybe vevő lekérdezések bevonása |
measurement.headers |
boolean | false |
false |
Profil- és konfigurációhash-fejlécek küldése |
measurement.timings |
boolean | false |
false |
A futási időt tartalmazó fejléc küldése |
staticPrerender.enabled |
boolean | false |
false |
Anonim módon biztonságos HTML-gyorsítótárazás engedélyezése |
staticPrerender.ttl |
integer | 86400 |
86400 |
A gyorsítótárazott dokumentum maximális kora másodpercben |
staticPrerender.invalidate |
string | "signature" |
"signature" |
signature vagy növekményes graph identitás használata |
staticPrerender.earlyServe |
boolean | false |
false |
Biztonságos találatok kiszolgálása a WordPress indulása előtt |
staticPrerender.serveLoggedIn |
boolean | false |
false |
A felhasználók fogyaszthatják, de nem írhatják a gyorsítótár-találatokat |
staticPrerender.dynamicPaths |
array | [] |
[] |
Dinamikus állapotban tartandó útvonal-előtagok |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Gyorsítótár-találatokkal tárolt és azokkal küldött válaszfejlécek |
staticPrerender.warm.enabled |
boolean | false |
false |
A tartós, ütemezett bemelegítési sor engedélyezése |
staticPrerender.warm.interval |
integer | 3600 |
3600 |
Bemelegítési időköz másodpercben |
staticPrerender.warm.concurrency |
integer | 2 |
2 |
Egy bemelegítési menet során feldolgozott feladatok maximális száma |
staticPrerender.warm.transport |
string | "http" |
"http" |
http vagy a gazdagép által biztosított internal renderer használata |
A statikus előrenderelés alapértelmezés szerint le van tiltva, és csak kifejezett engedélyezés esetén működik. A letiltott főkapcsoló nem regisztrál előrenderelési kéréskezelőket, a letiltott earlyServe és warm.enabled kapcsolók pedig nem regisztrálnak adminisztrációs vagy cron kezelőket. Az aláírásmód hagyományos kérések esetén olcsón előállítható aktivált identitást használ. A gráfmód kifejezett buildeléshez készült: oldalanként rögzíti a forrásfüggőségeket, így egy oldal módosítása nem érvényteleníti a nem kapcsolódó dokumentumokat. Az előmelegelésről, telepítésről, korai kiszolgálásról és biztonságról lásd a Statikus előrenderelés című részt.
A mérések programozottan érhetők el:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Ha a fejlécek engedélyezve vannak, a Blockstudio elküldi a X-Blockstudio-Performance-Profile, a X-Blockstudio-Performance-Config és opcionálisan a X-Blockstudio-Performance-Time értékét. A blockstudio/performance/measurement_enabled művelet megkapja a feloldott futásidejű beállításokat.
A media beállítások vezérlik a bs_media_image() működését, a assets/media.json jegyzéket és a frontend lusta betöltőjét. A segédfüggvényről, a jegyzéképítőről és a betöltő működéséről lásd a Média című részt.
content
| Beállítás | Típus | Alapértelmezett érték | Leírás |
|---|---|---|---|
enabled |
boolean | false |
Content Sync konfiguráció engedélyezése |
id |
string | "default" |
A szinkronizált entitásokon tárolt tartalomkészlet-névtér |
path |
string | "content" |
Témához viszonyított tartalomfájl-könyvtár |
includePageSyncManaged |
boolean | false |
A Page Sync által kezelt bejegyzések belefoglalása a törzs birtoklása nélkül |
authors |
string | "ignore" |
Szerző kezelése (ignore vagy meglévő felhasználó login) |
postTypes |
array | [] |
Engedélyezőlistán szereplő bejegyzéstípusok |
meta.include |
array | [] |
Szinkronizálandó meta-kulcsok globmintái |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Kizárandó meta-kulcsok globmintái |
meta.references |
object | {} |
Deklarált meta-hivatkozások, amelyek azonosítók és UID-k között átíródnak |
taxonomies |
array | [] |
A kifejezésekhez és kapcsolatokhoz engedélyezőlistán szereplő regisztrált taxonómiák |
media |
string | "manifest" |
Melléklet-hivatkozás viselkedése (manifest vagy none) |
A Content Sync kezelése a wp bs content segítségével történik, és az engedélyezőlistán szereplő bejegyzéseket, postmeta-adatokat és deklarált hivatkozásokat hordozható fájlokká alakítja. A munkafolyamatról és a fájlformátumról lásd a Content Sync című részt.
editor
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
formatOnSave |
boolean | false |
A block.json mentéskori formázása |
assets |
array | [] |
A szerkesztőben betöltendő további eszközök |
markup |
boolean | false |
Jelölőszerkesztés engedélyezése |
tailwind
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
enabled |
boolean | false |
Tailwind CSS-fordítás engedélyezése |
config |
string | "" |
Tailwind v4 CSS-első konfiguráció |
A fordítás működéséről és a CSS-első konfiguráció formátumáról lásd: Tailwind CSS.
blockTags
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
enabled |
boolean | false |
Oldalszintű bs: címkék megjelenítésének engedélyezése a bejegyzéstartalomban és widgetterületeken |
allow |
array | [] |
Blokknevminták engedélyezőlistája; támogatja a fnmatch() helyettesítő karaktereket |
deny |
array | [] |
Blokknevminták tiltólistája; elsőbbséget élvez a allow beállítással szemben |
prefixes |
object | {} |
A rövidítések névterének előtagja; minden érték egy névtér vagy rendezett tömb |
A sablonszintű címkeme gjelenítés mindig aktív; ezek a beállítások az oldalszintű behelyettesítést vezérlik. A címkeszintaxisról és a feloldási szabályokról lásd a Megjelenítés című részt.
ui
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
enabled |
boolean | false |
A csomagban található bsui/* UI összetevők és app/* demóalkalmazások regisztrálása |
blockEditor
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
disableLoading |
boolean | false |
Blokkbetöltés letiltása a szerkesztőben |
enhance |
boolean | false |
Blockstudio szerkesztői rámutatási és kijelölési vezérlőelemeinek engedélyezése |
cssClasses |
array | [] |
Stíluslap-URL-ek, amelyekből CSS osztályokat nyer ki az osztálymező automatikus kiegészítéséhez |
cssVariables |
array | [] |
Stíluslap-URL-ek, amelyekből CSS változókat nyer ki a kódmező automatikus kiegészítéséhez |
blockEditor.blocks
Használja a blockEditor.blocks beállítást a projekt egészére érvényes blokkbeszúró-házirendhez. A allow és a deny blokkneveket és helyettesítő mintákat fogad el, például: 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"]
}
}
}
}
A blocks.styles.deny törli azokat a stílusokat, amelyeket a WordPress PHP blokkstílus-regiszterén keresztül regisztráltak:
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
A blockEditor.patterns beállítással letilthatja a globális mintaforrásokat, és szűrheti a mintakategóriákat.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
A globális médiabeszúró házirendjéhez használja a blockEditor.media beállítást.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
grab.enabled |
boolean | false |
A frontend elemgyűjtőjének engedélyezése |
perf |
boolean | false |
A teljesítményprofilozó engedélyezése minden oldalbetöltéskor |
canvas.enabled |
boolean | false |
A vászon engedélyezése |
canvas.adminBar |
boolean | true |
A WordPress adminisztrációs sáv megjelenítése a vászon megtekintésekor |
githooks
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
commit |
boolean | false |
Elemzést végző pre-commit hook létrehozása, amikor a blockstudio-githooks sync fut |
A létrehozott hook által végrehajtott műveletekről és a szinkronban tartásáról lásd a kezelt commit hook című részt.
phpstan
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
preset |
string | "base" |
Alapértelmezett elemzési előbeállítás, ha a parancssor nem választ ki ilyet: base, theme, extreme-theme vagy wordpress-render |
configuration |
string | "" |
Az előbeállítás mellett használt projekt-PHPStan konfiguráció, feloldása innen: blockstudio.json |
roots |
array | ["."] |
A kanonikus parancs által elemzett témagyökerek |
excludePaths |
array | [] |
További kereső kizárások minden konfigurált gyökérhez viszonyítva |
maxFiles |
integer | 10000 |
A témakereső által megvizsgált fájlok maximális száma |
blockTags |
object | {} |
Elemtérképek, címkealiasok és scanPhp a blokkcímke-szabályhoz |
Ezek a beállítások vezérlik a kanonikus blockstudio-phpstan parancsot. Az előbeállításokról, rétegekről és bevezetésről lásd: PHPStan.
ai
| Beállítás | Típus | Alapértelmezett | Leírás |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Egyesített kontextusfájl létrehozása blokkokról, beállításokról, sémákról és dokumentációról az LLM-eszközök számára |
A dokumentációs mutatóról és a teljes generált szövegről lásd az AI-integráció című részt.
Engedélyezze és kapcsolja össze a csomagban található headless UI összetevőket, amelyeket a Blockstudio 7.3 vezetett be.