Ugrás a tartalomhoz

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:

JSON
{
  "$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.

PHP
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:

  1. Beépített alapértékek
  2. Az adminisztrációs UI felületen mentett beállítások (a blockstudio_settings opció)
  3. blockstudio.json a témában
  4. blockstudio/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:

PHP
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:

PHP
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:

PHP
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:

PHP
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/*.

JSON
{
  "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:

JSON
{
  "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.

JSON
{
  "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.

JSON
{
  "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.

UI Összetevők

Engedélyezze és kapcsolja össze a csomagban található headless UI összetevőket, amelyeket a Blockstudio 7.3 vezetett be.