Logikai felderítési források
A Blockstudio alapértelmezés szerint a fizikai témakönyvtárakból deríti fel a fájlokat. A futásidejű eszközök ezeket a könyvtárakat logikai leltárral helyettesíthetik. Ez hasznos előnézetekhez, átfedésekhez, generált témákhoz, távoli csatolásokhoz és más olyan környezetekhez, ahol az összetartozó fájlok nem egyetlen fizikai gyökérkönyvtárban találhatók.
A Blockstudio továbbra is feldolgozza és regisztrálja a blokkokat, oldalakat, gyűjteményeket, mintákat, mezőket, sablonokat és sablonrészeket. A forrás csak azt határozza meg, hogy mely logikai fájlok láthatók, és honnan olvashatók be.
Leltárforrások
A blockstudio/discovery/sources szűrővel cserélheti le az alapértelmezett
Filesystem_Discovery_Source objektumokat:
use Blockstudio\Inventory_Discovery_Source;
add_filter(
'blockstudio/discovery/sources',
function (array $sources, string $context, array $paths): array {
if ('blocks' !== $context) {
return $sources;
}
return [
new Inventory_Discovery_Source(
'preview:feature-card',
'/runtime-preview/feature-card/blockstudio',
[
'card/block.json' => [
'path' => '/theme/blockstudio/card/block.json',
'provenance' => [
'layer' => 'parent',
'inherited' => true,
],
],
'card/index.php' => [
'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
'provenance' => [
'layer' => 'preview',
],
],
],
'parent-and-preview-fingerprint',
['/theme/blockstudio', '/runtime-preview/feature-card/blockstudio']
),
];
},
10,
3
);
Az elérhető környezetek:
blocksfieldspagespatternssite-templatessite-template-parts
A leltár a végleges, látható fát írja le. Az eredmény visszaadása előtt állítsa össze a rétegeket:
- Minden látható logikai útvonalhoz egy bejegyzést használjon.
- A kiválasztott réteg adja meg a fizikai útvonalat.
- Hagyja ki a törölt logikai útvonalakat.
- A bejegyzések tetszőleges sorrendben adhatók vissza. A Blockstudio logikai útvonal szerint rendezi őket.
- Ha fontos az üres logikai könyvtárak láthatósága, adja meg őket a konstruktor opcionális hatodik argumentumában.
A Inventory_Discovery_Source kényelmes megoldás tömbalapú leltárakhoz.
Az integrációk megvalósíthatják a Discovery_Source interfészt, ha a bejegyzéseket
késleltetve oldják fel, vagy másik tárolórendszerből származnak.
Testvérútvonalak feloldása
A logikai testvérelemek különböző fizikai gyökérkönyvtárakra oldódhatnak fel. Egy szülő-
block.json használhat átfedő index.php elemet, az átfedő oldal pedig örökölheti a szülő
pages.json elemét, betöltőjét vagy elrendezését. A Blockstudio az olvasás előtt,
logikai útvonal alapján oldja fel ezeket a kapcsolatokat, majd beolvassa a kiválasztott fizikai fájlokat.
A gyűjteményen kívüli betöltőútvonalakra továbbra is érvényes a meglévő
blockstudio/pages/allow_external_loader_path biztonsági határ.
Azonosítás és érvénytelenítés
Minden forrás megadja a következőket:
- Stabil forrásazonosító a kiválasztott futtatókörnyezethez.
- Az ujjlenyomat, amely a látható leltár változásakor megváltozik.
- Fizikai megfigyelési bemenetek az élő újratöltéshez és a gyorsítótár ellenőrzéséhez.
- Minden bejegyzés eredete és metaadatai.
A Blockstudio a forrásazonosítókat és ujjlenyomatokat is belefoglalja a futtatókörnyezet, az oldalak jegyzéke, a Site Editor-sablon, a Canvas és a Tailwind gyorsítótár azonosságába.
Használja a blockstudio/cache/context elemet, ha ugyanaz a forrásválasztás több futtatókörnyezeti változatban is megjeleníthető:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
A környezet értékének szerializálhatónak és az egyenértékű kérések között stabilnak kell lennie. A Tailwind a legutóbbi érvényes CSS értéket környezetenként külön névtérben tárolja, így az egyik előnézet nem kaphatja meg egy másik előnézet tartalék CSS értékét.
Generált eszközök
Jelölje az örökölt vagy csak olvasható bejegyzéseket a inherited: true, readOnly: true,
vagy writable: false elemmel az eredet vagy metaadatok között. Ezután a Blockstudio
a lefordított eszközöket a konfigurált Blockstudio gyorsítótárgyökér alatti,
környezetenként külön generated hatókörbe írja a szülőforrás mellé írás helyett. Így a generált eszközök,
a Tailwind kimenete, a renderelt dokumentumok és a statikus előzetes renderelések
ugyanazt az írható gazdagépkörnyezetet használják.
Két szűrő szabályozza az egyéni futásidejű útválasztást:
add_filter(
'blockstudio/generated_output/path',
function (string $path, string $source, string $scope, array $metadata) {
return $path;
},
10,
4
);
add_filter(
'blockstudio/files/url',
function (string $url, string $path, string $scope) {
return $url;
},
10,
3
);
A URL szűrőt akkor használja, ha a kiválasztott fájlok a wp-content könyvtáron kívül találhatók, vagy futásidejű végponton keresztül érhetők el.