Siirry sisältöön

Loogiset löytölähteet

Blockstudio etsii tavallisesti tiedostoja fyysisistä teemahakemistoista. Ajonaikaiset työkalut voivat korvata nämä hakemistot loogisella luettelolla. Tämä on hyödyllistä esikatseluissa, päällekkäiskerroksissa, luoduissa teemoissa, etäkiinnityksissä ja muissa ympäristöissä, joissa toisiinsa liittyvät tiedostot eivät sijaitse samassa fyysisessä juuressa.

Blockstudio jäsentää ja rekisteröi edelleen lohkot, sivut, kokoelmat, kuviot, kentät, mallit ja mallien osat. Lähde määrittää vain, mitkä loogiset tiedostot ovat näkyvissä ja mistä kukin näkyvä tiedosto voidaan lukea.

Luettelon lähteet

Korvaa oletusarvoiset Filesystem_Discovery_Source-objektit käyttämällä blockstudio/discovery/sources-suodatinta:

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

Käytettävissä olevat kontekstit ovat:

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

Luettelo on lopullinen näkyvä puu. Yhdistä kerrokset ennen sen palauttamista:

  • Käytä yhtä merkintää kutakin näkyvää loogista polkua kohti.
  • Anna valitun kerroksen määrittää fyysinen polku.
  • Jätä poistetut loogiset polut pois.
  • Palauta merkinnät missä järjestyksessä tahansa. Blockstudio lajittelee ne loogisen polun mukaan.
  • Lisää tyhjät loogiset hakemistot konstruktorin valinnaiseen kuudenteen argumenttiin, jos hakemistojen näkyvyydellä on merkitystä.

Inventory_Discovery_Source sopii taulukkopohjaisiin luetteloihin. Integraatiot voivat toteuttaa Discovery_Source-rajapinnan, jos merkinnät ratkaistaan viiveellä tai ne tulevat toisesta tallennusjärjestelmästä.

Sisarsijainnin ratkaisu

Loogisten sisarsijaintien fyysiset juuret voivat olla erilaiset. Ylä- block.json voi käyttää päällekkäiskerroksen index.php-tiedostoa, ja kerroksen sivu voi periä ylätason pages.json-, lataajan tai asettelun. Blockstudio ratkaisee nämä suhteet loogisen polun perusteella ennen valittujen fyysisten tiedostojen lukemista.

Kokoelman ulkopuolisia lataajapolkuja koskee edelleen blockstudio/pages/allow_external_loader_path-tietoturvaraja.

Tunnisteet ja mitätöinti

Jokainen lähde tarjoaa:

  • Vakaan lähdetunnisteen valitulle suoritusympäristölle.
  • Sormenjäljen, joka muuttuu näkyvän luettelon muuttuessa.
  • Fyysiset seurattavat syötteet uudelleenlatausta ja välimuistin kelpoisuuden tarkistamista varten.
  • Jokaisen merkinnän alkuperätiedot ja metatiedot.

Blockstudio sisällyttää lähdetunnisteet ja sormenjäljet suoritusympäristön, sivumanifestin, Sivuston muokkain -mallin, piirtoalueen ja Tailwind-välimuistin tunnisteisiin.

Käytä blockstudio/cache/context-toimintoa, kun sama lähdevalinta voidaan hahmontaa useissa suoritusympäristön muunnelmissa:

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

Kontekstiarvon on oltava sarjoitettava ja vakaa vastaaville pyynnöille. Tailwind säilyttää viimeisimmän toimivan CSS-tiedon kontekstikohtaisessa nimiavaruudessa, joten yksi esikatselu ei saa toisen esikatselun varasisältöä CSS.

Luodut resurssit

Merkitse perityt tai vain luku -merkinnät tunnisteilla inherited: true, readOnly: true tai writable: false alkuperätiedoissa tai metatiedoissa. Tällöin Blockstudio kirjoittaa käännetyt resurssit kontekstikohtaiseen generated-alueeseen määritetyn Blockstudio-välimuistin juuren alle lähdetiedoston viereen kirjoittamisen sijaan. Luodut resurssit, Tailwind-tuloste, hahmonnusdokumentit ja staattiset esihahmonnukset käyttävät näin samaa kirjoitettavaa isäntäympäristön rajaa.

Mukautetun suoritusympäristön reitityksen kattavat kaksi suodatinta:

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

Käytä URL-suodatinta, kun valitut tiedostot sijaitsevat wp-content-hakemiston ulkopuolella tai niitä tarjotaan suoritusympäristön päätepisteen kautta.