
Blockstudio 7.4 handlar om att göra filbaserade projekt mer portabla. I 7.2 blev det enklare att granska och distribuera större projekt, och 7.3 lade till ett lager av UI ovanpå. 7.4 fokuserar på att flytta mer av ett projekt, dess sidor och dess utvalda innehåll från databasen till versionshanterade filer.

Den främsta nyheten är sidkollektioner: ett sätt att ange en mapp med sidkällor för Blockstudio och skapa en komplett nästlad WordPress-sidstruktur utifrån den. Källan kan vara PHP, Twig, Blade, HTML, Markdown eller en betrodd laddare som hämtar sidor från en annan lokal källa.

Kortversionen:

- **Sidkollektioner**: `pages.json` kan definiera en komplett uppsättning nästlade sidor, standardvärden, beteende för inläggstyper, layouter, laddare och kollektionsmetadata.
- **Markdown-sidor**: `index.md` fungerar som sidinnehåll, antingen med `page.json` eller på egen hand med frontmatter.
- **Sidlayouter för frontend**: `layout.php` kan omsluta synkroniserat sidinnehåll och använda hjälpfunktioner som `blockstudio_page_tree()` och `blockstudio_page_content()`.
- **Externa dokumentationskällor**: kollektionsladdare kan skapa sidor från lokala filer eller returnerade Markdown/HTML.
- **Rå Markdown-utdata**: Markdown-sidkällor kan visas som `.md` eller via `Accept: text/markdown`.
- **Anpassade inläggstyper för kollektioner**: kollektioner kan ha rena URL:er, automatisk uppdatering av omskrivningsregler, råa Markdown-rutter och migrering från sidor till anpassade inläggstyper utan kringlösningar i temat.
- **Content Sync**: `wp bs content pull`, `wp bs content push` och `wp bs content status` gör att tillåtelselistebaserade inlägg, termer, relationer och deklarerade metareferenser i projektet kan hanteras i portabla filer.
- **Blocktaggsprefix**: projektprefix som `<theme-card>` kan lösas i ordnade namnrymder utan alias per block.
- **Tillförlitligare synkronisering**: sidändringar upptäcks i manifest, laddare, layouter, metadata och källfiler.
- **Korrigeringar i körning och redigerare**: dynamiska alternativ hålls uppdaterade, klassnamn för frågeblock bevaras vid programmatisk rendering, `bsui/select` fungerar bättre i täta formulär, RichText-egenskaper når redigeraren och radering av upprepade rader med RichText finns kvar efter att ändringarna sparats.

## Filbaserade sidor

Det mesta i 7.4 bygger vidare på filbaserade sidor.

### Sidkollektioner

Före 7.4 var filbaserade sidor mest en funktion på mappnivå: skapa en `page.json`, lägg till en `index.php` eller `index.twig`, så synkroniserar Blockstudio den sidan till WordPress.

Det fungerar fortfarande. I 7.4 tillkommer ett andra läge för större strukturer.

Lägg till ett `pages.json`-manifest i en mapp, så blir 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"
  }
}
```

Varje sidkälla i kollektionen hittas, normaliseras, synkroniseras och länkas efter sökväg. En sida på `guide/install` blir en undersida till `guide`. Om sidan `guide` saknas skapar Blockstudio en genererad behållarsida så att hierarkin i WordPress fortfarande motsvarar filsystemets struktur.

Kollektioner kan använda den inbyggda inläggstypen `page` eller en egen inläggstyp. När en kollektion anger en inläggstyp som ännu inte finns registrerar Blockstudio den från `postTypeArgs`. Manifestet `postType` blir också standard för varje sida i kollektionen, så projekt behöver inte ange det på nytt i `defaults`.

Inläggstyper för kollektioner använder kollektionens slug som offentlig bas för URL. En kollektion av typen `docs` hittar sin rotsida på `/docs/`, en sida med `path: "getting-started"` på `/docs/getting-started/` och nästlade sökvägar under samma bas. Dubblerade URL:er som `/docs/docs/` omdirigeras till den kanoniska platsen. Omskrivningsregler uppdateras automatiskt när routningen för kollektionens inläggstyp ändras, så en ny kollektion kräver ingen manuell sparning av permalänkar.

Det här är det som får extern dokumentation, produktmanualer, kunskapsbaser och sidbibliotek att fungera naturligt i WordPress: källan ligger kvar i filer, men resultatet är fortfarande verkligt redigerbart WordPress-innehåll.

### Markdown som sidinnehåll

Markdown är nu en förstklassig sidkälla.

Fristående Markdown-sidor använder 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 också kombinera `page.json` med `index.md` när du vill dela upp konfiguration och innehåll mellan filer. Frontmatter i `index.md` kan åsidosätta matchande fält i `page.json`, och okända frontmatter-nycklar bevaras som metadata.

Markdown konverteras till HTML och skickas sedan genom samma sidparser som mallarna PHP, Twig och Blade, så att det slutliga innehållet blir inbyggd blockmarkering.

### Layouter och sidohjälpare

Kollektioner kan innehålla en `layout.php`-fil. I frontend omsluter Blockstudio det synkroniserade sidinnehållet med den layouten.

```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 nya hjälpfunktionerna visar kollektionen som strukturerade 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();
```

Då får du byggstenarna för att skapa ett komplett dokumentationsskal: navigering från sidträdet, sidmetadata från frontmatter och det synkroniserade WordPress-blockinnehållet som huvudyta.

### Laddare och rå Markdown

Kollektioner kan innehålla en betrodd lokal `loader.php`-fil. Den kan returnera sidor direkt eller ange ytterligare lokala kataloger som Blockstudio ska genomsöka.

```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 är användbart när källan redan genereras någon annanstans: en dokumentationsmapp för ett paket, en Markdown-export eller ett byggsteg som returnerar en lista med sidor.

Markdown-sidkällor kan också visa sin råa Markdown-källa. Begär sidan med suffixet `.md` eller skicka `Accept: text/markdown`. Frontmatter tas bort från svaret, så att verktyg får dokumentets läsbara brödtext. Det fungerar även för kollektionsinläggstyper, inklusive URL:er som `/docs.md` och `/docs/getting-started.md`.

[Läs dokumentationen för Pages](https://blockstudio.dev/sv/docs/pages-and-patterns/pages/)

## Content Sync

I 7.4 introduceras även Content Sync, ett WP-CLI-arbetsflöde för team som vill representera mer av sitt WordPress-projekt som filer.

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

Blockstudio hanterar redan block, fält, mallar, mönster och filbaserade sidor i projektet. Content Sync lägger till utvalt databasinnehåll i det filbaserade arbetsflödet: inlägg, termer, relationer och deklarerad metadata på tillåtelselistor kan hämtas till filer, granskas i git och skickas till en annan miljö.

Funktionen är avsiktligt explicit. Du aktiverar den i `blockstudio.json`, lägger till de inläggstyper och taxonomier du vill hantera på tillåtelselistor och deklarerar de metareferenser som ska skrivas om mellan miljöer.

Vid hämtning skriver Blockstudio portabla inlägg, termer, relationer och tillåtelselistebaserad metadata till filer i temat. Vid skickning valideras planen före skrivning, och deklarerade referenser till `post`, `term` och `attachment` löses tillbaka till lokala databas-ID:n. Funktionen gissar inte att godtyckliga heltal är ID:n.

Omfattningen för 7.4 är avsiktligt begränsad: inlägg, termer, termrelationer, tillåtelselistebaserad metadata, portabla UID:n, bilagemanifest, torrkörningar, hantering av rensning, låsta entiteter och statusrapportering. Insamling av taxonomidefinitioner, kopiering av mediebinarier och omskrivning av ID:n i blockmarkering ingår avsiktligt inte i den första versionen.

Det ger teamen ett enkelt sätt att versionshantera utvalt innehåll som teammedlemmar, fallstudier, platser, dokumentationsposter eller andra strukturerade poster utan att göra hela produktionsdatabasen till en migrering. Funktionen är avsedd för innehållsuppsättningar som fortfarande går att granska som filer: dussintals eller hundratals rader, och i vissa projekt några tusen när innehållet är strukturerat och ändras sällan. Den ersätter inte säkerhetskopior av databaser, synkronisering av e-handel och beställningar, analys, loggar, formulärinskick eller andra stora datamängder.

[Läs dokumentationen för Content Sync](https://blockstudio.dev/sv/docs/content-sync/)

### Tillförlitligare synkronisering

Blockstudio upptäcker nu ändringar i sidkällor, kollektionsmanifest, laddarfiler, layoutfiler, metadata och relaterade sökvägar. Om något av detta ändras uppdateras den synkroniserade WordPress-sidan.

Sidflödet hanterar också detaljerna som gör filbaserad dokumentation praktisk i verkliga projekt:

- Markdown-sidkällor synkroniseras som inbyggt blockinnehåll, inklusive blockattribut
- frontmatter-metadata är tillgängliga för hjälpfunktioner och layouter i frontend
- kollektionssidor behåller en stabil identitet mellan synkroniseringar
- nästlade sidor som inte tillhör en kollektion länkas till sin överordnade sida
- nästlade sidor som inte tillhör en kollektion kan ärva närmaste överordnade `layout.php`
- borttagna kollektionskällor tar bort sina genererade WordPress-sidor
- om en kollektion ändras från `page` till en anpassad inläggstyp migreras befintliga synkroniserade inlägg i stället för att skapa dubbletter
- sidordningen sparas via `menu_order`

## Blocktaggsprefix

Blocktaggar stöder nu konfigurerbara namnrymdsprefix. Ett projekt kan registrera ett kort prefix och låta Blockstudio lösa blocktaggen i en eller flera namnrymder:

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

  return $prefixes;
});
```

När det är på plats kan `<theme-card>` lösas till `theme-components/card`, `<theme-button>` falla tillbaka på `bsui/button` och `<theme-ui-feature-matrix>` lösas till `theme-components/ui-feature-matrix`.

Explicita `tag_aliases` gäller fortfarande när ett projekt behöver en engångsåsidosättning. Taggar med okända prefix lämnas orörda, och de befintliga filtren för tillåtna och nekade blocktaggar gäller fortfarande för block som löses via prefix.

[Läs dokumentationen för Block Tags](https://blockstudio.dev/sv/docs/blocks/rendering/#prefix-shorthands)

## Korrigeringar i körning och redigerare

7.4 innehåller också flera korrigeringar som bygger på erfarenheter från verkliga projekt.

- Alternativ som fylls i dynamiskt via frågor hålls uppdaterade när inlägg, termer, användare eller relaterad metadata ändras, och `populate.fetch: true`-frågeval hämtar aktuella alternativ vid tomma sökningar i redigeraren.
- Programmässiga blocktaggar `core/query` och `core/comments` bevarar `className` i den genererade omslagsmarkeringen.
- Pseudokomponenter i mallar bevarar egenskaper i camelCase, så att egenskaper som `allowedFormats` och `withoutInteractiveFormatting` når redigerarens komponent i stället för att tas bort dessförinnan.
- `bsui/select` hanterar alternativdata och överflödande menyer mer tillförlitligt, särskilt i tätare redigerarkontroller.
- `blockstudio/phpstan` känner igen fält som deklarerats inuti `tabs`-behållare, så att validering av mallar, Twig/Blade och blocktaggar förstår samma fältstruktur som Blockstudio använder i projekt.
- Radering av en upprepad rad med RichText finns kvar efter att ändringarna sparats. Inaktuella RichText-värden kan inte längre återställa den raderade raden.

## Därför är den här versionen viktig

Temat för 7.4 är portabilitet.

Sidkollektioner gör att hela dokumentationswebbplatser kan bestå av mappar med källfiler. Sidor i Markdown gör innehållet enkelt att skriva och läsa tillbaka. Content Sync utökar samma filbaserade modell till utvalt databasinnehåll, så att inlägg, termer och relationer kan finnas i git och flyttas mellan miljöer. Blocktaggsprefix gör stora blockbibliotek mer lättlästa i mallar.

Blockstudio är fortfarande filbaserat. Block är fortfarande mappar. Sidor är fortfarande filer. I 7.4 kan helt enkelt mer av ett projekt, dess sidstrukturer och utvalda innehåll, finnas i filerna och följa med dem.
