Vai al contenuto

Sorgenti di individuazione logica

Blockstudio normalmente individua i file nelle directory fisiche dei temi. Gli strumenti runtime possono sostituire tali directory con un inventario logico. È utile per anteprime, overlay, temi generati, mount remoti e altri ambienti in cui i file correlati non condividono un’unica radice fisica.

Blockstudio continua ad analizzare e registrare blocchi, pagine, raccolte, pattern, campi, template e parti di template. La sorgente determina solo quali file logici sono visibili e dove è possibile leggere ciascun file visibile.

Sorgenti dell’inventario

Usa il filtro blockstudio/discovery/sources per sostituire gli oggetti Filesystem_Discovery_Source predefiniti:

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

I contesti disponibili sono:

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

Un inventario è l’albero visibile finale. Componi i livelli prima di restituirlo:

  • Usa una voce per ogni percorso logico visibile.
  • Lascia che il livello selezionato fornisca il percorso fisico.
  • Ometti i percorsi logici eliminati.
  • Restituisci le voci in qualsiasi ordine. Blockstudio le ordina per percorso logico.
  • Se la visibilità delle directory è importante, includi le directory logiche vuote nel sesto argomento facoltativo del costruttore.

Inventory_Discovery_Source è pratico per gli inventari basati su array. Le integrazioni possono implementare l’interfaccia Discovery_Source quando le voci vengono risolte in modo differito o provengono da un altro sistema di archiviazione.

Risoluzione degli elementi adiacenti

Gli elementi logici adiacenti possono risolversi in radici fisiche diverse. Un block.json genitore può usare un index.php overlay e una pagina overlay può ereditare il proprio pages.json genitore, loader o layout. Blockstudio risolve queste relazioni in base al percorso logico prima di leggere i file fisici selezionati.

I percorsi dei loader esterni a una raccolta mantengono il limite di sicurezza esistente di blockstudio/pages/allow_external_loader_path.

Identità e invalidazione

Ogni sorgente fornisce:

  • Un ID sorgente stabile per il runtime selezionato.
  • Un’impronta digitale che cambia con l’inventario visibile.
  • Input fisici da monitorare per il ricaricamento a caldo e la convalida della cache.
  • Provenienza e metadati per ogni voce.

Blockstudio include gli ID sorgente e le impronte digitali nelle identità runtime, dei manifest delle pagine, dei template dell’editor del sito, di Canvas e della cache Tailwind.

Usa blockstudio/cache/context quando la stessa selezione di sorgenti può essere renderizzata con più varianti runtime:

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

Il valore di contesto deve essere serializzabile e stabile per richieste equivalenti. Tailwind mantiene l’ultimo CSS valido in uno spazio dei nomi specifico del contesto, così un’anteprima non riceve il fallback CSS di un’altra anteprima.

Risorse generate

Indica le voci ereditate o di sola lettura con inherited: true, readOnly: true o writable: false nella provenienza o nei metadati. Blockstudio scrive quindi le risorse compilate in un ambito generated specifico del contesto, sotto la radice configurata della cache Blockstudio, invece che accanto alla sorgente genitore. Le risorse generate, l’output Tailwind, i documenti di rendering e i prerender statici condividono così lo stesso limite host scrivibile.

Due filtri gestiscono il routing runtime personalizzato:

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

Usa il filtro URL quando i file selezionati si trovano fuori da wp-content o vengono forniti tramite un endpoint runtime.