Pereiti prie turinio

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:

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

Galimi kontekstai:

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

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

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

Naudokite filtrą URL, kai pasirinkti failai yra ne wp-content aplanke arba pateikiami per vykdymo aplinkos galinį tašką.