Loģiskie atklāšanas avoti
Blockstudio parasti atklāj failus fiziskajās tēmu direktorijās. Izpildvides rīki var aizstāt šīs direktorijas ar loģisku inventāru. Tas noder priekšskatījumiem, pārklājumiem, ģenerētām tēmām, attālajām montāžām un citām vidēm, kur saistītajiem failiem nav kopīgas fiziskās saknes.
Blockstudio joprojām parsē un reģistrē blokus, lapas, kolekcijas, rakstus, laukus, veidnes un veidņu daļas. Avots nosaka tikai to, kuri loģiskie faili ir redzami un kur var nolasīt katru redzamo failu.
Inventāra avoti
Izmantojiet filtru blockstudio/discovery/sources, lai aizstātu noklusējuma
objektus 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
);
Pieejamie konteksti ir:
blocksfieldspagespatternssite-templatessite-template-parts
Inventārs ir galīgais redzamais koks. Pirms atgriešanas apvienojiet slāņus:
- Katram redzamajam loģiskajam ceļam izmantojiet vienu ierakstu.
- Ļaujiet atlasītajam slānim norādīt fizisko ceļu.
- Izlaidiet dzēstos loģiskos ceļus.
- Ierakstus var atgriezt jebkurā secībā. Blockstudio tos sakārto pēc loģiskā ceļa.
- Ja svarīga direktoriju redzamība, iekļaujiet tukšās loģiskās direktorijas konstruktora izvēles sestajā argumentā.
Inventory_Discovery_Source ir ērts masīvos balstītiem inventāriem.
Integrācijas var ieviest saskarni Discovery_Source, ja ieraksti tiek
atrisināti pēc pieprasījuma vai nāk no citas krātuves sistēmas.
Blakusceļu atrisināšana
Loģiski blakus faili var atrasties dažādās fiziskajās saknēs. Vecāka
block.json var izmantot pārklājuma index.php, un pārklājuma lapa var mantot sava
vecāka pages.json, ielādētāju vai izkārtojumu. Blockstudio atrisina šīs saistības
pēc loģiskā ceļa, pirms nolasa atlasītos fiziskos failus.
Ielādētāja ceļiem ārpus kolekcijas joprojām ir spēkā esošā
blockstudio/pages/allow_external_loader_path drošības robeža.
Identitāte un nederīguma atzīmēšana
Katrs avots nodrošina:
- Stabilu avota ID atlasītajai izpildvidei.
- Kontrolsummu, kas mainās līdz ar redzamo inventāru.
- Fiziskās novērošanas ievades karstajai pārlādei un kešatmiņas validācijai.
- Katram ierakstam izcelsmes informāciju un metadatus.
Blockstudio iekļauj avotu ID un kontrolsummas izpildvides, lapas manifesta, Site Editor veidnes, Canvas un Tailwind kešatmiņas identitātēs.
Izmantojiet blockstudio/cache/context, ja viena un tā pati avota atlase var tikt renderēta
vairākos izpildvides variantos:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
Konteksta vērtībai jābūt serializējamai un stabilai līdzvērtīgiem pieprasījumiem. Tailwind glabā pēdējo derīgo CSS kontekstam paredzētā nosaukumtelpā, tāpēc viens priekšskatījums nevar saņemt cita priekšskatījuma rezerves CSS.
Ģenerētie līdzekļi
Atzīmējiet mantotus vai tikai lasāmus ierakstus ar inherited: true, readOnly: true,
vai writable: false izcelsmes informācijā vai metadatos. Blockstudio pēc tam raksta
kompilētos līdzekļus kontekstam paredzētā tvēruma generated konfigurētās
Blockstudio kešatmiņas saknes ietvaros, nevis blakus vecākavotam. Tādējādi ģenerētie līdzekļi,
Tailwind izvade, renderētie dokumenti un statiskās pirmrenderes koplieto
vienu un to pašu rakstāmo resursdatora robežu.
Pielāgotai izpildvides maršrutēšanai ir paredzēti divi filtri:
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
);
Izmantojiet filtru URL, ja atlasītie faili atrodas ārpus wp-content vai tiek piegādāti
caur izpildvides galapunktu.