Ugrás a tartalomhoz

Dennis · 2026. február 7.

Introducing Blockstudio 7

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, 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 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
{
  "name": "about",
  "title": "About Us",
  "slug": "about",
  "postStatus": "publish"
}
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
<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 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
<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
{
  "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
{
  "name": "home",
  "title": "Home",
  "postId": 2
}

A részletekért tekintse meg az Oldalak dokumentációját.

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
{
  "name": "hero-section",
  "title": "Hero Section",
  "categories": ["featured"],
  "keywords": ["hero", "banner"]
}
HTML
<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.

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
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
<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
{
  "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
{
  "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, 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
{
  "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
{
  "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.

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

Interaktivitás API

A Blockstudio mostantól támogatja az WordPress interaktivitási API funkciót. Engedélyezze a block.json fájlban:

JSON
{
  "blockstudio": {
    "interactivity": true
  }
}

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

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

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
{
  "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: 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
  • 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.

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
// 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
// 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, vagy ha v6 verzióról frissít, a v7 migrációs útmutatót.

A teljes forráskód elérhető a GitHub oldalon. Várjuk a hibajelentéseket, a PR-eket és a visszajelzéseket.