Gå til indhold

Hele sider defineret i kode

Skabeloner og Markdown, synkroniseret med WordPress med én kommando.

Samlinger fra filer

Definér pages.json, og lad Blockstudio finde alle kilder nedenunder. Indlejrede stier bliver til indlejrede sider, standardindstillinger gælder for samlingen, og manglende overordnede sider kan oprettes automatisk.

Brug samlinger til dokumentation, vidensbaser eller landingssider, og tilknyt eksterne mapper under et stipræfiks med loader.php.

Placér en layout.php eller et renderer-layout som layout.tsx ved siden af pages.json for at indpakke hver side i samlingen i én skal med blockstudio_page_tree() til sidepanelet.

pages/docs/pages.json
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}

Eksplicit synkronisering

wp bs pages sync anvender ændringer; uændrede sider kræver ingen skrivninger.

Markdown-kilder

Brug index.md med frontmatter, eller kombinér page.json med indholdet fra Markdown.

Rå Markdown

Markdown-filsider vises på deres URL plus .md eller på den normale URL ved Accept: text/markdown, med et canonical-link tilbage til HTML.

Samlingsloadere

Tilknyt eksterne dokumentationsmapper til en samling under et stipræfiks.

Webstedssamlinger

En pages.json med scope site anvender fælles standardværdier på et helt sidetræ og viser det som en liste uden at ændre URL’er eller indlægsrækker.

Navigationshjælpere

blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() og blockstudio_page_content() opbygger sidepaneler, sidevælgere og brødteksten.

Samlinger og indlægstyper

Samlinger kan registrere dedikerede hierarkiske indlægstyper.

Låsning af skabeloner

Lås sider eller enkelte blokke med contentOnly, all eller insert.

Skriv HTML, få blokke

Standardelementer som <h1>, <p> og <ul> knyttes til kerneblokke. Brug <block> til alle andre bloknavne og indlejringsniveauer.

Blockstudio fortolker komplette sidelayouts til rigtige, redigerbare WordPress-blokke.

index.php
<div>
  <h1 blockEditingMode="contentOnly">About Us</h1>
  <p>We build tools for WordPress developers.</p>
  <img src="/team.jpg" alt="Our team" />
</div>

<block name="core/columns">
  <block name="core/column"><h2>Our Mission</h2></block>
  <block name="core/column"><h2>Our Stack</h2></block>
</block>

Sider gengivet af komponenter

Angiv render i page.json til et indgangspunkt som page.tsx og en data.php-loader, så gengiveren for siden, som dit tema eller plugin registrerer, tegner hele siden. Sync gemmer én blockstudio/page-blok, og WordPress-indhold som en shortcode forbliver i sin plads.

Aktiver, som gengiveren returnerer, behandles på samme måde som blokaktiver og udskrives én gang, så en forhåndsgengivet side medbringer dem. blockstudio.dev selv bygges af komponentsider.

pages/legal-notice/page.json
{
  "name": "legal-notice",
  "title": "Legal Notice",
  "slug": "legal-notice",
  "postStatus": "publish",
  "render": { "entry": "page.tsx", "data": "data.php" }
}

Ruter uden et indlæg

Blockstudio\Virtual_Routes::register() leverer et dokument uden et tilknyttet indlæg, f.eks. en komponentreference eller et katalog. Med prefix og match kan én registrering håndtere en hel gruppe URL’er, og returnering af null overlader URL til WordPress.

Ruten gengives i Blockstudios outputbuffer, så dens blokke får deres aktiver og Tailwind-output. Stier i urls indgår i statiske prerender-builds, og Virtual_Routes::urls() returnerer dem til et sitemap.

functions.php
add_action( 'init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function ( $component, string $rest ) {
            get_header();
            echo my_component_page( $component );
            get_footer();
        },
        [
            'prefix' => true,
            'match'  => fn ( string $rest ) => '' === $rest ? 'index' : my_component( $rest ),
            'title'  => fn ( $component ) => my_component_title( $component ),
            'urls'   => fn () => my_component_paths(),
        ]
    );
} );

Synkronisér, når du siger til

Sidefiler ændres kun, når du beder om det: WordPress. wp bs pages sync anvender alle ændrede kilder, bevarer redigerbart indhold med nøgler og fjerner sider, hvis filer mangler.

Fingeraftryk dækker manifests, loaders, layouts og kilder, så uændrede sider ikke kræver nogen skrivninger. Udrulninger kalder Pages::reconcile() og får en maskinlæsbar rapport.

Terminal
# Apply changed sources, keep keyed edits
wp bs pages sync

# Replace managed content from the files
wp bs pages sync --authoritative

# Compare every page and report as JSON
wp bs pages sync --full --format=json

Blokke med nøgler bevarer indhold

Tilføj key til en blok. Ved næste synkronisering flettes skabelonattributter med eksisterende brugerindhold for blokke med nøgler, mens blokke uden nøgler erstattes.

Udvikl strukturen på tværs af udrulninger, mens kundernes indhold bevares.

index.php
<h1 key="title">About Us</h1>
<block name="core/cover" key="hero" url="/hero.jpg">
  <h2>Welcome to our company</h2>
  <p>Edit this content freely.</p>
</block>
<block name="core/columns" key="team">
  <block name="core/column"><h3>Our Team</h3></block>
</block>

Låsning af skabeloner og redigeringstilstande

"all" forhindrer ændringer, "contentOnly" låser strukturen, men tillader tekstredigering, og "insert" tillader redigering og omarrangering uden at tilføje eller fjerne.

Tilsidesæt ethvert element med blockEditingMode for at gøre en låst side selektivt redigerbar eller deaktivere en enkelt blok.

index.php
<h1>Welcome to Our Product</h1>
<p>The best solution for your needs.</p>
<block name="core/cover" blockEditingMode="disabled" url="/static-banner.jpg">
  <p>Promotional banner</p>
</block>
<block name="core/group" blockEditingMode="default">
  <h2>Customizable Section</h2>
</block>

Skabeloner til webstedseditoren fra filer

Tilføj template.json og en skabelon til templates/, eller part.json til parts/, så får dit bloktema filbaserede kilder til wp_template og wp_template_part.

De bruger samme syntaks som sider. En tilpasning i webstedseditoren har stadig forrang, indtil nogen nulstiller den; derefter træder filkilden i kraft igen.

templates/front-page/index.php
<block name="core/template-part" slug="header" />

<div>
  <h1>Welcome</h1>
  <block name="core/post-content" />
</div>

<block name="core/template-part" slug="footer" />

Udvalgt databaseindhold i git

wp bs content pull eksporterer tilladte indlæg, termer, relationer og deklarerede metadata til portérbare filer, og push anvender dem i et andet miljø. Deklarerede referencer, forældre og termrelationer overføres som stabile UID’er.

Indlæg, der administreres af sidesynkronisering, kan kombineres med includePageSyncManaged. Deres filer indeholder "bodyOwner": "page-sync", så Content Sync flytter metadataene, mens sidesynkroniseringen bevarer indholdet.

blockstudio.json
{
  "content": {
    "enabled": true,
    "id": "default",
    "path": "content",
    "postTypes": ["team_member"],
    "taxonomies": ["category"],
    "meta": {
      "include": ["_my_*"],
      "references": {
        "_thumbnail_id": { "kind": "attachment" },
        "_related_posts": { "kind": "post", "path": "*" }
      }
    },
    "media": "manifest"
  }
}

Nøglede blokke

Bevar brugerindhold, mens skabeloner udvikles.

Redigeringstilstande

Angiv sidestandarder, og tilsidesæt enkelte elementer.

Blokbindinger

Forbind blokke med indlægsmetadata, så indholdet bevares ved synkronisering.

Skabeloner til indlægstyper

templateFor gør en side til startstrukturen for alle nye indlæg af en type.

Fastgjorte indlægs-id’er

postId genbruger det samme ID, når en side slettes og synkroniseres igen, så menuer og links fortsat virker.

Stilladser og låse

sync: false sammen med Pages::force_sync() opretter en side én gang, som redaktører selv administrerer. Pages::lock() og unlock() forhindrer én side i at blive synkroniseret.

Brugerdefinerede parser-gengivere

Builder- og renderer-filtre omdanner et bloktag til blokarrayet for en tredjepartsblok eller ændrer, hvordan en kerneblok skrives.

Elementtilknytning

Tilknyt et HTML-element til en anden blok, vælg blokken ud fra elementets attributter, og send afsnittets HTML til et indholdsfelt.

Brugerdefinerede registreringsstier

Filtre tilføjer rødder for sider, mønstre og Site Editor-skabeloner, f.eks. fra et plugin.

Logiske registreringskilder

Forhåndsvisninger, overlays og genererede temaer kan give Blockstudio en sammensat filoversigt i stedet for én temamappe.

Stabile referencer

Erklærede referencer til indlæg, termer og vedhæftninger bliver til flytbare UID’er ved hentning og opløses til lokale ID’er ved afsendelse.

Status før afsendelse

wp bs content status rapporterer hver enhed som uændret, ville blive opdateret, mangler i databasen, konflikt, låst eller forældreløs og advarer om metanøgler, der ligner hemmeligheder.

Validerede afsendelser med afgrænset omfang

Push validerer hele planen, før den skriver, og springer låste enheder over. –dry-run viser planen, og –prune –yes fjerner kun enheder fra dette indholdssæt.

Versionsstyret

Spor sidefiler i Git, og udrul dem på tværs af miljøer.

PHP API

Tilgå træer, undersider, metadata, synkronisering, låsning og id’er programmatisk.

Plus

Det officielle udvidelsessæt

Premiumskabeloner til websteder, AI-systeminstruktioner og et privat Discord-fællesskab. Engangskøb med opdateringer hele livet.

  • 500+ hjemmesideskabeloner
  • AI-systeminstruktioner
  • Opdateringer hele livet
  • Privat Discord-fællesskab