Ga naar de inhoud

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:

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
);

De beschikbare contexten zijn:

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

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

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
);

Gebruik het filter URL wanneer geselecteerde bestanden buiten wp-content staan of via een runtime-eindpunt worden aangeboden.