Surse logice de descoperire
În mod normal, Blockstudio descoperă fișierele din directoarele fizice ale temei. Instrumentele runtime pot înlocui aceste directoare cu un inventar logic. Este util pentru previzualizări, straturi suprapuse, teme generate, montări la distanță și alte medii în care fișierele asociate nu au aceeași rădăcină fizică.
Blockstudio continuă să analizeze și să înregistreze blocuri, pagini, colecții, modele, câmpuri, șabloane și părți de șablon. Sursa stabilește doar ce fișiere logice sunt vizibile și de unde poate fi citit fiecare fișier vizibil.
Surse de inventar
Folosiți filtrul blockstudio/discovery/sources pentru a înlocui obiectele implicite
Filesystem_Discovery_Source:
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
);
Contextele disponibile sunt:
blocksfieldspagespatternssite-templatessite-template-parts
Un inventar este arborele final vizibil. Compuneți straturile înainte de a-l returna:
- Folosiți o intrare pentru fiecare cale logică vizibilă.
- Permiteți stratului selectat să furnizeze calea fizică.
- Omiteți căile logice șterse.
- Returnați intrările în orice ordine. Blockstudio le sortează după calea logică.
- Includeți directoarele logice goale în al șaselea argument opțional al constructorului atunci când vizibilitatea directoarelor contează.
Inventory_Discovery_Source este convenabil pentru inventarele bazate pe tablouri.
Integrările pot implementa interfața Discovery_Source atunci când intrările sunt
rezolvate la cerere sau provin dintr-un alt sistem de stocare.
Rezolvarea elementelor de la același nivel
Elementele logice înrudite pot fi rezolvate în rădăcini fizice diferite. Un părinte
block.json poate folosi un index.php suprapus, iar o pagină din stratul suprapus poate moșteni
pages.json, încărcătorul sau aspectul părintelui. Blockstudio rezolvă aceste relații
folosind calea logică înainte de a citi fișierele fizice selectate.
Căile încărcătorului din afara unei colecții păstrează limita de securitate
blockstudio/pages/allow_external_loader_path existentă.
Identitate și invalidare
Fiecare sursă furnizează:
- Un ID sursă stabil pentru runtime-ul selectat.
- O amprentă care se modifică odată cu inventarul vizibil.
- Intrări fizice de monitorizare pentru reîncărcarea la cald și validarea cache-ului.
- Proveniență și metadate pentru fiecare intrare.
Blockstudio include ID-urile sursei și amprentele în identitățile cache-urilor runtime, ale manifestului paginii, ale șablonului Site Editor, ale Canvas și ale Tailwind.
Folosiți blockstudio/cache/context când aceeași selecție de sursă poate fi redată în
mai multe variante runtime:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
Valoarea contextului trebuie să poată fi serializată și să rămână stabilă pentru cereri echivalente. Tailwind păstrează ultima versiune validă a CSS într-un spațiu de nume specific contextului, astfel încât o previzualizare să nu primească valoarea de rezervă CSS a altei previzualizări.
Resurse generate
Marcați intrările moștenite sau doar pentru citire cu inherited: true, readOnly: true,
sau writable: false în proveniență ori în metadate. Blockstudio scrie apoi
resursele compilate într-un domeniu generated specific contextului, sub rădăcina cache-ului
Blockstudio configurată, în loc să le scrie lângă sursa părinte. Resursele generate,
ieșirea Tailwind, documentele randate și pre-randările statice împart astfel
aceeași limită de scriere a gazdei.
Două filtre acoperă rutarea runtime personalizată:
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
);
Folosiți filtrul URL când fișierele selectate se află în afara wp-content sau sunt servite
printr-un endpoint runtime.