Pereiti prie turinio

Dennis · 2026 m. birželio 21 d.

Blockstudio 7.4

Blockstudio 7.4 leidimas skirtas tam, kad failais pagrįstus projektus būtų lengviau perkelti. 7.2 versijoje tapo lengviau tikrinti ir platinti didesnius projektus, o 7.3 versija ant jų pagrindo pridėjo UI sluoksnį. 7.4 versijoje daugiausia dėmesio skiriama tam, kad daugiau projekto, jo puslapių ir atrinkto turinio būtų galima perkelti iš duomenų bazės į versijų valdymo failus.

Pagrindinė naujovė – puslapių rinkiniai: būdas nurodyti Blockstudio aplanką su puslapių šaltiniais ir pagal jį sukurti visą įdėtinę WordPress puslapių struktūrą. Šaltinis gali būti PHP, Twig, Blade, HTML, Markdown arba patikimas įkėliklis, grąžinantis puslapius iš kito vietinio šaltinio.

Trumpai:

  • Puslapių rinkiniai: pages.json gali apibrėžti visą įdėtinių puslapių rinkinį, numatytąsias reikšmes, įrašų tipų veikimą, maketus, įkėliklius ir rinkinio metaduomenis.
  • Markdown puslapiai: index.md naudojamas kaip puslapio turinys – atskirai arba kartu su page.json.
  • Svetainės sąsajos puslapių maketai: layout.php gali apgaubti sinchronizuotą puslapio turinį ir naudoti pagalbines priemones, pvz., blockstudio_page_tree() ir blockstudio_page_content().
  • Išoriniai dokumentacijos šaltiniai: rinkinių įkėlikliai gali kurti puslapius iš vietinių failų arba grąžinti Markdown/HTML.
  • Neapdorota Markdown išvestis: Markdown puslapių šaltinius galima pateikti kaip .md arba per Accept: text/markdown.
  • Pasirinktiniai rinkinio įrašų tipai: rinkiniai gali turėti švarius URL, automatiškai atnaujinti perrašymo taisykles, neapdorotus Markdown maršrutus ir perkelti puslapius į pasirinktinius įrašų tipus be temoje esančių tarpinių sprendimų.
  • Turinio sinchronizavimas: wp bs content pull, wp bs content push ir wp bs content status leidžia į projektą perkelti į leidžiamų sąrašą įtrauktus įrašus, terminus, ryšius ir deklaruotas metaduomenų nuorodas kaip perkeliamus failus.
  • Blokų žymų prefiksai: projektiniai prefiksai, tokie kaip <theme-card>, gali būti atpažįstami sutvarkytose vardų srityse be kiekvieno bloko pseudonimų.
  • Patikimesnis sinchronizavimas: puslapių pakeitimai aptinkami manifestuose, įkėlikliuose, maketuose, metaduomenyse ir šaltinio failuose.
  • Vykdymo aplinkos ir redaktoriaus pataisos: dinaminės parinktys išlieka atnaujintos, užklausų blokų klasės išsaugomos programuojant atvaizdavimą, bsui/select geriau veikia tankiose formose, RichText ypatybės pasiekia redaktorių, o kartotuvo eilučių su RichText ištrynimai išlieka išsaugojus.

Failais pagrįsti puslapiai

Didžioji 7.4 versijos dalis paremta failais pagrįstais puslapiais.

Puslapių rinkiniai

Iki 7.4 versijos failais pagrįsti puslapiai daugiausia veikė aplanko lygmeniu: sukurkite page.json, pridėkite index.php arba index.twig, o Blockstudio sinchronizuos tą vieną puslapį į WordPress.

Tai vis dar veikia. 7.4 versijoje didesnėms struktūroms pridėtas antrasis režimas.

Pridėkite aplanke manifestą pages.json ir tas aplankas taps rinkiniu:

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

Aptinkamas, normalizuojamas, sinchronizuojamas ir pagal kelią susiejamas kiekvienas puslapio šaltinis rinkinyje. Puslapis adresu guide/install tampa guide antriniu puslapiu; jei trūksta puslapio guide, Blockstudio sukuria sugeneruotą konteinerio puslapį, kad WordPress hierarchija vis tiek atitiktų failų sistemos struktūrą.

Rinkiniai gali naudoti savąjį page įrašų tipą arba turėti atskirą. Kai rinkinyje deklaruojamas dar neegzistuojantis įrašų tipas, Blockstudio jį užregistruoja iš postTypeArgs. Manifesto postType taip pat tampa numatytąja reikšme kiekvienam rinkinio puslapiui, todėl projektuose jos nereikia kartoti faile defaults.

Rinkinių įrašų tipų viešųjų URL pagrindu naudojamas rinkinio trumpasis pavadinimas. docs rinkinys pagrindinį puslapį pateikia adresu /docs/, puslapį su path: "getting-started" – adresu /docs/getting-started/, o įdėtinius kelius – tuo pačiu pagrindu. Dvigubi URL, pavyzdžiui, /docs/docs/, nukreipiami į kanoninę vietą. Perrašymo taisyklės atnaujinamos automatiškai, kai pasikeičia rinkinio įrašų tipų maršrutizavimas, todėl naujam rinkiniui nereikia rankiniu būdu išsaugoti nuolatinių nuorodų nustatymų.

Dėl šios funkcijos išorinė dokumentacija, produktų vadovai, žinių bazės ir puslapių bibliotekos natūraliai pritaikomos WordPress: šaltinis lieka failuose, o rezultatas tebėra tikras redaguojamas WordPress turinys.

Markdown kaip puslapio turinys

Markdown dabar yra visavertis puslapio šaltinis.

Atskiri Markdown puslapiai naudoja frontmatter:

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

# About

This Markdown content is synced as native WordPress blocks.

Taip pat galite derinti page.json su index.md, kai norite konfigūraciją ir turinį laikyti atskiruose failuose. index.md esantis frontmatter gali pakeisti atitinkamus page.json laukus, o nežinomi frontmatter raktai išsaugomi kaip metaduomenys.

Markdown konvertuojamas į HTML, tada perduodamas tam pačiam puslapių analizatoriui kaip ir PHP, Twig bei Blade šablonai, todėl galutinis turinys yra savasis blokų žymėjimas.

Maketai ir puslapių pagalbinės priemonės

Rinkiniuose gali būti failas layout.php. Svetainės sąsajoje Blockstudio tuo maketu apgaubia sinchronizuotą puslapio turinį.

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>

Naujos pagalbinės priemonės pateikia rinkinį kaip struktūruotus duomenis:

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

Taip gausite viską, ko reikia pilnam dokumentacijos karkasui sukurti: naršymą pagal puslapių medį, puslapių metaduomenis iš frontmatter ir sinchronizuotą WordPress blokų turinį kaip pagrindinį turinio lauką.

Įkėlikliai ir neapdorotas Markdown

Rinkiniuose gali būti patikimas vietinis loader.php failas. Jis gali tiesiogiai grąžinti puslapius arba nurodyti Blockstudio papildomus vietinius aplankus, kuriuose reikia atlikti paiešką.

PHP
<?php

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

Tai naudinga, kai šaltinis jau sugeneruotas kitur: paketų dokumentacijos aplanke, Markdown eksporte arba kūrimo etape, kuris grąžina puslapių sąrašą.

Markdown puslapių šaltiniai taip pat gali pateikti neapdorotą Markdown šaltinį. Pateikite puslapio užklausą su priesaga .md arba siųskite Accept: text/markdown. Frontmatter pašalinamas iš atsakymo, todėl įrankiai gauna įskaitomą dokumento turinį. Tai veikia ir su rinkinių įrašų tipais, įskaitant URL, pvz., /docs.md ir /docs/getting-started.md.

Peržiūrėkite puslapių dokumentaciją

Turinio sinchronizavimas

7.4 versijoje taip pat pristatomas turinio sinchronizavimas – WP-CLI darbo eiga komandoms, norinčioms daugiau savo WordPress projekto turėti failų pavidalu.

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

Blockstudio projekte jau saugo blokus, laukus, šablonus, šablonų rinkinius ir failais pagrįstus puslapius. Turinio sinchronizavimas šią failais pagrįstą darbo eigą papildo pasirinktu duomenų bazės turiniu: į leidžiamų sąrašą įtraukti įrašai, terminai, ryšiai ir deklaruoti metaduomenys gali būti perkelti į failus, peržiūrėti naudojant git ir įkelti į kitą aplinką.

Ši funkcija sąmoningai veikia aiškiai apibrėžtai. Įjunkite ją faile blockstudio.json, įtraukite į leidžiamų sąrašą norimus tvarkyti įrašų tipus ir taksonomijas, o metaduomenų nuorodas, kurias reikia perrašyti skirtingose aplinkose, deklaruokite atskirai.

Atsisiunčiant Blockstudio įrašo perkeliamus įrašus, terminus, ryšius ir į leidžiamų sąrašą įtrauktus metaduomenis į temos failus. Įkeliant ji pirmiausia patikrina planą, o tada susieja deklaruotas post, term ir attachment nuorodas su vietinės duomenų bazės ID. Ji nemano, kad bet kokie sveikieji skaičiai yra ID.

7.4 versijos apimtis sąmoningai ribota: įrašai, terminai, terminų ryšiai, į leidžiamų sąrašą įtraukti metaduomenys, perkeliami UID, priedų manifestai, bandomieji paleidimai, šalinimo tvarkymas, užrakinti objektai ir būsenos ataskaitos. Taksonomijų apibrėžimų fiksavimas, medijos dvejetainių failų kopijavimas ir ID perrašymas blokų žymėjime į šią pirmąją versiją sąmoningai neįtraukti.

Taip komandos gali tvarkingai versijuoti atrinktą turinį, pavyzdžiui, komandos narius, atvejų analizes, vietas, dokumentacijos įrašus ar kitus struktūruotus duomenis, nepaversdamos visos gamybinės duomenų bazės perkėlimu. Ši funkcija skirta turinio rinkiniams, kuriuos vis dar galima peržiūrėti kaip failus: dešimtims ar šimtams eilučių, o kai kuriuose projektuose – ir keliems tūkstančiams, jei turinys struktūruotas ir retai kinta. Ji nepakeičia duomenų bazės atsarginių kopijų, el. prekybos ar užsakymų sinchronizavimo, analitikos, žurnalų, formų pateiktų duomenų ir kitų didelės apimties duomenų tvarkymo.

Peržiūrėkite turinio sinchronizavimo dokumentaciją

Patikimesnis sinchronizavimas

Blockstudio dabar aptinka puslapių šaltinių, rinkinių manifestų, įkėliklių failų, maketų failų, metaduomenų ir susijusių kelių pakeitimus. Pasikeitus bet kuriam iš jų, atnaujinamas sinchronizuotas WordPress puslapis.

Puslapių apdorojimo eiga taip pat sutvarko detales, dėl kurių failais pagrįsta dokumentacija tampa praktiška tikruose projektuose:

  • Markdown puslapių šaltiniai sinchronizuojami kaip savasis blokų turinys, įskaitant blokų atributus
  • frontmatter metaduomenys pasiekiami svetainės sąsajos pagalbinėms priemonėms ir maketams
  • sinchronizuojant išsaugoma stabili rinkinių puslapių tapatybė
  • įdėtiniai puslapiai, nepriklausantys rinkiniui, susiejami su savo pirminiu puslapiu
  • įdėtiniai puslapiai, nepriklausantys rinkiniui, gali paveldėti artimiausio protėvio layout.php
  • pašalinus rinkinio šaltinius, išvalomi jų sugeneruoti WordPress puslapiai
  • pakeitus rinkinį iš page į pasirinktinį įrašų tipą, esami sinchronizuoti įrašai perkeliami, užuot kūrus dublikatus
  • puslapių tvarka išsaugoma per menu_order

Blokų žymų prefiksai

Blokų žymos dabar palaiko konfigūruojamus vardų srities prefiksus. Projektas gali užregistruoti vieną trumpą prefiksą, kad Blockstudio galėtų rasti bloką vienoje ar keliose vardų srityse:

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

  return $prefixes;
});

Nustačius šią konfigūraciją, <theme-card> gali būti susieta su theme-components/card, <theme-button> gali būti susieta su bsui/button kaip atsarginiu variantu, o <theme-ui-feature-matrix> gali būti susieta su theme-components/ui-feature-matrix.

Jei projektui reikia vienkartinio pakeitimo, pirmenybė vis tiek teikiama aiškiems tag_aliases. Nepažįstamos prefiksų žymos paliekamos nepakeistos, o esami blokų žymų leidimo ir draudimo filtrai taikomi ir per prefiksus rastiems blokams.

Peržiūrėkite blokų žymų dokumentaciją

Vykdymo aplinkos ir redaktoriaus pataisos

7.4 versijoje taip pat yra pataisų, atsiradusių naudojant produktą realiuose projektuose.

  • Dinaminės užklausomis užpildomos parinktys atnaujinamos pakeitus įrašus, terminus, naudotojus ar susijusius metaduomenis, o populate.fetch: true užklausų pasirinkimo laukai pateikia naujausias parinktis, kai redaktoriaus paieškos laukeliai tušti.
  • Programiškai apdorojamos core/query ir core/comments blokų žymos sugeneruotoje apvalkalo žymėjimo struktūroje išsaugo className.
  • Šablonų pseudokomponentai išsaugo camelCase ypatybes, todėl tokios ypatybės kaip allowedFormats ir withoutInteractiveFormatting pasiekia redaktoriaus komponentą, užuot buvusios pašalintos anksčiau.
  • bsui/select patikimiau apdoroja parinkčių duomenis ir už matomų ribų išsiskleidžiančius meniu, ypač tankesniuose redaktoriaus valdikliuose.
  • blockstudio/phpstan atpažįsta laukus, deklaruotus konteineriuose tabs, todėl šablonų, Twig/Blade ir blokų žymų patikra supranta tą pačią laukų struktūrą, kurią projektuose naudoja Blockstudio.
  • Ištrynus kartotuvo eilutę su RichText, pakeitimas išlieka išsaugojus. Pasenusios RichText reikšmės nebegali grąžinti ištrintos eilutės.

Kodėl šis leidimas svarbus

7.4 versijos tema – perkeliamumas.

Puslapių rinkiniai leidžia ištisas dokumentacijos svetaines laikyti šaltinio failų aplankais. Markdown puslapiai palengvina šio turinio rašymą ir skaitymą. Turinio sinchronizavimas tą patį failais pagrįstą modelį išplečia atrinktam duomenų bazės turiniui, todėl įrašai, terminai ir ryšiai gali būti saugomi git ir perkeliami tarp aplinkų. Blokų žymų prefiksai padeda išlaikyti dideles blokų bibliotekas įskaitomas šablonuose.

Blockstudio vis dar pagrįstas failais. Blokai vis dar yra aplankai. Puslapiai vis dar yra failai. 7.4 versija tiesiog leidžia daugiau projekto dalių – puslapių struktūroms ir atrinktam turiniui – saugoti tuose failuose ir perkelti kartu su jais.