Loogilised avastusallikad
Tavaliselt leiab Blockstudio failid füüsilistest teemakataloogidest. Käitusaja tööriistad võivad need kataloogid asendada loogilise loendiga. See on kasulik eelvaadete, ülekatete, genereeritud teemade, kaugühendusega ühendatud kataloogide ja muude keskkondade puhul, kus seotud failid ei asu samas füüsilises juurkaustas.
Blockstudio parsib ja registreerib endiselt plokke, lehti, kollektsioone, mustreid, välju, malle ja malliosi. Allikas määrab ainult, millised loogilised failid on nähtavad ning kust saab iga nähtavat faili lugeda.
Loendiallikad
Vaikimisi objektide Filesystem_Discovery_Source asendamiseks kasutage filtrit blockstudio/discovery/sources:
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
);
Saadaolevad kontekstid:
blocksfieldspagespatternssite-templatessite-template-parts
Loend on lõplik nähtav puu. Koostage kihid enne tagastamist:
- Kasutage iga nähtava loogilise tee jaoks üht kirjet.
- Laske valitud kihil määrata füüsiline tee.
- Jätke kustutatud loogilised teed välja.
- Kirjeid võib tagastada suvalises järjestuses. Blockstudio sordib need loogilise tee järgi.
- Kui kataloogide nähtavus on oluline, lisage konstruktorile kuuenda valikulise argumendina tühjad loogilised kataloogid.
Inventory_Discovery_Source sobib hästi massiivipõhiste loendite jaoks.
Integratsioonid võivad rakendada liidest Discovery_Source, kui kirjed lahendatakse
laisklaadimisega või pärinevad teisest salvestussüsteemist.
Kõrvutiste üksuste lahendamine
Loogilised kõrvutised failid võivad asuda eri füüsilistes juurkaustades. Ülem-
block.json võib kasutada ülekattega index.php-i ning ülekattega leht pärida oma
ülemast pages.json, laaduri või paigutuse. Blockstudio lahendab need seosed
loogilise tee järgi enne valitud füüsiliste failide lugemist.
Kollektsioonist väljapoole jäävate laaduriteede puhul kehtib senine
blockstudio/pages/allow_external_loader_path turvapiir.
Identiteet ja kehtetuks muutmine
Iga allikas pakub järgmist:
- Valitud käituskeskkonna stabiilne allika-ID.
- Sõrmejälg, mis muutub nähtava loendi muutumisel.
- Füüsilised jälgitavad sisendid kuumlaadimiseks ja vahemälu valideerimiseks.
- Iga kirje päritolu ja metaandmed.
Blockstudio lisab allika ID-d ja sõrmejäljed käitusaja, lehe manifesti, Site Editori malli, Canvas ja Tailwind vahemälu identiteetidesse.
Kasutage blockstudio/cache/context, kui sama allikavalik võib renderduda
mitmes käitusvariandis:
add_filter(
'blockstudio/cache/context',
fn ($context, string $scope) => [
'preview' => 'feature-card',
'site' => get_current_blog_id(),
],
10,
2
);
Konteksti väärtus peab olema jadastatav ja samaväärsete päringute korral stabiilne. Tailwind hoiab viimast head CSS-i kontekstipõhises nimeruumis, nii et üks eelvaade ei saa teise eelvaate varu-CSS-i.
Genereeritud varad
Märkige päritolus või metaandmetes päritud või kirjutuskaitstud kirjed tähistega inherited: true, readOnly: true
või writable: false. Seejärel kirjutab Blockstudio kompileeritud varad kontekstipõhisesse generated ulatusse seadistatud Blockstudio vahemälu juurkausta alla, mitte algse lähtefaili kõrvale. Seega jagavad genereeritud varad,
Tailwind väljund, renderdatud dokumendid ja staatiliselt eeltöödeldud lehed sama kirjutatavat hosti piiri.
Kohandatud käitusaja marsruutimist katavad kaks filtrit:
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
);
Kasutage filtrit URL, kui valitud failid asuvad väljaspool wp-content või neid pakutakse käitusaja lõpp-punkti kaudu.