Saltar al contenido

Páginas completas definidas en código

Plantillas y Markdown, sincronizados con WordPress mediante un solo comando.

Colecciones desde archivos

Define pages.json y deja que Blockstudio detecte todas las fuentes que contiene. Las rutas anidadas se convierten en páginas anidadas, los valores predeterminados se aplican a la colección y se pueden generar los elementos principales que falten.

Usa colecciones para documentación, bases de conocimiento o páginas de destino, y monta carpetas externas bajo un prefijo de ruta con loader.php.

Coloque un layout.php o un diseño de renderizador como layout.tsx junto a pages.json para envolver cada página de la colección en una misma estructura, con blockstudio_page_tree() para la barra lateral.

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

Sincronización explícita

wp bs pages sync aplica los cambios; las páginas sin cambios no requieren escrituras.

Fuentes de Markdown

Usa index.md con metadatos iniciales o combina page.json con contenido de Markdown.

Markdown sin procesar

Las páginas de archivo Markdown responden en su URL más .md, o en el URL normal para Accept: text/markdown, con un enlace canónico a HTML.

Cargadores de colecciones

Monta carpetas externas de documentación en una colección bajo un prefijo de ruta.

Colecciones del sitio

Un pages.json con alcance site aplica valores predeterminados compartidos a todo un árbol de páginas y lo enumera, sin cambiar las URL ni las filas de entradas.

Ayudantes de navegación

blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() y blockstudio_page_content() crean barras laterales, paginadores y el cuerpo.

Colecciones y tipos de contenido

Las colecciones pueden registrar tipos de contenido jerárquicos específicos.

Bloqueo de plantillas

Bloquea páginas o bloques individuales con contentOnly, all o insert.

Escribe HTML y obtén bloques

Elementos estándar como <h1>, <p> y <ul> se asignan a bloques del núcleo. Usa <block> para cualquier otro nombre de bloque y nivel de anidamiento.

Blockstudio analiza diseños de página completos y los convierte en bloques WordPress reales y editables.

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>

Páginas renderizadas por componentes

Establezca render en page.json con una entrada como page.tsx y un cargador data.php, y el renderizador de páginas que registre su tema o plugin dibujará la página completa. La sincronización almacena un bloque blockstudio/page, y el contenido WordPress, como un shortcode, permanece en su espacio.

Los recursos que devuelve el renderizador reciben el mismo procesamiento que los recursos de bloques y se imprimen una sola vez, así que las páginas prerenderizadas los incluyen. blockstudio.dev se crea a partir de páginas de componentes.

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

Rutas sin una entrada

Blockstudio\Virtual_Routes::register() sirve un documento que no tiene una entrada detrás, como una referencia de componentes o un catálogo. Con prefix y match, un registro responde a toda una familia de URL, y devolver null deja que URL se encargue de WordPress.

La ruta se renderiza dentro del búfer de salida de Blockstudio, por lo que sus bloques reciben sus recursos y la salida de Tailwind. Las rutas de urls se incluyen en las compilaciones de prerenderizado estático, y Virtual_Routes::urls() las devuelve para un mapa del sitio.

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(),
        ]
    );
} );

Sincroniza cuando tú lo decidas

Los archivos de página solo cambian en WordPress cuando tú lo solicitas. wp bs pages sync aplica todas las fuentes modificadas, conserva el contenido del editor identificado por clave y elimina las páginas cuyos archivos ya no existen.

Las huellas digitales incluyen manifiestos, cargadores, diseños y fuentes, así que las páginas sin cambios no requieren escrituras. Los despliegues llaman a Pages::reconcile() y reciben un informe legible por máquinas.

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

Los bloques con clave conservan el contenido

Añade key a cualquier bloque. En la siguiente sincronización, los bloques con clave combinan los atributos de la plantilla con el contenido de usuario existente, mientras que los bloques sin clave se sustituyen.

Evoluciona la estructura entre despliegues sin perder el contenido de los clientes.

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>

Bloqueo de plantillas y modos de edición

"all" impide los cambios, "contentOnly" bloquea la estructura y permite editar el texto, y "insert" permite editar y reordenar sin añadir ni eliminar elementos.

Usa blockEditingMode para modificar cualquier elemento y hacer que una página bloqueada se pueda editar de forma selectiva, o desactivar un bloque individual.

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>

Plantillas del editor del sitio desde archivos

Añade template.json y una plantilla a templates/, o part.json a parts/, para que tu tema de bloques obtenga fuentes de wp_template y wp_template_part respaldadas por archivos.

Usan la misma sintaxis que las páginas. Las personalizaciones del editor del sitio siguen teniendo prioridad hasta que alguien las restablece; entonces vuelve a usarse la fuente del archivo.

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

Contenido seleccionado de la base de datos en git

wp bs content pull exporta las entradas, términos, relaciones y metadatos declarados permitidos a archivos portátiles, y push los aplica a otro entorno. Las referencias, los elementos superiores y las relaciones entre términos declarados se transfieren como UID estables.

Las entradas gestionadas por la sincronización de páginas pueden combinarse con includePageSyncManaged. Sus archivos llevan "bodyOwner": "page-sync", así que Content Sync transfiere los metadatos mientras la sincronización de páginas conserva el cuerpo.

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

Bloques con clave

Conserva el contenido de usuario mientras evolucionan las plantillas.

Modos de edición

Establece valores predeterminados para las páginas y modifica elementos individuales.

Vinculación de bloques

Conecta bloques con los metadatos de entradas para que el contenido se conserve durante la sincronización.

Plantillas de tipos de contenido

templateFor convierte una página en la estructura inicial de bloques de cada nueva entrada de un tipo.

ID de entradas fijados

postId recupera el mismo ID cuando se elimina una página y se sincroniza de nuevo, para que los menús y enlaces sigan funcionando.

Estructuras iniciales y bloqueos

sync: false con Pages::force_sync() crea una página una sola vez para que los editores se hagan cargo de ella. Pages::lock() y unlock() excluyen una página de la sincronización.

Renderizadores de analizadores personalizados

Los filtros de compilador y renderizador convierten una etiqueta de bloque en la matriz de bloques de un bloque de terceros o cambian cómo se escribe un bloque del núcleo.

Asignación de elementos

Asigne un elemento HTML a otro bloque, elija el bloque según los atributos del elemento y dirija el HTML de un párrafo a un campo de contenido.

Rutas de descubrimiento personalizadas

Los filtros añaden raíces para páginas, patrones y plantillas del Editor del sitio, por ejemplo, desde un plugin.

Fuentes de descubrimiento lógicas

Las vistas previas, las superposiciones y los temas generados pueden proporcionar a Blockstudio un inventario de archivos compuesto en lugar de una sola carpeta de tema.

Referencias estables

Al extraer, las referencias declaradas a entradas, términos y adjuntos se convierten en UID portátiles; al enviar, se resuelven en ID locales.

Estado antes del envío

wp bs content status informa si cada entidad no ha cambiado, se actualizaría, falta en la base de datos, está en conflicto, bloqueada o huérfana, y advierte sobre claves meta que parecen secretos.

Envíos validados y delimitados

Push valida todo el plan antes de escribir y omite las entidades bloqueadas. –dry-run muestra el plan, y –prune –yes elimina solo las entidades de este conjunto de contenido.

Bajo control de versiones

Registra los archivos de página en Git y despliégalos en distintos entornos.

PHP API

Accede mediante programación a árboles, elementos secundarios, metadatos, sincronización, bloqueos e identificadores.

Plus

El kit oficial de extensiones

Plantillas de sitio prémium, instrucciones de sistema para IA y una comunidad privada de Discord. Compra única, actualizaciones de por vida.

  • Más de 500 plantillas de sitios web
  • Instrucciones del sistema de IA
  • Actualizaciones de por vida
  • Comunidad privada de Discord