
Blockstudio 7.1 je prva funkcijska izdaja po prepisu v7. Medtem ko je v7 na novo zgradil temelje, 7.1 dodaja gradnike, ki bloke spreminjajo v nekaj več: plast podatkovne zbirke, strežniške funkcije, načrtovana opravila in CLI. Mapa bloka je zdaj lahko popolna aplikacija.

Tukaj je vse, kar je novega.

## Komponente

Vedno je obstajala napetost med bloki, ki jih uredniki uporabljajo v vstavljalniku, in bloki, ki jih razvijalci uporabljajo kot gradnike za druge stvari. Kartica, značka, statistični gradnik, vnosno polje obrazca. Potrebujejo celoten cevovod Blockstudio (atributi, predloge, sredstva, Tailwind), vendar nimajo kaj iskati v vstavljalniku.

Različica 7.1 uvaja komponente, ki to rešujejo. Nastavite `"component": true` v svojem block.json in blok bo šel skozi celoten graditveni cevovod, vendar ne bo registriran v registru vrst blokov WordPress. Ne prikaže se v vstavljalniku in ni v podatkih urejevalnika, poslanih v JavaScript, je pa v celoti na voljo za programsko upodabljanje.

```json title="block.json"
{
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      { "id": "title", "type": "text" },
      { "id": "description", "type": "textarea" }
    ]
  }
}
```

Upodobite jih iz PHP:

```php
bs_render_block([
  'name' => 'my-theme/card',
  'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);
```

Ali pa uporabite novo sintakso oznake HTML:

```html
<bs:my-theme-card title="My Card" description="Card content." />
```

## Oznake blokov

Bloke lahko zdaj vdelate kot oznake HTML z uporabo dveh zamenljivih sintaks:

```html
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />
```

Obe ustvarita enak rezultat. Obe delujeta z bloki Blockstudio in jedrnimi bloki WordPress. Znotraj predlog blokov se upodobita samodejno, brez dodatnega omogočanja. Tako lahko v predlogi sestavite celotne postavitve neposredno iz drugih blokov:

```twig title="index.twig"
<div class="my-page">
  <bs:mytheme-card title="Featured" />
  <block name="core/separator" />
  <bs:core-heading level="2">Section Title</bs:core-heading>
  <block name="core/group">
    <block name="core/paragraph">Inside a core group block.</block>
    <bs:mytheme-cta variant="primary" />
  </block>
</div>
```

Sintaksi se lahko poljubno gnezdita. Bloki Blockstudio se upodobijo skozi celoten cevovod (predloge, Tailwind, sredstva). Jedrni bloki se upodobijo prek WordPress z istimi upodabljalniki, ki poganjajo [Pages and Patterns](https://blockstudio.dev/sl/docs/pages-and-patterns/).

Za upodabljanje na ravni strani (vsebina objav, območja gradnikov) to omogočite v `blockstudio.json`:

```json
{ "blockTags": { "enabled": true } }
```

Seznami dovoljenih in zavrnjenih blokov z vzorci z nadomestnimi znaki določajo, kateri bloki se lahko upodobijo z oznakami. Atributa `data-*` in `html-*` se preneseta v korenski element HTML upodobljenega bloka. Registrirate lahko lastne upodabljalnike prek filtra `blockstudio/block_tags/renderers`.

Razčlenjevalnik oznak v ozadju uporablja nov lahek pregledovalnik nizov, ki v celoti nadomešča DOMDocument. Obdeluje gnezdene oznake s sledenjem globini, rekurzivne vsebniške bloke in mešano sintakso v enem prehodu. Na primerjalnih testih razčleni 1,000 ravnih oznak v 2.4ms in 100 ravni gnezdenja v 3.7ms, pri čemer je dosledno hitrejši od DOMDocument in WordPress's `WP_HTML_Tag_Processor`. Isti razčlenjevalnik obravnava tudi razčlenjevanje surovih elementov HTML za [Pages and Patterns](https://blockstudio.dev/sl/docs/pages-and-patterns/) in nadomešča razčlenjevalnik na osnovi DOMDocument, ki je prej obravnaval elemente `<p>`, `<div>` in druge elemente HTML.

## Nove vrste polj

### Block

Nova vrsta polja `block` omogoča, da se v atributu sklicujete na drug blok Blockstudio. Polja sklicanega bloka se razširijo neposredno z uporabo `idStructure` in `overrides`, tako kot polja po meri. Razlika je v tem, da dostop do vrednosti v predlogi vrne izhod upodobljenega bloka.

```json title="block.json"
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}
```

Če ima `mytheme/card` polji `heading` in `content`, gostiteljski blok v stranski vrstici dobi `card_heading` in `card_content`. V predlogi `{{ a.card }}` izpiše upodobljeno kartico. Deluje z običajnimi bloki in komponentami.

### Oznaka HTML

Vsaka tema ima bloke, pri katerih se mora raven naslova spreminjati glede na kontekst. H1 na domači strani, H2 na notranjih straneh. Namesto da bi vsakič ustvarili izbirno polje z vnaprej določenimi možnostmi, je zdaj na voljo namenska vrsta polja `html-tag` z vgrajenimi prednastavitvami.

```json
{
  "id": "tag",
  "type": "html-tag",
  "default": "h2",
  "tags": "heading",
  "exclude": ["h5", "h6"]
}
```

Prednastavitve: `heading` (h1-h6), `text` (naslovi + p, span, div), `structural` (div, section, article, aside, main, header, footer, nav), `all`. Lahko podate tudi lastno polje. `exclude` odstrani določene oznake iz katere koli prednastavitve.

```twig
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>
```

## Zbirka podatkov

To je osrednji del izdaje. V poljuben imenik bloka dodajte datoteko `db.php` in Blockstudio ustvari pet končnih točk REST CRUD, vsako zapisovanje preveri glede na shemo, samodejno upravlja zaledje za shranjevanje ter zagotavlja odjemalca JavaScript (`bs.db()`) in PHP API (`Db::get()`). Brez datotek za migracije, razredov krmilnikov ali registracije poti.

```php title="db.php"
return [
    'subscribers' => [
        'storage'    => 'table',
        'capability' => [
            'create' => true,
            'read'   => true,
            'update' => 'edit_posts',
            'delete' => 'manage_options',
        ],
        'fields' => [
            'email' => [
                'type'     => 'string',
                'format'   => 'email',
                'required' => true,
                'validate' => function ($value) {
                    if (str_ends_with($value, '@spam.com')) {
                        return 'This domain is blocked.';
                    }
                    return true;
                },
            ],
            'name' => ['type' => 'string', 'maxLength' => 100],
            'plan' => ['type' => 'string', 'enum' => ['free', 'pro']],
        ],
    ],
];
```

Že sama ta shema ustvari v celoti delujoč API s končnimi točkami za ustvarjanje, seznam, pridobivanje, posodabljanje in brisanje, vse z validacijo vnosa.

### Shranjevanje

Pet zaledij za shranjevanje, vsako primerno za različne primere uporabe:

- **`table`**: Tabela po meri MySQL, ki jo upravlja `dbDelta()`. Dodajanje polj v shemo ob naslednjem nalaganju strani doda stolpce. Privzeta izbira za produkcijo.
- **`sqlite`**: Ena datoteka SQLite v mapi bloka `db/`. Prave poizvedbe SQL, način WAL za sočasno branje in popolna prenosljivost. Kopirajte mapo in kopirali boste zbirko podatkov.
- **`jsonc`**: En objekt JSON v vsaki vrstici navadne datoteke. Berljivo za ljudi, primerno za nadzor različic in git.
- **`meta`**: Polje JSON, ki vsebuje polje WordPress v metapodatkih objave, povezano z določeno objavo.
- **`post_type`**: Vsak zapis postane objava WordPress v vrsti objav po meri. Polja so shranjena kot posamezni vnosi v metapodatkih objave, po njih je mogoče poizvedovati z `WP_Query`.

### Odjemalci

Na strani JavaScript vam `bs.db()` ponuja popolnega odjemalca CRUD:

```js
const db = bs.db('my-theme/block', 'subscribers');
const record = await db.create({ email: 'a@b.com', plan: 'pro' });
const pros = await db.list({ plan: 'pro' });
await db.update(record.id, { plan: 'free' });
await db.delete(record.id);
```

Z njim so priloženi trije pomožni pripomočki:

- **`bs.cache`**: Predpomnilnik poizvedb v pomnilniku z `get`, `set`, `invalidate` in `clear`. Skupen je vsem klicem poizvedb in sprememb.
- **`bs.query(key, fn, options)`**: Poljubno asinhrono funkcijo ovije s predpomnjenjem, združevanjem podvojenih zahtev in nastavljivim `staleTime`. Več klicev z istim ključem med izvajanjem zahteve vrne isto obljubo.
- **`bs.mutate(options)`**: Upravlja optimistične spremembe s samodejno povrnitvijo. Podajte odzivni objekt stanja, dejanje (`create`, `update`, `delete`) in optimistične podatke. UI se takoj posodobi. Če klic strežnika spodleti, se stanje povrne na posnetek pred spremembo.

Skupaj pokrivajo celoten cikel branja in zapisovanja: `bs.query` za branje iz predpomnilnika, `bs.mutate` za optimistično zapisovanje in `bs.cache` za ročno upravljanje.

Na strani PHP razred `Db` ponuja enake operacije:

```php
use Blockstudio\Db;

$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);
```

### Preverjanje veljavnosti

Napake pri preverjanju veljavnosti se vrnejo kot polja napak za posamezno polje, po vzoru oblike `fieldErrors` v Zod. Za isto polje lahko ne ustreza več pravilom, struktura pa omogoča preprosto povezavo napak s polji obrazca v ospredju:

```json
{
  "data": {
    "status": 400,
    "errors": {
      "email": ["Must be a valid email address.", "This domain is blocked."],
      "plan": ["Must be one of: free, pro."]
    }
  }
}
```

Povratni klici po meri `validate` se izvajajo na strežniku za vse, česar vgrajena pravila ne pokrivajo: blokiranje domen, preverjanje veljavnosti med polji in zunanja iskanja.

### Podatki za posameznega uporabnika

Za podatke posameznega uporabnika, kot so opravila, priljubljene vsebine ali osnutki, nastavite `userScoped` na `true`, za ostalo pa poskrbi Blockstudio. Doda stolpec `user_id`, ga samodejno nastavi ob ustvarjanju in vsako poizvedbo omeji na trenutnega uporabnika. Pri posodobitvah in brisanjih preveri lastništvo. Brez ročnega polja `user_id`, kavlja `before_create` ali filtriranja v RPC. Ena vrstica konfiguracije. Pri uporabi shrambe `post_type` se `userScoped` preslika v `post_author` namesto v ločen stolpec.

```php
return [
    'storage'    => 'sqlite',
    'userScoped' => true,
    'fields'     => [ /* ... */ ],
];
```

### Redno preverjanje sprememb

V shemi nastavite `'realtime' => true` in odjemalec bo samodejno preverjal spremembe. Ko se na strežniku kaj spremeni, se posodobi shramba Interactivity API, UI pa se znova upodobi, ne da bi morali na svoji strani spremeniti JavaScript. Nastavite `'realtime' => ['key' => 'todos', 'interval' => 5000]` za ključe stanja po meri in intervale. Preverjanje uporablja primerjavo zgoščenih vrednosti, da so zahteve manjše, in se ustavi, ko je zavihek brskalnika skrit.

### Varnost, kavlji, prenosljivost

Javne končne točke so zaščitene s samodejno dodano glavo CSRF `X-BS-Token`. Za dostop brez preverjanja pristnosti, na primer za dohodne spletne kavlje, uporabite `'open'`.

Kavlji življenjskega cikla se sprožijo pred vsakim zapisovanjem in po njem. Določite jih neposredno v `db.php` ali globalno prek dejanj WordPress.

Polja lahko določijo ključ `component` za upodabljanje obrazcev na podlagi sheme prek `bs_db_form()`.

Pri shrambi SQLite ali JSONC celotna aplikacija živi v eni mapi: koda, logika, nadzor dostopa in podatki. Za namestitev jo kopirajte.

## RPC

Včasih CRUD ne zadostuje. Potrebujete logiko po meri na strežniku: preklop opravila, pošiljanje obvestila, zbiranje statistike. Temu služijo `rpc.php`. Določite funkcijo PHP, jo pokličite iz ospredja z `bs.fn()`, Blockstudio pa poskrbi za končno točko REST, preverjanje pristnosti, zaščito CSRF in serializacijo JSON. Vzorec se zgleduje po [tRPC](https://trpc.io): postopki so določeni na strežniku, odjemalec pa jih kliče po imenu.

```php title="rpc.php"
return [
    'subscribe' => function (array $params): array {
        $email = sanitize_email($params['email']);
        return ['success' => true];
    },
];
```

```js
const result = await bs.fn('subscribe', { email: 'user@example.com' });
```

Vdelani skripti (`script-inline.js`) samodejno prepoznajo ime bloka iz atributa `data-block` v svoji oznaki script, zato vam ga ni treba podati ročno. Skripti modulov ga posredujejo kot tretji argument.

Možnosti nadzora dostopa vključujejo `public` (s CSRF), `'open'` (brez zaščite), nize zmogljivosti ali polja. Podprti so tudi nadzor metode HTTP za posamezno funkcijo, kavlji življenjskega cikla in klicanje med bloki iz JS ter PHP.

## Cron

Opravila v ozadju so določena v datoteki `cron.php`. Nastavite urnik in povratni klic, Blockstudio pa jih ob inicializaciji registrira v WordPress Cron. Ob deaktivaciji vtičnika so vsa opravila pravilno odstranjena iz urnika.

```php title="cron.php"
return [
    'cleanup' => [
        'schedule' => 'daily',
        'callback' => function () {
            $db = Db::get('my-theme/app', 'logs');
            // delete old entries
        },
    ],
    'sync' => [
        'schedule' => 'hourly',
        'callback' => function () {
            // pull from external API
        },
    ],
];
```

Podprti so vsi vgrajeni urniki WordPress, pa tudi intervali po meri prek filtra `cron_schedules`.

## CLI

Nov ukaz `wp bs` pokriva celoten nabor funkcij Blockstudio: bloke, zbirko podatkov, RPC, cron, nastavitve, prevajanje Tailwind, prevajanje SCSS, polja po meri in upravljanje sredstev.

```bash
wp bs blocks list --components
wp bs db schemas
wp bs db create my-theme/app subs --email=a@b.com
wp bs db list my-theme/app subs --plan=pro --format=json
wp bs rpc call my-theme/app subscribe --email=a@b.com
wp bs cron run my-theme/app cleanup
wp bs tailwind compile --file=template.html
wp bs scss compile --file=style.scss
wp bs fields list
wp bs assets list --type=global
wp bs settings get tailwind/enabled
```

Vsi ukazi podpirajo `--format=json` za skriptiranje.

## Izboljšave ponavljalnika

### textMinimized za polja objektov

Zložene vrstice ponavljalnika zdaj pravilno obravnavajo vrednosti polj objektov. Prej se je pri usmeritvi `textMinimized` na polje povezave prikazalo `[object Object]`. Zdaj Blockstudio samodejno prebere pravo podlastnost glede na vrsto polja: `title` za povezave, `value` za barve in prelive, `icon` za ikone. Nastavite lahko tudi izrecno lastnost `key`, da preberete katero koli želeno podlastnost.

```json
{
  "type": "repeater",
  "textMinimized": { "id": "href", "fallback": "Add a link" },
  "attributes": [{ "id": "href", "type": "link" }]
}
```

### RichText in MediaPlaceholder

Obe komponenti predloge zdaj delujeta znotraj polj ponavljalnika, kjer zapis v oglatih oklepajih določi pravo vrstico. Tako lahko v vsaki vrstici ponavljalnika sproti urejate naslove in odstavke ter območja za nalaganje predstavnostnih datotek.

```twig
{% for item in a.items %}
  <div class="card">
    <MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
    <RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" />
    <RichText tag="p" attribute="items[{{ loop.index0 }}].content" />
  </div>
{% endfor %}
```

## Pogoji polj po meri z idStructure

Pri uporabi polja po meri z `idStructure` se identifikatorji pogojev v definiciji polja zdaj samodejno prepišejo tako, da se ujemajo z razširjenimi imeni. Če ima skupina polj za velikost pisave pogoj za `enable` in jo razširite z `idStructure: "title_font_{id}"`, se pogoj zdaj pravilno sklicuje na `title_font_enable` namesto na izvirni `enable`.

Podprti so tudi pogoji na ravni sklica. Na sklicu polja po meri dodajte `conditions` in pogoj bo hkrati veljal za vsako razširjeno polje.

## Dinamični argumenti za izpolnjevanje

Argumenti za izpolnjevanje se lahko zdaj s sintakso `{attributes.*}` sklicujejo na druge atribute bloka. Ko se sklicevani atribut spremeni, izbirno polje samodejno znova pridobi svoje možnosti. Povežite izbirna polja: prvo izbere vrsto objave, drugo pa naloži objave te vrste.

```json
{
  "id": "selected_post",
  "type": "select",
  "populate": {
    "type": "query",
    "query": "posts",
    "arguments": {
      "post_type": "{attributes.post_type}"
    }
  }
}
```

Spremenite `post_type` v "page" in drugo izbirno polje naloži strani. Spremenite ga v "post" in naloži objave. Deluje s katero koli vrsto izpolnjevanja in katerim koli atributom.

## Composer

Blockstudio zdaj deluje, ko je naložen s katere koli lokacije pod `wp-content/`, ne le iz imenika vtičnikov. URL-ji sredstev se razrešijo prek konstante `BLOCKSTUDIO_URL` namesto prek `plugins_url()`, zato namestitve, vključene v temo, delujejo takoj:

```php title="functions.php"
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/vendor/blockstudio/blockstudio/blockstudio.php';
```

Odvisnosti izvajalnega okolja `composer.json` so bile urejene. Paketi z obsegom (TailwindPHP, ScssPhp, Minify), ki so že vključeni v `lib/`, niso več navedeni kot odvisnosti izvajalnega okolja. Ostajata samo `php >= 8.2` in `plugin-update-checker`.

Vsi trije načini namestitve (datoteka zip vtičnika, vtičnik prek Composer, vključitev v temo prek Composer) se zaženejo enako: s polno aktivacijo WordPress, registracijo blokov in upodabljanjem v ospredju.

Za navodila za nastavitev si oglejte dokumentacijo [Composer](https://blockstudio.dev/sl/docs/dev/composer/).

## Profilnik zmogljivosti

Dodajte `?blockstudio-perf` na katero koli stran URL in na dnu se prikaže razhroščevalna plošča s časi upodabljanja posameznih blokov, razčlenitvijo faz in stopnjami zadetkov v predpomnilniku. Časovni podatki so poslani tudi v glavah Server-Timing, ki so vidne v zavihku Network v orodjih DevTools brskalnika.

```json title="blockstudio.json"
{ "dev": { "perf": true } }
```

Trajno ga omogočite v nastavitvah, da profilirate vsako nalaganje strani. Viden je samo prijavljenim uporabnikom z zmožnostjo `edit_posts`.

Samozapiralne oznake blokov se zdaj prav tako shranijo v predpomnilnik v pomnilniku. Ko se isti blok z enakimi atributi na strani pojavi večkrat, nadaljnje upodobitve preskočijo celoten cevovod predlog.

## Popravki napak

- **Opozorila o opustitvi v PHP 8.4**: Odpravljeni sta bili opozorili o opustitvi `strpos()` in `str_replace()`, ki ju je povzročalo posredovanje `null` v `add_submenu_page()`.

## Več

- **Polja kode SCSS**: Polja kode podpirajo `language: "scss"`. Vrednosti se prevedejo prek ScssPhp tako v urejevalniku kot v ospredju.
- **Standardni bloki WordPress**: Imeniki Blockstudio lahko vsebujejo izhod `@wordpress/create-block` poleg blokov Blockstudio. Registrirajo se samodejno, brez ločene kode vtičnika.

---

Če si želite ogledati vzorec aplikacije s celotnim skladom v praksi, vodnik [Full-Stack Blocks guide](https://blockstudio.dev/sl/guides/full-stack-blocks/) prikazuje izdelavo aplikacije za opravila za posameznega uporabnika in javnega obrazca za prijavo na e-novice od začetka.
