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:
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:
blocksfieldspagespatternssite-templatessite-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:
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:
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.