Preskočiť na obsah

Logické zdroje vyhľadávania

Blockstudio zvyčajne vyhľadáva súbory vo fyzických adresároch tém. Nástroje prostredia môžu tieto adresáre nahradiť logickým inventárom. Hodí sa to pre ukážky, prekrytia, generované témy, vzdialené pripojenia a ďalšie prostredia, v ktorých súvisiace súbory nemajú spoločný fyzický koreň.

Blockstudio naďalej analyzuje a registruje bloky, stránky, kolekcie, vzory, polia, šablóny a časti šablón. Zdroj určuje iba to, ktoré logické súbory sú viditeľné a odkiaľ možno čítať každý viditeľný súbor.

Zdroje inventára

Pomocou filtra blockstudio/discovery/sources nahradíte predvolené objekty Filesystem_Discovery_Source:

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

Dostupné kontexty sú:

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

Inventár predstavuje konečný viditeľný strom. Pred jeho vrátením skombinujte vrstvy:

  • Pre každú viditeľnú logickú cestu použite jednu položku.
  • Fyzickú cestu nechajte určiť vybranej vrstve.
  • Vynechajte odstránené logické cesty.
  • Položky môžete vrátiť v ľubovoľnom poradí. Blockstudio ich zoradí podľa logickej cesty.
  • Ak záleží na viditeľnosti adresárov, uveďte prázdne logické adresáre v nepovinnom šiestom argumente konštruktora.

Inventory_Discovery_Source je praktický pre inventáre založené na poliach. Integrácie môžu implementovať rozhranie Discovery_Source, ak sa položky vyhodnocujú až podľa potreby alebo pochádzajú z iného systému úložiska.

Rozpoznávanie súrodeneckých položiek

Logické súrodenecké položky môžu smerovať do rôznych fyzických koreňov. Nadradený block.json môže používať prekrývacie index.php a stránka prekrytia môže dediť nadradené pages.json, zavádzač alebo rozloženie. Blockstudio tieto vzťahy vyrieši podľa logickej cesty ešte pred načítaním vybraných fyzických súborov.

Cesty zavádzačov mimo kolekcie podliehajú doterajším bezpečnostným obmedzeniam blockstudio/pages/allow_external_loader_path.

Identita a zneplatnenie

Každý zdroj poskytuje:

  • Stabilné ID zdroja pre vybrané prostredie.
  • Odtlačok, ktorý sa mení so zmenou viditeľného inventára.
  • Fyzické vstupy na sledovanie zmien a overovanie vyrovnávacej pamäte.
  • Pôvod a metadáta každej položky.

Blockstudio zahŕňa ID zdrojov a odtlačky do identít prostredia, manifestu stránky, šablóny editora stránky, plátna a vyrovnávacej pamäte Tailwind.

Použite blockstudio/cache/context, keď ten istý výber zdroja možno vykresliť vo viacerých variantoch prostredia:

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

Hodnota kontextu musí byť serializovateľná a stabilná pre ekvivalentné požiadavky. Tailwind uchováva posledný platný CSS v mennom priestore špecifickom pre kontext, takže jedna ukážka nemôže dostať záložný CSS inej ukážky.

Generované zdroje

Zdedené položky alebo položky iba na čítanie označte v pôvode alebo metadátach pomocou inherited: true, readOnly: true alebo writable: false. Blockstudio potom zapisuje skompilované zdroje do rozsahu generated špecifického pre kontext pod nakonfigurovaným koreňovým adresárom vyrovnávacej pamäte Blockstudio, nie vedľa nadradeného zdroja. Generované zdroje, výstup Tailwind, vykreslené dokumenty a statické predvykreslenia tak zdieľajú rovnakú zapisovateľnú hranicu hostiteľa.

Dva filtre pokrývajú vlastné smerovanie prostredia:

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

Použite filter URL, keď sa vybrané súbory nachádzajú mimo wp-content alebo sa poskytujú cez koncový bod prostredia.