Treci la conținut

Dennis · 14 octombrie 2026

Blockstudio 7.7

Blockstudio 7.7 adaugă rute virtuale pentru documente fără o postare WordPress, îmbunătățește compilările de prerandare direcționate și face editarea și redarea blocurilor existente mai fiabile. De asemenea, extinde verificările etichetelor de bloc din PHPStan și îmbunătățește accesibilitatea componentelor UI incluse.

Fluxul de lucru bazat pe fișiere rămâne același. Blocurile sunt redate din șabloanele lor, iar paginile bazate pe fișiere se modifică printr-o sincronizare explicită CLI sau API. Această versiune nu introduce sincronizarea automată a paginilor la solicitările vizitatorilor sau ale administratorilor.

Pe scurt:

  • Rute virtuale: difuzați o galerie de componente, un catalog sau un alt document complet fără a crea o postare ori a scrie un handler de redirecționare personalizat.
  • Compilări de prerandare direcționate: compilările HTTP înregistrează fișierele sursă folosite de fiecare pagină, astfel încât o compilare ulterioară să poată reda doar rutele afectate.
  • Păstrarea cache-ului: păstrați foile de stil retrase disponibile pentru paginile din cache și inspectați sau curățați intrările nefolosite din harta de difuzare timpurie.
  • Fiabilitatea editorului: blocurile selectate împreună își păstrează propriile valori, anularea și refacerea funcționează pentru RichText și câmpurile din bara laterală, iar contextul moștenit rămâne asociat blocului corect.
  • Fidelitatea conținutului din fișiere: listele imbricate, elementele de secționare, codul inline HTML, shortcode-urile și atributele escapate supraviețuiesc parsării și redării.
  • Îmbunătățiri PHPStan: etichetele cu prefix, aliasurile, elementele de pagină mapate și variabilele de șablon sunt verificate în raport cu definițiile proprii ale proiectului.
  • UI accesibile: controalele își expun corect starea, etichetele comută intrarea corespunzătoare, iar componentele de listă și tabel folosesc o structură HTML validă.
  • Traduceri: traducerile JavaScript instalate se încarcă în editor și în vizualizarea generală de administrare, inclusiv pentru controalele de câmp care anterior nu erau traduse.

Rute virtuale

Unele pagini provin din date, nu dintr-o postare gestionată de editor. De exemplu, o referință la o componentă poate avea nevoie de propriul URL și titlu de document, dar nu de o înregistrare în wp_posts.

Înregistrați documentul respectiv cu 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']
    );
});

Ruta difuzează /components/. Callback-ul său rulează în bufferul de ieșire al Blockstudio, astfel încât blocurile redate primesc stilurile, scripturile, resursele UI incluse și ieșirea Tailwind prin fluxul obișnuit. WordPress nu transformă ruta potrivită într-un 404 și nici nu o redirecționează către o postare.

Pentru o familie de URL-uri, setați prefix la true și furnizați un callback match. Callback-ul primește calea de sub rută și returnează valoarea necesară redării. Returnarea valorii null sau false lasă solicitarea în seama WordPress. Folosiți urls pentru a lista căile pe care trebuie să le includă o compilare de prerandare statică. O rută unică, fără prefix, își include implicit propria cale.

Virtual_Routes::urls() returnează URL-uri absolute pentru integrările care construiesc o hartă a site-ului. Nu adaugă automat documentele virtuale la harta postărilor din WordPress.

Consultați Rute virtuale pentru API și opțiunile complete.

Compilări de prerandare mai precise

Compilările în modul grafic realizate peste HTTP înregistrează acum fișierele folosite de fiecare rută: șablonul WordPress, șabloanele și resursele blocurilor redate, definițiile și machetele paginilor bazate pe fișiere, precum și dependențele adăugate prin blockstudio/render/dependencies.

La următoarea compilare, build_plan() compară aceste dependențe. Modificarea unui șablon de bloc marchează rutele dependente pentru redare, fără a recompila fiecare pagină neafectată. Modificările configurației comune continuă să afecteze întreaga compilare, iar rutele noi sau expirate sunt redate ca înainte.

Modificările care există doar în baza de date nu sunt dependențe de fișiere. O implementare care trebuie să preia o opțiune, o postare sau altă valoare din baza de date trebuie să forțeze o compilare sau să redea explicit URL-urile afectate.

Versiunea corectează și schimbarea identităților compilării în timpul primei redări, hărțile de difuzare timpurie învechite păstrate în cache-ul opcode-urilor și excluderea unor URL-uri valide doar pentru că calea lor conține search sau preview. Solicitările Markdown care folosesc Accept: text/markdown ocolesc HTML din cache, iar răspunsurile relevante trimit Vary: Accept.

Prerandarea statică ține acum cont de filtrele înregistrate de tema activă când decide dacă își atașează hook-urile. O temă poate dezactiva funcționalitatea fără ca o căutare anterioară a setărilor să o lase activă.

Consultați Prerandarea statică.

Păstrarea și întreținerea cache-ului

O pagină HTML din cache poate rămâne disponibilă și după expirarea identității runtime-ului care i-a compilat foaia de stil. cache.namespaceGrace controlează cât timp rămân disponibile spațiile de nume retrase după ce curățarea le detectează retragerea:

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

Acest exemplu păstrează fișierele retrase timp de nouă zile. Valoarea implicită este o zi. Spațiile de nume active în prezent și cele care servesc artefacte de prerandare implementate sunt protejate de curățarea fișierelor retrase.

Harta de difuzare timpurie are și comenzi de inspectare și curățare:

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

Acestea raportează și elimină intrările pentru site-urile șterse sau directoarele lipsă. Ștergerea unui site dintr-o rețea multisite elimină și intrările sale. Documentele de rută lipsă sunt raportate separat, fără a determina eliminarea unei intrări valide pentru întregul site.

Consultați Cache pentru recomandări privind păstrarea și întreținerea hărții pentru comenzi.

Un editor mai fiabil

Editarea unui bloc selectat împreună cu altele actualizează acum doar acel bloc. La salvare, fiecare bloc își păstrează propriul conținut, propriile chei, metadate și blocări, în loc să copieze atribute între blocurile selectate.

Valorile RichText se află direct în atributele blocului, astfel încât Gutenberg le poate include în anulare și refacere. Câmpurile din bara laterală participă la același istoric. InnerBlocks templateLock="false" este transmis ca valoare booleană reală și deblochează conținutul chiar și când o zonă exterioară este blocată.

Încărcările preliminare inițiale primesc ID-ul și tipul postării editate, astfel încât șabloanele să poată citi metadatele corecte de la prima redare. Blocurile copil identice aflate sub părinți diferiți păstrează contexte moștenite distincte în încărcările preliminare și în cache-urile de redare. Modificările atributelor sau ale contextului din timpul unei solicitări inițiale nu mai lasă previzualizarea în urmă.

Blockstudio nu mai inserează nici elemente ascunse de marcare a redării între rădăcinile blocurilor. Selectorii de frați adiacenți, precum .card + .card, văd acum aceleași relații dintre elemente în editor și pe interfața publică, iar redările de previzualizare din editor și din inserator rămân separate.

Stocare mai sigură a opțiunilor la nivelul întregului site

Câmpurile bazate pe opțiuni continuă să ofere valori pentru întregul site, dar salvarea unei postări nu mai scrie orbește fiecare copie salvată a acestor câmpuri:

  • Salvările în starea de ciornă, în așteptare, private și programate nu scriu opțiunile active ale site-ului.
  • Salvările postărilor publicate scriu câmpurile furnizate care s-au modificat în acea editare.
  • Salvarea doar a titlului unei copii vechi nu anulează o valoare mai nouă, valabilă pentru întregul site.
  • Câmpurile lipsă și blocurile eliminate nu șterg opțiunile existente.
  • Un null explicit elimină o opțiune. Șirurile goale, false, zero și tablourile goale rămân valori valide.

Aceasta este principala schimbare de comportament de verificat la actualizare. Dacă o integrare folosea o postare privată sau în starea de ciornă pentru a actualiza o opțiune activă, scrieți opțiunea explicit sau folosiți în schimb o postare de configurare publicată. Stocarea în metadatele postării nu este afectată de restricția care permite doar publicarea.

Consultați Stocarea pentru toate regulile de salvare.

Conținutul din fișiere rămâne intact

Fluxul de la HTML la blocuri păstrează mai mult din structura scrisă de dumneavoastră:

  • Listele imbricate devin blocuri de listă interioare ale elementului părinte. Clasele listei și ale elementelor sunt păstrate; listele plate obișnuite își păstrează ieșirea anterioară.
  • main, header, footer, article și aside devin blocuri de grup care păstrează elementul, în locul unui HTML brut care ocolește redarea blocurilor.
  • Paragrafele rich text mapate păstrează marcajele inline, paragrafele care conțin doar imagini sunt convertite în blocul de imagine mapat, iar etichetele shortcode își păstrează conținutul.
  • Atributele escapate sunt decodate și escapate o singură dată, inclusiv cele de pe InnerBlocks, RichText și elementul useBlockProps.
  • Semnele mai mare decât din atributele citate ale etichetelor cu închidere automată sunt acceptate.
  • Atributele globale HTML ajung la rădăcina unui bloc Blockstudio dacă blocul nu le declară drept câmpuri. wp bs pages sync raportează atributele stocate care nu sunt redate.

Paginile, tiparele și șabloanele din Site Editor bazate pe Blade sunt redate acum prin Blockstudio\Blade_Renderer, cu suport pentru versiunile illuminate/view 8 până la 12. Toate fișierele de extensie care vizează același bloc sunt înregistrate, iar prioritatea, câmpurile de grup și listele de ținte respectă schema documentată.

Sunt urmărite și dependențele SCSS imbricate. Editarea unei părți importate de o altă parte modifică versiunea foii de stil dependente și declanșează recompilarea.

Îmbunătățiri pentru PHPStan

Pachetul blockstudio/phpstan instalat separat extinde validarea etichetelor de bloc la etichetele cu prefix și alias, elementele de pagină mapate, machete, blocuri UI incluse și, opțional, alte surse PHP ale proiectului. Rezolvarea spațiilor de nume corespunde comportamentului runtime-ului, inclusiv pentru spațiile de nume care conțin cratime, iar atributele globale HTML transmise mai departe sunt acceptate.

Variabilele șabloanelor de bloc, precum $a, $block și $context, sunt considerate definite de Blockstudio. Tipurile câmpurilor sunt păstrate la coalescența valorilor null și la isset() în PHPStan 2.3, în timp ce un șablon care își atribuie propriul $a păstrează tipul atribuit.

Aceste modificări sunt incluse în blockstudio/phpstan 0.1.9. Actualizați pachetul separat de modul; necesită PHPStan 2.1.47 sau o versiune mai nouă:

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

Consultați PHPStan pentru configurare și presetările de analiză.

Accesibilitate și traduceri

Declanșatoarele UI incluse își expun starea extinsă pe butonul propriu-zis. Etichetele pentru casete de selectare, comutatoare și butoane radio denumesc comenzile și le activează. Firimiturile de navigare, paginarea, meniurile de navigare și tabelele nu mai inserează elemente de încadrare nevalide între liste sau tabele și elementele lor copil.

Butoanele pentru afișarea parolei își expun starea apăsată și au o zonă de clic mai mare. Câmpurile de introducere acceptă autocomplete, iar câmpurile pentru parolă acceptă un ID explicit și o etichetă accesibilă. Ferestrele de vizualizare ale caruselelor pot primi focalizarea de la tastatură, iar animațiile indicatorilor de încărcare și ale scheletelor respectă preferințele privind mișcarea redusă.

Editorul și prezentarea generală din administrare încarcă traducerile instalate JavaScript pentru domeniul de text blockstudio. Meniurile și substituenții atributelor, acțiunile ferestrei pop-up pentru cod, precum și insignele imaginilor și fișierelor pot fi acum traduse. Șirurile fără traducere rămân în engleză.

Consultați biblioteca UI și configurarea traducerilor.

Documentație și actualizare

Documentația adaugă ghiduri pentru site-uri de documentație, Content Sync, șabloane Site Editor, etichete de bloc, insule, tipuri de câmp personalizate, implementare, prerandare, configurarea registrului, instrumente de analiză și ecrane de aplicație UI. Ghidul de migrare ACF reflectă înregistrarea actuală ACF și Block Bindings.

Exemplele de populate personalizat folosesc acum filtrul acceptat cu un singur argument și set de date numit. Documentația despre resurse explică ordinea foilor de stil din frontend și cum să încărcați suprascrierile temei după blocul CSS. Instalările pentru contributori folosesc pachetul public Font Awesome fără acreditări de registru.

PHP 8.2 și WordPress 6.7 rămân cerințele minime. Rutele virtuale și noile comenzi de mentenanță sunt disponibile fără a modifica colecțiile de pagini existente. Consultați regulile de salvare a stocării opțiunilor de mai sus, actualizați pachetul separat PHPStan dacă îl folosiți și continuați să rulați explicit sincronizarea paginilor ca înainte.

7.7.1 Urmărire

Patch-ul 7.7.1 face rezultatele sincronizării mai clare și mai sigure. O îmbinare bazată pe chei care lasă o postare neschimbată nu mai creează o revizie și nu mai actualizează marcajul temporal al modificării. Stările de publicare existente sunt păstrate, înlocuirile titlului și slugului gestionate de fișier sunt raportate, iar paginile blocate sau eliminate sunt menționate în raportul CLI. Content Sync marchează corpurile gestionate de Page Sync și păstrează copiile existente pentru revizuire. Patch-ul protejează și atributele gestionate de WordPress împotriva ID-urilor de câmp conflictuale și păstrează clasele editorului adăugate de alte filtre.