
Blockstudio 7 jau čia. Tai didžiausias leidimas projekto istorijoje: visa kodo bazė visiškai perrašyta nuo pat pradžių. Kiekviena klasė, kiekvienas kablys, kiekviena kodo eilutė sukurta iš naujo, daugiausia dėmesio skiriant šiuolaikiniam PHP, WordPress kodavimo standartams ir ilgalaikiam palaikomumui.

Tačiau tai ne vien pertvarkymas. Blockstudio 7 pristato svarbias naujas funkcijas, tokias kaip puslapiai ir šablonai iš failų, įrašo metaduomenų saugojimo sistema, SEO integracija ir visiškai naujas HTML vertimo į blokus analizatorius, kuriuo visa tai veikia. Be to, Blockstudio dabar yra visiškai nemokama ir atvirojo kodo.

Peržvelkime visas naujienas.

## Nemokama ir atvirojo kodo

Su Blockstudio dirbu nuo 2020, per daugelį metų išleidau dešimtis versijų. Naudotojams jis patiko, tačiau rasti komerciškai gyvybingą WordPress blokų sistemos modelį visada buvo sudėtinga.

Viską pakeitė LLM. DI kodavimo asistentai jau pakankamai gerai rašo blokų kodą, tačiau jiems reikia tvarkingos, failais pagrįstos struktūros. WordPress blokų žymėjimas netvarkingas: nuosekliai įrašyti HTML komentarai su įterptais JSON atributais, sumaišyti su DOM struktūra. Žmonėms tai sudėtinga, o LLM dar sunkiau tai atlikti teisingai.

Blockstudio metodas, kai svarbiausi yra failai, visada buvo skirtas paprastumui palaikyti: aplanke yra `block.json` ir PHP šablonas. Jokių duomenų bazės įrašų, jokio React, jokio kūrimo etapo. Su v7 ši filosofija tęsiama dar toliau. HTML vertimo į blokus analizatorius leidžia rašyti paprastą HTML, kuris automatiškai paverčiamas galiojančiu blokų žymėjimu. Viskas lieka failų sistemoje. Duomenų bazė rašoma tik sinchronizuojant puslapius, kai to aiškiai paprašoma per PHP API arba CLI, o sinchronizavimą lemia failų šablonai.

Blockstudio atvirojo kodo modelis yra natūralus kitas žingsnis. Kuo daugiau LLM mokomi naudojant Blockstudio kodą, tuo geriau jie jį generuoja. Atvira kodo bazė, atvira dokumentacija ir iš anksto paruoštas failas [DI kontekstui](https://blockstudio.dev/lt/docs/dev/ai/), kurį gali naudoti bet kuris įrankis – taip sukuriama geriausia aplinka DI padedamai WordPress kūrybai.

Visą papildinį visi gali naudoti, išsišakoti ir prie jo prisidėti adresu [GitHub](https://github.com/inline0/blockstudio). Jokių licencijos raktų, mokamų sienų ar funkcijų apribojimų.

## Naujos funkcijos

### Puslapiai iš failų

Tai vienas didžiausių 7.0 versijos papildymų. Dabar galite apibrėžti ištisus WordPress puslapius kaip failų šablonus, kurie iškvietus puslapių sinchronizavimo API arba CLI sinchronizuojami su duomenų baze kaip natyvus blokų turinys.

Sukurkite aplanką su `page.json` ir šablono failu:

```json title="page.json"
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
```

```php title="index.php"
<div class="about-page">
  <h1>About Us</h1>
  <p>Welcome to our site.</p>
</div>
```

Paleiskite `wp bs pages sync`, kad Blockstudio išanalizuotų HTML į WordPress blokus ir sukurtų arba atnaujintų puslapį duomenų bazėje.

#### Blokų suliejimas pagal raktą

Sinchronizuojant šablonus naudotojų pakeitimai paprastai būtų perrašyti. `key` atributas išsaugo naudotojų turinį per sinchronizavimus:

```html title="index.php"
<h1 key="hero-title">Default Title</h1>
<p key="hero-description">Default description.</p>
```

Blokai su sutampančiais raktais išsaugo naudotojo redaguotą turinį atnaujinus šabloną. Blokai be raktų visiškai pakeičiami.

#### Blokų susiejimai

Kaip alternatyvą raktams galite naudoti WordPress branduolio [Blokų susiejimus API](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/), kad tiesiogiai susietumėte blokus su įrašo metaduomenimis. Tai nėra Blockstudio funkcija, o natyvus WordPress API sprendimas. Blockstudio tiesiog perduoda `metadata` atributą generuojamam blokų žymėjimui. Turinys saugomas metaduomenyse, o ne blokų žymėjime, todėl sinchronizuojant šablonus naudotojų pakeitimai niekada neprarandami. Duomenų taip pat galima ieškoti naudojant `WP_Query` ir jie pasiekiami per REST API.

```html title="index.php"
<h1 metadata='{"bindings":{"content":{"source":"core/post-meta","args":{"key":"hero_title"}}}}'>
  Default Title
</h1>
```

Abu būdus galima naudoti tame pačiame šablone.

#### Redagavimo valdikliai

Puslapiuose galima naudoti `blockEditingMode` ir `templateLock`, kad būtų valdoma, ką naudotojai gali keisti:

```json title="page.json"
{
  "name": "landing",
  "title": "Landing Page",
  "blockEditingMode": "contentOnly",
  "templateLock": "all"
}
```

Taip užrakinama puslapio struktūra, tačiau naudotojai vis tiek gali redaguoti tekstą ir mediją. Atskiri elementai šablone gali nepaisyti puslapio lygmens nuostatos naudodami `blockEditingMode` atributą.

#### Priskyrimas įrašų ID

Naudokite `postId`, kad susietumėte puslapio šabloną su esamu WordPress įrašu, išvengtumėte puslapių dublikatų ir užtikrintumėte, kad šablonas visada atnaujintų tinkamą įrašą:

```json title="page.json"
{
  "name": "home",
  "title": "Home",
  "postId": 2
}
```

Išsamią informaciją rasite [Puslapių dokumentacijoje](https://blockstudio.dev/lt/docs/pages-and-patterns/pages/).

### Šablonai iš failų

Panašiai kaip puslapius, dabar blokų šablonų rinkinius galite apibrėžti kaip failų šablonus. Parašykite savo šabloną HTML, o Blockstudio išanalizuos jį į blokų žymėjimą ir užregistruos kaip natyvų WordPress blokų šablonų rinkinį. Jie rodomi blokų įterpimo priemonėje, todėl naudotojai gali juos įterpti bet kur.

```json title="pattern.json"
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
```

```html title="index.php"
<div class="hero">
  <h1>Welcome</h1>
  <p>Get started today.</p>
</div>
```

Skirtingai nei puslapiai, šablonų rinkiniai nesukuria įrašų duomenų bazėje. Jie registruojami atmintyje kiekvieną kartą įkeliant puslapį. Žr. [Šablonų dokumentaciją](https://blockstudio.dev/lt/docs/pages-and-patterns/patterns/).

### HTML vertimo į blokus analizatorius

Naujas HTML analizatorius veikia tiek puslapiuose, tiek šablonų rinkiniuose: įprasti HTML šablonai paverčiami WordPress blokų žymėjimu. Jis automatiškai apdoroja konteinerinius blokus (pvz., grupes ir stulpelius) ir lapinius blokus (pvz., pastraipas ir antraštes). Analizatorius naudoja požymiais pagrįstą atvaizdavimo architektūrą, todėl ją paprasta išplėsti ir palaikyti papildomus blokų tipus naudojant filtrą `blockstudio/parser/renderers`:

```php title="functions.php"
add_filter( 'blockstudio/parser/renderers', function ( $renderers, $parser ) {
    $renderers['acme/hero'] = function ( $element, $attrs, $parser ) {
        $content = $parser->get_inner_html( $element );
        $html    = '<div class="acme-hero">' . $content . '</div>';

        return array(
            'blockName'    => 'acme/hero',
            'attrs'        => $attrs,
            'innerBlocks'  => array(),
            'innerHTML'    => $html,
            'innerContent' => array( $html ),
        );
    };

    return $renderers;
}, 10, 2 );
```

Užregistravę bloką galite naudoti bet kuriame puslapio arba šablonų rinkinio šablone:

```html title="index.php"
<block name="acme/hero" background="/hero.jpg">
  <h1>Welcome to our site</h1>
</block>
```

### Saugykla

Laukų reikšmes dabar galima saugoti įrašo metaduomenyse arba svetainės parinktyse, ne tik bloko atributuose. Tai svarbus pakeitimas:

```json title="block.json"
{
  "id": "subtitle",
  "type": "text",
  "label": "Subtitle",
  "storage": {
    "type": "postMeta"
  }
}
```

Įrašo metaduomenyse saugomas reikšmes galite naudoti taip:

- Ieškoti įrašų pagal laukų reikšmes naudojant `WP_Query` ir `meta_query`
- Pasiekti laukų duomenis per REST API, skirtą svetainėms be atvaizdavimo serveryje
- Dalytis duomenimis su kitų papildinių įrankiais, pvz., SEO, ir spartinančiosios atminties sluoksniais

Taip pat galite saugoti reikšmes parinkčių lentelėje, skirtas visos svetainės nuostatoms:

```json title="block.json"
{
  "id": "phone",
  "type": "text",
  "label": "Phone Number",
  "storage": {
    "type": "option",
    "optionKey": "company_phone"
  }
}
```

Visą API rasite [Saugojimo dokumentacijoje](https://blockstudio.dev/lt/docs/blocks/storage/).

### Pasirinktiniai laukai

Dabar galima dalytis pakartotinai naudojamais laukų aprašais tarp kelių blokų. Apibrėžkite laukų rinkinį vieną kartą ir nurodykite jį bet kuriame bloke. Taip išvengsite pasikartojimų, kai keliuose blokuose naudojama ta pati laukų struktūra.

Sukurkite `field.json` savo blockstudio kataloge:

```json title="fields/hero/field.json"
{
  "name": "hero",
  "title": "Hero Section",
  "attributes": [
    { "id": "heading", "type": "text", "label": "Heading", "default": "Hello World" },
    { "id": "description", "type": "textarea", "label": "Description" }
  ]
}
```

Tada nurodykite jį bet kuriame bloke naudodami `custom/` prefiksą:

```json title="block.json"
{
  "blockstudio": {
    "attributes": [
      { "type": "custom/hero", "idStructure": "hero_{id}" }
    ]
  }
}
```

Savybė `idStructure` prideda prefiksą prie kiekvieno lauko ID, todėl `heading` tampa `hero_heading`. Taip pat galite perrašyti atskirų laukų savybes konkrečiame egzemplioriuje naudodami raktą `overrides`.

Žr. [Pasirinktinių laukų dokumentaciją](https://blockstudio.dev/lt/docs/blocks/attributes/custom-fields/).

### Tailwind CSS v4

Tailwind palaikymas visiškai perkurtas v4. Užuot kompiliavusi kliento pusėje per CDN ir išsaugojusi diske išsaugant įrašą (v6 metodas), Blockstudio 7 kompiliuoja Tailwind serverio pusėje, kaskart pateikus išorinę užklausą, per [TailwindPHP](https://github.com/dnnsjsk/tailwindphp). Nereikia Node.js, CLI ar kūrimo etapo.

Kompiliavimui naudojama kandidatais pagrįsta spartinančioji atmintinė: Blockstudio iš galutinio HTML išrenka visus CSS klasių pavadinimus, surikiuoja juos ir apskaičiuoja jų maišą kartu su jūsų CSS konfigūracija, tada patikrina, ar yra failas spartinančiojoje atmintinėje. Toms pačioms klasėms parenkamas tas pats įrašas net pasikeitus aplinkiniam HTML (vienkartiniams skaičiams, laiko žymoms ar dinaminiam turiniui).

Konfigūracijoje naudojama Tailwind v4 sintaksė, kurioje pirmiausia aprašomi CSS. Tinkintas temas ir pagalbines klases apibrėžkite tiesiogiai faile `blockstudio.json` arba naudodami filtrą `blockstudio/tailwind/css`:

```php title="functions.php"
add_filter('blockstudio/tailwind/css', function ($css) {
  return $css . '
    @theme {
      --color-brand: #4f46e5;
    }

    @layer utilities {
      .container-narrow {
        max-width: 48rem;
        margin-inline: auto;
      }
    }
  ';
});
```

Blokų rengyklėje kartu įtrauktas Tailwind CDN scenarijus leidžia matyti tiesioginę peržiūrą rašant. Lauko tipas `classes` pateikia visų Tailwind pagalbinių klasių automatinio užbaigimo pasiūlymus. Išorinėje svetainės dalyje visada naudojamas serverio pusėje sukompiliuotas CSS, įterpiamas kaip tiesioginis stiliaus elementas prieš `</head>`.

Visą sąranką rasite [Tailwind dokumentacijoje](https://blockstudio.dev/lt/docs/tailwind/).

### Sąveika API

Blockstudio dabar palaiko [WordPress Interactivity API](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/). Įjunkite ją faile block.json:

```json title="block.json"
{
  "blockstudio": {
    "interactivity": true
  }
}
```

Pridėkite `data-wp-*` direktyvas į šabloną:

```php title="index.php"
<div useBlockProps
     data-wp-interactive="myBlock"
     data-wp-context='{ "isOpen": false }'>
  <button data-wp-on--click="actions.toggle"
          data-wp-bind--aria-expanded="context.isOpen">
    Toggle
  </button>
  <div data-wp-bind--hidden="!context.isOpen">
    This content is toggled by the button.
  </div>
</div>
```

Tada sukurkite `script.js` su saugyklos logika:

```javascript title="script.js"
import { store, getContext } from '@wordpress/interactivity';

store('myBlock', {
  actions: {
    toggle: () => {
      const context = getContext();
      context.isOpen = !context.isOpen;
    },
  },
});
```

Blockstudio tvarko importų žemėlapį, modulių įkėlimą ir direktyvų apdorojimą tiek išorinėje svetainės dalyje, tiek blokų rengyklėje. Blokai, kuriuose naudojamos tik deklaratyvios direktyvos su `data-wp-context` (pvz., `data-wp-bind--hidden` arba `data-wp-text`), veikia be jokio JavaScript. Taip pat palaikoma serverio pusės būsena, naudojant `wp_interactivity_state()`, išorinėje svetainės dalyje.

Visą sąranką rasite [Sąveikos dokumentacijoje](https://blockstudio.dev/lt/docs/blocks/interactivity/).

### SEO turinio analizė

Blockstudio blokai yra dinaminiai, todėl SEO papildiniai pagal numatytuosius nustatymus nemato jų laukų turinio. Blockstudio 7 tai išsprendžia automatiškai integruodama su Yoast SEO, Rank Math ir SEOPress. Teksto reikšmės iš laukų `text`, `textarea`, `richtext`, `wysiwyg` ir `link` (įskaitant įdėtas pasikartojančių laukų eilutes) išrenkamos ir perduodamos kiekvieno papildinio turinio analizei. Dabar SEO papildiniai gali tinkamai analizuoti blokų turinį pagal raktažodžių tankį, skaitomumą ir kitus rodiklius. Konfigūruoti nereikia.

### Pasikartojančio lauko numatytosios eilutės

Pasikartojančių laukų reikšmėms dabar galima nustatyti `default` savybę su iš anksto užpildytų eilučių masyvu. Įterpus bloką, pasikartojantis laukas užpildomas nurodytomis eilutėmis ir jų reikšmėmis tiek rengyklėje, tiek išorinėje svetainės dalyje:

```json title="block.json"
{
  "id": "features",
  "type": "repeater",
  "label": "Features",
  "default": [
    { "title": "Fast", "icon": "bolt" },
    { "title": "Secure", "icon": "shield" }
  ],
  "attributes": [
    { "id": "title", "type": "text", "label": "Title" },
    { "id": "icon", "type": "text", "label": "Icon" }
  ]
}
```

Savybė `min` taip pat veikia kartu su laukų numatytosiomis reikšmėmis: jei pasikartojantis laukas turi `min: 3`, o jo vidiniai laukai turi reikšmes `default`, automatiškai sukurtos eilutės užpildomos tomis numatytosiomis reikšmėmis, o ne paliekamos tuščios.

## Patobulinimai ir pataisymai

- **Pasikartojantis laukas `min` su numatytosiomis laukų reikšmėmis**: automatiškai sugeneruotose minimalaus skaičiaus eilutėse dabar naudojamos numatytosios laukų reikšmės tiek išorinėje svetainės dalyje, tiek rengyklėje
- **Tailwind rengyklės stiliai**: sukompiliuotas Tailwind CSS dabar įterpiamas į blokų rengyklės iframe kartu su CDN, todėl rengyklėje veikia tinkintos `@apply` taisyklės ir temų konfigūracija
- **[DI konteksto failas](https://blockstudio.dev/lt/docs/dev/ai/)**: `blockstudio-llm.txt` atkurtas kaip statinis failas, surinktas iš visos v7 dokumentacijos ir pašalintų pasikartojančių JSON schemų (~48k žetonų); taip pakeistas dinaminis generavimas iš v6
- **Kodo lauko atskiras langas**: kodo lauką dabar galima atverti atskirame lange su nepriklausomomis anuliavimo ir grąžinimo funkcijomis bei JavaScript sintaksės paryškinimu
- **Tailwind v4 kompiliavimas serverio pusėje**: žr. aukščiau esantį [Tailwind skyrių](#tailwind-css-v4)
- **API 3 versija**: blokai dabar tinkamai atvaizduojami įrėmintoje rengyklėje, įskaitant svetainės rengyklę ir adaptyviąsias peržiūras
- **Taškinė išteklių failų pavadinimų notacija**: aiškesnė išteklių priesagų pavadinimų konvencija (`*.inline.css`, `*.editor.js`, `*.scoped.css`)
- Pataisytas `bs_render_block()` įspėjimas iš `WP_Block_Supports` naudojant `useBlockProps`
- Pataisyta sąlyginių laukų problema, dėl kurios pirmą kartą įkeliant nebuvo atsižvelgiama į numatytąsias reikšmes
- Pataisyta problema, dėl kurios išorinėje svetainės dalyje iš `<RichText />` turinio buvo pašalinami dolerio ženklai
- Pataisyta `populate` funkcija, kad ji veiktų su taksonomijomis, kurias užregistravo kiti papildiniai
- Pataisyta `optionsPopulate` klaida nulinės reikšmės atveju WPML kontekstuose

## Kaip tai veikia viduje

### Visiškai perrašyta

Tai ne pertvarkymas ar sutvarkymas. Kiekviena klasė perrašyta nuo pradžių. Rezultatas – tvarkingesnė, moduliškesnė kodo bazė, kurią lengviau prižiūrėti ir plėsti.

### Šiuolaikinis PHP

Blockstudio 7 reikia PHP 8.2+ ir visur naudojamos šiuolaikinės tipų deklaracijos.

## Nesuderinami pakeitimai

Pagrindiniame 7.0 versijos naujinime yra keli nesuderinami pakeitimai. Dauguma jų turi atgalinį suderinamumą užtikrinančių alternatyvų, tačiau prieš naujindami peržiūrėkite šiuos pakeitimus. Visą migravimo vadovą rasite [v7 migravimo dokumentacijoje](https://blockstudio.dev/lt/docs/dev/migration/v7/).

### Kablių pavadinimuose dabar naudojama snake_case rašyba

Visų PHP kablių pavadinimai pakeisti iš camelCase į snake_case, kad atitiktų WordPress branduolio konvencijas:

```php title="functions.php"
// Before (v6)
add_filter('blockstudio/settings/blockEditor/cssClasses', function() {
    return ['my-stylesheet'];
});

// After (v7)
add_filter('blockstudio/settings/block_editor/css_classes', function() {
    return ['my-stylesheet'];
});
```

Seni camelCase pavadinimai vis dar veikia, tačiau rekomenduojame juos atnaujinti.

### Lauko jungiklis pagal numatytuosius nustatymus išjungtas

Savybės `switch` numatytoji reikšmė dabar yra `false`, o anksčiau buvo `true`. v6 versijoje kiekvienas laukas kairiajame krašte turėjo nematomą jungiklį, kuris pagal numatytuosius nustatymus būdavo įjungtas. v7 versijoje jungiklis įjungiamas pasirinktinai, o lauko etiketėje vaizduojamas matoma akies piktograma. Jei pasikliovėte numatytąja jungiklio elgsena, įtraukite `"switch": true` į laukų aprašus.

### Išteklių failų pavadinimuose naudojama taškinė notacija

Išteklių priesagose dabar naudojami taškai, o ne brūkšneliai (`style.inline.css` vietoj `style-inline.css`). Sena brūkšnelių notacija vis dar veikia, tačiau ateityje rekomenduojama naudoti taškinę notaciją.

### npm importų prefiksas

ES modulių importuose dabar naudojamas `npm:`, o ne `blockstudio/`:

```javascript title="script.js"
// Before (v6)
import confetti from "blockstudio/canvas-confetti@1.6.0";

// After (v7)
import confetti from "npm:canvas-confetti@1.6.0";
```

Prefiksas `blockstudio/` vis dar palaikomas dėl atgalinio suderinamumo.

### Pašalintos funkcijos

**Administravimo sritis ir kodo rengyklė.** WordPress administravimo nuostatų puslapis ir integruota blokų kodo rengyklė pašalinti. Visa konfigūracija dabar atliekama naudojant `blockstudio.json` ir PHP filtrus, todėl sąranka laikoma versijų valdymo sistemoje kartu su blokais.

Ankstesnėse versijose kodo rengyklė buvo naudinga blokams peržiūrėti, tačiau jos galimybės niekada neprilygo tikrai kūrimo aplinkai. Bėgant metams kai kurių papildinio funkcijų nebuvo galima įtraukti, nes jų nepavyko palaikyti atskiroje rengyklėje. Ji taip pat niekada nebūtų pakeitusi visavertės IDE. Pašalinus ją, papildinys gali visą dėmesį skirti kūrimui naudojant failus ir išvengti apribojimų.

**Licencijos raktas.** Nebereikalingas. Blockstudio yra nemokama ir atvirojo kodo.

**Blokų biblioteka.** Integruota „Blockstudio Elements“ biblioteka (Gallery, Slider, Image Comparison, Code, Icon) pašalinta. Tai buvo iš anksto sukurti pavyzdiniai blokai, pateikiami kartu su papildiniu. Jei juos naudojote, nukopijuokite blokų aplankus iš v6 į savo temos blockstudio katalogą.

## Darbo pradžia

Įdiekite Blockstudio 7 ir per kelias minutes sukurkite pirmą bloką. Žingsnis po žingsnio instrukcijas rasite vadove [Darbo pradžios vadovas](https://blockstudio.dev/lt/docs/general/getting-started/), o naujindami iš v6 peržiūrėkite [v7 migravimo vadovą](https://blockstudio.dev/lt/docs/dev/migration/v7/).

Visą šaltinio kodą rasite [GitHub](https://github.com/inline0/blockstudio). Kviečiame pranešti apie problemas, teikti PR ir pasidalinti atsiliepimais.
