
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:

```txt
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
```

```json title="pages/docs/pages.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:

```md title="pages/about/index.md"
---
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 title="pages/docs/layout.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 title="pages/docs/loader.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](https://blockstudio.dev/hu/docs/pages-and-patterns/pages/)

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

```bash
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](https://blockstudio.dev/hu/docs/content-sync/)

### 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](https://blockstudio.dev/hu/docs/blocks/rendering/#prefix-shorthands)

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