
Blockstudio 7.1 – pirmasis funkcijų leidimas po v7 perrašymo. v7 atkūrė pagrindą, o 7.1 prideda elementus, paverčiančius blokus kai kuo daugiau: duomenų bazės sluoksnį, serverio funkcijas, suplanuotas užduotis ir CLI. Dabar bloko aplankas gali būti visa programa.

Štai visos naujovės.

## Komponentai

Visada buvo įtampa tarp blokų, kuriuos redaktoriai naudoja įterpimo priemonėje, ir blokų, kuriuos kūrėjai naudoja kaip pagrindą kitiems dalykams kurti. Kortelei, ženkleliui, statistikos valdikliui ar formos laukui reikia viso Blockstudio proceso (atributų, šablonų, išteklių, Tailwind), tačiau jiems nėra reikalo rodytis įterpimo priemonėje.

7.1 pristato komponentus, kurie išsprendžia šią problemą. Nustatykite `"component": true` savo block.json, ir blokas pereis visą kūrimo procesą, tačiau nebus užregistruotas WordPress blokų tipų registre. Jis nepasirodys įterpimo priemonėje ir nebus įtrauktas į redaktoriaus duomenis, siunčiamus į JavaScript, tačiau bus visiškai pasiekiamas programiniam atvaizdavimui.

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

Atvaizduokite juos iš PHP:

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

Arba naudokite naują HTML žymų sintaksę:

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

## Blokų žymos

Dabar blokus galima įterpti kaip HTML žymas, naudojant vieną iš dviejų lygiaverčių sintaksių:

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

Abi sintaksės sukuria tą patį rezultatą. Abi veikia su Blockstudio blokais ir pagrindiniais WordPress blokais. Blokų šablonuose jos atvaizduojamos automatiškai, nieko papildomai neįjungus. Tai reiškia, kad visus maketus galite sudaryti tiesiai šablone iš kitų blokų:

```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>
```

Abi sintaksės gali laisvai būti įdėtos viena į kitą. Blockstudio blokai atvaizduojami per visą procesą (šablonus, Tailwind, išteklius). Pagrindiniai blokai atvaizduojami per WordPress, naudojant tuos pačius atvaizduoklius kaip ir [Puslapiuose ir šablonuose](https://blockstudio.dev/lt/docs/pages-and-patterns/).

Norėdami įjungti puslapio lygmens atvaizdavimą (įrašo turiniui, valdiklių sritims), tai nustatykite faile `blockstudio.json`:

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

Leidžiamų ir draudžiamų elementų sąrašai pagal pakaitos simbolių šablonus nustato, kuriuos blokus galima atvaizduoti naudojant žymas. Atributai `data-*` ir `html-*` perduodami atvaizduojamo bloko šakniniam HTML elementui. Pasirinktinius atvaizduoklius galima užregistruoti naudojant filtrą `blockstudio/block_tags/renderers`.

Po gaubtu žymų analizatorius yra naujas lengvasis eilučių skaitytuvas, visiškai pakeičiantis DOMDocument. Jis apdoroja įdėtas žymas sekdamas jų gylį, rekursinius konteinerių blokus ir mišrią sintaksę vienu perėjimu. Atliekant našumo bandymus, jis išanalizuoja 1,000 plokščių žymų per 2.4ms ir 100 įdėjimo lygių per 3.7ms – nuosekliai greičiau nei DOMDocument ir WordPress `WP_HTML_Tag_Processor`. Tas pats analizatorius taip pat apdoroja neapdorotas HTML elementų žymas, skirtas [Puslapiams ir šablonams](https://blockstudio.dev/lt/docs/pages-and-patterns/), pakeisdamas DOMDocument pagrįstą analizatorių, kuris anksčiau apdorojo `<p>`, `<div>` ir kitus HTML elementus.

## Nauji laukų tipai

### Blokas

Naujas `block` lauko tipas, leidžiantis kaip atributą nurodyti kitą Blockstudio bloką. Nurodyto bloko laukai išskleidžiami tiesiogiai, naudojant `idStructure` ir `overrides`, kaip ir pasirinktinių laukų atveju. Skirtumas tas, kad šablone pasiekus reikšmę grąžinamas atvaizduotas bloko turinys.

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

Jei `mytheme/card` turi `heading` ir `content` laukus, pagrindinis blokas šoninėje juostoje gauna `card_heading` ir `card_content`. Šablone `{{ a.card }}` pateikia atvaizduotą kortelę. Veikia ir su įprastais blokais, ir su komponentais.

### Žyma HTML

Kiekvienoje temoje yra blokų, kurių antraštės lygis turi keistis priklausomai nuo konteksto: H1 pagrindiniame puslapyje, H2 vidiniuose puslapiuose. Užuot kaskart kūrus pasirinkimo lauką su iš anksto nustatytomis parinktimis, dabar yra atskiras `html-tag` lauko tipas su integruotais rinkiniais.

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

Rinkiniai: `heading` (h1-h6), `text` (antraštės + p, span, div), `structural` (div, section, article, aside, main, header, footer, nav), `all`. Arba pateikite pasirinktinį masyvą. `exclude` pašalina konkrečias žymas iš bet kurio rinkinio.

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

## Duomenų bazė

Tai pagrindinė šio leidimo naujovė. Įtraukite `db.php` failą į bet kurio bloko katalogą, ir Blockstudio sugeneruos penkis REST CRUD galinius taškus, patikrins kiekvieną įrašymo operaciją pagal schemą, automatiškai valdys saugyklos posistemę ir pateiks tiek JavaScript klientą (`bs.db()`), tiek PHP API (`Db::get()`). Nereikia migracijos failų, valdiklių klasių ar maršrutų registravimo.

```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']],
        ],
    ],
];
```

Vien ši schema sukuria visiškai veikiantį API su kūrimo, sąrašo, gavimo, atnaujinimo ir ištrynimo galiniais taškais, kuriuose visi įvesties duomenys patikrinami.

### Saugykla

Penkios saugyklos posistemės, pritaikytos skirtingiems naudojimo atvejams:

- **`table`**: Tinkinta MySQL lentelė, valdoma per `dbDelta()`. Pridėjus laukų prie schemos, stulpeliai atsiranda įkėlus kitą puslapį. Numatytasis pasirinkimas gamybinėje aplinkoje.
- **`sqlite`**: Vienas SQLite failas bloko `db/` aplanke. Tikros SQL užklausos, WAL režimas lygiagrečiam skaitymui ir visiškas perkeliamumas. Nukopijuokite aplanką, nukopijuokite duomenų bazę.
- **`jsonc`**: Po vieną JSON objektą kiekvienoje eilutėje paprastame faile. Žmogui suprantama, versijų valdymui tinkama, git pritaikyta.
- **`meta`**: JSON masyvas WordPress įrašo metaduomenyse, susietas su konkrečiu įrašu.
- **`post_type`**: Kiekvienas įrašas tampa WordPress įrašu tinkintame įrašų tipe. Laukai saugomi kaip atskiri įrašo metaduomenų įrašai, juos galima visapusiškai užklausti naudojant `WP_Query`.

### Klientai

JavaScript pusėje `bs.db()` suteikia visavertį CRUD klientą:

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

Kartu pateikiamos trys pagalbinės priemonės:

- **`bs.cache`**: atmintyje saugoma užklausų talpykla su `get`, `set`, `invalidate` ir `clear`. Bendrinama tarp visų užklausų ir keitimo operacijų.
- **`bs.query(key, fn, options)`**: bet kurią asinchroninę funkciją apgaubia talpykla, užklausų dublikatų šalinimu ir konfigūruojamu `staleTime`. Kelios užklausos su tuo pačiu raktu, kol pirmoji dar vykdoma, grąžina tą patį pažadą.
- **`bs.mutate(options)`**: tvarko optimistinius pakeitimus ir automatiškai juos atšaukia. Perduokite reaktyviosios būsenos objektą, veiksmą (`create`, `update`, `delete`) ir optimistinius duomenis. UI atnaujinamas iškart. Jei serverio iškvietimas nepavyksta, būsena grąžinama į pradinę, prieš pakeitimą užfiksuotą kopiją.

Kartu jos apima visą skaitymo ir rašymo ciklą: `bs.query` talpykloje saugomiems duomenims skaityti, `bs.mutate` optimistiniams duomenims įrašyti, `bs.cache` rankiniam valdymui.

PHP pusėje `Db` klasė suteikia tas pačias operacijas:

```php
use Blockstudio\Db;

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

### Tikrinimas

Tikrinimo klaidos pateikiamos kaip kiekvieno lauko klaidų masyvai, įkvėpti Zod `fieldErrors` formato. Tame pačiame lauke gali nepavykti kelios taisyklės, o struktūra leidžia lengvai susieti klaidas su formos laukais sąsajoje:

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

Pasirinktiniai `validate` atgaliniai iškvietimai vykdomi serveryje viskam, ko negali apimti integruotos taisyklės: domenų blokavimui, kelių laukų tikrinimui, išorinėms paieškoms.

### Vartotojui priskirti duomenys

Jei duomenys priklauso atskiriems vartotojams, pavyzdžiui, darbų sąrašai, parankiniai ar juodraščiai, nustatykite `userScoped` į `true`, o Blockstudio pasirūpins likusiais dalykais. Jis prideda `user_id` stulpelį, automatiškai jį nustato kuriant įrašą ir filtruoja visas užklausas pagal dabartinį vartotoją. Atnaujinant ir trinant tikrinama nuosavybė. Nereikia rankinio lauko `user_id`, kablio `before_create` ar filtravimo RPC. Pakanka vienos konfigūracijos eilutės. Naudojant `post_type` saugyklą, `userScoped` susiejamas su `post_author`, o ne atskiru stulpeliu.

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

### Apklausa realiuoju laiku

Nustatykite schemoje `'realtime' => true`, ir klientas automatiškai tikrins, ar nėra pakeitimų. Kai serveryje kas nors pasikeičia, atnaujinama Interactivity API saugykla, o UI pateikiamas iš naujo be jokių JavaScript pakeitimų jūsų pusėje. Konfigūruokite naudodami `'realtime' => ['key' => 'todos', 'interval' => 5000]`, kad nustatytumėte pasirinktinius būsenos raktus ir intervalus. Apklausa naudoja maišos reikšmių palyginimą, kad užklausos būtų lengvos, ir pristabdoma, kai naršyklės kortelė paslėpta.

### Saugumas, kabliai, perkeliamumas

Viešieji galiniai taškai apsaugomi automatiškai įterpiama `X-BS-Token` CSRF antrašte. Kai reikia tikrai neautentifikuotos prieigos, pavyzdžiui, gaunamoms tinklo kabliukų užklausoms, naudokite `'open'`.

Gyvavimo ciklo kabliai suveikia prieš kiekvieną įrašymo operaciją ir po jos. Apibrėžkite juos tiesiogiai `db.php` arba visuotinai per WordPress veiksmus.

Laukai gali apibrėžti `component` raktą, kad formos būtų atvaizduojamos pagal schemą per `bs_db_form()`.

Naudojant SQLite arba JSONC saugyklą, visa programa telpa viename aplanke: kodas, logika, prieigos valdymas ir duomenys. Norėdami ją įdiegti, nukopijuokite aplanką.

## RPC

Kartais CRUD funkcijų nepakanka. Reikia pasirinktinės serverio logikos: pakeisti užduoties būseną, išsiųsti pranešimą, apibendrinti statistiką. Tam skirta `rpc.php`. Apibrėžkite PHP funkciją, iškvieskite ją iš priekinės sąsajos naudodami `bs.fn()`, o Blockstudio pasirūpins REST galiniu tašku, autentifikavimu, CSRF apsauga ir JSON serializavimu. Šis metodas įkvėptas [tRPC](https://trpc.io): procedūros apibrėžiamos serveryje, o iš kliento iškviečiamos pagal pavadinimą.

```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' });
```

Įterptieji scenarijai (`script-inline.js`) automatiškai aptinka bloko pavadinimą pagal scenarijaus žymos atributą `data-block`, todėl jo nereikia perduoti rankiniu būdu. Modulių scenarijai jį perduoda kaip trečią argumentą.

Prieigos valdymo parinktys apima `public` (su CSRF), `'open'` (be apsaugos), galimybių eilutes arba masyvus. Taip pat palaikomas kiekvienos funkcijos HTTP metodo valdymas, gyvavimo ciklo kabliai ir skirtingų blokų funkcijų iškvietimas iš JS ir PHP.

## Cron

Foninės užduotys apibrėžiamos `cron.php` faile. Nustatykite grafiką ir atgalinio iškvietimo funkciją, o Blockstudio inicijavimo metu užregistruos jas WordPress Cron. Išaktyvinus įskiepį, visos užduotys tvarkingai pašalinamos iš grafiko.

```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
        },
    ],
];
```

Palaikomi visi integruoti WordPress grafikai, taip pat pasirinktiniai intervalai per filtrą `cron_schedules`.

## CLI

Nauja komanda `wp bs` apima visą Blockstudio funkcijų rinkinį: blokus, duomenų bazę, RPC, cron, nustatymus, Tailwind kompiliavimą, SCSS kompiliavimą, pasirinktinius laukus ir išteklių valdymą.

```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
```

Visos komandos palaiko `--format=json` scenarijams.

## Kartotuvų patobulinimai

### textMinimized objektų laukams

Dabar sutrauktos kartotuvo eilutės tinkamai apdoroja objektų laukų reikšmes. Anksčiau, nurodžius nuorodos lauką `textMinimized`, buvo rodoma `[object Object]`. Dabar Blockstudio automatiškai nuskaito tinkamą laukelio savybę pagal lauko tipą: nuorodoms – `title`, spalvoms ir gradientams – `value`, piktogramoms – `icon`. Taip pat galite aiškiai nustatyti `key` savybę, kad būtų nuskaitoma bet kuri norima antrinė savybė.

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

### RichText ir MediaPlaceholder

Dabar abu šablono komponentai veikia kartotuvo laukuose, naudojant laužtinių skliaustų žymėjimą, kad būtų nurodyta tinkama eilutė. Kiekvienoje kartotuvo eilutėje esančias antraštes, pastraipas ir medijos įkėlimo sritis galima redaguoti tiesiogiai.

```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 %}
```

## Pasirinktinių laukų sąlygos naudojant idStructure

Naudojant pasirinktinį lauką su `idStructure`, lauko apraše esančių sąlygų ID dabar automatiškai perrašomi taip, kad atitiktų išplėstus pavadinimus. Jei šrifto dydžio laukų grupėje yra sąlyga su `enable`, o grupę išplečiate naudodami `idStructure: "title_font_{id}"`, dabar sąlyga teisingai nurodo `title_font_enable`, o ne pradinį `enable`.

Taip pat palaikomos nuorodos lygmens sąlygos. Pridėkite `conditions` prie pasirinktinio lauko nuorodos, kad jos būtų taikomos iškart visiems išplėstiems laukams.

## Dinaminiai užpildymo argumentai

Dabar užpildymo argumentai gali nurodyti kitus bloko atributus naudodami sintaksę `{attributes.*}`. Pasikeitus nurodytam atributui, pasirinkimo laukas automatiškai iš naujo gauna parinktis. Susiekite pasirinkimo laukus: vienu pasirinkite įrašo tipą, kitu įkelkite to tipo įrašus.

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

Pakeiskite `post_type` į „page“ ir antrajame pasirinkimo lauke bus įkeliami puslapiai. Pakeiskite į „post“ ir bus įkeliami įrašai. Veikia su bet kuriuo užpildymo tipu ir bet kuriuo atributu.

## Composer

Blockstudio dabar veikia įkeltas iš bet kurios vietos po `wp-content/`, ne tik iš įskiepių katalogo. Išteklių URL nustatomi naudojant konstantą `BLOCKSTUDIO_URL`, o ne `plugins_url()`, todėl temoje įdiegtas variantas veikia iškart:

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

`composer.json` vykdymo aplinkos priklausomybės sutvarkytos. Aprėptį turintys paketai (TailwindPHP, ScssPhp, Minify), jau įtraukti į `lib/`, nebenurodomi kaip vykdymo aplinkos priklausomybės. Liko tik `php >= 8.2` ir `plugin-update-checker`.

Visi trys diegimo būdai (įskiepio ZIP failas, įskiepis per Composer, temoje įdiegtas variantas per Composer) užsikrauna vienodai: visiškai suaktyvinamas WordPress, užregistruojami blokai ir atvaizduojama sąsaja.

Sąrankos instrukcijas rasite [Composer dokumentacijoje](https://blockstudio.dev/lt/docs/dev/composer/).

## Našumo profiliuoklis

Pridėkite `?blockstudio-perf` prie bet kurio puslapio URL, ir apačioje atsiras derinimo skydelis, kuriame matysite kiekvieno bloko atvaizdavimo trukmę, etapų trukmių išskaidymą ir talpyklos pataikymų dažnį. Laiko duomenys taip pat siunčiami Server-Timing antraštėmis, kurias galima matyti naršyklės kūrėjų įrankių tinklo skirtuke.

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

Įjunkite tai nustatymuose visam laikui, kad būtų profiliuojamas kiekvienas puslapio įkėlimas. Matoma tik prisijungusiems vartotojams, turintiems galimybę `edit_posts`.

Dabar atmintyje taip pat talpykloje saugomos neuždaromosios blokų žymos. Jei tame pačiame puslapyje kelis kartus pasirodo tas pats blokas su identiškais atributais, vėliau jį atvaizduojant visas šablono procesas praleidžiamas.

## Klaidų taisymai

- **PHP 8.4 pasenusių funkcijų įspėjimai**: ištaisyti `strpos()` ir `str_replace()` pasenusių funkcijų įspėjimai, atsiradę perduodant `null` į `add_submenu_page()`.

## Daugiau

- **SCSS kodo laukai**: kodo laukai palaiko `language: "scss"`. Reikšmės kompiliuojamos per ScssPhp ir redaktoriuje, ir sąsajoje.
- **Standartiniai WordPress blokai**: Blockstudio kataloguose gali būti `@wordpress/create-block` išvestis kartu su Blockstudio blokais. Jie automatiškai užregistruojami be jokio atskiro įskiepio kodo.

---

Jei norite pamatyti viso steko modelį praktiškai, vadove [„Viso steko blokai“](https://blockstudio.dev/lt/guides/full-stack-blocks/) žingsnis po žingsnio parodoma, kaip nuo nulio sukurti vartotojui skirtą darbų sąrašo programą ir viešą naujienlaiškio prenumeratos formą.
