Logické zdroje vyhledávání
Blockstudio obvykle vyhledává soubory ve fyzických adresářích šablon. Nástroje běhového prostředí mohou tyto adresáře nahradit logickým inventářem. To se hodí pro náhledy, překryvy, generované šablony, vzdálená připojení a další prostředí, kde související soubory nemají společný fyzický kořenový adresář.
Blockstudio stále analyzuje a registruje bloky, stránky, kolekce, vzory, pole, šablony a části šablon. Zdroj pouze určuje, které logické soubory jsou dostupné a kde lze každý z nich načíst.
Zdroje inventáře
Pomocí filtru blockstudio/discovery/sources nahraďte výchozí 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 jsou:
blocksfieldspagespatternssite-templatessite-template-parts
Inventář představuje konečný viditelný strom. Před jeho vrácením složte jednotlivé vrstvy:
- Pro každou viditelnou logickou cestu použijte jednu položku.
- Fyzickou cestu určete podle vybrané vrstvy.
- Vynechte odstraněné logické cesty.
- Položky můžete vrátit v libovolném pořadí. Blockstudio je seřadí podle logické cesty.
- Pokud záleží na viditelnosti adresářů, uveďte prázdné logické adresáře ve volitelném šestém argumentu konstruktoru.
Inventory_Discovery_Source se hodí pro inventáře založené na polích.
Integrace mohou implementovat rozhraní Discovery_Source, pokud se položky
vyhodnocují líně nebo pocházejí z jiného systému úložiště.
Rozpoznávání sousedních souborů
Logicky sousední soubory se mohou nacházet v různých fyzických kořenech. Nadřazený soubor block.json může použít překryvný soubor index.php a stránka v překryvu může zdědit nadřazený pages.json, zavaděč nebo rozvržení. Blockstudio tato propojení vyhodnocuje podle logické cesty ještě před načtením vybraných fyzických souborů.
Cesty zavaděčů mimo kolekci nadále podléhají stávající bezpečnostní hranici blockstudio/pages/allow_external_loader_path.
Identita a zneplatnění
Každý zdroj poskytuje:
- Stabilní ID zdroje pro vybrané běhové prostředí.
- Otisk, který se mění spolu s viditelným inventářem.
- Fyzické vstupy pro sledování změn a ověřování mezipaměti.
- Původ a metadata pro každou položku.
Blockstudio zahrnuje ID a otisky zdrojů do identit běhového prostředí, manifestu stránky, šablony editoru webu, plátna a mezipaměti Tailwind.
Použijte blockstudio/cache/context, pokud lze stejný výběr zdroje vykreslit ve více variantách běhového prostředí:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
Hodnota kontextu musí být serializovatelná a stabilní pro ekvivalentní požadavky. Tailwind ukládá poslední platný CSS do jmenného prostoru specifického pro kontext, takže jeden náhled nemůže dostat záložní CSS jiného náhledu.
Generovaná aktiva
Označte zděděné položky nebo položky pouze ke čtení pomocí inherited: true, readOnly: true nebo writable: false v původu či metadatech. Blockstudio pak zapíše zkompilovaná aktiva do rozsahu generated specifického pro kontext pod nakonfigurovaným kořenem mezipaměti Blockstudio, místo aby je ukládal vedle nadřazeného zdroje. Generovaná aktiva, výstup Tailwind, dokumenty vykreslování i staticky předběžně vykreslené stránky tak sdílejí stejnou zapisovatelnou hranici hostitele.
Vlastní směrování běhového prostředí pokrývají dva filtry:
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žijte filtr URL, pokud se vybrané soubory nacházejí mimo wp-content nebo jsou poskytovány prostřednictvím koncového bodu běhového prostředí.