Treci la conținut

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.json poate defini un set complet de pagini imbricate, valori implicite, comportamentul tipului de articol, aspecte, loader-e și metadatele colecției.
  • Pagini Markdown: index.md poate fi folosit ca și conținut al paginii, fie cu page.json, fie singur, cu frontmatter.
  • Aspecte pentru paginile frontend: layout.php poate încadra conținutul sincronizat al paginii și poate folosi ajutoare precum blockstudio_page_tree() și blockstudio_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 .md sau prin Accept: 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 și wp bs content status permit 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/select funcț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:

Text
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
JSON
{
  "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:

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

PHP
<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:

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

Citiți documentația Pages

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.

Shell
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.php ascendent
  • 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:

PHP
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: true cu interogări preiau opțiuni actualizate pentru căutările goale din editor.
  • Etichetele blocurilor core/query și core/comments generate programatic păstrează className în marcajul wrapper generat.
  • Pseudocomponentele de șablon păstrează proprietățile camelCase, astfel încât proprietăți precum allowedFormats și withoutInteractiveFormatting ajung la componenta editorului, în loc să fie eliminate înainte.
  • bsui/select gestionează mai fiabil datele opțiunilor și meniurile care depășesc spațiul disponibil, în special în controalele dense ale editorului.
  • blockstudio/phpstan recunoaște câmpurile declarate în containere tabs, 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.