Logické zdroje vyhľadávania
Blockstudio zvyčajne vyhľadáva súbory vo fyzických adresároch tém. Nástroje prostredia môžu tieto adresáre nahradiť logickým inventárom. Hodí sa to pre ukážky, prekrytia, generované témy, vzdialené pripojenia a ďalšie prostredia, v ktorých súvisiace súbory nemajú spoločný fyzický koreň.
Blockstudio naďalej analyzuje a registruje bloky, stránky, kolekcie, vzory, polia, šablóny a časti šablón. Zdroj určuje iba to, ktoré logické súbory sú viditeľné a odkiaľ možno čítať každý viditeľný súbor.
Zdroje inventára
Pomocou filtra blockstudio/discovery/sources nahradíte predvolené
objekty Filesystem_Discovery_Source:
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
);
Dostupné kontexty sú:
blocksfieldspagespatternssite-templatessite-template-parts
Inventár predstavuje konečný viditeľný strom. Pred jeho vrátením skombinujte vrstvy:
- Pre každú viditeľnú logickú cestu použite jednu položku.
- Fyzickú cestu nechajte určiť vybranej vrstve.
- Vynechajte odstránené logické cesty.
- Položky môžete vrátiť v ľubovoľnom poradí. Blockstudio ich zoradí podľa logickej cesty.
- Ak záleží na viditeľnosti adresárov, uveďte prázdne logické adresáre v nepovinnom šiestom argumente konštruktora.
Inventory_Discovery_Source je praktický pre inventáre založené na poliach.
Integrácie môžu implementovať rozhranie Discovery_Source, ak sa položky
vyhodnocujú až podľa potreby alebo pochádzajú z iného systému úložiska.
Rozpoznávanie súrodeneckých položiek
Logické súrodenecké položky môžu smerovať do rôznych fyzických koreňov. Nadradený
block.json môže používať prekrývacie index.php a stránka prekrytia môže dediť
nadradené pages.json, zavádzač alebo rozloženie. Blockstudio tieto vzťahy
vyrieši podľa logickej cesty ešte pred načítaním vybraných fyzických súborov.
Cesty zavádzačov mimo kolekcie podliehajú doterajším
bezpečnostným obmedzeniam blockstudio/pages/allow_external_loader_path.
Identita a zneplatnenie
Každý zdroj poskytuje:
- Stabilné ID zdroja pre vybrané prostredie.
- Odtlačok, ktorý sa mení so zmenou viditeľného inventára.
- Fyzické vstupy na sledovanie zmien a overovanie vyrovnávacej pamäte.
- Pôvod a metadáta každej položky.
Blockstudio zahŕňa ID zdrojov a odtlačky do identít prostredia, manifestu stránky, šablóny editora stránky, plátna a vyrovnávacej pamäte Tailwind.
Použite blockstudio/cache/context, keď ten istý výber zdroja možno vykresliť vo viacerých
variantoch prostredia:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
Hodnota kontextu musí byť serializovateľná a stabilná pre ekvivalentné požiadavky. Tailwind uchováva posledný platný CSS v mennom priestore špecifickom pre kontext, takže jedna ukážka nemôže dostať záložný CSS inej ukážky.
Generované zdroje
Zdedené položky alebo položky iba na čítanie označte v pôvode alebo metadátach pomocou
inherited: true, readOnly: true alebo writable: false. Blockstudio potom zapisuje
skompilované zdroje do rozsahu generated špecifického pre kontext pod nakonfigurovaným
koreňovým adresárom vyrovnávacej pamäte Blockstudio, nie vedľa nadradeného zdroja. Generované zdroje,
výstup Tailwind, vykreslené dokumenty a statické predvykreslenia tak zdieľajú
rovnakú zapisovateľnú hranicu hostiteľa.
Dva filtre pokrývajú vlastné smerovanie prostredia:
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
);
Použite filter URL, keď sa vybrané súbory nachádzajú mimo wp-content alebo sa poskytujú
cez koncový bod prostredia.