Pāriet uz saturu

Dennis · 2026. gada 21. jūnijs

Blockstudio 7.4

Blockstudio 7.4 mērķis ir padarīt failos glabātus projektus pārnesamākus. 7.2 atviegloja lielāku projektu pārskatīšanu un izplatīšanu, bet 7.3 papildināja tos ar UI slāni. 7.4 ļauj lielāku daļu projekta, tā lapu un atlasītā satura pārvietot no datubāzes uz versiju kontrolētiem failiem.

Galvenā jaunā funkcija ir lapu kolekcijas: veids, kā norādīt Blockstudio uz lapu avotu mapi un no tās ģenerēt pilnu ligzdotu WordPress lapu struktūru. Avots var būt PHP, Twig, Blade, HTML, Markdown vai uzticams ielādētājs, kas atgriež lapas no cita lokāla avota.

Īsumā:

  • Lapu kolekcijas: pages.json var definēt pilnu ligzdotu lapu kopu, noklusējuma vērtības, ierakstu tipu darbību, izkārtojumus, ielādētājus un kolekcijas metadatus.
  • Markdown lapas: index.md var izmantot kā lapas saturu — gan kopā ar page.json, gan atsevišķi ar priekšlapas metadatiem.
  • Priekšgala lapu izkārtojumi: layout.php var aptvert sinhronizēto lapas saturu un izmantot palīgfunkcijas, piemēram, blockstudio_page_tree() un blockstudio_page_content().
  • Ārējie dokumentācijas avoti: kolekciju ielādētāji var ģenerēt lapas no lokāliem failiem vai atgrieztajiem Markdown/HTML.
  • Neapstrādāta Markdown izvade: Markdown lapu avotus var nodrošināt kā .md vai ar Accept: text/markdown.
  • Kolekciju pielāgotie ierakstu tipi: kolekcijām var būt tīri URL, automātiska pārrakstīšanas noteikumu atjaunošana, neapstrādāti Markdown maršruti un lapu migrēšana uz pielāgotu ierakstu tipu bez tēmas puses starpslāņiem.
  • Content Sync: wp bs content pull, wp bs content push un wp bs content status ļauj projektu atļauto sarakstu ierakstus, terminus, attiecības un deklarētās metadatu atsauces glabāt pārnesamos failos.
  • Bloku tagu prefiksi: projektu prefiksi, piemēram, <theme-card>, var tikt atrisināti vairākās secīgās nosaukumvietās bez katra bloka aizstājvārda.
  • Uzticamāka sinhronizācija: lapu izmaiņas tiek noteiktas manifestos, ielādētājos, izkārtojumos, metadatos un avota failos.
  • Izpildlaika un redaktora labojumi: dinamiskās opcijas paliek aktuālas, vaicājumu bloku klases saglabājas programmatiskās renderēšanas laikā, bsui/select labāk darbojas blīvās veidlapās, RichText rekvizīti nonāk redaktorā, un atkārtotāja rindu dzēšana ar RichText saglabājas pēc saglabāšanas.

Failos balstītas lapas

Lielākā daļa 7.4 funkciju papildina failos balstītas lapas.

Lapu kolekcijas

Pirms 7.4 failos balstītas lapas galvenokārt darbojās mapju līmenī: izveidojiet page.json, pievienojiet index.php vai index.twig, un Blockstudio sinhronizē šo vienu lapu ar WordPress.

Tas joprojām darbojas. 7.4 pievieno otru režīmu lielākām struktūrām.

Pievienojiet mapei pages.json manifestu, un šī mape kļūs par kolekciju:

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"
  }
}

Katrs lapas avots kolekcijā tiek atrasts, normalizēts, sinhronizēts un sasaistīts pēc ceļa. Lapa vietā guide/install kļūst par guide bērnu; ja trūkst guide lapas, Blockstudio izveido ģenerētu konteinera lapu, lai WordPress hierarhija joprojām atbilstu failu sistēmas struktūrai.

Kolekcijas var izmantot iebūvēto page ierakstu tipu vai savu ierakstu tipu. Ja kolekcijā ir norādīts ierakstu tips, kas vēl nepastāv, Blockstudio to reģistrē no postTypeArgs. Arī manifesta postType kļūst par noklusējuma vērtību katrai kolekcijas lapai, tāpēc projektiem tas nav jāatkārto defaults.

Kolekciju ierakstu tipi kā publisko URL pamatu izmanto kolekcijas slug. docs kolekcija atrisina saknes lapu vietā /docs/, lapu ar path: "getting-started" — vietā /docs/getting-started/, bet ligzdotos ceļus — zem tā paša pamata. Dubultie URL, piemēram, /docs/docs/, novirza uz kanonisko atrašanās vietu. Pārrakstīšanas noteikumi tiek automātiski atjaunoti, kad mainās kolekcijas ierakstu tipa maršrutēšana, tāpēc jaunai kolekcijai nav manuāli jāsaglabā pastāvīgo saišu iestatījumi.

Tieši šī funkcija ļauj ārējai dokumentācijai, produktu rokasgrāmatām, zināšanu bāzēm un lapu bibliotēkām dabiski iekļauties WordPress: avots paliek failos, bet rezultāts joprojām ir īsts, rediģējams WordPress saturs.

Markdown kā lapas saturs

Markdown tagad ir pilnvērtīgs lapas avots.

Atsevišķas Markdown lapas izmanto priekšlapas metadatus:

Markdown
---
name: about
title: About
slug: about
postStatus: publish
---

# About

This Markdown content is synced as native WordPress blocks.

Varat arī apvienot page.json ar index.md, ja vēlaties konfigurāciju un saturu sadalīt vairākos failos. Priekšlapas metadati failā index.md var aizstāt atbilstošos page.json laukus, un nezināmās priekšlapas metadatu atslēgas tiek saglabātas kā metadati.

Markdown tiek pārveidots par HTML un pēc tam nodots tam pašam lapu parsētājam, ko izmanto PHP, Twig un Blade veidnes, tāpēc gala saturs ir vietējais bloku marķējums.

Izkārtojumi un lapu palīgfunkcijas

Kolekcijās var iekļaut failu layout.php. Priekšgalā Blockstudio ar šo izkārtojumu aptver sinhronizēto lapas saturu.

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>

Jaunās palīgfunkcijas atklāj kolekciju kā strukturētus datus:

PHP
blockstudio_pages('docs');
blockstudio_page_tree('docs');
blockstudio_page_children('docs-guide', 'docs');
blockstudio_page_collection('docs');
blockstudio_page_content();
blockstudio_current_page();

Tas nodrošina vajadzīgos elementus pilna dokumentācijas karkasa izveidei: navigāciju no lapu koka, lapas metadatus no priekšlapas metadatiem un sinhronizēto WordPress bloku saturu kā galveno izvades apgabalu.

Ielādētāji un neapstrādāts Markdown

Kolekcijās var iekļaut uzticamu lokālu loader.php failu. Tas var tieši atgriezt lapas vai norādīt Blockstudio uz papildu lokālajiem direktorijiem, kuros meklēt.

PHP
<?php

return [
  'pages' => [
    [
      'name' => 'docs-api',
      'title' => 'API',
      'path' => 'api',
      'content' => "# API\n\nGenerated markdown content.",
      'contentType' => 'markdown',
    ],
  ],
];

Tas noder, ja avots jau tiek ģenerēts citur, piemēram, pakotnes dokumentācijas mapē, Markdown eksportā vai būvēšanas solī, kas atgriež lapu sarakstu.

Markdown lapu avoti var arī nodrošināt neapstrādātu Markdown avotu. Pieprasiet lapu ar sufiksu .md vai nosūtiet Accept: text/markdown. Atbilde nesatur priekšlapas metadatus, tāpēc rīki saņem lasāmu dokumenta pamatdaļu. Tas darbojas arī kolekciju ierakstu tipiem, tostarp URL, piemēram, /docs.md un /docs/getting-started.md.

Lasiet Pages dokumentāciju

Content Sync

7.4 ievieš arī Content Sync — WP-CLI darbplūsmu komandām, kuras vēlas vairāk sava WordPress projekta pārvaldīt kā failus.

Apvalks
wp bs content pull
wp bs content push --dry-run
wp bs content status

Blockstudio jau glabā jūsu projektā blokus, laukus, veidnes, rakstus un failos balstītas lapas. Content Sync papildina šo failu prioritātes darbplūsmu ar atlasītu datubāzes saturu: atļauto sarakstu ierakstus, terminus, attiecības un deklarētos metadatus var ielasīt failos, pārskatīt git un nosūtīt uz citu vidi.

Šī funkcija ir apzināti skaidri konfigurējama. Iespējojiet to blockstudio.json, atļauto sarakstā norādiet pārvaldāmos ierakstu tipus un taksonomijas, kā arī deklarējiet metadatu atsauces, kuras jāpārraksta, pārvietojot saturu starp vidēm.

Ielādes laikā Blockstudio ieraksta pārnesamos ierakstus, terminus, attiecības un atļauto sarakstu metadatus jūsu tēmas failos. Nosūtīšanas laikā tas pirms rakstīšanas validē plānu un atrisina deklarētās post, term un attachment atsauces uz lokālās datubāzes ID. Tas neuzskata patvaļīgus veselus skaitļus par ID.

7.4 tvērums ir apzināti ierobežots: ieraksti, termini, terminu attiecības, atļauto sarakstu metadati, pārnesamie UID, pielikumu manifesti, izmēģinājumi, dzēšamo vienību apstrāde, bloķētas vienības un statusa pārskati. Taksonomiju definīciju apkopošana, multivides failu kopēšana un bloku marķējumā ietvertu ID pārrakstīšana šajā pirmajā versijā nav iekļauta.

Tas komandām sniedz vienkāršu veidu, kā versēt atlasītu saturu, piemēram, komandas dalībniekus, gadījumu izpētes, atrašanās vietas, dokumentācijas ierakstus vai citus strukturētus datus, nepārvēršot visu ražošanas datubāzi migrācijā. Šī funkcija paredzēta satura kopām, kuras joprojām var pārskatīt kā failus: desmitiem vai simtiem rindu un dažos projektos arī daži tūkstoši, ja saturs ir strukturēts un mainās reti. Tā neaizstāj datubāzes dublējumkopijas, e-komercijas vai pasūtījumu sinhronizāciju, analītiku, žurnālus, veidlapu iesniegumus vai citus liela apjoma datus.

Lasiet Content Sync dokumentāciju

Uzticamāka sinhronizācija

Blockstudio tagad nosaka izmaiņas lapu avotos, kolekciju manifestos, ielādētāju failos, izkārtojumu failos, metadatos un saistītajos ceļos. Ja mainās kāds no tiem, tiek atjaunināta sinhronizētā WordPress lapa.

Lapu apstrādes plūsma tagad ietver arī detaļas, kas failos balstītu dokumentāciju padara praktiski izmantojamu reālos projektos:

  • Markdown lapu avoti tiek sinhronizēti kā vietējais bloku saturs, tostarp bloku atribūti
  • Priekšlapas metadati ir pieejami priekšgala palīgfunkcijām un izkārtojumiem
  • Kolekciju lapas sinhronizācijas laikā saglabā nemainīgu identitāti
  • Ligzdotās lapas ārpus kolekcijām ir saistītas ar savu vecāka lapu
  • Ligzdotās lapas ārpus kolekcijām var mantot tuvākā senča layout.php
  • Noņemtie kolekciju avoti iztīra to ģenerētās WordPress lapas
  • Mainot kolekciju no page uz pielāgotu ierakstu tipu, esošie sinhronizētie ieraksti tiek migrēti, nevis dublēti
  • Lapu secība tiek saglabāta ar menu_order

Bloku tagu prefiksi

Bloku tagi tagad atbalsta konfigurējamus nosaukumvietu prefiksus. Projektā var reģistrēt vienu īsu prefiksu un ļaut Blockstudio atrast bloku vienā vai vairākās nosaukumvietās:

PHP
add_filter('blockstudio/block_tags/prefixes', function ($prefixes) {
  $prefixes['theme'] = ['theme-components', 'bsui'];

  return $prefixes;
});

Pēc konfigurēšanas <theme-card> var atrisināt uz theme-components/card, <theme-button> var izmantot rezerves variantu bsui/button, bet <theme-ui-feature-matrix> var atrisināt uz theme-components/ui-feature-matrix.

Ja projektam vajadzīgs vienreizējs aizstājums, priekšroka joprojām ir tieši norādītiem tag_aliases. Nezināmi prefiksu tagi paliek nemainīti, un esošie bloku tagu atļaušanas un liegšanas filtri joprojām attiecas uz blokiem, kas atrasti pēc prefiksa.

Lasiet Block Tags dokumentāciju

Izpildlaika un redaktora labojumi

7.4 ietver arī vairākus labojumus, kuru pamatā ir reālu projektu lietošanas pieredze.

  • Dinamiskās opcijas, ko aizpilda vaicājumi, paliek aktuālas, mainoties ierakstiem, terminiem, lietotājiem vai saistītajiem metadatiem, un populate.fetch: true vaicājumu atlases laukos tukšiem redaktora meklējumiem tiek ielādētas aktuālās opcijas.
  • Programmatiski izvadītiem core/query un core/comments bloku tagiem ģenerētajā apvalka marķējumā tiek saglabāts className.
  • Veidņu pseidokomponenti saglabā camelCase rekvizītu nosaukumus, tāpēc rekvizīti, piemēram, allowedFormats un withoutInteractiveFormatting, sasniedz redaktora komponentu, nevis tiek atmesti pirms tam.
  • bsui/select uzticamāk apstrādā opciju datus un pārpildītas izvēlnes, it īpaši blīvākos redaktora vadības elementos.
  • blockstudio/phpstan atpazīst laukus, kas deklarēti tabs konteineros, tāpēc veidņu, Twig/Blade un bloku tagu validācija izprot to pašu lauku struktūru, ko projektos izmanto Blockstudio.
  • Atkārtotāja rindas dzēšana ar RichText saglabājas pēc saglabāšanas. Novecojušas RichText vērtības vairs nevar atjaunot dzēsto rindu.

Kāpēc šis laidiens ir svarīgs

7.4 galvenā tēma ir pārnesamība.

Lapu kolekcijas pārvērš veselas dokumentācijas vietnes mapēs ar avota failiem. Markdown lapas atvieglo šī satura rakstīšanu un atkārtotu nolasīšanu. Content Sync paplašina to pašu failu prioritātes modeli, attiecinot to uz atlasītu datubāzes saturu, lai ieraksti, termini un attiecības varētu atrasties git un tikt pārvietoti starp vidēm. Bloku tagu prefiksi padara lielas bloku bibliotēkas veidnēs pārskatāmākas.

Blockstudio joprojām balstās uz failiem. Bloki joprojām ir mapes. Lapas joprojām ir faili. 7.4 vienkārši ļauj lielāku projekta daļu — lapu struktūras un atlasīto saturu — glabāt šajos failos un pārvietot kopā ar tiem.