Pāriet uz saturu

Dennis · 2026. gada 14. oktobris

Blockstudio 7.7

Blockstudio 7.7 pievieno virtuālus maršrutus dokumentiem bez WordPress ieraksta, uzlabo atlasītas iepriekšējās renderēšanas veidošanas darbības un padara esošo bloku rediģēšanu un renderēšanu uzticamāku. Tā arī paplašina PHPStan bloku tagu pārbaudes un uzlabo pieejamību iekļautajos UI komponentos.

Darba plūsma, kuras pamatā ir faili, paliek nemainīga. Bloki tiek renderēti no savām veidnēm, un failos glabātās lapas maina, veicot skaidri norādītu CLI vai API sinhronizāciju. Šis laidiens neievieš automātisku lapu sinhronizāciju apmeklētāju vai administratora pieprasījumu laikā.

Īsumā:

  • Virtuālie maršruti: nodrošiniet komponentu galeriju, katalogu vai citu pilnvērtīgu dokumentu, neveidojot ierakstu un nerakstot pielāgotu novirzīšanas apstrādātāju.
  • Atlasītas iepriekšējās renderēšanas veidošanas darbības: HTTP veidošanas darbības reģistrē avota failus, ko izmanto katra lapa, lai nākamajā veidošanas reizē varētu renderēt tikai ietekmētos maršrutus.
  • Kešatmiņas saglabāšana: saglabājiet nolietotas stilu lapas pieejamas kešotām lapām un pārbaudiet vai iztīriet neizmantotos ātrās apkalpošanas kartes ierakstus.
  • Uzticamāks redaktors: vairākatlasēti bloki saglabā savas vērtības, RichText un sānu paneļa laukos darbojas atsaukšana un atjaunošana, un mantotais konteksts paliek pie pareizā bloka.
  • Failu satura precizitāte: ligzdoti saraksti, sadaļu veidošanas elementi, iekļauts HTML, īskodi un ekranēti atribūti tiek saglabāti parsēšanas un renderēšanas laikā.
  • PHPStan uzlabojumi: prefiksu tagi, aizstājvārdi, kartēti lapas elementi un veidņu mainīgie tiek pārbaudīti atbilstoši paša projekta definīcijām.
  • Pieejams UI: vadīklas pareizi atklāj savu stāvokli, etiķetes pārslēdz pareizo ievades lauku, un sarakstu un tabulu komponentos tiek izmantota derīga HTML struktūra.
  • Tulkojumi: redaktorā un administrēšanas pārskatā tiek ielādēti instalētie JavaScript tulkojumi, tostarp iepriekš netulkotajām lauku vadīklām.

Virtuālie maršruti

Dažas lapas tiek iegūtas no datiem, nevis redaktoram piesaistīta ieraksta. Piemēram, komponenta atsaucei var būt vajadzīgs savs URL un dokumenta virsraksts, bet ne ieraksts wp_posts.

Reģistrējiet šo dokumentu, izmantojot Blockstudio\Virtual_Routes:

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']
    );
});

Maršruts nodrošina /components/. Tā atzvanīšanas funkcija darbojas Blockstudio izvades buferī, tāpēc renderētie bloki saņem savus stilus, skriptus, iekļautos UI resursus un Tailwind izvadi, izmantojot parasto apstrādes plūsmu. WordPress nepārvērš atbilstošo maršrutu par 404 un nenovirza to uz ierakstu.

URL saimei iestatiet prefix uz true un norādiet match atzvanīšanas funkciju. Tā saņem ceļu zem maršruta un atgriež renderētājam vajadzīgo vērtību. Ja tiek atgriezts null vai false, pieprasījums tiek nodots WordPress. Izmantojiet urls, lai uzskaitītu ceļus, kas jāiekļauj statiskās iepriekšējās renderēšanas veidošanas darbībā. Viena maršruta ceļš, kas nav prefikss, tiek iekļauts pēc noklusējuma.

Virtual_Routes::urls() atgriež absolūtos URL integrācijām, kas veido vietnes karti. Tas automātiski nepievieno virtuālos dokumentus WordPress ierakstu vietnes kartei.

Pilnu API un pieejamās opcijas skatiet sadaļā Virtuālie maršruti.

Precīzākas iepriekšējās renderēšanas veidošanas darbības

Grafu režīma veidošanas darbības, kas tika renderētas virs HTTP, tagad reģistrē failus, ko izmanto katrs maršruts: WordPress veidni, renderēto bloku veidnes un resursus, failu lapu definīcijas un izkārtojumus, kā arī atkarības, kas pievienotas ar blockstudio/render/dependencies.

Nākamajā veidošanas reizē build_plan() salīdzina šīs atkarības. Mainot bloka veidni, tiek atzīmēti renderēšanai maršruti, kas no tās atkarīgi, un nav jāpārveido visas nesaistītās lapas. Izmaiņas koplietotajā konfigurācijā joprojām ietekmē visu veidošanas darbību, un jauni vai beigušies maršruti tiek renderēti kā iepriekš.

Izmaiņas, kas veiktas tikai datubāzē, nav atkarības no failiem. Ja izvietošanas laikā jāiekļauj opcija, ieraksts vai cita datubāzes vērtība, jāveic piespiedu veidošana vai skaidri jārenderē ietekmētie URL.

Laidienā arī novērstas veidošanas identitātes izmaiņas pirmās renderēšanas laikā, novecojušas opkoda kešatmiņā saglabātas ātrās apkalpošanas kartes un kļūdaina derīgu URL izslēgšana tikai tāpēc, ka to ceļā ir search vai preview. Markdown pieprasījumi, kuros izmantots Accept: text/markdown, apiet kešoto HTML, un attiecīgajās atbildēs tiek nosūtīts Vary: Accept.

Tagad statiskā iepriekšējā renderēšana ņem vērā aktīvās tēmas reģistrētos filtrus, lemjot, vai pievienot tās āķus. Tēma var atspējot šo funkciju, un agrāka iestatījumu pārbaude to vairs neieslēgs.

Skatiet sadaļu Statiskā iepriekšējā renderēšana.

Kešatmiņas saglabāšana un uzturēšana

Kešota HTML lapa var pastāvēt ilgāk par izpildlaika identitāti, kurā tika kompilēta tās stilu lapa. cache.namespaceGrace nosaka, cik ilgi nolietotas nosaukumvietas paliek pieejamas pēc tam, kad tīrīšanas laikā pirmoreiz konstatēts, ka tās vairs netiek lietotas:

JSON
{
  "cache": {
    "namespaceGrace": 777600
  }
}

Šajā piemērā nolietotie faili tiek saglabāti deviņas dienas. Pēc noklusējuma tie tiek glabāti vienu dienu. Aktīvās nosaukumvietas un nosaukumvietas, kas apkalpo izvietotus iepriekšējas renderēšanas artefaktus, ir pasargātas no tīrīšanas.

Ātrās apkalpošanas kartei ir arī pārbaudes un tīrīšanas komandas:

Apvalks
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune

Tās uzrāda un noņem izdzēstām vietnēm vai trūkstošām mapēm atbilstošus ierakstus. Dzēšot vairāku vietņu instalācijas vietni, tiek noņemti arī tās ieraksti. Trūkstošie maršrutu dokumenti tiek uzrādīti atsevišķi, un to dēļ netiek noņemts viss derīgas vietnes ieraksts.

Norādījumus par saglabāšanas termiņiem skatiet sadaļā Kešatmiņa, bet komandas — sadaļā kartes uzturēšana.

Uzticamāks redaktors

Rediģējot vairākatlasītu bloku, tagad tiek atjaunināts tikai šis bloks. Saglabājot tiek paturēts katra bloka saturs, atslēgas, metadati un bloķējumi, nevis kopēti atribūti starp atlasītajiem blokiem.

RichText vērtības atrodas tieši bloku atribūtos, tāpēc Gutenberg var tās iekļaut atsaukšanas un atjaunošanas darbībās. Arī sānu paneļa lauki tiek iekļauti tajā pašā vēsturē. InnerBlocks templateLock="false" tiek nodots kā īsta Būla vērtība un ļauj rediģēt saturu arī tad, ja ārējā apgabala rediģēšana ir bloķēta.

Sākotnējās iepriekšielādes saņem rediģētā ieraksta ID un tipu, tāpēc veidnes jau pirmajā renderēšanas reizē var nolasīt pareizos metadatus. Identiski pakārtotie bloki ar dažādiem vecākblokiem iepriekšielādēs un renderēšanas kešatmiņās saglabā atsevišķu mantoto kontekstu. Atribūtu vai konteksta izmaiņu dēļ sākotnējā pieprasījuma laikā priekšskatījums vairs neatpaliek.

Blockstudio arī pārtrauc slēptu renderēšanas marķieru elementu ievietošanu starp bloku saknēm. Blakus esošo elementu selektori, piemēram, .card + .card, tagad redaktorā redz tādas pašas elementu attiecības kā priekšgalā, savukārt redaktora un bloku ievietotāja priekšskatījuma renderējumi paliek atsevišķi.

Drošāka visas vietnes opciju glabāšana

Laukos, kuru pamatā ir opcijas, joprojām var glabāt visas vietnes vērtības, taču, saglabājot ierakstu, vairs netiek akli pārrakstīta katra šo lauku saglabātā kopija:

  • Melnraksta, gaidoša, privāta un ieplānota ieraksta saglabāšana neraksta aktīvās vietnes opcijas.
  • Publicējot tiek saglabāti norādītie lauki, kas šajā rediģēšanas reizē ir mainīti.
  • Saglabājot tikai virsrakstu vecai kopijai, jaunāka visas vietnes vērtība netiek atcelta.
  • Trūkstošu lauku un noņemtu bloku dēļ esošās opcijas netiek dzēstas.
  • Skaidri norādīts null noņem opciju. Tukšas virknes, false, nulle un tukši masīvi joprojām ir derīgas vērtības.

Šī ir galvenā uzvedības izmaiņa, kas jāpārbauda pēc jaunināšanas. Ja integrācija izmantoja privātu ierakstu vai melnrakstu, lai atjauninātu aktīvu opciju, ierakstiet šo opciju tieši vai tā vietā izmantojiet publicētu konfigurācijas ierakstu. Ieraksta metadatu glabāšanu publicēšanas ierobežojums neietekmē.

Pilnus saglabāšanas noteikumus skatiet sadaļā Glabāšana.

Failu saturs paliek neskarts

HTML pārveides plūsma par blokiem saglabā vairāk no jūsu rakstītā satura struktūras:

  • Ligzdoti saraksti kļūst par pakārtotiem sarakstu blokiem sava vecākā elementa iekšienē. Sarakstu un vienumu klases tiek saglabātas; parastiem plakaniem sarakstiem iepriekšējā izvade paliek nemainīga.
  • main, header, footer, article un aside kļūst par grupu blokiem, kas saglabā attiecīgo elementu, nevis neapstrādātu HTML, kas apiet bloku renderēšanu.
  • Kartētas bagātināta teksta rindkopas saglabā iekļauto marķējumu, rindkopas, kurās ir tikai attēli, tiek pārveidotas par kartēto attēlu bloku, un īskodu tagi saglabā savu saturu.
  • Ekranētie atribūti tiek dekodēti un ekranēti vienu reizi, tostarp atribūti InnerBlocks, RichText un elementam useBlockProps.
  • Pie lielākas zīmes atribūtiem pašnoslēdzošā tagā pēdiņās vairs netraucē.
  • Globālie HTML atribūti nonāk bloka Blockstudio saknē, ja bloks tos nav deklarējis kā laukus. wp bs pages sync uzrāda saglabātos atribūtus, kas netiek renderēti.

Lapās, paraugos un vietnes redaktora veidnēs, kuru pamatā ir Blade, tagad renderēšanai tiek izmantots Blockstudio\Blade_Renderer, un tiek atbalstītas versijas no 8 līdz 12: illuminate/view. Tiek reģistrēti visi paplašinājumu faili, kas paredzēti vienam blokam, un to prioritāte, grupu lauki un mērķu saraksti atbilst dokumentētajai shēmai.

Tiek uzskaitītas arī ligzdotas atkarības no SCSS. Rediģējot daļveidni, ko importē cita daļveidne, mainās atkarīgās stilu lapas versija un tiek sākta atkārtota kompilēšana.

PHPStan uzlabojumi

Atsevišķi instalētā pakotne blockstudio/phpstan paplašina bloku tagu validāciju, iekļaujot prefiksu un aizstājvārdu tagus, kartētus lapas elementus, izkārtojumus, iekļautos UI blokus un, pēc izvēles, arī citus projekta PHP avotus. Nosaukumvietu atrisināšana atbilst izpildlaikam, tostarp nosaukumvietām ar defisēm, un tiek pieņemti pārsūtītie globālie HTML atribūti.

Bloku veidņu mainīgie, piemēram, $a, $block un $context, tiek uzskatīti par definētiem ar Blockstudio. Lauku tipi tiek saglabāti, izmantojot nulles apvienošanas operatoru un isset() vidē PHPStan 2.3, savukārt veidne, kas piešķir vērtību savam $a, saglabā piešķirto tipu.

Šīs izmaiņas pieejamas laidienā blockstudio/phpstan 0.1.9. Atjauniniet pakotni atsevišķi no spraudņa; tai nepieciešama PHPStan 2.1.47 vai jaunāka versija:

Apvalks
composer require --dev blockstudio/phpstan:^0.1.9

Konfigurācijas un analīzes iepriekšiestatījumus skatiet sadaļā PHPStan.

Pieejamība un tulkojumi

Iekļautie UI trigeri atklāj savu izvērsto stāvokli pašā pogā. Atzīmes izvēles rūtiņām, pārslēgiem un radio pogām nosauc un pārslēdz attiecīgās vadīklas. Ceļrāži, lappušu numerācija, navigācijas izvēlnes un tabulas vairs neievieto nederīgus ieskaujošos elementus starp sarakstiem vai tabulām un to bērnelementiem.

Paroles pārslēgi atklāj nospiesto stāvokli, un tiem ir lielāks klikšķa apgabals. Ievades lauki pieņem autocomplete, un paroles ievades laukiem var norādīt ID un pieejamu etiķeti. Karuseļa skata logiem var piešķirt tastatūras fokusu, un ielādes indikatora un skeleta animācijas ievēro samazinātas kustības preferences.

Redaktorā un administrēšanas pārskatā tiek ielādēti instalētie JavaScript tulkojumi teksta domēnam blockstudio. Atribūtu izvēlnes un vietturi, koda uznirstošā loga darbības, kā arī attēlu un failu emblēmas tagad var tulkot. Virknes, kurām nav tulkojuma, paliek angļu valodā.

Skatiet UI bibliotēku un tulkošanas iestatīšanu.

Dokumentācija un jaunināšana

Dokumentācijā pievienotas pamācības par dokumentācijas vietnēm, Content Sync, Site Editor veidnēm, bloku tagiem, salām, pielāgotiem lauku tipiem, izvietošanu, iepriekšēju renderēšanu, reģistra iestatīšanu, analīzes rīkiem un UI lietotnes ekrāniem. ACF migrācijas ceļvedis atspoguļo aktuālo ACF reģistrēšanu un Block Bindings.

Pielāgotas populēšanas piemēros tagad izmantots atbalstītais vienargumenta filtrs ar nosauktu datu kopu. Aktīvu dokumentācijā paskaidrota priekšgala stilu lapu ielādes secība un tas, kā ielādēt motīva izmaiņas pēc bloka CSS. Līdzstrādnieku instalācijās tiek izmantota publiskā Font Awesome pakotne bez reģistra piekļuves datiem.

PHP 8.2 un WordPress 6.7 joprojām ir minimālās prasības. Virtuālie maršruti un jaunās uzturēšanas komandas ir pieejamas, nemainot esošās lapu kolekcijas. Pārskatiet iepriekš aprakstītos opciju glabāšanas saglabāšanas noteikumus, atjauniniet atsevišķo PHPStan pakotni, ja to lietojat, un turpiniet veikt lapu sinhronizāciju tieši tāpat kā iepriekš.

7.7.1 Turpinājums

7.7.1 ielāps padara sinhronizācijas rezultātus skaidrākus un drošākus. Apvienošana pēc atslēgas, kas nemaina ierakstu, vairs neveido jaunu versiju un neatjaunina tā modificēšanas laika zīmogu. Esošie publicēšanas statusi tiek saglabāti, par faila pārvaldīto nosaukumu un pastāvīgās saites aizstāšanu tiek ziņots, bet bloķētās vai dzēstās lapas tiek norādītas CLI pārskatā. Content Sync atzīmē Page Sync pārvaldītos pamattekstus un saglabā esošās pārskatīšanas kopijas. Ielāps arī aizsargā WordPress pārvaldītos atribūtus no konfliktējošiem lauku ID un saglabā redaktora klases, ko pievienojuši citi filtri.