Dennis · 2026. június 21.
Blockstudio 7.4
Blockstudio A 7.4 célja a fájlokkal kezelt projektek hordozhatóbbá tétele. A 7.2 megkönnyítette a nagyobb projektek áttekintését és terjesztését, a 7.3 pedig egy UI réteggel bővítette az alapokat. A 7.4 arra összpontosít, hogy a projekt, az oldalai és a válogatott tartalmai nagyobb része kerüljön az adatbázisból verziókezelt fájlokba.
A kiemelt újdonság az oldalgyűjtemény: egy mód arra, hogy az Blockstudio egy oldalfájlokat tartalmazó mappára mutasson, és abból teljes, beágyazott WordPress oldalstruktúrát hozzon létre. A forrás lehet PHP, Twig, Blade, HTML, Markdown, vagy egy megbízható betöltő, amely egy másik helyi forrásból ad vissza oldalakat.
Röviden:
- Oldalgyűjtemények: az
pages.jsonteljes, beágyazott oldalkészletet, alapértékeket, bejegyzéstípus-viselkedést, elrendezéseket, betöltőket és gyűjteménymetaadatokat határozhat meg. - Markdown oldalak: az
index.mdoldaltartalomként használható, akárpage.jsonmellett, akár önmagában, frontmatterrel. - Frontendoldal-elrendezések: az
layout.phpkörbeveheti a szinkronizált oldaltartalmat, és olyan segédeket használhat, mint azblockstudio_page_tree()és azblockstudio_page_content(). - Külső dokumentációs források: a gyűjteménybetöltők helyi fájlokból vagy visszaadott Markdown/HTML elemekből hozhatnak létre oldalakat.
- Nyers Markdown kimenet: az Markdown oldalfájl-források
.mdformátumban vagy azAccept: text/markdownsegítségével szolgálhatók ki. - Gyűjtemények egyéni bejegyzéstípusai: a gyűjtemények saját tiszta URL-eket, automatikus átírási szabályfrissítést, nyers Markdown útvonalakat és oldalról CPT-re történő migrációt kezelhetnek témaszintű köztes megoldások nélkül.
- Content Sync: az
wp bs content pull, azwp bs content pushés azwp bs content statuslehetővé teszi a projekt számára az engedélyezési listán szereplő bejegyzések, kifejezések, kapcsolatok és deklarált metahivatkozások hordozható fájlokba mentését. - Blokkcímke-előtagok: a projektek előtagjai, például az
<theme-card>, sorrendbe rendezett névterekben is feloldhatók blokkonkénti aliasok nélkül. - Megbízhatóbb szinkronizálás: a rendszer a jegyzékfájlok, betöltők, elrendezések, metaadatok és forrásfájlok változásait is észleli.
- Futásidejű és szerkesztői javítások: a dinamikus beállítások naprakészek maradnak, a lekérdezési blokkok osztályai programozott rendereléskor is megmaradnak, az
bsui/selectjobban működik a sűrű űrlapokon, a RichText tulajdonságai eljutnak a szerkesztőbe, és a RichTextet tartalmazó ismétlősorok törlése mentés után is megmarad.
Fájlalapú oldalak
A 7.4 nagy része a fájlalapú oldalakra épül.
Oldalgyűjtemények
A 7.4 előtt a fájlalapú oldalak főként mappaszintű funkciót jelentettek: létre kellett hozni egy page.json elemet, hozzáadni egy index.php vagy index.twig fájlt, az Blockstudio pedig ezt az egy oldalt szinkronizálta az WordPress rendszerbe.
Ez továbbra is működik. A 7.4 egy második módot ad a nagyobb struktúrák kezelésére.
Adjon hozzá egy pages.json jegyzékfájlt egy mappához, és a mappa gyűjteménnyé válik:
pages/
docs/
pages.json
layout.php
index.md
guide/
install/
index.md
reference/
page.json
index.md
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"postTypeArgs": {
"label": "Docs",
"rewrite": {
"slug": "docs"
},
"supports": ["title", "editor", "page-attributes"]
},
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}
A gyűjteményben található minden oldalfájlt felderít, normalizál, szinkronizál és útvonal alapján összekapcsol. Az guide/install helyen lévő oldal az guide gyermekévé válik; ha hiányzik az guide oldal, az Blockstudio létrehoz egy generált tárolóoldalt, így az WordPress hierarchia továbbra is megfelel a fájlrendszer szerkezetének.
A gyűjtemények használhatják a natív page bejegyzéstípust, vagy saját típust is kaphatnak. Ha egy gyűjtemény még nem létező bejegyzéstípust ad meg, az Blockstudio az postTypeArgs alapján regisztrálja. A jegyzék postType értéke a gyűjtemény minden oldalának alapértéke lesz, így a projekteknek nem kell megismételniük azt az defaults fájlban.
A gyűjtemények bejegyzéstípusai a gyűjtemény slugját használják nyilvános URL alapként. Egy docs gyűjtemény gyökéroldala az /docs/ címen található, az path: "getting-started" attribútummal rendelkező oldal az /docs/getting-started/ címen, a beágyazott útvonalak pedig ugyanazon alap alatt érhetők el. Az ismétlődő URL-ek, például az /docs/docs/, átirányítanak a kanonikus címre. Az átírási szabályok automatikusan frissülnek, ha változik a gyűjtemény bejegyzéstípusának útvonalkezelése, ezért új gyűjtemény hozzáadásához nem kell kézzel menteni a közvetlen hivatkozásokat.
Ez teszi természetessé a külső dokumentációk, termékkézikönyvek, tudásbázisok és oldalkönyvtárak használatát az WordPress rendszerben: a forrás fájlokban marad, az eredmény pedig továbbra is valódi, szerkeszthető WordPress tartalom.
Markdown oldaltartalomként
Az Markdown mostantól elsőrangú oldalfájl-forrás.
Az önálló Markdown oldalak frontmattert használnak:
---
name: about
title: About
slug: about
postStatus: publish
---
# About
This Markdown content is synced as native WordPress blocks.
Az page.json az index.md fájllal is párosítható, ha a konfigurációt és a tartalmat külön fájlokban szeretné tárolni. Az index.md frontmatterje felülírhatja a megfelelő page.json mezőket, az ismeretlen frontmatter-kulcsok pedig metaadatként megmaradnak.
Az Markdown HTML formátumra alakul, majd ugyanazon az oldalelemzőn halad át, mint az PHP, Twig és Blade sablonok, így a végső tartalom natív blokkjelölés lesz.
Elrendezések és oldal-segédek
A gyűjtemények tartalmazhatnak egy layout.php fájlt. A frontend oldalon az Blockstudio ezzel az elrendezéssel veszi körül a szinkronizált oldaltartalmat.
<main class="docs-layout">
<aside>
<?php foreach (blockstudio_page_tree('docs') as $item) : ?>
<a href="<?php echo esc_url($item['permalink'] ?? '#'); ?>">
<?php echo esc_html($item['title']); ?>
</a>
<?php endforeach; ?>
</aside>
<article>
<?php echo blockstudio_page_content(); ?>
</article>
</main>
Az új segédek strukturált adatként teszik elérhetővé a gyűjteményt:
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
Ezekkel felépíthető egy teljes dokumentációs keret: navigáció az oldalhierarchiából, oldalmétaadatok a frontmatterből, a szinkronizált WordPress blokktartalom pedig fő tartalomként szolgál.
Betöltők és nyers Markdown
A gyűjtemények tartalmazhatnak egy megbízható helyi loader.php fájlt. Ez közvetlenül adhat vissza oldalakat, vagy további helyi könyvtárakat jelölhet ki, amelyeket az Blockstudio felderíthet.
<?php
return [
'pages' => [
[
'name' => 'docs-api',
'title' => 'API',
'path' => 'api',
'content' => "# API\n\nGenerated markdown content.",
'contentType' => 'markdown',
],
],
];
Ez akkor hasznos, ha a forrást már máshol állítják elő: például egy csomag dokumentációs mappájában, egy Markdown exportból vagy egy olyan buildlépésben, amely oldalak listáját adja vissza.
Az Markdown oldalfájl-források a nyers Markdown forrást is kiszolgálhatják. Kérje le az oldalt .md utótaggal, vagy küldjön Accept: text/markdown értéket. A válaszból eltávolítja a frontmattert, így az eszközök az olvasható dokumentumtörzset kapják meg. Ez a gyűjtemények bejegyzéstípusainál is működik, többek között az olyan URL-ekkel, mint az /docs.md és az /docs/getting-started.md.
Olvassa el az Pages dokumentációját
Content Sync
A 7.4 a Content Sync funkciót is bevezeti: ez egy WP-CLI munkafolyamat azoknak a csapatoknak, amelyek a WordPress projektjük nagyobb részét szeretnék fájlokban tárolni.
wp bs content pull
wp bs content push --dry-run
wp bs content status
Blockstudio már kezeli a blokkokat, mezőket, sablonokat, mintákat és fájlalapú oldalakat a projektben. A Content Sync kiválasztott adatbázis-tartalmakat ad ehhez a fájlközpontú munkafolyamathoz: az engedélyezőlistán szereplő bejegyzések, kifejezések, kapcsolatok és deklarált metaadatok fájlokba húzhatók, áttekinthetők itt: git, majd feltölthetők egy másik környezetbe.
A folyamat szándékosan egyértelmű. Engedélyezze az blockstudio.json alatt, adja meg az engedélyezési listán a kezelni kívánt bejegyzéstípusokat és taxonómiákat, majd deklarálja azokat a metahivatkozásokat, amelyeket a környezetek között át kell írni.
Lekéréskor az Blockstudio hordozható bejegyzéseket, kifejezéseket, kapcsolatokat és engedélyezett metaadatokat ír a témában lévő fájlokba. Feltöltéskor írás előtt ellenőrzi a tervet, majd a deklarált post, term és attachment hivatkozásokat visszafejti a helyi adatbázisazonosítókra. Nem találgatja meg, hogy az önkényes egész számok azonosítók-e.
A 7.4 hatóköre szándékosan visszafogott: bejegyzések, kifejezések, kifejezéskapcsolatok, engedélyezett metaadatok, hordozható UID-k, csatolmányjegyzékek, próbaüzemek, törlések kezelése, zárolt entitások és állapotjelentések tartoznak bele. A taxonómiadefiníciók rögzítése, a médiafájlok bináris másolása és a blokkjelölésekben lévő azonosítók átírása szándékosan kimarad ebből az első verzióból.
Ez tiszta megoldást kínál a csapatoknak arra, hogy verziókezeljék a válogatott tartalmakat, például a csapattagokat, esettanulmányokat, helyszíneket, dokumentációs bejegyzéseket vagy más strukturált rekordokat, anélkül, hogy az egész éles adatbázist migrációvá alakítanák. Olyan tartalomkészletekhez készült, amelyek fájlokként még áttekinthetők: több tucat vagy több száz rekordhoz, egyes projektekben pedig alacsony ezres nagyságrendig, ha a tartalom strukturált és ritkán változik. Nem helyettesíti az adatbázismentéseket, az e-kereskedelmi és rendelési szinkronizálást, az analitikát, a naplókat, az űrlapbeküldéseket vagy más nagy mennyiségű adat kezelését.
Olvassa el a Content Sync dokumentációját
Megbízhatóbb szinkronizálás
Az Blockstudio mostantól észleli az oldalfájl-források, a gyűjteményjegyzékek, a betöltőfájlok, az elrendezésfájlok, a metaadatok és a kapcsolódó útvonalak változásait. Ha ezek bármelyike megváltozik, frissül a szinkronizált WordPress oldal.
Az oldalkezelési folyamat azokat a részleteket is kezeli, amelyek a fájlokkal tárolt dokumentációt valódi projektekben használhatóvá teszik:
- Az Markdown oldalfájl-források natív blokktartalomként szinkronizálódnak, a blokk attribútumaival együtt
- A frontmatter metaadatai elérhetők a frontend segédei és elrendezései számára
- A gyűjteményoldalak szinkronizálások között is megőrzik stabil azonosítójukat
- A beágyazott, nem gyűjteményhez tartozó oldalak a szülőoldalukra hivatkoznak
- A beágyazott, nem gyűjteményhez tartozó oldalak örökölhetik a legközelebbi ősoldal
layout.phpértékét - Az eltávolított gyűjteményforrások törlik a generált WordPress oldalakat
- Ha egy gyűjtemény
pagetípusról egyéni bejegyzéstípusra vált, a meglévő szinkronizált bejegyzéseket migrálja, nem hoz létre másolatokat - Az oldalak sorrendje az
menu_ordersegítségével marad meg
Blokkcímke-előtagok
A blokkcímkék mostantól konfigurálható névtér-előtagokat támogatnak. Egy projekt regisztrálhat egy rövid előtagot, így az Blockstudio egy vagy több névtérben is feloldhatja a blokkot:
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
Ezzel az <theme-card> feloldható erre: theme-components/card; az <theme-button> visszaeshet erre: bsui/button; az <theme-ui-feature-matrix> pedig erre oldható fel: theme-components/ui-feature-matrix.
Ha a projekt egyszeri felülbírálást igényel, a kifejezett tag_aliases továbbra is elsőbbséget élveznek. Az ismeretlen előtagú címkék változatlanok maradnak, és a meglévő blokkcímke-engedélyezési és -tiltási szűrők továbbra is érvényesek az előtag alapján feloldott blokkokra.
Olvassa el a Block Tags dokumentációját
Futásidejű és szerkesztői javítások
A 7.4 a valódi projektek használata során felmerült hibák javításait is tartalmazza.
- A lekérdezéssel feltöltött dinamikus beállítások naprakészek maradnak, ha a bejegyzések, kifejezések, felhasználók vagy kapcsolódó metaadatok változnak, az
populate.fetch: truelekérdezési választók pedig élő beállításokat kérnek le az üres szerkesztői keresésekhez. - A programozott
core/queryéscore/commentsblokkcímkék megőrzik azclassNameértékét a generált burkolójelölésben. - A sablonok pszeudokomponensei megőrzik a camelCase tulajdonságokat, így az olyan tulajdonságok, mint az
allowedFormatsés azwithoutInteractiveFormatting, eljutnak a szerkesztő komponenséhez, és nem vesznek el előtte. - Az
bsui/selectmegbízhatóbban kezeli a beállításadatokat és a túlcsorduló menüket, különösen a sűrűbb szerkesztői vezérlőkben. - Az
blockstudio/phpstanfelismeri aztabstárolókban deklarált mezőket, így a sablon-, Twig/Blade- és blokkcímke-ellenőrzés ugyanazt a mezőszerkezetet ismeri fel, amelyet a projektek az Blockstudio használatával adnak meg. - A RichTextet tartalmazó ismétlősor törlése mentés után is megmarad. Az elavult RichText-értékek többé nem állítják vissza a törölt sort.
Miért fontos ez a kiadás
A 7.4 témája a hordozhatóság.
Az oldalkollekciók egész dokumentációs webhelyeket alakítanak át forrásfájlok mappáivá. Az Markdown-oldalakat egyszerű megírni, és könnyű visszaolvasni a tartalmukat. A Content Sync ugyanezt a fájlközpontú modellt terjeszti ki a gondosan kiválasztott adatbázis-tartalmakra, így a bejegyzések, kifejezések és kapcsolatok az git-ban tárolhatók, és átvihetők a környezetek között. A blokkcímke-előtagok olvashatóvá teszik a nagy blokkgyűjteményeket a sablonokban.
Az Blockstudio továbbra is fájlalapú. A blokkok továbbra is mappákban vannak. Az oldalak továbbra is fájlok. A 7.4 csak azt teszi lehetővé, hogy egy projekt nagyobb része, az oldalstruktúrái és válogatott tartalmai ezekben a fájlokban éljenek és velük együtt legyenek hordozhatók.