
Blockstudio 7.4 handler om at gøre filbaserede projekter mere portable. Hvor 7.2 gjorde større projekter nemmere at undersøge og distribuere, og 7.3 tilføjede et lag af UI ovenpå, fokuserer 7.4 på at flytte mere af projektet, dets sider og dets kuraterede indhold ud af databasen og over i versionsstyrede filer.

Hovedfunktionen er sidekollektioner: en måde at pege Blockstudio på en mappe med sidekilder og generere en komplet indlejret sidestruktur i WordPress ud fra den. Kilden kan være PHP, Twig, Blade, HTML, Markdown eller en betroet loader, der returnerer sider fra en anden lokal kilde.

Kort fortalt:

- **Sidekollektioner**: `pages.json` kan definere et komplet sæt af indlejrede sider, standardindstillinger, adfærd for indlægstyper, layouts, loadere og kollektionsmetadata.
- **Markdown-sider**: `index.md` fungerer som sideindhold, enten med `page.json` eller alene med frontmatter.
- **Sidelayouts til frontend**: `layout.php` kan indramme synkroniseret sideindhold og bruge hjælpere som `blockstudio_page_tree()` og `blockstudio_page_content()`.
- **Eksterne dokumentationskilder**: Kollektionsloadere kan generere sider fra lokale filer eller returnerede Markdown/HTML.
- **Rå Markdown-output**: Markdown-sidekilder kan leveres som `.md` eller via `Accept: text/markdown`.
- **Brugerdefinerede indlægstyper for kollektioner**: Kollektioner kan have rene URL'er, automatisk genindlæsning af omskrivningsregler, rå Markdown-ruter og migrering fra side til indlægstype uden tilpasninger på temaets side.
- **Content Sync**: `wp bs content pull`, `wp bs content push` og `wp bs content status` gør det muligt at flytte indlæg, termer, relationer og erklærede metareferencer på projektets tilladelsesliste til portable filer.
- **Bloktag-præfikser**: Projektpræfikser som `<theme-card>` kan slås op på tværs af ordnede navnerum uden aliaser pr. blok.
- **Mere pålidelig synkronisering**: Ændringer af sider registreres på tværs af manifester, loadere, layouts, metadata og kildefiler.
- **Rettelser af runtime og editor**: Dynamiske valgmuligheder holdes opdaterede, klasser for forespørgselsblokke bevares ved programmatisk rendering, `bsui/select` fungerer bedre i tætte formularer, RichText-egenskaber når frem til editoren, og sletning af repeaterrækker med RichText bevares nu efter lagring.

## Filbaserede sider

Det meste af 7.4 bygger videre på filbaserede sider.

### Sidekollektioner

Før 7.4 var filbaserede sider hovedsageligt en mappefunktion: Opret en `page.json`, tilføj en `index.php` eller `index.twig`, og Blockstudio synkroniserer den ene side til WordPress.

Det fungerer stadig. 7.4 tilføjer en anden tilstand til større strukturer.

Tilføj et `pages.json`-manifest til en mappe, så bliver mappen en kollektion:

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

Alle sidekilder i kollektionen registreres, normaliseres, synkroniseres og forbindes via sti. En side på `guide/install` bliver et undersiden af `guide`; hvis siden `guide` mangler, opretter Blockstudio en genereret containerside, så WordPress-hierarkiet stadig svarer til filsystemets struktur.

Kollektioner kan bruge den indbyggede indlægstype `page` eller deres egen indlægstype. Når en kollektion angiver en indlægstype, der endnu ikke findes, registrerer Blockstudio den fra `postTypeArgs`. Manifestets `postType` bliver også standardværdien for hver side i kollektionen, så projekter ikke behøver gentage den i `defaults`.

Kollektionens indlægstyper bruger kollektions-sluggen som offentlig URL-basis. En `docs`-kollektion slår sin rodside op på `/docs/`, en side med `path: "getting-started"` på `/docs/getting-started/` og indlejrede stier under den samme basis. Dobbelte URL'er som `/docs/docs/` videresendes til den kanoniske placering. Omskrivningsregler tømmes automatisk, når kollektionens routing for indlægstypen ændres, så en ny kollektion ikke kræver en manuel lagring af permalinkindstillingerne.

Det er denne funktion, der får eksterne dokumentationssider, produktmanualer, vidensbaser og sidebiblioteker til at føles naturlige i WordPress: Kilden forbliver i filer, mens resultatet stadig er reelt, redigerbart WordPress-indhold.

### Markdown som sideindhold

Markdown er nu en førsteklasses sidekilde.

Standalone Markdown-sider bruger frontmatter:

```md title="pages/about/index.md"
---
name: about
title: About
slug: about
postStatus: publish
---

# About

This Markdown content is synced as native WordPress blocks.
```

Du kan også kombinere `page.json` med `index.md`, hvis du vil dele konfiguration og indhold op i separate filer. Frontmatter i `index.md` kan tilsidesætte tilsvarende felter i `page.json`, og ukendte frontmatter-nøgler bevares som metadata.

Markdown konverteres til HTML og sendes derefter gennem den samme sideparser som skabelonerne PHP, Twig og Blade, så det endelige indhold bliver indbygget blokmarkup.

### Layouts og sidehjælpere

Kollektioner kan indeholde en `layout.php`-fil. På frontend indrammer Blockstudio det synkroniserede sideindhold med dette layout.

```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>
```

De nye hjælpere viser kollektionen som strukturerede data:

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

Det giver dig de dele, du skal bruge til at bygge en komplet dokumentationsramme: navigation fra sidetræet, sidemetadata fra frontmatter og det synkroniserede WordPress-blokindhold som hovedindhold.

### Loadere og rå Markdown

Kollektioner kan indeholde en betroet lokal `loader.php`-fil. Den kan returnere sider direkte eller angive yderligere lokale mapper, som Blockstudio skal undersøge.

```php title="pages/docs/loader.php"
<?php

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

Det er nyttigt, når kilden allerede er genereret et andet sted: en mappe med pakkedokumentation, en Markdown-eksport eller et byggetrin, der returnerer en liste over sider.

Markdown-sidekilder kan også levere deres rå Markdown-kilde. Anmod om siden med suffikset `.md`, eller send `Accept: text/markdown`. Frontmatter fjernes fra svaret, så værktøjer får den læsbare dokumenttekst. Det fungerer også for kollektionens indlægstyper, herunder URL'er som `/docs.md` og `/docs/getting-started.md`.

[Læs dokumentationen til Pages](https://blockstudio.dev/da/docs/pages-and-patterns/pages/)

## Content Sync

7.4 introducerer også Content Sync, et WP-CLI-workflow for teams, der vil have mere af deres WordPress-projekt repræsenteret som filer.

```bash
wp bs content pull
wp bs content push --dry-run
wp bs content status
```

Blockstudio håndterer allerede blokke, felter, skabeloner, mønstre og filbaserede sider i dit projekt. Content Sync føjer udvalgt databaseindhold til denne filbaserede arbejdsgang: tilladte indlæg, termer, relationer og deklarerede metadata kan hentes ind i filer, gennemgås i git og overføres til et andet miljø.

Det er med vilje eksplicit. Du aktiverer det i `blockstudio.json`, tilføjer de indlægstyper og taksonomier, du vil administrere, til tilladelseslisten og angiver de metareferencer, der skal omskrives mellem miljøer.

Ved hentning skriver Blockstudio portable indlæg, termer, relationer og metadata på tilladelseslisten til filer i dit tema. Ved overførsel validerer systemet planen før skrivning og knytter erklærede referencer til `post`, `term` og `attachment` tilbage til lokale database-id'er. Det gætter ikke på, at vilkårlige heltal er id'er.

Omfanget af 7.4 er bevidst begrænset: indlæg, termer, termrelationer, metadata på tilladelseslisten, portable UID'er, vedhæftningsmanifester, prøvekørsler, håndtering af fjernelse, låste entiteter og statusrapportering. Registrering af taksonomidefinitioner, kopiering af mediefiler og omskrivning af id'er i blokmarkup er bevidst udeladt i denne første version.

Det giver teams en enkel måde at versionsstyre kurateret indhold som teammedlemmer, kundecases, lokationer, dokumentationsposter eller andre strukturerede data uden at omdanne hele produktionsdatabasen til en migrering. Funktionen er beregnet til indholdssamlinger, der stadig kan gennemgås som filer: snesevis eller hundredvis af rækker, og i nogle projekter lave tusinder, når indholdet er struktureret og ændres sjældent. Den erstatter ikke databasesikkerhedskopier, synkronisering af e-handel eller ordrer, analyser, logfiler, formularindsendelser eller andre store datamængder.

[Læs dokumentationen til Content Sync](https://blockstudio.dev/da/docs/content-sync/)

### Mere pålidelig synkronisering

Blockstudio registrerer nu ændringer i sidekilder, kollektionsmanifester, loaderfiler, layoutfiler, metadata og relaterede stier. Hvis noget af dette ændres, opdateres den synkroniserede WordPress-side.

Sideprocessen håndterer også de detaljer, der gør filbaseret dokumentation praktisk i virkelige projekter:

- Markdown-sidekilder synkroniseres som indbygget blokindhold, inklusive blokattributter
- frontmatter-metadata er tilgængelige for frontend-hjælpere og layouts
- kollektionssider bevarer en stabil identitet på tværs af synkroniseringer
- indlejrede sider uden for kollektioner knyttes til deres overordnede side
- indlejrede sider uden for kollektioner kan arve den nærmeste forfader `layout.php`
- fjernede kollektionskilder rydder op i deres genererede WordPress-sider
- når en kollektion ændres fra `page` til en brugerdefineret indlægstype, migreres eksisterende synkroniserede indlæg i stedet for at oprette dubletter
- siderækkefølgen gemmes via `menu_order`

## Bloktag-præfikser

Bloktags understøtter nu konfigurerbare navnerumspræfikser. Et projekt kan registrere ét kort præfiks og lade Blockstudio finde blokken i et eller flere navnerum:

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

  return $prefixes;
});
```

Når dette er sat op, kan `<theme-card>` finde `theme-components/card`, `<theme-button>` kan falde tilbage på `bsui/button`, og `<theme-ui-feature-matrix>` kan finde `theme-components/ui-feature-matrix`.

Eksplicitte `tag_aliases` vinder stadig, når et projekt har brug for en engangstilsidesættelse. Ukendte præfikstags forbliver urørte, og de eksisterende filtre, der tillader eller afviser bloktags, gælder stadig for blokke, der findes via præfikser.

[Læs dokumentationen til Block Tags](https://blockstudio.dev/da/docs/blocks/rendering/#prefix-shorthands)

## Rettelser af runtime og editor

7.4 indeholder også en række rettelser, der udsprang af brug i virkelige projekter.

- Dynamiske valgmuligheder, der udfyldes via forespørgsler, holdes opdaterede, når indlæg, termer, brugere eller relaterede metadata ændres, og `populate.fetch: true`-forespørgselsvalglister henter aktuelle valgmuligheder ved tomme søgninger i editoren.
- Programmatisk brug af bloktags i `core/query` og `core/comments` bevarer `className` i den genererede wrapper-markup.
- Pseudokomponenter i skabeloner bevarer camelCase-egenskaber, så egenskaber som `allowedFormats` og `withoutInteractiveFormatting` når frem til editorens komponent i stedet for at blive fjernet på forhånd.
- `bsui/select` håndterer valgmulighedsdata og menuer, der går ud over deres område, mere pålideligt, især i tættere editor-kontroller.
- `blockstudio/phpstan` genkender felter, der er erklæret i `tabs`-containere, så validering af skabeloner, Twig/Blade og bloktags forstår den samme feltstruktur, som Blockstudio bruger i projekter.
- Sletning af en repeaterrække med RichText bevares efter lagring. Forældede RichText-værdier kan ikke længere genskabe den slettede række.

## Hvorfor denne udgivelse er vigtig

Temaet for 7.4 er portabilitet.

Sidekollektioner gør hele dokumentationswebsteder til mapper med kildefiler. Markdown-sider gør indholdet nemt at skrive og læse tilbage. Content Sync udvider den samme filbaserede model til kurateret databaseindhold, så indlæg, termer og relationer kan ligge i git og flyttes mellem miljøer. Bloktagpræfikser gør store blokbiblioteker overskuelige i skabeloner.

Blockstudio er stadig filbaseret. Blokke er stadig mapper. Sider er stadig filer. 7.4 gør det blot muligt at have mere af et projekt, dets sidestrukturer og dets kuraterede indhold i disse filer og lade det følge med.
