Hoppa till innehåll

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:

PHP
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:

  • blocks
  • fields
  • pages
  • patterns
  • site-templates
  • site-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:

PHP
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:

PHP
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.