
Blockstudio 7 je tu. To je največja izdaja v zgodovini projekta: popolna prenova celotne kodne zbirke od temeljev. Vsak razred, vsaka kljuka in vsaka vrstica kode so bili znova napisani s poudarkom na sodobnem PHP, standardih kodiranja WordPress in dolgoročni vzdrževalnosti.

A to ni le prenova. Blockstudio 7 prinaša pomembne nove funkcije, kot so strani in vzorci na podlagi datotek, sistem za shranjevanje metapodatkov objav, integracija SEO in povsem nov razčlenjevalnik HTML v bloke, ki poganja vse skupaj. Poleg tega je Blockstudio zdaj povsem brezplačen in odprtokoden.

Poglejmo si vse novosti.

## Brezplačno in odprtokodno

Na Blockstudio delam od 2020 in v preteklih letih sem izdal na desetine različic. Uporabniki so ga imeli radi, vendar je bilo za komercialno ogrodje blokov WordPress vedno težko najti ustrezen trg.

Enačbo so spremenili veliki jezikovni modeli. Pomočniki za kodiranje z umetno inteligenco so zdaj dovolj dobri za pisanje kode blokov, vendar za delo potrebujejo čiste strukture na podlagi datotek. Oznake blokov WordPress so neurejene: serializirani komentarji HTML z vdelanimi atributi JSON, pomešani s strukturo DOM. To je težko za ljudi, še težje pa za velike jezikovne modele, ki morajo vse pravilno razumeti.

Pristop Blockstudio, ki daje prednost datotekam, je bil vedno zasnovan tako, da stvari poenostavi: `block.json` in predloga PHP v mapi. Brez vnosov v zbirki podatkov, brez React in brez koraka gradnje. S v7 gre ta filozofija še dlje. Razčlenjevalnik HTML v bloke omogoča pisanje navadnega HTML, ki se samodejno pretvori v veljavne oznake blokov. Vse ostane v datotečnem sistemu. V zbirko podatkov se zapisujejo le sinhronizacije strani, ki jih izrecno zahtevate prek PHP API ali CLI, pri tem pa se uporabljajo predloge datotek.

Odprtokodnost je za Blockstudio naraven naslednji korak. Več ko se modeli LLM učijo na kodi Blockstudio, bolje jo ustvarjajo. Odprta koda, odprta dokumentacija in vnaprej pripravljena [kontekstna datoteka za AI](https://blockstudio.dev/sl/docs/dev/ai/), ki jo lahko uporabi katerokoli orodje: tako nastane najboljše okolje za razvoj WordPress s pomočjo AI.

Celoten vtičnik je na voljo na [GitHub](https://github.com/inline0/blockstudio), kjer ga lahko vsakdo uporablja, razcepi in prispeva k njegovemu razvoju. Brez licenčnih ključev, plačljivih omejitev ali zaklenjenih funkcij.

## Nove funkcije

### Strani na podlagi datotek

To je ena največjih novosti v različici 7.0. Zdaj lahko celotne strani WordPress določite kot predloge datotek, ki se ob zagonu sinhronizacije strani API ali CLI sinhronizirajo z zbirko podatkov kot izvorna vsebina blokov.

Ustvarite mapo z `page.json` in datoteko s predlogo:

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

Zaženite `wp bs pages sync`, da Blockstudio razčleni HTML v bloke WordPress ter ustvari ali posodobi stran v zbirki podatkov.

#### Združevanje blokov po ključih

Običajno bi se pri sinhronizaciji predlog uporabniške spremembe prepisale. Atribut `key` to prepreči, saj med sinhronizacijami ohrani uporabniško vsebino:

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

Bloki z ujemajočimi se ključi ohranijo vsebino, ki jo je uredil uporabnik, tudi po posodobitvi predloge. Bloki brez ključev se v celoti zamenjajo.

#### Povezave blokov

Namesto ključev lahko uporabite WordPress jedrne povezave blokov [Block Bindings API](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/) za neposredno povezavo blokov z metapodatki objave. To ni funkcija Blockstudio, temveč izvorna funkcija WordPress API. Blockstudio zgolj posreduje atribut `metadata` v ustvarjene oznake bloka. Vsebina je shranjena v metapodatkih in ne v oznakah bloka, zato sinhronizacija predloge nikoli ne izbriše uporabniških sprememb. Do podatkov je mogoče dostopati tudi prek `WP_Query` in API REST.

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

Oba pristopa lahko uporabite v isti predlogi.

#### Nastavitve urejanja

Strani podpirajo `blockEditingMode` in `templateLock` za določanje, kaj lahko uporabniki spreminjajo:

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

S tem zaklenete strukturo strani, uporabnikom pa še vedno omogočite urejanje besedila in predstavnosti. Posamezni elementi lahko nastavitev za celotno stran preglasijo z atributom `blockEditingMode` v predlogi.

#### Pripenjanje na ID-je objav

Uporabite `postId`, da predlogo strani povežete z obstoječo objavo WordPress. Tako preprečite podvojene strani in zagotovite, da predloga vedno posodobi pravilno objavo:

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

Za vse podrobnosti si oglejte [dokumentacijo za strani](https://blockstudio.dev/sl/docs/pages-and-patterns/pages/).

### Vzorci na podlagi datotek

Podobno kot strani lahko zdaj tudi vzorce blokov določite kot predloge datotek. Vzorec napišite v HTML, Blockstudio pa ga razčleni v oznake blokov in registrira kot izvorni vzorec bloka WordPress. Prikažejo se v vstavljalniku blokov, uporabniki pa jih lahko vstavijo kamor koli.

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

Za razliko od strani vzorci ne ustvarjajo vnosov v zbirki podatkov. Ob vsakem nalaganju strani se registrirajo v pomnilniku. Oglejte si [dokumentacijo za vzorce](https://blockstudio.dev/sl/docs/pages-and-patterns/patterns/).

### Razčlenjevalnik HTML v bloke

Strani in vzorce poganja novi razčlenjevalnik HTML, ki standardne predloge HTML pretvori v oznake blokov WordPress. Samodejno obravnava vsebnike, kot so skupine in stolpci, ter samostojne bloke, kot so odstavki in naslovi. Razčlenjevalnik uporablja arhitekturo izrisovalnika na podlagi lastnosti, zato ga je preprosto razširiti s podporo za dodatne vrste blokov prek filtra `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 );
```

Ko blok registrirate, ga lahko uporabite v kateri koli predlogi strani ali vzorca:

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

### Shranjevanje

Vrednosti polj je zdaj poleg atributov blokov mogoče shranjevati tudi v metapodatkih objav ali možnostih spletnega mesta. To je velika novost:

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

Ko so vrednosti shranjene v metapodatkih objav, lahko:

- Iščete objave po vrednostih polj z `WP_Query` in `meta_query`
- Dostopate do podatkov polj prek REST API za brezglave nastavitve
- Delite podatke z drugimi vtičniki, kot so orodja SEO, in s sistemi za predpomnjenje

Vrednosti lahko shranite tudi v tabelo možnosti za globalne nastavitve celotnega spletnega mesta:

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

Za vse podrobnosti si oglejte [dokumentacijo o shranjevanju](https://blockstudio.dev/sl/docs/blocks/storage/) za API.

### Polja po meri

Definicije polj za večkratno uporabo je zdaj mogoče deliti med več bloki. Enkrat določite nabor polj in se nato nanj sklicujte v katerem koli bloku. Tako se izognete ponavljanju, kadar si več blokov deli enako strukturo polj.

Ustvarite `field.json` v imeniku blockstudio:

```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" }
  ]
}
```

Nato se nanjo sklicujte iz katerega koli bloka s predpono `custom/`:

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

Lastnost `idStructure` pred vsako ID-oznako polja doda predpono, zato `heading` postane `hero_heading`. Posamezne lastnosti polj lahko preglasite tudi za vsako instanco posebej s ključem `overrides`.

Oglejte si [dokumentacijo za polja po meri](https://blockstudio.dev/sl/docs/blocks/attributes/custom-fields/).

### Tailwind CSS v4

Podpora za Tailwind je bila za v4 v celoti prenovljena. Namesto prevajanja na odjemalcu prek CDN in shranjevanja na disk ob shranjevanju objave (pristop v6) Blockstudio 7 prevede Tailwind na strežniku ob vsaki zahtevi za spletno stran prek [TailwindPHP](https://github.com/dnnsjsk/tailwindphp). Brez Node.js, brez CLI in brez potrebe po koraku gradnje.

Prevajanje uporablja predpomnjenje na podlagi kandidatov: Blockstudio iz končnega HTML pridobi vsa imena razredov CSS, jih razvrsti in zgosti skupaj z vašo konfiguracijo CSS ter preveri, ali datoteka že obstaja v predpomnilniku. Enaki razredi se vedno ujemajo z istim zapisom v predpomnilniku, tudi če se spremeni okoliški HTML (nonce, časovni žigi, dinamična vsebina).

Konfiguracija uporablja sintakso CSS, ki najprej temelji na Tailwind v4. Določite teme po meri in uporabne razrede neposredno v `blockstudio.json` ali prek filtra `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;
      }
    }
  ';
});
```

V urejevalniku blokov priloženi skript Tailwind CDN med tipkanjem prikaže predogled v živo. Vrsta polja `classes` ponuja samodokončanje za vse uporabne razrede Tailwind. Na sprednjem delu se vedno uporabi prevedeni CSS s strežnika, ki je vstavljen kot oznaka sloga v vrstici pred `</head>`.

Za celotno nastavitev si oglejte dokumentacijo [Tailwind](https://blockstudio.dev/sl/docs/tailwind/).

### Interaktivnost API

Blockstudio zdaj podpira specifikacijo Interactivity [WordPress Interactivity API](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/). Omogočite jo v block.json:

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

Predlogi dodajte direktive `data-wp-*`:

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

Ustvarite še `script.js` z logiko shrambe:

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

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

Blockstudio obravnava importmap, nalaganje modulov in obdelavo direktiv tako na sprednjem delu kot v urejevalniku blokov. Bloki, ki uporabljajo samo deklarativne direktive z `data-wp-context`, kot sta `data-wp-bind--hidden` ali `data-wp-text`, delujejo povsem brez JavaScript. Na sprednjem delu je podprto tudi stanje na strani strežnika prek `wp_interactivity_state()`.

Za celotno nastavitev si oglejte [dokumentacijo o interaktivnosti](https://blockstudio.dev/sl/docs/blocks/interactivity/).

### Analiza vsebine SEO

Bloki Blockstudio so dinamični, zato njihova vsebina polj vtičnikom SEO privzeto ni vidna. Blockstudio 7 to odpravlja s samodejnimi integracijami za Yoast SEO, Rank Math in SEOPress. Besedilne vrednosti iz polj `text`, `textarea`, `richtext`, `wysiwyg` in `link`, vključno z ugnezdenimi vrsticami ponavljalnika, se pridobijo in posredujejo v analizo vsebine vsakega vtičnika. Vtičniki SEO lahko zdaj pravilno analizirajo vsebino blokov glede gostote ključnih besed, berljivosti in drugih meril. Nastavitev ni potrebna.

### Privzete vrstice ponavljalnika

Polja ponavljalnika zdaj podpirajo lastnost `default` z vnaprej izpolnjenimi vrsticami v obliki polja. Ob vstavljanju bloka se ponavljalnik napolni z določenimi vrsticami in njihovimi vrednostmi, tako v urejevalniku kot na sprednjem delu:

```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" }
  ]
}
```

Lastnost `min` deluje tudi s privzetimi vrednostmi na ravni polj: če ima ponavljalnik `min: 3`, njegova notranja polja pa vrednosti `default`, se samodejno ustvarjene vrstice vnaprej izpolnijo s temi privzetimi vrednostmi in niso prazne.

## Izboljšave in popravki

- **Ponavljajoče se polje `min` s privzetimi vrednostmi polj**: samodejno ustvarjene vrstice do najmanjšega števila zdaj uporabljajo privzete vrednosti posameznih polj na javni strani in v urejevalniku
- **Slogi Tailwind v urejevalniku**: prevedeni Tailwind CSS se zdaj vstavi v iframe urejevalnika blokov ob CDN, zato v urejevalniku delujejo pravila `@apply` po meri in konfiguracija teme
- **[Kontekstna datoteka za AI](https://blockstudio.dev/sl/docs/dev/ai/)**: `blockstudio-llm.txt` je na novo zgrajen kot statična datoteka iz celotne dokumentacije v7 in shem JSON brez podvojitev (~48k tokenov), namesto dinamičnega ustvarjanja iz v6
- **Polje za kodo v ločenem oknu**: polje za kodo je zdaj mogoče odpreti v ločenem oknu z neodvisnim razveljavljanjem in ponavljanjem dejanj ter poudarjanjem sintakse JavaScript
- **Strežniško prevajanje Tailwind v4**: glejte zgornji [razdelek o Tailwind](#tailwind-css-v4)
- **Različica API 3**: bloki se zdaj pravilno izrisujejo v urejevalniku v iframe, tudi v urejevalniku spletnega mesta in odzivnih predogledih
- **Pikčasta notacija za sredstva**: preglednejše poimenovanje pripon datotek sredstev (`*.inline.css`, `*.editor.js`, `*.scoped.css`)
- Odpravljeno opozorilo `bs_render_block()` iz `WP_Block_Supports` pri uporabi `useBlockProps`
- Odpravljeno neupoštevanje privzetih vrednosti pogojnih polj ob prvem nalaganju
- Odpravljeno odstranjevanje znakov za dolar iz vsebine `<RichText />` na javni strani
- Popravljeno delovanje možnosti `populate` s taksonomijami, ki jih registrirajo drugi vtičniki
- Odpravljena napaka null za `optionsPopulate` v okoljih WPML

## Delovanje v ozadju

### Popolna prenova

To ni preoblikovanje ali čiščenje kode. Vsak razred je bil napisan znova od začetka. Rezultat je čistejša in bolj modularna kodna zbirka, ki jo je lažje vzdrževati in razširjati.

### Sodoben PHP

Blockstudio 7 zahteva PHP 8.2+ in povsod uporablja sodobne deklaracije tipov.

## Spremembe, ki lahko prekinejo združljivost

Kot večja posodobitev različica 7.0 vključuje več sprememb, ki lahko prekinejo združljivost. Večina ima nadomestne možnosti, združljive s starejšimi različicami, vendar jih pred nadgradnjo preglejte. Celoten vodnik za selitev najdete v dokumentaciji za selitev [v7](https://blockstudio.dev/sl/docs/dev/migration/v7/).

### Imena kljuk zdaj uporabljajo snake_case

Vse kljuke PHP so bile preimenovane iz camelCase v snake_case, da ustrezajo konvencijam jedra WordPress:

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

Stara imena camelCase še vedno delujejo, vendar priporočamo, da jih posodobite.

### Stikalo polja je privzeto izklopljeno

Lastnost `switch` je zdaj privzeto nastavljena na `false` namesto na `true`. V v6 je imelo vsako polje na levem robu nevidno stikalo, ki je bilo privzeto vklopljeno. V v7 je stikalo neobvezno in uporablja vidno ikono očesa v oznaki polja. Če ste se zanašali na privzeto delovanje stikala, dodajte `"switch": true` v definicije polj.

### Imena datotek sredstev uporabljajo piko

Pripone sredstev zdaj uporabljajo pike namesto vezajev (`style.inline.css` namesto `style-inline.css`). Stari zapis z vezaji še vedno deluje, vendar je pika odslej priporočena konvencija.

### Predpona uvoza npm

Uvozi modulov ES zdaj uporabljajo `npm:` namesto `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";
```

Predpona `blockstudio/` je še vedno podprta zaradi združljivosti s starejšimi različicami.

### Odstranjene funkcije

**Skrbniški del in urejevalnik kode.** Skrbniška stran z nastavitvami WordPress in vgrajeni urejevalnik kode blokov sta bila odstranjena. Vsa konfiguracija zdaj poteka prek filtrov `blockstudio.json` in PHP, zato je vaša nastavitev poleg blokov shranjena v sistemu za nadzor različic.

Urejevalnik kode je bil v starejših različicah uporaben za predogled blokov, vendar nikoli ni dosegel vseh zmogljivosti pravega razvojnega okolja. V preteklih letih so bile številne funkcije vtičnika omejene, ker jih v samostojnem urejevalniku ni bilo mogoče podpreti. Prav tako nikoli ne bi mogel nadomestiti celovitega integriranega razvojnega okolja. Z njegovo odstranitvijo se lahko vtičnik v celoti posveti razvoju na podlagi datotek brez kompromisov.

**Licenčni ključ.** Ni več potreben. Blockstudio je brezplačen in odprtokoden.

**Knjižnica blokov.** Vgrajena knjižnica »Blockstudio Elements« (Gallery, Slider, Image Comparison, Code, Icon) je bila odstranjena. To so bili vnaprej pripravljeni primeri blokov, priloženi vtičniku. Če ste jih uporabljali, kopirajte mape blokov iz v6 v imenik blockstudio svoje teme.

## Začetek

Namestite Blockstudio 7 in v nekaj minutah ustvarite svoj prvi blok. Oglejte si [vodnik za začetek](https://blockstudio.dev/sl/docs/general/getting-started/), ki vas korak za korakom vodi skozi postopek, ali pa vodnik za selitev [v7](https://blockstudio.dev/sl/docs/dev/migration/v7/), če nadgrajujete z različice v6.

Celotna izvorna koda je na voljo na [GitHub](https://github.com/inline0/blockstudio). Dobrodošli so prijava napak, PR-ji in povratne informacije.
