
Blockstudio 7.7 új virtuális útvonalakat ad a WordPress nélküli dokumentumokhoz, javítja a célzott előrenderelési buildfolyamatokat, és megbízhatóbbá teszi a meglévő blokkok szerkesztését és megjelenítését. Emellett bővíti a(z) PHPStan blokkcímkéinek ellenőrzését, és javítja a mellékelt UI komponensek akadálymentességét.

A fájlközpontú munkafolyamat változatlan marad. A blokkok a sablonjaikból jelennek meg, a fájlalapú oldalak pedig explicit CLI vagy API szinkronizálással módosulnak. Ez a kiadás nem vezet be automatikus oldalszinkronizálást a látogatói vagy adminisztrációs kérések során.

Röviden:

- **Virtuális útvonalak**: jelenítsen meg komponensgalériát, katalógust vagy más teljes dokumentumot bejegyzés létrehozása vagy egyedi átirányításkezelő írása nélkül.
- **Célzott előrenderelési buildek**: a HTTP buildek rögzítik az egyes oldalak által használt forrásfájlokat, így egy későbbi build csak az érintett útvonalakat jelenítheti meg.
- **Gyorsítótár-megőrzés**: őrizze meg a visszavont stíluslapokat a gyorsítótárazott oldalakhoz, és vizsgálja meg vagy ritkítsa a korai kiszolgálási térkép nem használt bejegyzéseit.
- **Megbízhatóbb szerkesztő**: a többes kijelölésű blokkok megőrzik saját értékeiket, a RichText és az oldalsávmezők visszavonása és ismétlése működik, az örökölt kontextus pedig a megfelelő blokknál marad.
- **A fájltartalom hű megőrzése**: a beágyazott listák, szekcióelemek, inline HTML, rövidkódok és escape-elt attribútumok a feldolgozás és megjelenítés során is megmaradnak.
- **PHPStan-fejlesztések**: az előtagcímkéket, aliasokat, leképezett oldalelemeket és sablonváltozókat a projekt saját definíciói alapján ellenőrzi.
- **Akadálymentes UI**: a vezérlők helyesen jelzik az állapotukat, a címkék a megfelelő beviteli mezőt kapcsolják át, a lista- és táblázatkomponensek pedig érvényes HTML-struktúrát használnak.
- **Fordítások**: a telepített JavaScript fordítások betöltődnek a szerkesztőben és az adminisztrációs áttekintőben, beleértve a korábban lefordítatlan mezővezérlőket is.

## Virtuális útvonalak

Egyes oldalak adatokból származnak, nem a szerkesztőben létrehozott bejegyzésekből. Egy komponensreferenciának például szüksége lehet saját URL-re és dokumentumcímre, de nem kell bejegyzésnek lennie a `wp_posts`-ben.

Regisztrálja a dokumentumot a `Blockstudio\Virtual_Routes` segítségével:

```php title="functions.php"
add_action('init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function () {
            get_header();
            echo bs_block([
                'name' => 'mytheme/card',
                'data' => ['heading' => 'Example card'],
            ]);
            get_footer();
        },
        ['title' => 'Component gallery']
    );
});
```

Az útvonal a `/components/`-t szolgálja ki. A callback a Blockstudio kimeneti pufferén belül fut, ezért a megjelenített blokkok megkapják a stílusaikat, szkriptjeiket, a csomagba foglalt UI-eszközöket és a Tailwind kimenetet a szokásos folyamaton keresztül. A WordPress nem alakítja át a találatot adó útvonalat 404-be, és nem irányítja át egy bejegyzésre.

URL-család esetén állítsa a `prefix` értékét erre: `true`, és adjon meg egy `match` callbacket. A callback megkapja az útvonal alatti elérési utat, és visszaadja a megjelenítőnek szükséges értéket. A `null` vagy a `false` visszaadása esetén a kérést a WordPress kezeli tovább. A `urls` segítségével sorolja fel azokat az útvonalakat, amelyeket a statikus előrenderelési buildnek tartalmaznia kell. Egyetlen, nem prefix jellegű útvonal alapértelmezés szerint a saját elérési útját veszi fel.

A `Virtual_Routes::urls()` abszolút URL-eket ad vissza a webhelytérképet összeállító integrációknak. A virtuális dokumentumokat nem adja hozzá automatikusan a WordPress bejegyzéseket tartalmazó webhelytérképéhez.

A teljes API leírásért és a beállítási lehetőségekért lásd: [Virtuális útvonalak](https://blockstudio.dev/hu/docs/pages-and-patterns/pages/#virtual-routes).

## Pontosabb előrenderelési buildek

Az HTTP fölött futtatott gráfmódú buildek ezentúl rögzítik az egyes útvonalak által használt fájlokat: a WordPress sablont, a megjelenített blokksablonokat és eszközöket, a fájlalapú oldalak definícióit és elrendezéseit, valamint a `blockstudio/render/dependencies` segítségével hozzáadott függőségeket.

A következő build során a `build_plan()` összeveti ezeket a függőségeket. Egy blokksablon módosítása újramegjelenítésre jelöli az attól függő útvonalakat anélkül, hogy újraépítené az összes többi, nem kapcsolódó oldalt. A megosztott konfiguráció módosításai továbbra is a teljes buildre hatnak, az új vagy lejárt útvonalak pedig a korábbiak szerint jelennek meg.

Az adatbázisban tárolt változások nem fájlfüggőségek. Ha a telepítésnek fel kell vennie egy beállítás, bejegyzés vagy más adatbázisérték módosítását, kényszerítsen ki buildet, vagy jelenítse meg explicit módon az érintett URL-eket.

A kiadás azt a hibát is javítja, amely miatt a buildazonosítók az első megjelenítés során változtak, valamint a beragadt opcode-gyorsítótárban lévő korai kiszolgálási térképeket, továbbá azt, hogy egyes érvényes URL-eket pusztán azért zártak ki, mert az elérési útjuk tartalmazta a `search` vagy a `preview` elemet. A Markdown kérések `Accept: text/markdown` használatakor megkerülik a gyorsítótárazott HTML elemet, a megfelelő válaszok pedig elküldik a `Vary: Accept` fejlécet.

A statikus előrenderelés mostantól figyelembe veszi az aktív téma által regisztrált szűrőket, amikor eldönti, csatlakoztassa-e a hookjait. Egy téma letilthatja a funkciót anélkül, hogy egy korábbi beállításlekérdezés aktív állapotban hagyná.

Lásd: [Statikus előrenderelés](https://blockstudio.dev/hu/docs/production/static-prerendering/).

## A gyorsítótár megőrzése és karbantartása

Egy gyorsítótárazott HTML oldal tovább élhet annál a futásidejű identitásnál, amellyel a stíluslapját lefordították. A `cache.namespaceGrace` szabályozza, mennyi ideig maradnak elérhetők a visszavont névterek azután, hogy a karbantartás először észlelte a visszavonásukat:

```json title="blockstudio.json"
{
  "cache": {
    "namespaceGrace": 777600
  }
}
```

Ez a példa kilenc napig őrzi meg a visszavont fájlokat. Az alapértelmezés egy nap. Az aktív névterek és az éles előrenderelési artefaktumokat kiszolgáló névterek védettek a visszavonás utáni törléssel szemben.

A korai kiszolgálási térképhez ellenőrző és takarító parancsok is tartoznak:

```bash
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
```

Jelentést készítenek, és eltávolítják a törölt webhelyekhez vagy hiányzó könyvtárakhoz tartozó bejegyzéseket. Többhelyes rendszerben egy webhely törlése annak bejegyzéseit is eltávolítja. A hiányzó útvonal-dokumentumokat külön jelzik, így nem törlik miattuk a teljes, érvényes webhelybejegyzést.

A megőrzési útmutatót a [Gyorsítótárazás](https://blockstudio.dev/hu/docs/production/caching/), a parancsokat pedig a [térkép karbantartása](https://blockstudio.dev/hu/docs/production/static-prerendering/#warming-maintenance-and-observability) részben találja.

## Megbízhatóbb szerkesztő

A többes kijelölésű blokkok szerkesztése mostantól csak az adott blokkot módosítja. Mentéskor minden blokk megőrzi saját tartalmát, kulcsait, metaadatait és zárolásait, így nem másolódnak attribútumok a kijelölt blokkok között.

A RichText értékek közvetlenül a blokk attribútumaiban találhatók, ezért a Gutenberg felveheti őket a visszavonási és ismétlési előzményekbe. Az oldalsáv mezői ugyanennek az előzménynek a részét képezik. A `InnerBlocks templateLock="false"` valódi logikai értékként kerül átadásra, és akkor is feloldja a tartalom zárolását, ha egy külső terület zárolt.

A kezdeti előtöltések megkapják a szerkesztett bejegyzés azonosítóját és típusát, így a sablonok az első megjelenítéskor a megfelelő metaadatokat olvashatják. A különböző szülőkhöz tartozó azonos gyermekblokkok külön örökölt kontextust kapnak az előtöltésekben és a megjelenítési gyorsítótárakban. Az első kérés közben bekövetkező attribútum- vagy kontextusváltozások többé nem hagyják lemaradva az előnézetet.

A Blockstudio emellett megszünteti a rejtett megjelenítésjelölő elemek beszúrását a blokkgyökerek közé. Az olyan szomszédos testvérre vonatkozó szelektorok, mint a `.card + .card`, most ugyanazokat az elemek közötti kapcsolatokat látják a szerkesztőben, mint a frontenden; a szerkesztő és a beszúró előnézeti megjelenítései pedig továbbra is különállók.

## A webhelyszintű beállítások biztonságosabb tárolása

A beállításokhoz kötött mezők továbbra is webhelyszintű értékeket adnak, de egy bejegyzés mentése többé nem írja felül vakon ezeknek a mezőknek az összes mentett másolatát:

- A vázlatok, függőben lévő, privát és ütemezett mentések nem írják a webhely élő beállításait.
- A közzétett mentések az adott szerkesztés során megváltozott, megadott mezőket írják ki.
- Egy régi másolat címének módosítása és mentése nem állít vissza egy újabb webhelyszintű értéket.
- A hiányzó mezők és eltávolított blokkok nem törlik a meglévő beállításokat.
- Egy explicit `null` eltávolít egy beállítást. Az üres karakterláncok, a `false`, a nulla és az üres tömbök érvényes értékek maradnak.

Frissítéskor ezt a viselkedésváltozást kell elsősorban ellenőrizni. Ha egy integráció privát vagy vázlatbejegyzést használt egy éles beállítás frissítésére, írja ki explicit módon azt a beállítást, vagy használjon helyette közzétett konfigurációs bejegyzést. A bejegyzés metaadatainak tárolására nem vonatkozik a csak közzétett bejegyzéseket érintő korlátozás.

A mentés teljes szabályait a [Tárolás](https://blockstudio.dev/hu/docs/blocks/storage/) részben találja.

## A fájltartalom sértetlen marad

A HTML-ről blokkokra alakító folyamat több megőriz a megírt szerkezetből:

- A beágyazott listák a szülő listaelem belső lista-blokkjaivá válnak. A lista és az elemek osztályai megmaradnak; a hagyományos, lapos listák kimenete változatlan marad.
- A `main`, a `header`, a `footer`, a `article` és a `aside` olyan csoportblokkokká válik, amelyek megőrzik a saját elemüket, ahelyett hogy nyers HTML tartalomként kerülnének ki, megkerülve a blokkmegjelenítést.
- A leképezett RichText-bekezdések megőrzik az inline jelölést, a kizárólag képet tartalmazó bekezdések a leképezett képblokkká alakulnak, a rövidkódcímkék pedig megőrzik a tartalmukat.
- Az escape-elt attribútumok dekódolása és escape-elése egyszer történik, beleértve a `InnerBlocks`, a `RichText` és a `useBlockProps` elem attribútumait is.
- A nagyobb mint jelek idézőjelek közötti, önlezáró címkeattribútumokban is elfogadottak.
- A globális HTML attribútumok eljutnak egy Blockstudio blokk gyökeréhez, ha a blokk nem deklarálja őket mezőként. A `wp bs pages sync` jelzi a tárolt, de meg nem jelenített attribútumokat.

A Blade-alapú oldalak, mintázatok és webhelyszerkesztő-sablonok mostantól a `Blockstudio\Blade_Renderer` segítségével jelennek meg, a `illuminate/view` 8-tól 12-ig terjedő verzióinak támogatásával. Az ugyanazt a blokkot megcélzó bővítményfájlok mind regisztrálódnak, prioritásuk, csoportmezőik és célpontlistáik pedig követik a dokumentált sémát.

A beágyazott SCSS függőségeket is követi a rendszer. Ha egy másik részleges sablon által importált részleges sablont szerkeszt, a függő stíluslap verziója megváltozik, és újrafordítás indul.

## PHPStan-fejlesztések

A külön telepíthető `blockstudio/phpstan` csomag kibővíti a blokkcímkék ellenőrzését az előtagos és aliascímkékkel, a leképezett oldalelemekkel, az elrendezésekkel, a csomagban található UI blokkokkal, valamint igény szerint a projekt más PHP forrásaival. A névtérfeloldás a futásidejű működést követi, az elválasztójelet tartalmazó névterek esetén is, és elfogadja a továbbított globális HTML attribútumokat.

A blokk sablonváltozóit, például a `$a`, a `$block` és a `$context` változót, a Blockstudio meghatározottnak tekinti. A mezőtípusok megmaradnak null-koaleszkálás és `isset()` esetén, a PHPStan 2.3 alatt, míg a saját `$a` értéket beállító sablon megőrzi az általa megadott típust.

Ezek a módosítások a `blockstudio/phpstan` 0.1.9 kiadásában érhetők el. Frissítse a csomagot külön a bővítménytől; ehhez PHPStan 2.1.47 vagy újabb verzió szükséges:

```bash
composer require --dev blockstudio/phpstan:^0.1.9
```

A konfigurációval és az elemzési előbeállításokkal kapcsolatban lásd: [PHPStan](https://blockstudio.dev/hu/docs/dev/phpstan/).

## Akadálymentesség és fordítások

A csomagban található UI-kapcsolók a tényleges gombon jelzik a kibontott állapotot. A jelölőnégyzetek, kapcsolók és választógombok címkéi megnevezik és átváltják a vezérlőket. A navigációs útvonal-jelzők, lapozók, navigációs menük és táblázatok többé nem szúrnak be érvénytelen körbefoglaló elemeket a listák vagy táblázatok és gyermekeik közé.

A jelszó láthatóságát váltó gombok jelzik lenyomott állapotukat, és nagyobb kattintási területük van. A beviteli mezők elfogadják a `autocomplete` értéket, a jelszómezők pedig explicit azonosítót és akadálymentes címkét is kaphatnak. A körhinta nézetei billentyűzettel fókuszálhatók, a töltésjelzők és vázlatok animációi pedig figyelembe veszik a csökkentett mozgásra vonatkozó beállítást.

A szerkesztő és az adminisztrációs áttekintő betölti a telepített JavaScript fordításokat a `blockstudio` szövegtartományhoz. Az attribútummenük és helyőrzők, a kódfelugró műveletei, valamint a kép- és fájlcímkék mostantól lefordíthatók. A fordítás nélküli karakterláncok angolul maradnak.

Lásd a [UI könyvtárat](https://blockstudio.dev/hu/ui/) és a [fordítás beállítása](https://blockstudio.dev/hu/docs/general/getting-started/#translations) című részt.

## Dokumentáció és frissítés

A dokumentáció útmutatókat tartalmaz dokumentációs webhelyekhez, a Content Sync funkcióhoz, a Site Editor sablonjaihoz, blokktagekhez, szigetekhez, egyéni mezőtípusokhoz, telepítéshez, előzetes rendereléshez, regiszterbeállításhoz, elemzőeszközökhöz és UI képernyőkhöz. A ACF migrációs útmutató a jelenlegi ACF-regisztrációt és a Block Bindings funkciót tükrözi.

Az egyéni populate példák mostantól a támogatott, egyargumentumú, elnevezett adatkészlet-szűrőt használják. Az eszközökről szóló dokumentáció ismerteti a frontend stíluslapjainak sorrendjét, valamint azt, hogyan tölthetők be a téma felülbírálásai a blokk CSS után. A közreműködők telepítései nyilvános Font Awesome csomagot használnak regisztrációs adatok nélkül.

A PHP 8.2 és a WordPress 6.7 továbbra is a minimális követelmény. A virtuális útvonalak és az új karbantartási parancsok a meglévő oldalkollekciók módosítása nélkül használhatók. Tekintse át a fent ismertetett opciótárolási mentési szabályokat, frissítse a különálló PHPStan csomagot, ha használja, és továbbra is explicit módon futtassa az oldalak szinkronizálását, ahogyan eddig.

### 7.7.1 Utánkövetés

A 7.7.1 javítás egyértelműbbé és biztonságosabbá teszi a szinkronizálás eredményeit. A kulcsok alapján végzett egyesítés, amely nem módosít egy bejegyzést, többé nem hoz létre új verziót, és nem frissíti a módosítás időbélyegét. A meglévő közzétételi állapotok megmaradnak, a fájl által kezelt cím- és slugcserékről jelentés készül, a zárolt vagy eltávolított oldalak pedig szerepelnek a CLI jelentésben. A Content Sync a Page Sync által kezelt törzsszövegeket jelöli meg, a meglévő ellenőrzési példányokat pedig megőrzi. A javítás emellett megóvja a WordPress által kezelt attribútumokat az ütköző mezőazonosítóktól, és megőrzi a más szűrők által hozzáadott szerkesztői osztályokat.
