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.
{
"collection": "docs",
"title": "Documentation",
"postType": "bs_docs",
"defaults": {
"postStatus": "publish",
"templateLock": "contentOnly"
}
}---
title: Installation
order: 10
---
# Installation
Install Blockstudio from this Markdown page.<?php $current = blockstudio_current_page(); ?>
<main class="docs-layout">
<aside>
<?php foreach (blockstudio_page_tree('docs') as $item) : ?>
<?php $is_current = ($item['post_id'] ?? null) === ($current['post_id'] ?? null); ?>
<a
href="<?php echo esc_url($item['permalink'] ?? '#'); ?>"
<?php echo $is_current ? 'aria-current="page"' : ''; ?>
>
<?php echo esc_html($item['title']); ?>
</a>
<?php endforeach; ?>
</aside>
<article>
<?php echo blockstudio_page_content(); ?>
</article>
</main>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.
<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.
{
"name": "legal-notice",
"title": "Legal Notice",
"slug": "legal-notice",
"postStatus": "publish",
"render": { "entry": "page.tsx", "data": "data.php" }
}add_action(
'blockstudio/pages/renderers',
static function (): void {
Blockstudio\Page_Renderers::register(
'react',
array(
'extensions' => array( 'tsx' ),
'layouts' => array( 'layout.tsx' ),
'render' => 'my_theme_render_page',
)
);
}
);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.
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.
# 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$report = Blockstudio\Pages::reconcile();
if (0 === $report['failed']) {
// Once the release is live and verified:
Blockstudio\Pages::store_successful_source_identity(
$report['sourceIdentity']
);
}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.
<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>{
"name": "about",
"title": "About Us",
"slug": "about",
"templateLock": "contentOnly"
}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.
<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>{
"name": "landing",
"title": "Landing Page",
"slug": "landing",
"templateLock": "contentOnly",
"blockEditingMode": "contentOnly"
}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.
<block name="core/template-part" slug="header" />
<div>
<h1>Welcome</h1>
<block name="core/post-content" />
</div>
<block name="core/template-part" slug="footer" />{
"slug": "front-page",
"title": "Front Page",
"description": "Homepage template"
}{
"slug": "header",
"title": "Header",
"area": "header"
}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.
{
"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"
}
}wp bs content pull --dry-run
wp bs content pull
wp bs content status
wp bs content push --dry-run
wp bs content push --prune --yesBloques 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.
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