
Blockstudio 7.5 viimeistelee Blockstudio-projektien tiedostot ensisijaisena pitävän työnkulun: mukautetut kenttätyypit, tiedostopohjaiset Site Editor -pohjat, lohkosaarekkeet, Storh-tietokantatallennus, loogiset löytölähteet, koostettavat lohkotunnisteet sekä nopeammat käyttöönotto- ja ajonaikaiset polut.

Uudelleenkäytettävien mukautettujen kenttien avulla projekteissa voi määrittää olemassa olevien kenttien ryhmän kerran ja käyttää sitä uudelleen `type: "custom/{name}"`:n kanssa. Mukautetut kenttätyypit ratkaisevat toisenlaisen ongelman: niiden avulla teema tai lisäosa voi rekisteröidä uuden nimiavaruudellisen kenttätyypin, tarjota sille oman muokkaimen ohjaimen ja tallentaa arvon tavallisena Blockstudio-datana.

Lyhyesti:

- **Loogiset löytölähteet**: ajonaikaiset ympäristöt voivat tarjota kootun loogisen teemaluettelon alkuperätietoineen ja välimuistitunnisteineen, samalla kun Blockstudio vastaa löydöistä, rinnakkaistiedostojen ratkaisusta, luoduista resursseista, Canvasista ja Tailwind-toiminnasta.
- **PHP-kenttätyyppien rekisteri**: teemat ja lisäosat voivat rekisteröidä nimiavaruudellisia kenttätyyppejä, kuten `acme/dimensions`, käyttäen `bs_register_field_type()`- tai `blockstudio/field_types`-suodatinta.
- **Muokkaimen ohjausrekisteri**: mukautetut muokkaimen skriptit voivat kutsua funktiota `window.blockstudio.registerFieldType()` ja näyttää vastaavan React-ohjaimen tavallisessa Blockstudio-kentän UI-käyttöliittymässä.
- **Rakenteiset arvot**: mukautetut kentät voivat tallentaa merkkijonoja, lukuja, totuusarvoja, taulukoita tai objekteja pakottamatta objektien arvoja vaihtoehtokenttien normalisoinnin läpi.
- **Tallennustuki**: artikkelin metatiedot ja vaihtoehtojen taustalla olevat mukautetut kentät voivat määrittää arvonsa tyypin ja REST-skeeman, myös objekti- ja taulukkoarvoille.
- **Natiivi integraatio**: mukautetut kenttätyypit toimivat ryhmien, välilehtien, toistimien, uudelleenkäytettävien mukautettujen kenttien, mallien ja laajennusten mallipolkujen sisällä.
- **Sivuston muokkaimen mallit**: teemat voivat määrittää `wp_template`- ja `wp_template_part`-lähteitä tiedostoista `template.json`, `part.json` ja Blockstudio.
- **Lohkosaarekkeet**: lohkot voivat ensin näyttää välimuistin kannalta turvallisen rungon ja sitten ladata pyynnön mukaan räätälöidyt osat tai hakea ne erissä sivun latauduttua.
- **Storh-tietokantatallennus**: `bs.db` voi käyttää uploads-hakemistossa olevaa indeksoitua tiedostopohjaista tallennusta, jossa julkiset kokonaislukutunnisteet säilyvät ja siirtyminen JSONC-muodosta Storh-muotoon onnistuu työkalulla WP-CLI.
- **Jäsentimen ja bsui:n parannukset**: yhdistetyt richtext-kappaleet tarvitsevat vähemmän mukautettua jäsenninliimaa, `InnerBlocks` voi käyttää tokenisoitua `allowedBlocks`-sisältöä, sisäkkäinen `bs_render_block()`-tuloste vastaa käyttöliittymän renderöintiä muokkaimen esikatseluissa ja `bsui/button` saa kuvakkeet sekä helpommin käytettävät tyylittelykoukut.
- **Yhdisteltävät lohkotunnisteet**: etuliitetunnisteet voivat ratketa toisen etuliitteen kautta (`<theme-ui-input>` → `bsui/input`), ja etuliite- sekä aliastunnisteet renderöidään lohkomallien tulosteessa, eivät vain sivun sisällössä.
- **Isäntäkoneystävälliset koontivälimuistit**: ajonaikaiset ja muokkaimen välimuistit sijoitetaan oletuksena uploads-hakemiston ulkopuolelle, niiden sijaintia voi muuttaa ja vanhat merkinnät siivotaan, jotta pitkäikäisiin projekteihin ei kerry välimuistitiedostoja.
- **Sivujen vaiheittainen täsmäytys**: julkaisutyökalut voivat täsmäyttää koko tiedostopohjaisten sivujen luettelon, ohittaa muuttumattomat artikkelit, ilmoittaa tarkasti muutokset ja tallentaa varmennetun lähdetunnisteen käyttöönoton jälkeen.
- **Nopeampi lämmin renderöinti**: kelvolliset ajonaikaiset välimuistit ladataan ennen löytövaihetta, rinnakkaiset kylmät pyynnöt julkaisevat yhden atomisen tuloksen ja Tailwind ylläpitää sivuston kokoista välimuistia uudelleenkäytettävällä kääntäjän tilalla.
- **Turvallinen erärenderöinti**: viejät voivat nollata pyyntökohtaisen renderöintitilan asiakirjojen välillä rakentamatta löytöjä uudelleen sekä kerätä lähderiippuvuudet lohkojen renderöinnin aikana.

## Uudet ominaisuudet

7.5 tuo laajan joukon uusia ominaisuuksia löytöihin, malleihin ja tallennukseen.

### Loogiset löytölähteet

Blockstudio löytää tavallisesti tiedostot fyysisistä teemahakemistoista. 7.5 lisää alemman tason lähteen API ajonaikaisille ympäristöille, jotka kokoavat teeman peittokerroksista, esikatseluista, luoduista tiedostoista, etäliitoksista tai muista yhdistetyistä luetteloista.

Integraatio voi tarjota lopullisen loogisen tiedostopuun, ja Blockstudio vastaa edelleen lohkojen, kenttien, sivujen, kuvioiden, Site Editorin, Canvasin, resurssien ja Tailwind-toiminnan hallinnasta:

```php title="functions.php"
use Blockstudio\Inventory_Discovery_Source;

add_filter(
    'blockstudio/discovery/sources',
    function (array $sources, string $context): 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'],
                    ],
                    'card/index.php' => [
                        'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
                        'provenance' => ['layer' => 'preview'],
                    ],
                ],
                'preview-fingerprint'
            ),
        ];
    },
    10,
    2
);
```

Loogiset polut pysyvät vakaina, vaikka rinnakkaistiedostot tulisivat eri fyysisistä juurihakemistoista. Lähdetunnisteet ja sormenjäljet muodostavat ajonaikaisen ympäristön ja Tailwind-välimuistien tunnisteet, seurattavien syötteiden muutokset mitätöivät ne, ja alkuperätiedot määrittävät, minne luodut tiedostot voidaan kirjoittaa. Tavallisten teemojen oletustiedostojärjestelmälähde pysyy ennallaan.

### Tiedostopohjaiset Site Editor -mallit

Sivut ja kuviot ovat jo antaneet tiimeille mahdollisuuden säilyttää sisältörakenteita tiedostoissa. 7.5 laajentaa tämän mallin itse Site Editor -muokkaimeen.

```text
theme/
  templates/
    front-page/
      template.json
      index.php
  parts/
    header/
      part.json
      index.php
```

```json title="templates/front-page/template.json"
{
  "slug": "front-page",
  "title": "Front Page"
}
```

```php title="templates/front-page/index.php"
<div class="site-shell">
  <block name="core/template-part" slug="header" />

  <main>
    <h1>Welcome</h1>
    <block name="core/post-content" />
  </main>
</div>
```

Blockstudio kääntää lähteen samalla jäsentimellä, jota sivut ja kuviot käyttävät, ja tarjoaa tuloksen WordPress-ympäristölle tavallisena Site Editor -mallina tai malliosana. Site Editor näyttää mallin, käyttöliittymä voi renderöidä sen, ja WordPress hallitsee edelleen mukautuksia.

Tämä viimeinen kohta on tärkeä. Tiedostopohjaiset mallit ovat lähteen varaversio. Jos käyttäjä tallentaa mallin Site Editorissa, WordPress luo tavallisen `wp_template`- tai `wp_template_part`-tietokantamukautuksen, joka tulee käyttöön. Kun mukautus nollataan, uusin tiedostolähde näkyy jälleen.

### Sivujen vaiheittainen käyttöönotto

Tiedostopohjaiset sivut saivat käyttöönoton täsmäytysrajapinnan API versiossa 7.5. Versiosta 7.6.2 alkaen vain nimenomaiset API- ja `wp bs pages sync`-toiminnot käynnistävät synkronoinnin; tavalliset pyynnöt eivät koskaan ota lähdemuutoksia käyttöön:

```php
$report = Blockstudio\Pages::reconcile([
  'authoritative' => true,
  'plan_valid' => true,
  'source' => [
    'commit' => $commit,
    'dirtyHash' => $dirtyHash,
  ],
]);
```

Täsmäytys käy läpi koko haluttujen sivujen luettelon, vertaa sisältöä ja synkronointimoottorin sormenjälkiä sekä ilmoittaa luodut, päivitetyt, ennallaan olevat, poistetut ja epäonnistuneet sivut. Sivuille, joiden sormenjäljet täsmäävät, ei tehdä artikkeli- tai artikkelin metatietokirjoituksia. Puuttuvat hallitut sivut poistetaan vasta, kun löytövaihe on päättynyt virheittä.

Täsmäytys palauttaa deterministisen lähdetunnisteen, mutta ei merkitse käyttöönottoa onnistuneeksi. Käyttöönottotyökalu tallentaa tunnisteen vasta, kun vastaavat tiedostot ja reitit ovat aktiivisia ja varmennettuja. Tavallinen WP-CLI-käynnistys rekisteröi välimuistissa olevat kokoelma-artikkelityypit ja uudelleenkirjoitukset löytämättä ja synkronoimatta jokaista sivua.

### Lohkosaarekkeet

Useimmat Blockstudio-lohkot renderöidään palvelimella. Se sopii hyvin WordPress-käyttöön, mutta aiheuttaa tutun välimuistiongelman: yksi personoitu lohko voi vaikeuttaa koko sivun välimuistittamista.

Lohkosaarekkeet jakavat tämän rajan lohkotasolla.

```json title="block.json"
{
  "name": "acme/cart-count",
  "blockstudio": {
    "island": "dynamic"
  }
}
```

Dynaaminen saareke renderöi ensimmäisessä vastauksessa vain välimuistin kannalta turvallisen paikkamerkin. Selain lähettää sitten yhden eräpyynnön kaikista sivun käyttövalmiista dynaamisista saarekkeista, ja Blockstudio renderöi osat kävijän todellisessa pyyntöympäristössä.

Näin koko sivun välimuisti voi tallentaa sivun rungon, kun taas ostoskorin määrä, tiliohjaimet, käyttöoikeuksin rajattu UI tai muut käyttäjäkohtaiset osat pysyvät ajan tasalla.

```php title="placeholder.php"
<div class="cart-count-placeholder">Loading cart...</div>
```

```php title="index.php"
<div class="cart-count">
  <?php echo esc_html(acme_cart_count()); ?>
</div>
```

Lohkoille, jotka renderöivät jo välimuistin kannalta turvallista HTML-sisältöä ja tarvitsevat vain käyttöliittymän liitossignaalin, käytä hydratoitua saareketta:

```json title="block.json"
{
  "name": "acme/tabs",
  "blockstudio": {
    "island": "hydrate"
  }
}
```

Hydratoidut saarekkeet eivät tee REST-pyyntöä. Ne renderöidään normaalisti, ja käyttöliittymässä ne saavat `blockstudio:island:hydrate`-tapahtuman.

Dynaamiset saarekkeet toimivat myös ohjelmallisissa renderöintipoluissa:

```php
bs_render_block([
  'name' => 'acme/cart-count',
  'data' => ['productId' => 42],
]);
```

Ja lohkotunnisteiden kautta:

```html
<bs:acme-cart-count product-id="42" />
```

Päätepisteen toiminta-ala on tarkoituksella rajattu. Se renderöi vain rekisteröityjä Blockstudio-lohkoja, jotka ovat dynaamisia ja jotka on nimenomaisesti merkitty dynaamisiksi saarekkeiksi. Attribuutit suodatetaan lohkoskeeman ja saareke-sallittujen luettelon perusteella, ja kukin merkki sisältää allekirjoituksen, jonka palveleva WordPress-sivusto on luonut.

### Storh-tietokantatallennus

Blockstudio-tietokantakerros tukee jo tauluja, SQLite-tietoja, JSONC-tietoja, artikkelin metatietoja ja mukautettuja artikkelityyppejä. 7.5 lisää `storage: "storh"`-tuen projekteille, jotka haluavat tiedostopohjaisen tallennuksen turvallisemmilla rinnakkaiskirjoituksilla ja skeemasta johdetuilla indekseillä, mutta eivät halua aktiivisia tietueita lohkojen lähdetiedostojen viereen.

```php title="db.php"
return [
    'storage' => 'storh',
    'fields'  => [
        'title'  => ['type' => 'string', 'required' => true],
        'status' => ['type' => 'string'],
        'count'  => ['type' => 'integer'],
    ],
];
```

Storh-tietueet sijaitsevat uploads-hakemistossa:

```text
wp-content/uploads/blockstudio/db/my-theme-my-block/default/
```

Julkinen API pysyy ennallaan. `bs.db()`, REST ja `Db::get()` palauttavat edelleen kokonaislukuarvoja `id`. Sisäisesti Blockstudio yhdistää nämä tunnisteet Storh-järjestelmän UUIDv7-asiakirjatunnisteisiin, joten olemassa oleva asiakaskoodi ei vaadi muutoksia.

Jokainen määritetyn skeeman kenttä indeksoidaan yhtäsuuruussuodattimia varten, numero- ja päivämäärätyyppiset kentät saavat arvoalueindeksit, ja nimenomaiset yksilöllisyysvihjeet välitetään eteenpäin. Projekteille, jotka aloittivat JSONC-siementiedostoilla, uusi CLI-siirto pitää lähdetiedoston paikallaan ja kirjoittaa vastaavan Storh-tallennuksen:

```bash
wp bs db migrate my-theme/app subscribers --to=storh
```

Näin JSONC saa selkeämmän roolin yksinkertaisena, versionhallintaan sopivana siemen- ja määritysmuotona, kun taas Storh on parempi oletusarvoinen tiedostopohja aktiivisesti kirjoitettavalle tuotantodatalle.

### Jäsentimen ja bsui:n parannukset

7.5 viimeistelee myös pienempiä osia, joita tarvitaan, kun projektissa käytetään enemmän tiedostopohjaisia malleja ja paketoituja UI-osia.

Elementtien yhdistäminen pystyy nyt käsittelemään tavallisen richtext-kappaletapauksen ilman mukautettua rakentajaa. Jos `<p>` yhdistetään rekisteröityyn ei-ytimen Blockstudio-lohkoon, jossa on `content`-richtext-attribuutti, yksinkertainen sisäteksti kopioidaan kyseiseen attribuuttiin. Sisäkkäiset tunnisteet ja yhdistetyt alielementit jäsennetään edelleen sisälohkoiksi.

`InnerBlocks` hyväksyy malleissa tokenisoidun `allowedBlocks`-sisällön:

```php title="index.php"
<InnerBlocks allowedBlocks="<?php echo esc_attr(wp_json_encode([
  'core/paragraph',
  'category:content',
  'bsui/field',
])); ?>" />
```

Tuetut tokenit ovat `namespace/*`, `category:<slug>` ja `@theme`. Ne laajennetaan palvelimella ennen kuin muokkain vastaanottaa mallin, joten käyttöliittymän renderöintipolku pysyy ennallaan.

Ohjelmalliset upotukset ovat myös ennustettavampia. `bs_render_block()` ja `bs_block()` renderöivät nyt upotetut lohkot käyttöliittymässä ratkaistuina HTML-elementteinä myös silloin, kun niitä kutsutaan toisen lohkon muokkain-esikatselun sisältä. Näin sisäkkäiset lohkot eivät vuoda raakaa `<RichText />`- tai `<InnerBlocks />`-pseudokomponenttia esikatselun merkintään.

Paketoitua UI-sisältöä varten `bsui/button` tukee nyt `icon`-attribuuttia ja toimintoa `iconPosition`. Paketoidun `bsui/*`-sisällön sisäiset tyylit tulostetaan `@layer bsui`-kaskadikerroksessa, ja painikkeiden muunnelmia voi laajentaa lisäämällä `blockstudio/ui/button/variants-style`-määrityksen olemassa olevan `blockstudio/blocks/attributes`-suodattimen lisäksi.

Lohkotunnisteita voi yhdistellä entistä monipuolisemmin. Etuliite voi ratketa toisen etuliitteen kautta, joten `theme`-projektietuliitteellä ja `ui`-nimiavaruusetuliitteellä varustettu `<theme-ui-input />` ratkeaa tunnisteeksi `bsui/input`. Rekisteröidyt etuliite- ja aliastunnisteet renderöidään nyt myös lohkomallien tulosteessa, eivät vain sivun sisällössä, joten malli voi tulostaa ne suoraan funktion `bs_render_block()` kutsumisen sijaan.

Funktion `blockstudio/block_tags/builders` kautta rekisteröidyt mukautetut lohkonrakentajat osallistuvat nyt yhdenmukaisesti tunnisteiden ja yhdistettyjen elementtien jäsentämiseen. Nimenomaiset renderöintisuodattimet suoritetaan edelleen tämän jälkeen, ja ne voivat ohittaa rakentajan.

### Nopeammat lämpimät pyynnöt ja viennit

Ajonaikaisen ympäristön ja muokkaimen välimuistit sijoitetaan nyt oletuksena hakemistoon `wp-content/blockstudio/cache` uploads-hakemiston sijaan. Sijaintia voi muuttaa asetuksella `cache.path` tai `blockstudio/cache/dir`, joten pysyvä välimuistitus toimii myös isännillä, jotka estävät PHP-hyötykuormat uploads-hakemistossa. Ajonaikaisen ympäristön, muokkaimen resurssien ja Tailwind-välimuistien vanhat merkinnät siivotaan myös automaattisesti, jotta pitkäikäiset projektit eivät enää kerrytä rajattomasti välimuistitiedostoja levylle.

Käyttöliittymän lämpimät pyynnöt lataavat nyt kelvollisen ajonaikaisen rekisterin ennen löytölähteiden muodostamista. Näin vältetään rekursiivinen lähteiden etsintä, lohkojen muodostaminen, kenttien jäsentäminen ja toistuvat välimuistiavaimen puun läpikäynnit. Tuotanto- ja testiympäristöjen pyynnöt luottavat oletuksena varmennettuun seurantatilannekuvaan 20 sekunnin ajan, kun taas paikallisissa ja kehitysympäristöissä tarkistus tehdään edelleen jokaisella pyynnöllä.

Kylmän välimuistin luonti tapahtuu vain kerran rinnakkaisista pyynnöistä huolimatta. Yksi pyyntö rakentaa hyötykuorman ja julkaisee sen atomisesti, kun taas rinnakkaiset pyynnöt odottavat valmista tulosta. Tailwind säilyttää nyt oletuksena enintään 1,000 käännettyä merkintää 30 päivän ajan ja käyttää kääntäjän lämpimän käynnistyksen tilaa uudelleen, joten sivuston laajuinen reittijoukko ei enää pyöri pienen välimuistin läpi.

Pitkäikäiset viejät voivat kutsua funktiota `Blockstudio\Batch_Render::reset()` asiakirjojen välillä. Se tyhjentää pyyntökohtaiset laskurit, resurssit, saarekkeet, asettelut ja Tailwind-luonnin rakentamatta löytöjä uudelleen. Suodatin `blockstudio/render/dependencies` tarjoaa kunkin renderöidyn lohkon käyttämät malli- ja resurssipolut riippuvuuskaavioita varten.

## Luotettavuus ja yhteensopivuus

Julkaisun viimeistelee useita korjauksia:

- Funktion `blockstudio/blocks/attributes` kautta muutetut kenttämäärittelyt ohjaavat nyt sekä renderöinnin aikaista vaihtoehtojen kelpoisuuden tarkistusta että muokkaimen skeemaa. Myös tyypitetyt numero- ja totuusarvovaihtoehdot ratkeavat yhdenmukaisesti.
- Muokkaimen lohkokääreet käyttävät samoja luotuja luokkia kuin käyttöliittymän renderöinnit, ja Canvas voi kopioida määritetyt käyttöliittymän body-luokat uuden `blockstudio/editor/canvas/body_class`-suodattimen kautta.
- Sisällön synkronointi tarkistaa koko lähdesuunnitelman ennen tuhoavia kirjoituksia, pitää siivoustoiminnot määritetyn sisältöjoukon sisällä ja ilmoittaa tiedostokirjoitusten virheistä päivittämättä kyseisen kohteen synkronointitilaa.
- Composer-paketit, jotka on niputettu aktiivisten tai yläteemojen symbolisiin linkkeihin, löytävät muokkaimen resurssit julkisen teeman URL-hakemistosta.
- Avaimella määritetyt tiedostosivut säilyttävät muokkaimen omistamat Blockstudio-kenttäarvot, siirtävät vanhemman sisäkkäisen avainrakenteen synkronoinnin yhteydessä ja hyväksyvät kelvolliseksi avaimeksi numeerisen nollan.
- Dynaamiset saarekkeet tarkistavat allekirjoitukset ennen pyynnön attribuuttisuodattimia, ohittavat allekirjoittamattoman pyyntöympäristön, palauttavat saman alkuperän kirjautuneet kävijät ja välttävät nimettömien käyttäjien välimuistitörmäykset.
- Raakat Markdown-sivupäätepisteet noudattavat nyt artikkelien näkyvyysasetuksia ja salasanasuojausta.
- Muokkaimen ohjaimet käsittelevät luotettavammin tyhjiä ehtoja, valintaruutujen kaikkien arvojen valintoja, asynkronisia vaihtoehtojen päivityksiä, dynaamisen renderöinnin järjestystä sekä toistimien RichText- tai WYSIWYG-tilaa.

## Mukautetut kenttätyypit

Lisätietoja edellä esitellyistä mukautetuista kenttätyypeistä.

### Miksi mukautettuja kenttätyyppejä?

Blockstudio-ratkaisun pitäisi olla hyödyllinen heti asennuksen jälkeen, mutta oikeissa projekteissa tarvitaan usein toimialakohtaisia ohjaimia: välistystokenien valitsimia, suunnittelujärjestelmän värimerkityksiä, mukautuvia mittoja, kuvakelähteitä, tuotevalitsimia tai rakenteiseen arvoon liittyviä toimituksellisia ohjaimia.

Ennen versiota 7.5 nämä projektit saattoivat joko yhdistellä useita sisäänrakennettuja kenttiä tai haarauttaa muokkaimen. Versio 7.5 tarjoaa näiden väliin tuetun vaihtoehdon: Blockstudio hallitsee kentän elinkaarta ja projekti ohjainta.

```php title="functions.php"
add_action('init', function () {
    wp_register_script(
        'acme-field-dimensions',
        get_stylesheet_directory_uri() . '/fields/dimensions.js',
        ['blockstudio-blocks', 'wp-components', 'wp-element'],
        '1.0.0',
        true
    );

    bs_register_field_type('acme/dimensions', [
        'attribute'     => 'object',
        'default'       => [],
        'editor_script' => 'acme-field-dimensions',
        'storage'       => [
            'type'        => 'object',
            'rest_schema' => [
                'type'                 => 'object',
                'additionalProperties' => ['type' => 'string'],
            ],
        ],
    ]);
});
```

```js title="fields/dimensions.js"
const { createElement: el } = wp.element;
const { TextControl } = wp.components;

window.blockstudio.registerFieldType('acme/dimensions', {
  component(props) {
    const value =
      props.value &&
      typeof props.value === 'object' &&
      !Array.isArray(props.value)
        ? props.value
        : {};
    const sides = props.sides || ['top', 'right', 'bottom', 'left'];

    return el(
      'div',
      {},
      sides.map((side) =>
        el(TextControl, {
          key: side,
          label: side,
          value: value[side] || '',
          onChange(nextValue) {
            props.onChange({
              ...value,
              [side]: nextValue,
            });
          },
        }),
      ),
    );
  },
});
```

Sen jälkeen kenttää voi käyttää kohteessa `block.json` natiivin kentän tavoin:

```json title="block.json"
{
  "blockstudio": {
    "attributes": [
      {
        "id": "margin",
        "type": "acme/dimensions",
        "label": "Margin",
        "sides": ["top", "bottom"],
        "default": {
          "top": "md",
          "bottom": "md"
        }
      }
    ]
  }
}
```

### Tavalliset malliarvot

Tallennettu arvo on käytettävissä kohteissa PHP, Twig ja Blade kuten mikä tahansa muu Blockstudio-attribuutti.

```php title="index.php"
<div class="<?php echo esc_attr('mt-' . ($a['margin']['top'] ?? '')); ?>">
  <?php echo esc_html($a['title'] ?? ''); ?>
</div>
```

Samat objektipolut toimivat myös laajennusten malleissa:

```json title="extend.json"
{
  "blockstudio": {
    "extend": "core/group",
    "attributes": [
      {
        "id": "margin",
        "type": "acme/dimensions",
        "set": [
          {
            "attribute": "class",
            "value": "mt-{attributes.margin.top} mb-{attributes.margin.bottom}"
          }
        ]
      }
    ]
  }
}
```

## Yhteensopivuushuomiot

Olemassa olevat sisäänrakennetut kenttätyypit pysyvät ennallaan. Myös olemassa olevat `custom/{name}`-uudelleenkäytettävät kenttäryhmät pysyvät ennallaan. Mukautettujen kenttätyyppien nimien on oltava pienaakkosilla ja nimiavaruudellisia, esimerkiksi `acme/dimensions`; nimiavaruudet `custom/` ja `blockstudio/` pysyvät varattuina.

Jos PHP rekisteröi kenttätyypin mutta sen muokkaimen skripti ei rekisteröi vastaavaa ohjainta, Blockstudio säilyttää tallennetun arvon ja näyttää muokkaimessa ilmoituksen, jota ei voi muokata. Jos kenttätyyppiä ei rekisteröidä kohteessa PHP, Blockstudio jättää sen pois luoduista WordPress-attribuuteista.

## 7.5.1-ylläpitopäivitys

7.5.1 poistaa taulukon merkkijonoksi muuntamisesta tulevan varoituksen, joka ilmestyi valmisteltaessa monivalinta-arvoja renderöintiä varten. Tallennetut ja renderöidyt arvot olivat jo oikein, mutta virheenkorjauslokiin saattoi tulla yksi varoitus jokaista kentän renderöintiä kohti.

Mukana tuleva `blockstudio/phpstan`-v0.1.7-päivitys tunnistaa myös nimettömien ryhmien sisään sisäkkäiset kentät kohteissa PHP, Twig ja Blade sekä päätellyissä malliattribuuttien rakenteissa. Olemassa olevat projektit saavat pakettikorjauksen komennolla `composer update blockstudio/phpstan`.
