Loginiai aptikimo šaltiniai
Blockstudio paprastai aptinka failus fiziniuose temų kataloguose. Vykdymo aplinkos įrankiai gali šiuos katalogus pakeisti loginiu inventoriumi. Tai naudinga peržiūroms, perdangoms, sugeneruotoms temoms, nuotolinėms prijungtoms saugykloms ir kitoms aplinkoms, kur susiję failai nėra viename fiziniame šakniniame kataloge.
Blockstudio vis tiek analizuoja ir užregistruoja blokus, puslapius, rinkinius, šablonus, laukus, maketus ir šablonų dalis. Šaltinis nustato tik tai, kurie loginiai failai matomi ir kur galima skaityti kiekvieną matomą failą.
Inventoriaus šaltiniai
Naudokite filtrą blockstudio/discovery/sources, kad pakeistumėte numatytuosius
Filesystem_Discovery_Source objektus:
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
);
Galimi kontekstai:
blocksfieldspagespatternssite-templatessite-template-parts
Inventorius yra galutinis matomas medis. Prieš grąžindami sudėkite sluoksnius:
- Kiekvienam matomam loginiam keliui naudokite po vieną įrašą.
- Leiskite pasirinktam sluoksniui pateikti fizinį kelią.
- Neįtraukite ištrintų loginių kelių.
- Įrašus grąžinkite bet kokia tvarka. Blockstudio surikiuoja juos pagal loginį kelią.
- Jei svarbu, kad katalogai būtų matomi, konstruktoriaus pasirinktiniame šeštajame argumente įtraukite tuščius loginius katalogus.
Inventory_Discovery_Source patogu naudoti su masyvais pagrįstais inventoriais.
Integracijos gali įgyvendinti sąsają Discovery_Source, kai įrašai
nustatomi prireikus arba gaunami iš kitos saugyklos sistemos.
Gretimų failų kelio nustatymas
Logiškai gretimų failų fizinės šakninės vietos gali skirtis. Pirminis
block.json gali naudoti perdangos index.php, o perdangos puslapis gali paveldėti
pirminio failo pages.json, įkėlimo programą arba maketą. Blockstudio nustato šiuos ryšius
pagal loginį kelią prieš skaitydamas pasirinktus fizinius failus.
Įkėlimo programų keliams už rinkinio ribų taikoma esama
blockstudio/pages/allow_external_loader_path saugumo riba.
Tapatybė ir negaliojimo nustatymas
Kiekvienas šaltinis pateikia:
- Stabilų pasirinktos vykdymo aplinkos šaltinio ID.
- Piršto atspaudą, kuris keičiasi pasikeitus matomam inventoriui.
- Fizinius stebimus kelius, naudojamus perkrovimui iš naujo ir talpyklos patikrai.
- Kiekvieno įrašo kilmę ir metaduomenis.
Blockstudio įtraukia šaltinių ID ir pirštų atspaudus į vykdymo aplinkos, puslapio manifesto, Site Editor šablonų, Canvas ir Tailwind talpyklų tapatybes.
Naudokite blockstudio/cache/context, kai tą patį šaltinio pasirinkimą galima atvaizduoti
keliais vykdymo aplinkos variantais:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
Konteksto reikšmė turi būti nuosekliai serializuojama ir stabili lygiavertėms užklausoms. Tailwind saugo paskutinį tinkamą CSS kontekstui skirtoje vardų srityje, todėl viena peržiūra negauna kitos peržiūros atsarginio CSS.
Sugeneruoti ištekliai
Paveldėtus arba tik skaityti skirtus įrašus pažymėkite inherited: true, readOnly: true
arba writable: false kilmės duomenyse arba metaduomenyse. Tada Blockstudio rašo
sukompiliuotus išteklius į kontekstui skirtą generated aprėptį po sukonfigūruotu
Blockstudio talpyklos šakniniu katalogu, o ne šalia pirminio šaltinio. Todėl sugeneruoti ištekliai,
Tailwind išvestis, atvaizduoti dokumentai ir statiniai išankstiniai atvaizdai naudoja
bendrą rašomą pagrindinės aplinkos ribą.
Pasirinktiniam vykdymo aplinkos maršrutų parinkimui naudojami du filtrai:
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
);
Naudokite filtrą URL, kai pasirinkti failai yra ne wp-content aplanke arba pateikiami per vykdymo aplinkos galinį tašką.