Logische detectiebronnen
Blockstudio detecteert normaal gesproken bestanden in fysieke themamappen. Runtimehulpmiddelen kunnen deze mappen vervangen door een logische inventaris. Dit is handig voor previews, overlays, gegenereerde thema’s, externe mounts en andere omgevingen waarbij verwante bestanden geen fysieke hoofdmap delen.
Blockstudio parseert en registreert nog steeds blokken, pagina’s, collecties, patronen, velden, templates en template-onderdelen. De bron bepaalt alleen welke logische bestanden zichtbaar zijn en waar elk zichtbaar bestand kan worden gelezen.
Inventarisbronnen
Gebruik het filter blockstudio/discovery/sources om de standaardobjecten Filesystem_Discovery_Source te vervangen:
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
);
De beschikbare contexten zijn:
blocksfieldspagespatternssite-templatessite-template-parts
Een inventaris is de uiteindelijke zichtbare structuur. Stel lagen samen voordat je deze teruggeeft:
- Gebruik één item voor elk zichtbaar logisch pad.
- Laat de geselecteerde laag het fysieke pad leveren.
- Laat verwijderde logische paden weg.
- Geef items terug in willekeurige volgorde. Blockstudio sorteert ze op logisch pad.
- Neem lege logische mappen op in het optionele zesde argument van de constructor wanneer zichtbaarheid van mappen van belang is.
Inventory_Discovery_Source is handig voor inventarissen op basis van arrays.
Integraties kunnen de interface Discovery_Source implementeren wanneer items
lui worden opgelost of uit een ander opslagsysteem komen.
Resolutie van naastliggende bestanden
Logisch naastliggende bestanden kunnen naar verschillende fysieke hoofdlocaties verwijzen. Een bovenliggend
block.json kan een overlay index.php gebruiken, en een overlaypagina kan overerven van de bovenliggende
pages.json, loader of lay-out. Blockstudio lost deze relaties op
op basis van het logische pad voordat de geselecteerde fysieke bestanden worden gelezen.
Loaderpaden buiten een collectie vallen nog steeds onder de bestaande
beveiligingsgrens van blockstudio/pages/allow_external_loader_path.
Identiteit en invalidatie
Elke bron levert:
- Een stabiele bron-ID voor de geselecteerde runtime.
- Een fingerprint die verandert wanneer de zichtbare inventaris verandert.
- Fysieke watch-invoer voor hot reload en cachevalidatie.
- Herkomst en metadata voor elk item.
Blockstudio neemt bron-ID’s en fingerprints op in runtime-, paginamanifest-, Site Editor-template-, Canvas- en Tailwind-cache-identiteiten.
Gebruik blockstudio/cache/context wanneer dezelfde bronselectie onder meerdere runtimevarianten kan worden weergegeven:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
De contextwaarde moet serialiseerbaar en stabiel zijn voor gelijkwaardige verzoeken. Tailwind bewaart de laatst bekende goede CSS in een contextspecifieke naamruimte, zodat de ene preview niet de terugvalwaarde CSS van een andere preview ontvangt.
Gegenereerde assets
Markeer overgeërfde of alleen-lezen items met inherited: true, readOnly: true
of writable: false in de herkomst of metadata. Blockstudio schrijft dan
gecompileerde assets naar een contextspecifieke scope generated onder de geconfigureerde
Blockstudio-cachehoofdmap, in plaats van naast de bovenliggende bron. Gegenereerde assets,
Tailwind-uitvoer, renderdocumenten en statische prerenders delen zo
dezelfde schrijfbare hostgrens.
Twee filters dekken aangepaste runtimeroutering af:
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
);
Gebruik het filter URL wanneer geselecteerde bestanden buiten wp-content staan of
via een runtime-eindpunt worden aangeboden.