Gå til indhold

Logiske opdagelseskilder

Blockstudio finder normalt filer i fysiske temamapper. Runtime-værktøjer kan erstatte disse mapper med en logisk beholdning. Det er nyttigt til forhåndsvisninger, overlays, genererede temaer, fjernmonteringer og andre miljøer, hvor relaterede filer ikke deler én fysisk rod.

Blockstudio analyserer og registrerer stadig blokke, sider, samlinger, mønstre, felter, skabeloner og skabelondele. Kilden bestemmer kun, hvilke logiske filer der er synlige, og hvor hver synlig fil kan læses fra.

Kilder til beholdningen

Brug filteret blockstudio/discovery/sources til at erstatte standardobjekterne 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
);

De tilgængelige kontekster er:

  • blocks
  • fields
  • pages
  • patterns
  • site-templates
  • site-template-parts

En beholdning er det endelige synlige træ. Sammensæt lagene, før du returnerer den:

  • Brug én post for hver synlig logisk sti.
  • Lad det valgte lag levere den fysiske sti.
  • Udelad slettede logiske stier.
  • Returnér posterne i vilkårlig rækkefølge. Blockstudio sorterer dem efter logisk sti.
  • Medtag tomme logiske mapper i konstruktorens valgfrie sjette argument, når det er vigtigt, at mapperne er synlige.

Inventory_Discovery_Source er praktisk til beholdninger baseret på arrays. Integrationer kan implementere grænsefladen Discovery_Source, når poster løses efter behov eller kommer fra et andet lagringssystem.

Løsning af søskendefiler

Logiske søskendefiler kan løses til forskellige fysiske rødder. En overordnet block.json kan bruge et overlay-index.php, og en overlayside kan arve sin overordnede pages.json, loader eller layout. Blockstudio løser disse relationer ud fra logiske stier, før de valgte fysiske filer læses.

Stier til loadere uden for en samling er fortsat underlagt den eksisterende sikkerhedsgrænse blockstudio/pages/allow_external_loader_path.

Identitet og ugyldiggørelse

Hver kilde angiver:

  • Et stabilt kilde-ID for det valgte runtime.
  • Et fingeraftryk, der ændres med den synlige beholdning.
  • Fysiske overvågningsstier til hot reload og cachevalidering.
  • Oplysninger om oprindelse og metadata for hver post.

Blockstudio medtager kilde-ID’er og fingeraftryk i identiteter for runtime, sidemanifest, skabelon i Site Editor, Canvas og Tailwind-cache.

Brug blockstudio/cache/context, når det samme kildevalg kan gengives under flere runtime-varianter:

PHP
add_filter(
    'blockstudio/cache/context',
    fn ($context, string $scope) => [
        'preview' => 'feature-card',
        'site' => get_current_blog_id(),
    ],
    10,
    2
);

Kontekstværdien skal kunne serialiseres og være stabil for tilsvarende anmodninger. Tailwind gemmer seneste gode CSS i et kontekstspecifikt navnerum, så én forhåndsvisning ikke får en anden forhåndsvisnings reserve-CSS.

Genererede aktiver

Markér nedarvede eller skrivebeskyttede poster med inherited: true, readOnly: true eller writable: false i oplysninger om oprindelse eller metadata. Blockstudio skriver derefter kompilerede aktiver til et kontekstspecifikt generated-omfang under den konfigurerede cacherod Blockstudio i stedet for ved siden af den overordnede kilde. Genererede aktiver, output fra Tailwind, gengivne dokumenter og statiske prerenderinger deler dermed den samme skrivbare værtsgrænse.

To filtre dækker brugerdefineret routing i runtime:

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

Brug filteret URL, når valgte filer ligger uden for wp-content eller betjenes via et runtime-slutpunkt.