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:
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:
blocksfieldspagespatternssite-templatessite-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:
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:
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.