Logiska upptäcktskällor
Blockstudio upptäcker normalt filer från fysiska temakataloger. Körningsverktyg kan ersätta dessa kataloger med en logisk inventering. Det är användbart för förhandsvisningar, överlägg, genererade teman, fjärrmonteringar och andra miljöer där relaterade filer inte delar samma fysiska rot.
Blockstudio tolkar och registrerar fortfarande block, sidor, samlingar, mönster, fält, mallar och malldelar. Källan avgör bara vilka logiska filer som är synliga och var varje synlig fil kan läsas.
Inventeringskällor
Använd filtret blockstudio/discovery/sources för att ersätta standardobjekten
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
);
Tillgängliga sammanhang:
blocksfieldspagespatternssite-templatessite-template-parts
En inventering är det slutliga synliga trädet. Sätt samman lager innan du returnerar det:
- Använd en post för varje synlig logisk sökväg.
- Låt det valda lagret ange den fysiska sökvägen.
- Utelämna borttagna logiska sökvägar.
- Returnera posterna i valfri ordning. Blockstudio sorterar dem efter logisk sökväg.
- Inkludera tomma logiska kataloger i konstruktorns valfria sjätte argument när katalogernas synlighet spelar roll.
Inventory_Discovery_Source är praktisk för arraybaserade inventeringar.
Integrationer kan implementera gränssnittet Discovery_Source när poster
löses upp vid behov eller kommer från ett annat lagringssystem.
Lösning av syskonfiler
Logiska syskonfiler kan lösas till olika fysiska rötter. En överordnad
block.json kan använda ett överlägg index.php, och en överlagrad sida kan ärva sin
överordnade pages.json, laddare eller layout. Blockstudio löser dessa relationer
via logisk sökväg innan de valda fysiska filerna läses.
Sökvägar till laddare utanför en samling omfattas fortfarande av den befintliga
säkerhetsgränsen blockstudio/pages/allow_external_loader_path.
Identitet och ogiltigförklaring
Varje källa tillhandahåller:
- Ett stabilt käll-ID för den valda körningsmiljön.
- Ett fingeravtryck som ändras när den synliga inventeringen ändras.
- Fysiska bevakningsindata för direktinläsning och cachevalidering.
- Ursprung och metadata för varje post.
Blockstudio inkluderar käll-ID:n och fingeravtryck i identiteter för körning, sidmanifest, mallar i Site Editor, Canvas och cache för Tailwind.
Använd blockstudio/cache/context när samma källval kan renderas i
flera körningsvarianter:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
Kontextvärdet måste kunna serialiseras och vara stabilt för likvärdiga förfrågningar. Tailwind håller den senast fungerande CSS i ett kontextspecifikt namnrymdsutrymme, så att en förhandsvisning inte får en annan förhandsvisnings reserv-CSS.
Genererade resurser
Markera ärvda poster eller poster som endast kan läsas med inherited: true, readOnly: true,
eller writable: false i ursprungsinformationen eller metadata. Blockstudio skriver då
kompilerade resurser till ett kontextspecifikt omfång för generated under den konfigurerade
cacheroten Blockstudio i stället för intill den överordnade källan. Genererade resurser,
Tailwind-utdata, renderingsdokument och statiska förgenereringar delar därmed samma
skrivbara värdgräns.
Två filter hanterar anpassad routning vid körning:
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
);
Använd filtret URL när valda filer ligger utanför wp-content eller tillhandahålls
via en slutpunkt för körningsmiljön.