
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:

```txt
pages/
  docs/
    pages.json
    layout.php
    index.md
    guide/
      install/
        index.md
    reference/
      page.json
      index.md
```

```json title="pages/docs/pages.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:

```md title="pages/about/index.md"
---
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 title="pages/docs/layout.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 title="pages/docs/loader.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](https://blockstudio.dev/lv/docs/pages-and-patterns/pages/)

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

```bash
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](https://blockstudio.dev/lv/docs/content-sync/)

### 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](https://blockstudio.dev/lv/docs/blocks/rendering/#prefix-shorthands)

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