Preskoči na vsebino

Logični viri odkrivanja

Blockstudio datoteke običajno odkriva v fizičnih imenikih tem. Orodja izvajanja lahko te imenike nadomestijo z logičnim inventarjem. To je uporabno za predoglede, prekrivanja, ustvarjene teme, oddaljene priklope in druga okolja, kjer povezane datoteke nimajo skupnega fizičnega korena.

Blockstudio še vedno razčlenjuje in registrira bloke, strani, zbirke, vzorce, polja, predloge in dele predlog. Vir določa samo, katere logične datoteke so vidne in kje je mogoče prebrati posamezno vidno datoteko.

Viri inventarja

Uporabite filter blockstudio/discovery/sources za zamenjavo privzetih objektov 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
);

Na voljo so naslednji konteksti:

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

Inventar predstavlja končno vidno drevo. Preden ga vrnete, sestavite plasti:

  • Za vsako vidno logično pot uporabite en vnos.
  • Izbrana plast naj zagotovi fizično pot.
  • Izpustite izbrisane logične poti.
  • Vnosi so lahko v poljubnem vrstnem redu. Blockstudio jih razvrsti po logični poti.
  • Če je vidnost imenikov pomembna, vključite prazne logične imenike v neobvezni šesti argument konstruktorja.

Inventory_Discovery_Source je priročen za inventarje, ki temeljijo na poljih. Integracije lahko implementirajo vmesnik Discovery_Source, kadar se vnosi razrešujejo sproti ali prihajajo iz drugega sistema za shranjevanje.

Razreševanje sorodnih datotek

Logične sorodne datoteke se lahko razrešijo v različne fizične korene. Nadrejeni block.json lahko uporablja prekrivni index.php, stran v prekrivni plasti pa lahko podeduje nadrejeni pages.json, nalagalnik ali postavitev. Blockstudio te povezave razreši po logični poti, preden prebere izbrane fizične datoteke.

Poti nalagalnika zunaj zbirke ohranijo obstoječo varnostno mejo blockstudio/pages/allow_external_loader_path.

Identiteta in razveljavljanje

Vsak vir zagotavlja:

  • Stabilen ID vira za izbrano okolje izvajanja.
  • Prstni odtis, ki se spremeni ob spremembi vidnega inventarja.
  • Fizične vhode za spremljanje zaradi vročega ponovnega nalaganja in preverjanja predpomnilnika.
  • Izvorne podatke in metapodatke za vsak vnos.

Blockstudio v identitete predpomnilnikov izvajanja, manifesta strani, predloge urejevalnika mesta, platna in predpomnilnika Tailwind vključuje ID-je virov in prstne odtise.

Uporabite blockstudio/cache/context, kadar lahko ista izbira vira izriše več različic izvajalnega okolja:

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

Vrednost konteksta mora biti serializabilna in stabilna za enakovredne zahteve. Tailwind hrani zadnji dober CSS v imenskem prostoru za posamezen kontekst, zato en predogled ne more prejeti nadomestnega CSS drugega predogleda.

Ustvarjena sredstva

Podedovane vnose ali vnose samo za branje označite z inherited: true, readOnly: true ali writable: false v izvornih podatkih ali metapodatkih. Blockstudio nato zbrane datoteke zapiše v obseg generated, določen za kontekst, pod konfiguriranim korenom predpomnilnika Blockstudio, namesto poleg nadrejenega vira. Ustvarjena sredstva, izhod Tailwind, dokumenti izrisov in statični vnaprej izrisani dokumenti tako uporabljajo isto zapisljivo mejo gostitelja.

Dva filtra pokrivata usmerjanje izvajalnega okolja po meri:

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

Uporabite filter URL, kadar izbrane datoteke ležijo zunaj wp-content ali so na voljo prek izvajalne končne točke.