Ga naar de inhoud

Volledige pagina’s, gedefinieerd in code

Templates en Markdown, met één opdracht gesynchroniseerd met WordPress.

Collecties uit bestanden

Definieer pages.json en laat Blockstudio elke bron eronder ontdekken. Geneste paden worden geneste pagina’s, standaardwaarden gelden voor de collectie en ontbrekende bovenliggende pagina’s kunnen worden aangemaakt.

Gebruik collecties voor documentatie, kennisbanken of landingspagina’s en koppel externe mappen onder een padvoorvoegsel met loader.php.

Plaats een layout.php of een rendererlayout zoals layout.tsx naast pages.json om elke pagina van de collectie in één shell te wikkelen, met blockstudio_page_tree() voor de zijbalk.

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

Expliciete synchronisatie

wp bs pages sync past wijzigingen toe; ongewijzigde pagina’s kosten geen schrijfbewerkingen.

Markdown-bronnen

Gebruik index.md met frontmatter of combineer page.json met Markdown-content.

Ruwe Markdown

Markdown-bestandspagina’s zijn beschikbaar op hun URL plus .md, of op de normale URL voor Accept: text/markdown, met een canonieke link terug naar de HTML.

Collectieladers

Koppel externe documentatiemappen onder een padvoorvoegsel aan een collectie.

Sitecollecties

Een pages.json met scope site past gedeelde standaardinstellingen toe op een volledige paginaboom en geeft die weer, zonder URL’s of berichtrecords te wijzigen.

Navigatiehelpers

blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() en blockstudio_page_content() bouwen zijbalken, pagers en de hoofdinhoud.

Collecties en berichttypen

Collecties kunnen speciale hiërarchische berichttypen registreren.

Templates vergrendelen

Vergrendel pagina’s of afzonderlijke blokken met contentOnly, all of insert.

Schrijf HTML, krijg blokken

Standaardelementen zoals <h1>, <p> en <ul> worden gekoppeld aan core-blokken. Gebruik <block> voor elke andere bloknaam en elk nestingniveau.

Blockstudio parseert volledige paginalay-outs naar echte, bewerkbare WordPress-blokken.

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>

Pagina’s gerenderd door componenten

Stel render in page.json in op een item zoals page.tsx en een loader voor data.php, waarna de pagerenderer die uw thema of plugin registreert de volledige pagina tekent. Sync slaat één blockstudio/page-block op, en WordPress-content zoals een shortcode blijft op zijn plek.

Assets die de renderer teruggeeft, worden op dezelfde manier verwerkt als block-assets en maar één keer afgedrukt, zodat een vooraf gerenderde pagina ze bevat. blockstudio.dev zelf wordt opgebouwd uit componentpagina’s.

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

Routes zonder bericht

Blockstudio\Virtual_Routes::register() serveert een document waar geen bericht achter zit, zoals een componentreferentie of catalogus. Met prefix en match beantwoordt één registratie een hele reeks URL’s, en door null terug te geven blijft de URL over aan WordPress.

De route wordt gerenderd in de outputbuffer van Blockstudio, zodat de blocks hun assets en Tailwind-output krijgen. Paden in urls worden toegevoegd aan statische prerender-builds, en Virtual_Routes::urls() geeft ze terug voor een 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(),
        ]
    );
} );

Synchroniseer wanneer u dat wilt

Paginabestanden worden alleen gewijzigd wanneer u daarom vraagt: WordPress. wp bs pages sync past elke gewijzigde bron toe, behoudt inhoud in blokken met een sleutel en verwijdert pagina’s waarvan de bestanden ontbreken.

Fingerprints omvatten manifesten, loaders, lay-outs en bronnen, zodat ongewijzigde pagina’s geen schrijfbewerkingen kosten. Deployments roepen Pages::reconcile() aan en leveren een machineleesbaar rapport op.

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

Blokken met een sleutel behouden inhoud

Voeg key toe aan een willekeurig blok. Bij de volgende synchronisatie worden templatekenmerken van blokken met een sleutel samengevoegd met bestaande gebruikerscontent, terwijl blokken zonder sleutel worden vervangen.

Pas de structuur bij deployments aan terwijl de content van klanten intact blijft.

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>

Templates vergrendelen en bewerkingsmodi

"all" voorkomt wijzigingen, "contentOnly" vergrendelt de structuur maar staat tekstbewerkingen toe, en "insert" staat bewerken en herordenen toe zonder elementen toe te voegen of te verwijderen.

Overschrijf elk element met blockEditingMode om een vergrendelde pagina selectief bewerkbaar te maken of één blok uit te schakelen.

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>

Templates voor de Site Editor uit bestanden

Voeg template.json en een template toe aan templates/, of part.json aan parts/, en uw block theme krijgt bestandsbronnen voor wp_template en wp_template_part.

Ze gebruiken dezelfde syntaxis als pagina’s. Een aanpassing in de Site Editor blijft van kracht totdat iemand deze reset; daarna wordt de bestandsbron weer gebruikt.

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

Geselecteerde database-inhoud in git

wp bs content pull exporteert toegestane berichten, termen, relaties en gedeclareerde metadata naar overdraagbare bestanden, en push past ze toe op een andere omgeving. Gedeclareerde verwijzingen, bovenliggende items en termrelaties worden als stabiele UID’s overgezet.

Berichten die door page sync worden beheerd, kunnen worden gekoppeld aan includePageSyncManaged. Hun bestanden bevatten "bodyOwner": "page-sync", zodat Content Sync de metadata verplaatst terwijl page sync de inhoud behoudt.

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

Blokken met sleutels

Behoud gebruikerscontent terwijl templates zich ontwikkelen.

Bewerkingsmodi

Stel paginastandaarden in en overschrijf afzonderlijke elementen.

Blokkoppelingen

Koppel blokken aan berichtmeta zodat content synchronisatie overleeft.

Templates voor berichttypen

templateFor maakt een pagina de startstructuur van blocks voor elk nieuw bericht van een type.

Vastgezette bericht-ID’s

postId herstelt dezelfde ID wanneer een pagina wordt verwijderd en opnieuw wordt gesynchroniseerd, zodat menu’s en links blijven werken.

Steigers en vergrendelingen

sync: false met Pages::force_sync() maakt een pagina één keer aan die editors zelf kunnen beheren. Pages::lock() en unlock() zorgen dat één pagina niet wordt gesynchroniseerd.

Aangepaste parser-renderers

Builder- en rendererfilters zetten een blocktag om in de blockarray van een block van derden of wijzigen hoe een core-block wordt geschreven.

Elementtoewijzing

Koppel een element van HTML aan een ander block, kies het block op basis van de attributen van het element en stuur alinea-HTML door naar een inhoudsveld.

Aangepaste detectiepaden

Filters voegen roots toe voor pagina’s, patronen en Site Editor-templates, bijvoorbeeld vanuit een plugin.

Logische detectiebronnen

Previews, overlays en gegenereerde thema’s kunnen Blockstudio een samengestelde bestandsinventaris aanleveren in plaats van één themamap.

Stabiele verwijzingen

Aangegeven verwijzingen naar berichten, termen en bijlagen worden bij het ophalen draagbare UID’s en worden bij het pushen omgezet in lokale ID’s.

Status vóór het pushen

wp bs content status rapporteert elke entiteit als ongewijzigd, wordt bijgewerkt, ontbreekt in de database, conflict, vergrendeld of verweesd, en waarschuwt voor metadatatoetsen die op geheimen lijken.

Gevalideerde, afgebakende pushes

Push valideert het volledige plan voordat er iets wordt weggeschreven en slaat vergrendelde entiteiten over. –dry-run toont het plan, en –prune –yes verwijdert alleen de entiteiten uit deze contentset.

Onder versiebeheer

Houd paginabestanden bij in Git en implementeer ze in verschillende omgevingen.

PHP API

Benader programmatisch bomen, onderliggende items, metadata, synchronisatie, vergrendelingen en ID’s.

Plus

De officiële uitbreidingskit

Premium-sitetemplates, AI-systeeminstructies en een privécommunity van Discord. Eenmalige aankoop, levenslange updates.

  • 500+ websitesjablonen
  • Systeeminstructies voor AI
  • Updates voor altijd
  • Privécommunity van Discord