Dennis · 21 iunie 2026
Blockstudio 7.4
Blockstudio Versiunea 7.4 urmărește să facă proiectele susținute de fișiere mai portabile. Versiunea 7.2 a făcut proiectele mai mari mai ușor de inspectat și distribuit, iar 7.3 a adăugat un nivel UI peste acestea. Versiunea 7.4 se concentrează pe mutarea unei părți mai mari din proiect, din paginile și conținutul său selectat, din baza de date în fișiere gestionate prin controlul versiunilor.
Funcționalitatea principală este cea de colecții de pagini: o modalitate de a indica lui Blockstudio un dosar cu surse de pagini și de a genera din acesta o structură completă de pagini WordPress imbricate. Sursa poate fi PHP, Twig, Blade, HTML, Markdown sau un loader de încredere care returnează pagini dintr-o altă sursă locală.
Pe scurt:
- Colecții de pagini:
pages.jsonpoate defini un set complet de pagini imbricate, valori implicite, comportamentul tipului de articol, aspecte, loader-e și metadatele colecției. - Pagini Markdown:
index.mdpoate fi folosit ca și conținut al paginii, fie cupage.json, fie singur, cu frontmatter. - Aspecte pentru paginile frontend:
layout.phppoate încadra conținutul sincronizat al paginii și poate folosi ajutoare precumblockstudio_page_tree()șiblockstudio_page_content(). - Surse externe de documentație: loader-ele colecțiilor pot genera pagini din fișiere locale sau din Markdown/HTML returnate.
- Ieșire brută Markdown: sursele de pagini Markdown pot fi servite ca
.mdsau prinAccept: text/markdown. - Tipuri de articole personalizate pentru colecții: colecțiile pot avea URL-uri curate, reîmprospătarea automată a regulilor de rescriere, rute brute Markdown și migrări de pagini la CPT fără adaptări la nivel de temă.
- Content Sync:
wp bs content pull,wp bs content pushșiwp bs content statuspermit mutarea articolelor, termenilor, relațiilor și referințelor meta declarate, incluse în lista permisă a proiectului, în fișiere portabile. - Prefixe pentru etichetele blocurilor: prefixele de proiect precum
<theme-card>pot fi rezolvate în spații de nume ordonate, fără aliasuri pentru fiecare bloc. - Sincronizare mai fiabilă: modificările paginilor sunt detectate în manifeste, loader-e, aspecte, metadate și fișierele sursă.
- Remedieri pentru runtime și editor: opțiunile dinamice rămân actualizate, clasele blocurilor de interogare se păstrează la randarea programatică,
bsui/selectfuncționează mai bine în formulare dense, proprietățile RichText ajung la editor, iar ștergerea rândurilor din câmpurile repetabile cu RichText este salvată acum corect.
Pagini bazate pe fișiere
Cea mai mare parte a versiunii 7.4 se bazează pe pagini bazate pe fișiere.
Colecții de pagini
Înainte de versiunea 7.4, paginile bazate pe fișiere erau în mare parte o funcționalitate la nivel de dosar: creați un page.json, adăugați un index.php sau index.twig, iar Blockstudio sincronizează pagina respectivă în WordPress.
Acest lucru funcționează în continuare. Versiunea 7.4 adaugă un al doilea mod pentru structuri mai mari.
Adăugați un manifest pages.json într-un dosar, iar acel dosar devine o colecție:
pages/
docs/
pages.json
layout.php
index.md
guide/
install/
index.md
reference/
page.json
index.md
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"postTypeArgs": {
"label": "Docs",
"rewrite": {
"slug": "docs"
},
"supports": ["title", "editor", "page-attributes"]
},
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}
Fiecare sursă de pagină din colecție este descoperită, normalizată, sincronizată și asociată după cale. O pagină la guide/install devine copilul lui guide; dacă pagina guide lipsește, Blockstudio creează o pagină container generată, astfel încât ierarhia WordPress să corespundă în continuare structurii sistemului de fișiere.
Colecțiile pot folosi tipul nativ de articol page sau propriul lor tip de articol. Când o colecție declară un tip de articol care încă nu există, Blockstudio îl înregistrează din postTypeArgs. Manifestul postType devine și valoarea implicită pentru fiecare pagină din colecția respectivă, astfel încât proiectele nu trebuie să îl repete în defaults.
Tipurile de articole ale colecțiilor folosesc slugul colecției drept bază publică URL. O colecție docs își găsește pagina-rădăcină la /docs/, o pagină cu path: "getting-started" la /docs/getting-started/, iar paginile imbricate au căi sub aceeași bază. URL-urile dublate, precum /docs/docs/, redirecționează către locația canonică. Regulile de rescriere sunt reîmprospătate automat când se schimbă rutarea tipului de articol al colecției, astfel încât o colecție nouă nu necesită salvarea manuală a legăturilor permanente.
Aceasta este piesa care face ca documentația externă, manualele de produs, bazele de cunoștințe și bibliotecile de pagini să se integreze firesc în WordPress: sursa rămâne în fișiere, dar rezultatul este tot conținut real, editabil, WordPress.
Markdown ca și conținut al paginii
Markdown este acum o sursă de pagini de primă clasă.
Paginile Markdown independente folosesc frontmatter:
---
name: about
title: About
slug: about
postStatus: publish
---
# About
This Markdown content is synced as native WordPress blocks.
Puteți combina și page.json cu index.md atunci când doriți să separați configurația de conținut în fișiere diferite. Frontmatter-ul din index.md poate înlocui câmpurile page.json corespunzătoare, iar cheile necunoscute din frontmatter sunt păstrate ca metadate.
Markdown este convertit în HTML și apoi trecut prin același analizator de pagini ca șabloanele PHP, Twig și Blade, astfel încât conținutul final este marcaj de blocuri nativ.
Aspecte și ajutoare pentru pagini
Colecțiile pot include un fișier layout.php. În frontend, Blockstudio încadrează conținutul sincronizat al paginii în acel aspect.
<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>
Noile ajutoare expun colecția sub formă de date structurate:
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();
Astfel, aveți componentele necesare pentru a construi o structură completă de documentație: navigarea din arborele de pagini, metadatele paginii din frontmatter și conținutul de blocuri WordPress sincronizat, ca zonă principală de afișare.
Loader-e și Markdown brut
Colecțiile pot include un fișier local loader.php de încredere. Acesta poate returna pagini direct sau îi poate indica lui Blockstudio directoare locale suplimentare de explorat.
<?php
return [
'pages' => [
[
'name' => 'docs-api',
'title' => 'API',
'path' => 'api',
'content' => "# API\n\nGenerated markdown content.",
'contentType' => 'markdown',
],
],
];
Acest lucru este util când sursa este deja generată în altă parte: într-un dosar de documentație al unui pachet, într-un export Markdown sau într-un pas de compilare care returnează o listă de pagini.
Sursele de pagini Markdown pot servi și sursa lor brută Markdown. Solicitați pagina cu sufixul .md sau trimiteți Accept: text/markdown. Frontmatter-ul este eliminat din răspuns, astfel încât instrumentele primesc corpul lizibil al documentului. Această funcționalitate este disponibilă și pentru tipurile de articole ale colecțiilor, inclusiv pentru URL-uri precum /docs.md și /docs/getting-started.md.
Content Sync
Versiunea 7.4 introduce și Content Sync, un flux de lucru WP-CLI pentru echipele care vor ca o parte mai mare din proiectul lor WordPress să fie reprezentată în fișiere.
wp bs content pull
wp bs content push --dry-run
wp bs content status
Blockstudio păstrează deja în proiect blocuri, câmpuri, șabloane, modele și pagini bazate pe fișiere. Content Sync adaugă conținut selectat din baza de date acestui flux de lucru bazat pe fișiere: articole, termeni, relații și metadate declarate, incluse în lista permisă, pot fi extrase în fișiere, revizuite în git și trimise către un alt mediu.
Funcționalitatea este concepută să fie explicită. O activați în blockstudio.json, includeți în lista permisă tipurile de articole și taxonomiile pe care doriți să le gestionați și declarați referințele meta care trebuie rescrise între medii.
La extragere, Blockstudio scrie în fișiere din tema dumneavoastră articole, termeni, relații și metadate incluse în lista permisă, într-un format portabil. La trimitere, validează planul înainte de a scrie și rezolvă referințele post, term și attachment declarate înapoi la ID-urile bazei de date locale. Nu presupune că numerele întregi arbitrare sunt ID-uri.
Domeniul versiunii 7.4 este intenționat restrâns: articole, termeni, relații între termeni, metadate incluse în lista permisă, UID-uri portabile, manifeste de atașamente, rulări de probă, gestionarea eliminărilor și raportarea stării. Capturarea definițiilor taxonomiilor, copierea fișierelor media și rescrierea ID-urilor din marcajul blocurilor sunt lăsate intenționat în afara acestei prime versiuni.
Astfel, echipele au o modalitate simplă de a gestiona în controlul versiunilor conținut selectat, precum membrii echipei, studiile de caz, locațiile, intrările din documentație sau alte înregistrări structurate, fără a transforma întreaga bază de date de producție într-o migrare. Este destinat seturilor de conținut care pot fi în continuare revizuite ca fișiere: zeci sau sute de rânduri și, în unele proiecte, câteva mii, dacă acel conținut este structurat și se schimbă rar. Nu înlocuiește copiile de siguranță ale bazei de date, sincronizarea comerțului electronic/comenzilor, analizele, jurnalele, trimiterile de formulare sau alte date în volume mari.
Citiți documentația Content Sync
Sincronizare mai fiabilă
Blockstudio detectează acum modificările din sursele de pagini, manifeste ale colecțiilor, fișierele loader-elor și ale aspectelor, metadate și căi asociate. Dacă oricare dintre acestea se schimbă, pagina WordPress sincronizată este actualizată.
Fluxul de procesare a paginilor gestionează și detaliile care fac documentația bazată pe fișiere practică în proiectele reale:
- Sursele de pagini Markdown se sincronizează ca și conținut nativ de blocuri, inclusiv atributele blocurilor
- metadatele frontmatter sunt disponibile ajutoarelor și aspectelor din frontend
- paginile colecțiilor își păstrează identitatea între sincronizări
- paginile imbricate care nu fac parte din colecții sunt asociate paginii lor părinte
- paginile imbricate care nu fac parte din colecții pot moșteni cel mai apropiat
layout.phpascendent - sursele eliminate din colecții șterg paginile generate WordPress aferente
- schimbarea unei colecții din
pageîntr-un tip de articol personalizat migrează articolele sincronizate existente, în loc să creeze duplicate - ordinea paginilor este păstrată prin
menu_order
Prefixe pentru etichetele blocurilor
Etichetele blocurilor acceptă acum prefixe configurabile pentru spațiile de nume. Un proiect poate înregistra un prefix scurt, iar Blockstudio poate găsi blocul într-unul sau mai multe spații de nume:
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
$prefixes['theme'] = ['theme-components', 'bsui'];
return $prefixes;
});
Astfel, <theme-card> poate fi rezolvat la theme-components/card, <theme-button> poate reveni la bsui/button, iar <theme-ui-feature-matrix> poate fi rezolvat la theme-components/ui-feature-matrix.
Suprascrierile explicite tag_aliases rămân prioritare atunci când un proiect are nevoie de o excepție punctuală. Etichetele cu prefixe necunoscute sunt lăsate neschimbate, iar filtrele existente de permitere și blocare a etichetelor de blocuri se aplică în continuare blocurilor rezolvate prin prefix.
Citiți documentația Block Tags
Remedieri pentru runtime și editor
Versiunea 7.4 include și o serie de remedieri care au rezultat din utilizarea în proiecte reale.
- Opțiunile populate dinamic prin interogări rămân actualizate când se modifică articole, termeni, utilizatori sau metadate asociate, iar câmpurile select
populate.fetch: truecu interogări preiau opțiuni actualizate pentru căutările goale din editor. - Etichetele blocurilor
core/queryșicore/commentsgenerate programatic păstreazăclassNameîn marcajul wrapper generat. - Pseudocomponentele de șablon păstrează proprietățile camelCase, astfel încât proprietăți precum
allowedFormatsșiwithoutInteractiveFormattingajung la componenta editorului, în loc să fie eliminate înainte. bsui/selectgestionează mai fiabil datele opțiunilor și meniurile care depășesc spațiul disponibil, în special în controalele dense ale editorului.blockstudio/phpstanrecunoaște câmpurile declarate în containeretabs, astfel încât șabloanele, validarea etichetelor de blocuri Twig/Blade și cea din proiecte înțeleg aceeași structură de câmpuri folosită de Blockstudio.- Ștergerea unui rând dintr-un câmp repetabil cu RichText este păstrată după salvare. Valorile RichText învechite nu mai pot readuce rândul șters.
De ce contează această versiune
Tema versiunii 7.4 este portabilitatea.
Colecțiile de pagini transformă site-uri întregi de documentație în dosare cu fișiere sursă. Paginile Markdown fac conținutul ușor de scris și de citit ulterior. Content Sync extinde același model bazat pe fișiere și la conținutul selectat din baza de date, astfel încât articolele, termenii și relațiile să poată fi păstrate în git și transferate între medii. Prefixele etichetelor blocurilor mențin lizibile șabloanele care folosesc biblioteci mari de blocuri.
Blockstudio rămâne bazat pe fișiere. Blocurile sunt tot dosare. Paginile sunt tot fișiere. Versiunea 7.4 permite ca și mai multe elemente ale proiectului, structurile paginilor și conținutul selectat să fie păstrate în aceste fișiere și transferate împreună cu ele.