Ugrás a tartalomhoz

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.json teljes, 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.md oldaltartalomként használható, akár page.json mellett, akár önmagában, frontmatterrel.
  • Frontendoldal-elrendezések: az layout.php körbeveheti a szinkronizált oldaltartalmat, és olyan segédeket használhat, mint az blockstudio_page_tree() és az blockstudio_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 .md formátumban vagy az Accept: text/markdown segí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, az wp bs content push és az wp bs content status lehető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/select jobban 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:

Text
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
JSON
{
  "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:

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

PHP
<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:

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

Shell
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 page tí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_order segí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:

PHP
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: true lekérdezési választók pedig élő beállításokat kérnek le az üres szerkesztői keresésekhez.
  • A programozott core/query és core/comments blokkcímkék megőrzik az className é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 az withoutInteractiveFormatting, eljutnak a szerkesztő komponenséhez, és nem vesznek el előtte.
  • Az bsui/select megbí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/phpstan felismeri az tabs tá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.