Liigu sisu juurde

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:

PHP
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:

  • blocks
  • fields
  • pages
  • patterns
  • site-templates
  • site-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:

PHP
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:

PHP
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.