Ugrás a tartalomhoz

Logikai felderítési források

A Blockstudio alapértelmezés szerint a fizikai témakönyvtárakból deríti fel a fájlokat. A futásidejű eszközök ezeket a könyvtárakat logikai leltárral helyettesíthetik. Ez hasznos előnézetekhez, átfedésekhez, generált témákhoz, távoli csatolásokhoz és más olyan környezetekhez, ahol az összetartozó fájlok nem egyetlen fizikai gyökérkönyvtárban találhatók.

A Blockstudio továbbra is feldolgozza és regisztrálja a blokkokat, oldalakat, gyűjteményeket, mintákat, mezőket, sablonokat és sablonrészeket. A forrás csak azt határozza meg, hogy mely logikai fájlok láthatók, és honnan olvashatók be.

Leltárforrások

A blockstudio/discovery/sources szűrővel cserélheti le az alapértelmezett Filesystem_Discovery_Source objektumokat:

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
);

Az elérhető környezetek:

  • blocks
  • fields
  • pages
  • patterns
  • site-templates
  • site-template-parts

A leltár a végleges, látható fát írja le. Az eredmény visszaadása előtt állítsa össze a rétegeket:

  • Minden látható logikai útvonalhoz egy bejegyzést használjon.
  • A kiválasztott réteg adja meg a fizikai útvonalat.
  • Hagyja ki a törölt logikai útvonalakat.
  • A bejegyzések tetszőleges sorrendben adhatók vissza. A Blockstudio logikai útvonal szerint rendezi őket.
  • Ha fontos az üres logikai könyvtárak láthatósága, adja meg őket a konstruktor opcionális hatodik argumentumában.

A Inventory_Discovery_Source kényelmes megoldás tömbalapú leltárakhoz. Az integrációk megvalósíthatják a Discovery_Source interfészt, ha a bejegyzéseket késleltetve oldják fel, vagy másik tárolórendszerből származnak.

Testvérútvonalak feloldása

A logikai testvérelemek különböző fizikai gyökérkönyvtárakra oldódhatnak fel. Egy szülő- block.json használhat átfedő index.php elemet, az átfedő oldal pedig örökölheti a szülő pages.json elemét, betöltőjét vagy elrendezését. A Blockstudio az olvasás előtt, logikai útvonal alapján oldja fel ezeket a kapcsolatokat, majd beolvassa a kiválasztott fizikai fájlokat.

A gyűjteményen kívüli betöltőútvonalakra továbbra is érvényes a meglévő blockstudio/pages/allow_external_loader_path biztonsági határ.

Azonosítás és érvénytelenítés

Minden forrás megadja a következőket:

  • Stabil forrásazonosító a kiválasztott futtatókörnyezethez.
  • Az ujjlenyomat, amely a látható leltár változásakor megváltozik.
  • Fizikai megfigyelési bemenetek az élő újratöltéshez és a gyorsítótár ellenőrzéséhez.
  • Minden bejegyzés eredete és metaadatai.

A Blockstudio a forrásazonosítókat és ujjlenyomatokat is belefoglalja a futtatókörnyezet, az oldalak jegyzéke, a Site Editor-sablon, a Canvas és a Tailwind gyorsítótár azonosságába.

Használja a blockstudio/cache/context elemet, ha ugyanaz a forrásválasztás több futtatókörnyezeti változatban is megjeleníthető:

PHP
add_filter(
    'blockstudio/cache/context',
    fn ($context, string $scope) => [
        'preview' => 'feature-card',
        'site' => get_current_blog_id(),
    ],
    10,
    2
);

A környezet értékének szerializálhatónak és az egyenértékű kérések között stabilnak kell lennie. A Tailwind a legutóbbi érvényes CSS értéket környezetenként külön névtérben tárolja, így az egyik előnézet nem kaphatja meg egy másik előnézet tartalék CSS értékét.

Generált eszközök

Jelölje az örökölt vagy csak olvasható bejegyzéseket a inherited: true, readOnly: true, vagy writable: false elemmel az eredet vagy metaadatok között. Ezután a Blockstudio a lefordított eszközöket a konfigurált Blockstudio gyorsítótárgyökér alatti, környezetenként külön generated hatókörbe írja a szülőforrás mellé írás helyett. Így a generált eszközök, a Tailwind kimenete, a renderelt dokumentumok és a statikus előzetes renderelések ugyanazt az írható gazdagépkörnyezetet használják.

Két szűrő szabályozza az egyéni futásidejű útválasztást:

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
);

A URL szűrőt akkor használja, ha a kiválasztott fájlok a wp-content könyvtáron kívül találhatók, vagy futásidejű végponton keresztül érhetők el.