Ugrás a tartalomhoz

Dennis · 2026. október 14.

Blockstudio 7.7

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

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.

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
{
  "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:

Shell
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, a parancsokat pedig a térkép karbantartása 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 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:

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

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 és a fordítás beállítása 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.