Dennis · 2026. március 14.
Blockstudio 7.1
A Blockstudio 7.1 az első funkciókiadás a v7 átírása óta. Míg a v7 új alapokra helyezte a rendszert, a 7.1 olyan elemeket ad hozzá, amelyekkel a blokkok többre képesek: adatbázisréteget, szerverfunkciókat, ütemezett feladatokat és egy CLI. Egy blokk mappája most már teljes alkalmazás lehet.
Íme az összes újdonság.
Komponensek
Mindig is volt némi feszültség az olyan blokkok között, amelyeket a szerkesztők a beszúróban használnak, és azok között, amelyeket a fejlesztők más dolgok építőelemeiként használnak. Egy kártya, egy jelvény, egy statisztikai widget, egy űrlapmező. Szükségük van a teljes Blockstudio folyamatra (attribútumok, sablonok, eszközfájlok, Tailwind), de semmi keresnivalójuk a beszúróban.
A 7.1 komponenseket vezet be ennek megoldására. Állítsa be a "component": true értéket a block.json fájlban, és a blokk végigmegy a teljes összeállítási folyamaton, de nem kerül be a WordPress blokktípus-nyilvántartásába. Nem jelenik meg a beszúróban, és nem kerül bele a JavaScript-nek küldött szerkesztői adatokba, de programozott megjelenítésre teljesen használható.
{
"name": "my-theme/card",
"title": "Card",
"blockstudio": {
"component": true,
"attributes": [
{ "id": "title", "type": "text" },
{ "id": "description", "type": "textarea" }
]
}
}
Jelenítse meg őket innen: PHP:
bs_render_block([
'name' => 'my-theme/card',
'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);
Vagy az új HTML címkeszintaxissal:
<bs:my-theme-card title="My Card" description="Card content." />
Blokkcímkék
A blokkok mostantól HTML címkékként ágyazhatók be, két felcserélhető szintaxis használatával:
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />
Mindkettő ugyanazt az eredményt adja. Mindkettő működik a Blockstudio blokkokkal és az alapvető WordPress blokkokkal. A blokk sablonjain belül külön bekapcsolás nélkül, automatikusan jelennek meg. Így a sablonban közvetlenül más blokkokból állíthat össze teljes elrendezéseket:
<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>
A két szintaxis szabadon egymásba ágyazható. A Blockstudio blokkok végigmennek a teljes folyamaton (sablonok, Tailwind, eszközfájlok). Az alapblokkok megjelenítését a WordPress végzi ugyanazokkal a megjelenítőkkel, amelyek a Pages and Patterns funkciót is működtetik.
Az oldalszintű megjelenítéshez (bejegyzéstartalom, widgetterületek) engedélyezze ezt itt: blockstudio.json:
{ "blockTags": { "enabled": true } }
Az engedélyezési és tiltólisták helyettesítő mintákkal szabályozzák, mely blokkok jeleníthetők meg címkéken keresztül. A data-* és html-* attribútumok változatlanul átkerülnek a megjelenített blokk gyökér HTML elemébe. Egyéni megjelenítők a blockstudio/block_tags/renderers szűrővel regisztrálhatók.
A háttérben a címkeelemző egy új, könnyű karakterlánc-olvasó, amely teljesen kiváltja a DOMDocumentet. Mélységkövetéssel kezeli a beágyazott címkéket, a rekurzív tárolóblokkokat és az egyetlen menetben feldolgozott vegyes szintaxist. A teljesítménymérésekben 1,000 egyszerű címkét 2,4 ms alatt, 100 egymásba ágyazási szintet pedig 3,7 ms alatt elemez, így következetesen gyorsabb a DOMDocumentnél és a WordPress WP_HTML_Tag_Processor megoldásánál. Ugyanez az elemző a Pages and Patterns funkcióhoz a nyers HTML elemeket is feldolgozza, és kiváltja a korábbi, DOMDocument-alapú elemzőt, amely a <p>, <div> és más HTML elemeket kezelte.
Új mezőtípusok
Blokk
Új block mezőtípus, amellyel egy másik Blockstudio blokk attribútumként hivatkozható. A hivatkozott blokk mezői a idStructure és overrides segítségével, a saját mezőkhöz hasonlóan, beágyazva jelennek meg. A különbség: a sablonban az érték elérése a megjelenített blokk kimenetét adja vissza.
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Ha a mytheme/card rendelkezik heading és content mezővel, a befogadó blokk oldalsávján megjelenik a card_heading és a card_content. A sablonban a {{ a.card }} a megjelenített kártyát adja ki. Normál blokkokkal és komponensekkel egyaránt működik.
HTML címke
Minden témában vannak olyan blokkok, amelyek címsorszintjének a környezettől függően kell változnia. H1 a kezdőlapon, H2 a belső oldalakon. Ahelyett, hogy minden alkalommal rögzített beállításokkal rendelkező választómezőt készítene, mostantól külön html-tag mezőtípus áll rendelkezésre beépített előbeállításokkal.
{
"id": "tag",
"type": "html-tag",
"default": "h2",
"tags": "heading",
"exclude": ["h5", "h6"]
}
Előbeállítások: heading (h1-h6), text (címsorok + p, span, div), structural (div, section, article, aside, main, header, footer, nav), all. Egyéni tömb is megadható. A exclude eltávolít bizonyos címkéket bármelyik előbeállításból.
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>
Adatbázis
Ez a kiadás központi újdonsága. Adjon hozzá egy db.php fájlt bármelyik blokkmappához, és a Blockstudio létrehozza az öt REST CRUD-végpontot, minden írási műveletet ellenőriz a séma alapján, automatikusan kezeli a tárolási hátteret, valamint egy JavaScript klienst (bs.db()) és egy PHP API megoldást (Db::get()) is biztosít. Nincs szükség migrációs fájlokra, vezérlőosztályokra vagy útvonal-regisztrációra.
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']],
],
],
];
Már ez a séma is teljesen működő API-t hoz létre létrehozási, listázási, lekérési, frissítési és törlési végpontokkal, mindegyiknél bemenet-ellenőrzéssel.
Tárolás
Ötféle tárolási háttér, különböző felhasználási esetekhez:
table: Egyéni MySQL tábla, amelyet adbDelta()kezel. Ha mezőket ad a sémához, a következő oldalbetöltéskor új oszlopok jönnek létre. Ez az éles környezetben használt alapértelmezett megoldás.sqlite: Egyetlen SQLite fájl a blokkdb/mappájában. Valódi SQL lekérdezések, WAL-mód az egyidejű olvasáshoz, és teljes hordozhatóság. Másolja a mappát, másolja az adatbázist.jsonc: Fájlonként soronként egy JSON objektum. Ember által olvasható, verziókezelhető, gitbarát.meta: JSON tömb a WordPress bejegyzés metaadataiban, egy adott bejegyzéshez kötve.post_type: Minden rekordból WordPress bejegyzés lesz egy egyéni bejegyzéstípusban. A mezők külön bejegyzés-metaadatként tárolódnak, és aWP_Querysegítségével teljes körűen lekérdezhetők.
Kliensek
A JavaScript oldalon a bs.db() teljes CRUD-klienst biztosít:
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);
Három kiegészítő segédprogram is tartozik hozzá:
bs.cache: Memóriabeli lekérdezési gyorsítótárget,set,invalidateéscleartámogatással. Minden lekérdezés és módosítás között megosztott.bs.query(key, fn, options): Bármely aszinkron függvényt gyorsítótárazással, kérések összevonásával és beállíthatóstaleTimeértékekkel egészít ki. Ha egy kérés folyamatban van, azonos kulccsal több hívás ugyanazt az ígéretet adja vissza.bs.mutate(options): Optimista módosításokat kezel automatikus visszaállítással. Adjon meg egy reaktív állapotobjektumot, egy műveletet (create,update,delete) és optimista adatokat. A UI azonnal frissül. Ha a szerverkérés sikertelen, az állapot visszaáll a módosítás előtti pillanatképre.
Ezek együtt a teljes olvasási és írási ciklust lefedik: bs.query a gyorsítótárazott olvasásokhoz, bs.mutate az optimista írásokhoz, bs.cache a kézi vezérléshez.
A PHP oldalon a Db osztály ugyanezeket a műveleteket biztosítja:
use Blockstudio\Db;
$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);
Érvényesítés
Az érvényesítési hibák mezőnkénti hibatömbökként érkeznek vissza, a Zod fieldErrors formátuma alapján. Ugyanazon a mezőn több szabály is hibát jelezhet, a szerkezet pedig megkönnyíti a hibák hozzárendelését a kezelőfelületen lévő űrlapmezőkhöz:
{
"data": {
"status": 400,
"errors": {
"email": ["Must be a valid email address.", "This domain is blocked."],
"plan": ["Must be one of: free, pro."]
}
}
}
Egyéni validate visszahívások futnak le a szerveren minden olyan ellenőrzéshez, amelyre a beépített szabályok nem terjednek ki: domainek blokkolása, mezők közötti ellenőrzés, külső lekérdezések.
Felhasználóhoz kötött adatok
Felhasználónkénti adatokhoz, például teendőkhöz, kedvencekhez vagy piszkozatokhoz állítsa a userScoped értékét erre: true, a többit pedig a Blockstudio intézi. Hozzáad egy user_id oszlopot, létrehozáskor automatikusan beállítja, és minden lekérdezést az aktuális felhasználóra szűkít. A frissítések és törlések ellenőrzik a tulajdonjogot. Nincs szükség kézi user_id mezőre, before_create hookra vagy a RPC szerinti szűrésre. Egy sor beállítás. post_type tárolás használatakor a userScoped külön oszlop helyett a post_author mezőre képeződik le.
return [
'storage' => 'sqlite',
'userScoped' => true,
'fields' => [ /* ... */ ],
];
Valós idejű lekérdezés
Állítsa be a 'realtime' => true értéket a sémában, és az ügyfél automatikusan lekérdezi a változásokat. Ha valami megváltozik a szerveren, az Interactivity API tároló frissül, a UI pedig újrarenderelődik anélkül, hogy az Ön oldalán bármilyen JavaScript változtatásra lenne szükség. A 'realtime' => ['key' => 'todos', 'interval' => 5000] segítségével egyéni állapotkulcsok és időközök állíthatók be. A lekérdezések hash-összehasonlítást használnak a kérések kis méretűen tartásához, és szünetelnek, amikor a böngészőlap rejtett.
Biztonság, hookok és hordozhatóság
A nyilvános végpontokat automatikusan hozzáadott X-BS-Token CSRF-fejléc védi. Használja a 'open' beállítást, ha valóban hitelesítés nélküli hozzáférésre van szüksége, például bejövő webhookokhoz.
Az életciklus-hookok minden írási művelet előtt és után lefutnak. Definiálja őket közvetlenül a db.php fájlban vagy globálisan, a WordPress műveleteken keresztül.
A mezőknél megadható egy component kulcs a sémavezérelt űrlapmegjelenítéshez a bs_db_form() segítségével.
SQLite vagy JSONC tárolással az egész alkalmazás egyetlen mappában él: a kód, a logika, a hozzáférés-vezérlés és az adatok. A telepítéshez elég átmásolni.
RPC
Néha a CRUD nem elég. Egyéni szerveroldali logikára van szükség: például teendők állapotának váltására, értesítések küldésére vagy statisztikák összesítésére. Erre szolgál a rpc.php. Definiáljon egy PHP függvényt, hívja meg a kezelőfelületről a bs.fn() segítségével, a Blockstudio pedig kezeli a REST végpontot, a hitelesítést, a CSRF-védelmet és a JSON szerializálást. A megoldás a tRPC mintáját követi: az eljárásokat a szerveren definiálja, az ügyfél pedig név szerint hívja meg őket.
return [
'subscribe' => function (array $params): array {
$email = sanitize_email($params['email']);
return ['success' => true];
},
];
const result = await bs.fn('subscribe', { email: 'user@example.com' });
A beágyazott szkriptek (script-inline.js) automatikusan felismerik a blokk nevét a szkriptcímkéjük data-block attribútumából, így nem kell kézzel átadnia. A moduláris szkriptek harmadik argumentumként kapják meg.
A hozzáférés-vezérlési lehetőségek között szerepel a public (CSRF-védelemmel), a 'open' (védelem nélkül), a jogosultsági karakterláncok és a tömbök. Támogatott a függvényenkénti HTTP metódusvezérlés, az életciklus-hookok, valamint a blokkok közötti hívás a JS és a PHP felől egyaránt.
Cron
A háttérfeladatokat egy cron.php fájlban lehet definiálni. Adjon meg egy ütemezést és egy visszahívási függvényt, a Blockstudio pedig az indításkor regisztrálja őket a WordPress Cron rendszerben. A bővítmény kikapcsolásakor minden ütemezés szabályosan törlődik.
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
},
],
];
Minden beépített WordPress ütemezés támogatott, az egyéni időközök pedig a cron_schedules szűrővel állíthatók be.
CLI
Egy új wp bs parancs lefedi a teljes Blockstudio funkciókészletet: blokkok, adatbázis, RPC, cron, beállítások, Tailwind fordítás, SCSS fordítás, egyéni mezők és eszközfájlok kezelése.
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
Minden parancs támogatja a --format=json kapcsolót szkripteléshez.
Ismétlődő mezők fejlesztései
textMinimized objektummezőkhöz
Az összecsukott ismétlődő sorok most már megfelelően kezelik az objektummezők értékeit. Korábban a textMinimized linkmezőre állítva ezt mutatta: [object Object]. Most a Blockstudio automatikusan a mezőtípusnak megfelelő almezőt olvassa ki: title a linkeknél, value a színeknél és színátmeneteknél, icon az ikonoknál. Egyéni key tulajdonság is megadható bármelyik kívánt almező kiolvasásához.
{
"type": "repeater",
"textMinimized": { "id": "href", "fallback": "Add a link" },
"attributes": [{ "id": "href", "type": "link" }]
}
RichText és MediaPlaceholder
Mindkét sablonkomponens használható ismétlődő mezőkben is; a zárójeles jelölés a megfelelő sort célozza meg. Minden ismétlődő sorban szerkeszthetők a címek és bekezdések, valamint használhatók médiafeltöltési területek.
{% 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 %}
Egyéni mezők feltételei idStructure használatával
Ha egyéni mezőhöz idStructure van beállítva, a meződefinícióban szereplő feltételek az azonosítóikat automatikusan a kibontott nevekre módosítják. Ha a betűméret-mezőcsoport egyik feltétele a enable mezőre vonatkozik, és a csoportot a idStructure: "title_font_{id}" segítségével bővíti ki, a feltétel most már helyesen a title_font_enable mezőre hivatkozik az eredeti enable helyett.
A hivatkozási szintű feltételek is támogatottak. Adja meg a conditions értéket az egyéni mező hivatkozásánál, hogy egyszerre minden kibontott mezőre alkalmazza őket.
Dinamikus populate argumentumok
A populate argumentumok mostantól más blokkattribútumokra is hivatkozhatnak a {attributes.*} szintaxis használatával. Ha a hivatkozott attribútum megváltozik, a választómező automatikusan újra lekéri a lehetőségeit. Fűzze össze a választómezőket: az egyik kiválasztja a bejegyzéstípust, a másik betölti az adott típus bejegyzéseit.
{
"id": "selected_post",
"type": "select",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "{attributes.post_type}"
}
}
}
Módosítsa a post_type értékét „page”-re, és a második választó oldalakat tölt be. Állítsa „post”-ra, és bejegyzéseket tölt be. Bármilyen populate-típussal és attribútummal működik.
Composer
A Blockstudio mostantól bárhonnan betöltve működik a wp-content/ alól, nem csak a bővítmények mappájából. Az eszközfájlok URL-jei a BLOCKSTUDIO_URL konstanson keresztül oldódnak fel a plugins_url() helyett, így a témába csomagolt telepítések azonnal működnek:
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/vendor/blockstudio/blockstudio/blockstudio.php';
A composer.json futásidejű függőségeit átrendeztük. A hatókörrel ellátott csomagok (TailwindPHP, ScssPhp, Minify), amelyek már szerepelnek a lib/ csomagban, többé nem futásidejű függőségek. Csak a php >= 8.2 és a plugin-update-checker marad.
Mindhárom telepítési mód (bővítmény-zip, bővítmény a Composer segítségével, témába csomagolva a Composer révén) ugyanazt eredményezi: a teljes WordPress aktiválást, a blokkok regisztrációját és a felhasználói felületen történő megjelenítést.
A beállítási útmutatóért tekintse meg a Composer dokumentációt.
Teljesítményprofilozó
Adja hozzá a ?blockstudio-perf értéket bármely oldal URL eleméhez, és alul megjelenik egy hibakereső panel blokkonkénti megjelenítési időkkel, fázisokra bontott adatokkal és gyorsítótár-találati arányokkal. Az időzítési adatok Server-Timing fejlécként is elküldésre kerülnek, és a böngésző Fejlesztői eszközeinek Hálózat lapján láthatók.
{ "dev": { "perf": true } }
A beállításokban véglegesen bekapcsolva minden oldalbetöltés profilozható. Csak a edit_posts jogosultsággal rendelkező, bejelentkezett felhasználók láthatják.
Az önzáró blokkcímkék is gyorsítótárazódnak a memóriában. Ha egy oldalon többször szerepel ugyanaz a blokk azonos attribútumokkal, a további megjelenítések kihagyják a teljes sablonfolyamatot.
Hibajavítások
- PHP 8.4 elavulási figyelmeztetései: Javítottuk az
strpos()és azstr_replace()elavulási figyelmeztetéseit, amelyeket aznullátadása okozott aadd_submenu_page()számára.
Továbbiak
- SCSS kódmezők: A kódmezők támogatják az
language: "scss"használatát. Az értékek a ScssPhp segítségével fordítódnak le a szerkesztőben és a felhasználói felületen is. - Szabványos WordPress blokkok: Az Blockstudio könyvtárak tartalmazhatnak
@wordpress/create-blockkimenetet az Blockstudio blokkok mellett. Külön bővítménykód nélkül, automatikusan regisztrálódnak.
Ha működés közben is látni szeretné a teljes veremű mintát, a Full-Stack Blocks útmutató végigvezeti egy felhasználónkénti teendőalkalmazás és egy nyilvános hírlevél-feliratkozási űrlap nulláról történő elkészítésén.