
Megérkezett a Blockstudio 7. Ez a projekt történetének legnagyobb kiadása: a teljes kódbázist alapjaiban írtuk újra. Minden osztályt, hookot és kódsort a nulláról építettünk fel, a modern PHP, WordPress kódolási szabványokra és a hosszú távú karbantarthatóságra összpontosítva.

Ez azonban nem csupán átalakítás. A Blockstudio 7 olyan jelentős új funkciókat vezet be, mint a fájlalapú oldalak és minták, a bejegyzésmeta-tároló rendszer, a SEO-integráció és az ezt működtető vadonatúj HTML-blokkokká alakító elemző. Emellett a Blockstudio mostantól teljesen ingyenes és nyílt forráskódú.

Nézzük meg, mi minden újdonságot hoz.

## Ingyenes és nyílt forráskódú

A Blockstudio projekten 2020 óta dolgozom, és az évek során több tucat kiadást készítettem. Akik használták, szerették, de egy kereskedelmi WordPress blokkkeretrendszer számára mindig nehéz volt megtalálni a piaci helyét.

Az LLM-ek változtatták meg a helyzetet. Az AI-kódoló asszisztensek már elég jók blokk-kód írásában, de ehhez rendezett, fájlalapú struktúrákra van szükségük. A WordPress blokkjainak jelölése kusza: szerializált HTML megjegyzések beágyazott JSON attribútumokkal, DOM-struktúrával vegyítve. Ezt az embereknek is nehéz jól kezelniük, az LLM-eknek pedig még nehezebb.

A Blockstudio fájlokat előtérbe helyező megközelítése mindig is az egyszerűséget szolgálta: egy `block.json` és egy PHP sablon egy mappában. Nincsenek adatbázis-bejegyzések, nincs React, nincs buildfolyamat. A v7 segítségével ez az elv még tovább érvényesül. A HTML-blokkokká alakító elemző lehetővé teszi, hogy egyszerű HTML-t írjon, amely automatikusan érvényes blokkjelöléssé alakul. Minden a fájlrendszerben marad. Az egyetlen adatbázisba írás az oldalak szinkronizálása, amelyet kifejezetten a PHP API vagy a CLI segítségével kérhet, és amelyet fájlsablonok vezérelnek.

A Blockstudio nyílt forráskódúvá tétele természetes következő lépés. Minél több LLM tanul Blockstudio-kódból, annál jobban tudja azt generálni. A nyílt kódbázis, a nyílt dokumentáció és az előre elkészített [AI-környezetfájl](https://blockstudio.dev/hu/docs/dev/ai/), amelyet bármely eszköz felhasználhat: így teremthető meg a legjobb környezet az AI-val támogatott WordPress fejlesztéshez.

A teljes bővítmény elérhető a [GitHub](https://github.com/inline0/blockstudio) oldalon, ahol bárki használhatja, elágaztathatja és közreműködhet a fejlesztésében. Nincsenek licenckulcsok, fizetőfalak vagy funkciókorlátozások.

## Új funkciók

### Fájlalapú oldalak

Ez a 7.0 egyik legnagyobb újdonsága. Mostantól teljes WordPress oldalakat határozhat meg fájlsablonokként, amelyek az oldalszinkronizálási API vagy CLI futtatásakor natív blokk-tartalomként szinkronizálódnak az adatbázisba.

Hozzon létre egy mappát egy `page.json` fájllal és egy sablonfájllal:

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

Futtassa a `wp bs pages sync` parancsot, hogy a Blockstudio feldolgozza a HTML fájlt WordPress blokkokká, majd létrehozza vagy frissítse az oldalt az adatbázisban.

#### Kulcsalapú blokkösszefésülés

A sablonok szinkronizálásakor a felhasználói módosítások normál esetben felülíródnának. A `key` attribútum megőrzi a felhasználói tartalmat a szinkronizálások során:

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

Az azonos kulcsú blokkok megtartják a felhasználó által szerkesztett tartalmukat a sablon frissítésekor. A kulcs nélküli blokkok teljes egészében lecserélődnek.

#### Blokkhozzárendelések

A kulcsok alternatívájaként használhatja a WordPress core [BlokkhozzárendelésekAPI](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-bindings/) funkcióját, amellyel közvetlenül kapcsolhatja össze a blokkokat a bejegyzés metaadataival. Ez nem Blockstudio-funkció, hanem natív WordPress API. A Blockstudio egyszerűen továbbadja a `metadata` attribútumot a létrehozott blokkjelölésnek. A tartalom metaadatokban, nem pedig a blokk jelölésében tárolódik, ezért a sablonok szinkronizálása soha nem törli a felhasználói módosításokat. Az adatok `WP_Query` segítségével is lekérdezhetők, és a REST API révén is elérhetők.

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

Mindkét megközelítés használható ugyanabban a sablonban.

#### Szerkesztési vezérlők

Az oldalakon a `blockEditingMode` és a `templateLock` segítségével szabályozhatja, hogy a felhasználók mit módosíthatnak:

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

Ez zárolja az oldal szerkezetét, miközben lehetővé teszi a felhasználóknak a szöveg és a média szerkesztését. Az egyes elemek a sablonban megadott `blockEditingMode` attribútummal felülírhatják az oldalszintű beállítást.

#### Rögzítés bejegyzésazonosítóhoz

A `postId` segítségével egy oldalsablont meglévő WordPress bejegyzéshez rendelhet, így elkerülheti a duplikált oldalakat, és biztosíthatja, hogy a sablon mindig a megfelelő bejegyzést frissítse:

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

A részletekért tekintse meg az [Oldalak dokumentációját](https://blockstudio.dev/hu/docs/pages-and-patterns/pages/).

### Fájlalapú minták

Az oldalakhoz hasonlóan mostantól a blokk-mintákat is fájlsablonként határozhatja meg. Írja meg a mintát HTML formátumban, a Blockstudio pedig blokkjelöléssé alakítja, és natív WordPress blokk-mintaként regisztrálja. A blokkok beszúrására szolgáló eszközben jelennek meg, és a felhasználók bárhol elhelyezhetik őket.

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

Az oldalakkal ellentétben a minták nem hoznak létre adatbázis-bejegyzéseket. Minden oldalbetöltéskor a memóriában regisztrálódnak. Tekintse meg a [Minták dokumentációját](https://blockstudio.dev/hu/docs/pages-and-patterns/patterns/).

### HTML-blokkokká alakító elemző

Az oldalakat és a mintákat egyaránt egy új HTML-elemző működteti, amely a szabványos HTML-sablonokat WordPress blokkjelöléssé alakítja. Automatikusan kezeli a konténerblokkokat (például a csoportokat és oszlopokat), valamint az önálló blokkokat (például a bekezdéseket és címsorokat). Az elemző tulajdonságalapú renderelőarchitektúrát használ, így a `blockstudio/parser/renderers` szűrőn keresztül könnyen bővíthető további blokktípusok támogatásával:

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

A regisztráció után a blokk bármely oldal- vagy mintasablonban használható:

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

### Tárolás

A mezők mostantól blokkattribútumok mellett a bejegyzés metaadataiban vagy a webhely beállításai között is tárolhatják értékeiket. Ez nagy újdonság:

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

A bejegyzés metaadataiban tárolt értékekkel a következőket teheti:

- Bejegyzések lekérdezése mezőértékek alapján a `WP_Query` és a `meta_query` használatával
- Mezőadatok elérése a REST API segítségével headless környezetekben
- Adatok megosztása más bővítményekkel, például a SEO eszközeivel és gyorsítótárazási rétegekkel

Az értékeket a beállítások táblájában is tárolhatja globális, az egész webhelyre kiterjedő beállításokhoz:

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

A részletekért tekintse meg a [Tárolás dokumentációját](https://blockstudio.dev/hu/docs/blocks/storage/), amely a teljes API leírást tartalmazza.

### Egyéni mezők

Az újrahasználható meződefiníciók mostantól több blokk között is megoszthatók. Határozzon meg egyszer egy mezőkészletet, majd hivatkozzon rá bármely blokkból. Ezzel elkerülhető az ismétlés, ha több blokk ugyanazt a mezőstruktúrát használja.

Hozzon létre egy `field.json` fájlt a blockstudio könyvtárában:

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

Ezután hivatkozzon rá bármely blokkból a `custom/` előtag használatával:

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

A `idStructure` tulajdonság minden mezőazonosító elé előtagot illeszt, így a `heading` értéke `hero_heading` lesz. Az egyes mezőtulajdonságokat példányonként is felülírhatja a `overrides` kulccsal.

Tekintse meg az [Egyéni mezők dokumentációját](https://blockstudio.dev/hu/docs/blocks/attributes/custom-fields/).

### Tailwind CSS v4

A Tailwind támogatását teljesen újraírtuk a v4 számára. A korábbi, CDN segítségével végzett kliensoldali fordítás és a bejegyzés mentésekor történő lemezre írás (a v6 megközelítés) helyett a Blockstudio 7 minden frontendkéréskor szerveroldalon fordítja a Tailwind-t a [TailwindPHP](https://github.com/dnnsjsk/tailwindphp) segítségével. Nincs Node.js, nincs CLI, és nincs szükség buildfolyamatra.

A fordítás jelöltalapú gyorsítótárazást használ: a Blockstudio kinyeri az összes CSS osztálynevet a végleges HTML fájlból, rendezi és kivonatot készít belőlük az CSS konfigurációval együtt, majd ellenőrzi, van-e gyorsítótárazott fájl. Ugyanazok az osztályok ugyanazt a gyorsítótár-találatot adják akkor is, ha a környező HTML megváltozik (nonce-ok, időbélyegek, dinamikus tartalom).

A konfiguráció a Tailwind v4 CSS-központú szintaxisát használja. Egyéni témákat és segédosztályokat közvetlenül az `blockstudio.json` fájlban vagy a `blockstudio/tailwind/css` szűrőn keresztül határozhat meg:

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

A blokk szerkesztőjében egy mellékelt Tailwind CDN szkript gépelés közben élő előnézetet biztosít. A `classes` mezőtípus automatikus kiegészítést kínál az összes Tailwind segédosztályhoz. A frontend mindig a szerveroldalon lefordított CSS-t használja, amely a `</head>` elé beszúrt inline style tagben kap helyet.

A teljes beállításhoz tekintse meg a [Tailwind dokumentációját](https://blockstudio.dev/hu/docs/tailwind/).

### Interaktivitás API

A Blockstudio mostantól támogatja az [WordPress interaktivitási API](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/) funkciót. Engedélyezze a block.json fájlban:

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

Adjon `data-wp-*` direktívákat a sablonhoz:

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

Ezután hozzon létre egy `script.js` fájlt az állapotkezelési logikával:

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

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

A Blockstudio kezeli az importmapet, a modulok betöltését és a direktívák feldolgozását a frontend és a blokk szerkesztőjében egyaránt. A kizárólag `data-wp-context`-t (például `data-wp-bind--hidden`-t vagy `data-wp-text`-t) használó deklaratív direktívák bármilyen JavaScript nélkül működnek. A `wp_interactivity_state()` segítségével megadott szerveroldali állapot is támogatott a frontend oldalon.

A teljes beállításhoz tekintse meg az [Interaktivitás dokumentációját](https://blockstudio.dev/hu/docs/blocks/interactivity/).

### SEO tartalomelemzés

A Blockstudio blokkok dinamikusak, ezért mezőik tartalmát az SEO bővítmények alapértelmezés szerint nem látják. A Blockstudio 7 ezt az Yoast SEO, a Rank Math és a SEOPress automatikus integrációjával oldja meg. Az `text`, `textarea`, `richtext`, `wysiwyg` és `link` mezők szöveges értékeit (beleértve a beágyazott ismétlősorokat is) kinyeri, és átadja az egyes bővítmények tartalomelemzéséhez. Az SEO bővítmények így megfelelően elemezhetik a blokkok tartalmát kulcsszósűrűség, olvashatóság és más mérőszámok alapján. Nincs szükség konfigurációra.

### Ismétlő alapértelmezett sorai

Az ismétlőmezők mostantól támogatják a `default` tulajdonságot, amellyel előre kitöltött sorok tömbje adható meg. Egy blokk beszúrásakor az ismétlő megkapja a megadott sorokat és értékeket a szerkesztőben és a frontend oldalon egyaránt:

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

A `min` tulajdonság a mezőszintű alapértelmezett értékekkel is működik: ha egy ismétlőnél meg van adva a `min: 3`, a benne lévő mezők pedig a `default` értéket kapják alapértelmezettként, akkor az automatikusan létrehozott sorok üresek helyett ezekkel az értékekkel lesznek kitöltve.

## Továbbfejlesztések és javítások

- **Ismétlő `min` mezőalapértelmezésekkel**: az automatikusan létrehozott minimális számú sor mostantól a mezőszintű alapértelmezett értékeket használja a frontend oldalon és a szerkesztőben is
- **Tailwind szerkesztőstílusok**: a lefordított Tailwind CSS mostantól a CDN mellett a blokk szerkesztőjének iframe-jébe is bekerül, így az egyéni `@apply`-szabályok és a témabeállítások a szerkesztőben is működnek
- **[AI-környezetfájl](https://blockstudio.dev/hu/docs/dev/ai/)**: a `blockstudio-llm.txt` mostantól statikus fájl, amely a teljes v7 dokumentációból és az ismétlődésmentes JSON sémákból áll össze (mintegy 48 ezer token); felváltja a v6 dinamikus generálását
- **Kómező külön ablakban**: a kódmező mostantól külön ablakban is megnyitható, önálló visszavonási és újbóli végrehajtási előzményekkel, valamint JavaScript szintaxiskiemeléssel
- **Tailwind v4 szerveroldali fordítása**: lásd a fenti [Tailwind részt](#tailwind-css-v4)
- **API 3. verzió**: a blokkok mostantól megfelelően jelennek meg az iframe-es szerkesztőben, beleértve a Site Editort és a reszponzív előnézeteket
- **Pontozott jelölés az eszközfájloknál**: letisztultabb fájlelnevezési konvenció az eszközök utótagjaihoz (`*.inline.css`, `*.editor.js`, `*.scoped.css`)
- Javítva a `bs_render_block()` figyelmeztetés, amelyet a `WP_Block_Supports` adott a `useBlockProps` használatakor
- Javítva, hogy a feltételes mezők első betöltéskor figyelmen kívül hagyták az alapértelmezett értékeket
- Javítva, hogy a frontend eltávolította a dollárjeleket a `<RichText />` tartalmából
- Javítva, hogy a `populate` funkció más bővítmények által regisztrált taxonómiákkal is működjön
- Javítva a WPML környezetekben jelentkező `optionsPopulate` null-hiba

## A motorháztető alatt

### Teljes újraírás

Ez nem átalakítás vagy rendbetétel. Minden osztályt a nulláról írtunk újra. Az eredmény egy tisztább, modulárisabb kódbázis, amelyet könnyebb karbantartani és bővíteni.

### Modern PHP

A Blockstudio 7 használatához PHP 8.2+ szükséges, és mindenütt modern típusdeklarációkat használ.

## Visszafelé nem kompatibilis változások

Főverzió-frissítésként a 7.0 több visszafelé nem kompatibilis változást tartalmaz. Ezek többségéhez rendelkezésre áll visszafelé kompatibilis tartalékmegoldás, de frissítés előtt érdemes áttekinteni őket. A teljes migrációs útmutatóért tekintse meg a [v7 migrációs dokumentációját](https://blockstudio.dev/hu/docs/dev/migration/v7/).

### A hookok neve mostantól snake_case formátumú

Minden PHP hook neve camelCase-ről snake_case-re változott, a WordPress core konvencióihoz igazodva:

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

A régi camelCase nevek továbbra is működnek, de javasoljuk a frissítésüket.

### A mezőkapcsoló alapértelmezés szerint ki van kapcsolva

A `switch` tulajdonság alapértelmezett értéke mostantól `false` a korábbi `true` helyett. A v6 verzióban minden mező bal szélén volt egy láthatatlan kapcsoló, amely alapértelmezés szerint be volt kapcsolva. A v7 verzióban a kapcsolót külön kell bekapcsolni, és a mező címkéjén látható szemikon jelzi. Ha a kapcsoló korábbi alapértelmezett működésére támaszkodott, adja hozzá a `"switch": true` elemet a meződefiníciókhoz.

### Az eszközfájlok elnevezése pontozott jelölést használ

Az eszközök utótagjaiban mostantól kötőjelek helyett pontok szerepelnek (`style.inline.css` helyett `style-inline.css`). A régi kötőjeles jelölés továbbra is működik, de a továbbiakban a pontozott forma ajánlott.

### npm importelőtag

Az ES-modulok importjai mostantól a `npm:` előtagot használják a korábbi `blockstudio/` helyett:

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

A `blockstudio/` előtag továbbra is támogatott a visszafelé kompatibilitás érdekében.

### Eltávolított funkciók

**Adminisztrációs felület és kódszerkesztő.** A WordPress adminisztrációs beállítási oldalt és a beépített blokk-kódszerkesztőt is eltávolítottuk. Mostantól minden konfiguráció a `blockstudio.json` és a PHP szűrőkön keresztül történik, így a beállítások a blokkokkal együtt, verziókezelés alatt tárolhatók.

A kódszerkesztő a korábbi verziókban hasznos volt a blokkok előnézetéhez, de sosem nyújtott teljes értékű fejlesztőkörnyezetet. Az évek során több bővítményfunkció fejlesztése azért maradt el, mert az önálló szerkesztőben nem lehetett támogatni őket. Teljes értékű IDE-t sem pótolhatott volna. Az eltávolításával a bővítmény kompromisszumok nélkül összpontosíthat a fájlalapú fejlesztésre.

**Licenckulcs.** Többé nincs rá szükség. A Blockstudio ingyenes és nyílt forráskódú.

**Blokkkönyvtár.** A beépített „Blockstudio Elements” könyvtárat (Gallery, Slider, Image Comparison, Code, Icon) eltávolítottuk. Ezek előre elkészített példablokkok voltak, amelyek a bővítménnyel együtt érkeztek. Ha használta őket, másolja át a blokk mappáit innen: v6 a témája blockstudio könyvtárába.

## Első lépések

Telepítse a Blockstudio 7-et, és készítse el első blokkját néhány perc alatt. Lépésről lépésre haladó útmutatóért tekintse meg az [Első lépések útmutatót](https://blockstudio.dev/hu/docs/general/getting-started/), vagy ha v6 verzióról frissít, a [v7 migrációs útmutatót](https://blockstudio.dev/hu/docs/dev/migration/v7/).

A teljes forráskód elérhető a [GitHub](https://github.com/inline0/blockstudio) oldalon. Várjuk a hibajelentéseket, a PR-eket és a visszajelzéseket.
