Pāriet uz saturu

Loģiskie atklāšanas avoti

Blockstudio parasti atklāj failus fiziskajās tēmu direktorijās. Izpildvides rīki var aizstāt šīs direktorijas ar loģisku inventāru. Tas noder priekšskatījumiem, pārklājumiem, ģenerētām tēmām, attālajām montāžām un citām vidēm, kur saistītajiem failiem nav kopīgas fiziskās saknes.

Blockstudio joprojām parsē un reģistrē blokus, lapas, kolekcijas, rakstus, laukus, veidnes un veidņu daļas. Avots nosaka tikai to, kuri loģiskie faili ir redzami un kur var nolasīt katru redzamo failu.

Inventāra avoti

Izmantojiet filtru blockstudio/discovery/sources, lai aizstātu noklusējuma objektus 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
);

Pieejamie konteksti ir:

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

Inventārs ir galīgais redzamais koks. Pirms atgriešanas apvienojiet slāņus:

  • Katram redzamajam loģiskajam ceļam izmantojiet vienu ierakstu.
  • Ļaujiet atlasītajam slānim norādīt fizisko ceļu.
  • Izlaidiet dzēstos loģiskos ceļus.
  • Ierakstus var atgriezt jebkurā secībā. Blockstudio tos sakārto pēc loģiskā ceļa.
  • Ja svarīga direktoriju redzamība, iekļaujiet tukšās loģiskās direktorijas konstruktora izvēles sestajā argumentā.

Inventory_Discovery_Source ir ērts masīvos balstītiem inventāriem. Integrācijas var ieviest saskarni Discovery_Source, ja ieraksti tiek atrisināti pēc pieprasījuma vai nāk no citas krātuves sistēmas.

Blakusceļu atrisināšana

Loģiski blakus faili var atrasties dažādās fiziskajās saknēs. Vecāka block.json var izmantot pārklājuma index.php, un pārklājuma lapa var mantot sava vecāka pages.json, ielādētāju vai izkārtojumu. Blockstudio atrisina šīs saistības pēc loģiskā ceļa, pirms nolasa atlasītos fiziskos failus.

Ielādētāja ceļiem ārpus kolekcijas joprojām ir spēkā esošā blockstudio/pages/allow_external_loader_path drošības robeža.

Identitāte un nederīguma atzīmēšana

Katrs avots nodrošina:

  • Stabilu avota ID atlasītajai izpildvidei.
  • Kontrolsummu, kas mainās līdz ar redzamo inventāru.
  • Fiziskās novērošanas ievades karstajai pārlādei un kešatmiņas validācijai.
  • Katram ierakstam izcelsmes informāciju un metadatus.

Blockstudio iekļauj avotu ID un kontrolsummas izpildvides, lapas manifesta, Site Editor veidnes, Canvas un Tailwind kešatmiņas identitātēs.

Izmantojiet blockstudio/cache/context, ja viena un tā pati avota atlase var tikt renderēta vairākos izpildvides variantos:

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

Konteksta vērtībai jābūt serializējamai un stabilai līdzvērtīgiem pieprasījumiem. Tailwind glabā pēdējo derīgo CSS kontekstam paredzētā nosaukumtelpā, tāpēc viens priekšskatījums nevar saņemt cita priekšskatījuma rezerves CSS.

Ģenerētie līdzekļi

Atzīmējiet mantotus vai tikai lasāmus ierakstus ar inherited: true, readOnly: true, vai writable: false izcelsmes informācijā vai metadatos. Blockstudio pēc tam raksta kompilētos līdzekļus kontekstam paredzētā tvēruma generated konfigurētās Blockstudio kešatmiņas saknes ietvaros, nevis blakus vecākavotam. Tādējādi ģenerētie līdzekļi, Tailwind izvade, renderētie dokumenti un statiskās pirmrenderes koplieto vienu un to pašu rakstāmo resursdatora robežu.

Pielāgotai izpildvides maršrutēšanai ir paredzēti divi filtri:

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

Izmantojiet filtru URL, ja atlasītie faili atrodas ārpus wp-content vai tiek piegādāti caur izpildvides galapunktu.