Bloques personalizados en 3 archivos
Sin JavaScript, sin proceso de compilación ni código repetitivo.
Define campos en JSON
Añade una clave blockstudio a block.json. Define atributos con tipos como text, toggle y color. Blockstudio genera automáticamente el UI del editor, con tipos de campo 27 que van desde campos de texto hasta repetidores y editores de código, además de los tipos de campo que registres tú mismo.
La compatibilidad completa con el esquema JSON ofrece autocompletado y validación en VS Code, PhpStorm y cualquier editor compatible.
Cada campo puede definir un default para los bloques nuevos y un fallback que recibe la plantilla mientras el campo esté vacío.
{
"name": "starter/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "id": "showCta", "type": "toggle", "label": "Show CTA" },
{ "id": "background", "type": "color", "label": "Background" }
]
}
}Flujo de trabajo con 3 archivos
block.json para los campos, una plantilla para el marcado y una hoja de estilos opcional.
React en PHP
RichText, InnerBlocks y useBlockProps funcionan directamente en PHP, Twig o Blade.
SCSS y Tailwind
Use CSS, SCSS o Tailwind. SCSS admite rutas de importación y un preámbulo compartido; al editar un parcial anidado, se recompilan todos los archivos que lo importan.
27 tipos de campo
Texto, color, imagen, repetidor, selector, editor de código y más, configurados en JSON.
JSON Schema
Autocompletado y validación en VS Code, PhpStorm y editores compatibles.
Tres lenguajes de plantillas
PHP, Twig y Blade comparten las mismas variables y componentes.
Importaciones de npm
Importa paquetes en script.js; se cargan localmente en producción y usan CDN en el editor.
Interactivity API
Activa la interactividad de WordPress con API usando una sola opción.
Componentes de React en plantillas de PHP
Usa <RichText /> para la edición en línea y HTML para el frontend estático, <InnerBlocks /> para bloques secundarios y useBlockProps para el contenedor, todo en una sola plantilla.
En el editor se convierten en componentes reales de React. En el frontend se muestran como HTML del lado del servidor, sin enviar JavaScript a los visitantes.
<div useBlockProps class="container">
<RichText
class="text-xl font-semibold"
tag="h1"
attribute="headline"
placeholder="Enter headline"
/>
<?php if ($a['showCta']): ?>
<a href="<?= esc_url($a['ctaUrl']) ?>">
<?= esc_html($a['ctaLabel']) ?>
</a>
<?php endif; ?>
<InnerBlocks class="mt-4 p-4 border" />
</div>Escribe en PHP, Twig o Blade
Use el lenguaje de plantillas que conozca. PHP funciona desde el primer momento, Twig se ejecuta una vez instalado Timber, y Blade se ejecuta en illuminate/view 8 a 12 mediante Blockstudio\Blade_Renderer. Las variables, los componentes y el comportamiento son los mismos.
$a (atributos), $b (bloque), $c (contexto) y $innerBlocks están disponibles en todos los lenguajes.
Twig las plantillas también reciben el contexto completo de Timber. Blade también muestra páginas, patrones y plantillas del Editor del sitio. El wrapper antiguo de jenssegers/blade falla con illuminate/view 10 y versiones posteriores, así que use Blade_Renderer en su lugar.
<div useBlockProps class="card">
<RichText tag="h2" attribute="title" placeholder="Card title" />
{% if a.image %}
<img src="{{ a.image.url|esc_url }}"
alt="{{ a.image.alt|esc_attr }}" />
{% endif %}
<div class="card__body">{{ a.description|esc_html }}</div>
<InnerBlocks allowedBlocks='["core/button"]' />
</div><div useBlockProps class="card">
<RichText tag="h2" attribute="title" placeholder="Card title" />
@if ($a['description'])
<div class="card__body">{{ $a['description'] }}</div>
@endif
<InnerBlocks allowedBlocks='["core/button"]' />
</div>Lógica condicional y opciones dinámicas
Muestra y oculta campos con operadores como ==, !=, includes, empty y comparaciones. Combina condiciones con lógica OR.
Las opciones pueden depender de otro campo. Incluya {attributes.post_type.value} en los argumentos de populate y la lista se volverá a cargar cuando cambie ese campo. Añada fetch: true para buscar entradas mientras el editor escribe.
Comparta una lista de opciones entre bloques con type: custom y el filtro blockstudio/blocks/attributes/populate, y registre sus propias condiciones globales, como una comprobación de compra, mediante blockstudio/blocks/conditions.
{
"name": "starter/posts",
"title": "Posts",
"blockstudio": {
"attributes": [
{
"id": "post_type",
"type": "select",
"label": "Post type",
"options": [
{ "value": "page", "label": "Pages" },
{ "value": "post", "label": "Posts" }
]
},
{
"id": "selected_post",
"type": "select",
"label": "Post",
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "{attributes.post_type.value}" }
}
},
{
"id": "style",
"type": "select",
"label": "Style",
"populate": { "type": "custom", "custom": "cardStyles" },
"conditions": [[
{ "type": "purchasedProduct", "operator": "==", "value": "yes" }
]]
}
]
}
}add_filter('blockstudio/blocks/attributes/populate', function ($options) {
$options['cardStyles'] = [
['value' => 'light', 'label' => 'Light'],
['value' => 'dark', 'label' => 'Dark'],
];
return $options;
});
add_filter('blockstudio/blocks/conditions', function ($conditions) {
$conditions['purchasedProduct'] = user_has_purchased(123) ? 'yes' : 'no';
return $conditions;
});Repetidores fáciles de gestionar
Defina min y max, inicie los bloques nuevos con default filas y contraiga las filas existentes con minimized. textMinimized etiqueta una fila contraída con uno de sus propios campos, como un nombre.
Las filas admiten todos los tipos de campo excepto las pestañas, incluidos los repetidores anidados. Una condición dentro de una fila comprueba un campo externo con "context": "main", y <RichText /> y <MediaPlaceholder /> editan una sola fila cuando su attribute apunta a repeaterId[index].fieldId.
{
"name": "starter/team",
"title": "Team",
"blockstudio": {
"attributes": [
{
"id": "members",
"type": "repeater",
"label": "Team members",
"min": 1,
"max": 12,
"minimized": true,
"textMinimized": { "id": "name", "fallback": "Team member" },
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "bio", "type": "richtext", "label": "Bio" }
]
}
]
}
}<div useBlockProps class="team">
<?php foreach ($a['members'] as $index => $member): ?>
<article>
<h3><?= esc_html($member['name']) ?></h3>
<RichText
tag="p"
attribute="members[<?= $index ?>].bio"
placeholder="Short bio"
/>
</article>
<?php endforeach; ?>
</div>Conjuntos de campos reutilizables
Defina un grupo de campos una vez en un field.json y haga referencia a él desde cualquier bloque con "type": "custom/cta". Los campos se integran directamente, así que las plantillas los leen como cualquier otro atributo.
Use el mismo conjunto dos veces con un idStructure como hero_{id}, y cambie las etiquetas, los valores predeterminados o las condiciones de cada bloque con overrides. El tipo de campo block hace lo mismo con un bloque completo: expande sus campos directamente y devuelve su HTML renderizado.
{
"name": "cta",
"title": "Call to action",
"attributes": [
{ "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
{ "id": "url", "type": "link", "label": "Button URL" }
]
}{
"name": "starter/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{
"type": "custom/cta",
"idStructure": "secondary_{id}",
"overrides": {
"label": { "default": "Contact us" }
}
},
{
"id": "card",
"type": "block",
"block": "starter/card",
"idStructure": "card_{id}"
}
]
}
}Módulos ES sin proceso de compilación
Añade script.js y se carga como módulo ES. Importa paquetes de npm con el prefijo npm: y Blockstudio los descarga localmente para producción.
El editor ofrece una vista previa instantánea y el frontend usa módulos locales sin dependencias externas, que solo se encolan una vez.
Las hojas de estilo se importan de la misma manera. import "npm:swiper@11.0.0/swiper.min.css" descarga el archivo y lo encola una vez por versión, incluso cuando lo usan varios bloques.
import Swiper from "npm:swiper@11.0.0";
import "npm:swiper@11.0.0/swiper.min.css";
for (const el of document.querySelectorAll(".swiper")) {
new Swiper(el, {
slidesPerView: 3,
spaceBetween: 20,
loop: true,
});
}Etiquetas de bloque más allá de las plantillas
Asocie un prefijo corto a un espacio de nombres en blockstudio.json, o una etiqueta a un bloque con un filtro de alias, y <acme-card> renderizará acme/card. Active blockTags.enabled para renderizar etiquetas en el contenido de las entradas y los widgets, limitadas por los patrones allow y deny.
Los atributos de data-* llegan al elemento raíz del bloque, y los atributos de html-* llegan allí sin el prefijo. Añada sus propios generadores de etiquetas con blockstudio/block_tags/builders y convierta las formas abreviadas a la grafía portable <bs:acme-card> con el comando migrate-block-tags.
{
"blockTags": {
"enabled": true,
"prefixes": {
"acme": ["acme"],
"ui": ["acme-ui"]
},
"deny": ["acme-ui/admin-*"]
}
}<div useBlockProps class="acme-features">
<acme-card
title="Fast"
text="Rendered on the server."
data-track="card"
/>
<ui-button label="Get started" href="/start" html-id="start" />
</div>Tipos de campo personalizados
Registra tu propio control de campo y úsalo como uno integrado.
Bloques isla
Guarda en caché toda la página y genera un bloque durante la solicitud del visitante.
Registro condicional
Registre un bloque solo para un tipo de entrada, un perfil de usuario u otra condición global, o sáltelo si falta un plugin o la versión necesaria de un plugin.
Metadatos de entradas y opciones
Guarda valores en los metadatos de entradas o en opciones, junto con los atributos del bloque.
Lógica condicional
Muestra campos según sus valores mediante igualdad, inclusión, comprobación de valores vacíos y comparaciones.
Poblaciones dinámicas
Carga opciones desde entradas, usuarios, términos, funciones o API.
Sobrescrituras
Defina override: true con el nombre de un bloque compartido para combinar atributos por ID, reemplazar recursos con nombres de archivo coincidentes y cambiar la plantilla. Las plantillas de Twig pueden sobrescribir bloques individuales mediante extends.
Variantes
Declare variaciones en block.json que establezcan valores de campos y oculte con hidden el campo que las controla.
Componentes
Defina component: true para un bloque que solo se renderiza desde PHP o etiquetas de bloque. Conserva los campos, las plantillas, los recursos y Tailwind, pero nunca aparece en el insertador.
Reglas de InnerBlocks
Permita bloques con los tokens namespace/*, category: y @theme, cambie la plantilla interna desde una opción de selección y quite el wrapper en la interfaz pública con un filtro.
Recursos de campos de código
Un campo de código con asset: true convierte la entrada del editor en CSS, SCSS o JavaScript para ese bloque, limitado a la instancia mediante %selector%.
Recursos por nombre de archivo
*.view.js se carga solo en la interfaz pública, y los prefijos global-, admin- y block-editor- cargan un archivo en cada página, en wp-admin o en el editor de bloques.
Iconos y carpetas de bloques
Asigne a un bloque un icono SVG personalizado o HTML, cambie la ubicación de búsqueda con el filtro blockstudio/path y añada carpetas con Blockstudio\Build::init().
Valores de ACF y Meta Box
Las plantillas reciben $post_id, así que get_field() y rwmb_get_value() leen la entrada editada, y refreshOn vuelve a cargar la vista previa después de guardar.
Contexto de Query Loop
Dentro de un Query Loop, $block[‘context’][‘postId’] sigue el elemento actual, mientras que $block[‘postId’] sigue siendo la entrada que se está viendo.
WPML
wp bs wpml config escribe el wpml-config.xml que marca los campos de texto como traducibles, y las imágenes almacenadas en campos se incluyen en los trabajos de traducción de WPML con sus textos alternativos y leyendas.
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