# 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.

[Referencia de tipos de campo](https://blockstudio.dev/es/docs/blocks/attributes/field-types/)

block.json

```
{
  "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.

[Explorar componentes](https://blockstudio.dev/es/docs/blocks/react-components/)

index.php

```
<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.

[Lenguajes de plantillas](https://blockstudio.dev/es/docs/blocks/templating/blade/)

index.twig

```
<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>
```

## 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`.

[Lógica condicional](https://blockstudio.dev/es/docs/blocks/attributes/conditional-logic/)

block.json

```
{
  "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" }
        ]]
      }
    ]
  }
}
```

## 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`.

[Patrones de repetidores](https://blockstudio.dev/es/guides/field-patterns/#repeater-patterns)

block.json

```
{
  "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" }
        ]
      }
    ]
  }
}
```

## 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.

[Campos personalizados](https://blockstudio.dev/es/docs/blocks/attributes/custom-fields/)

fields/cta/field.json

```
{
  "name": "cta",
  "title": "Call to action",
  "attributes": [
    { "id": "label", "type": "text", "label": "Button label", "default": "Learn more" },
    { "id": "url", "type": "link", "label": "Button URL" }
  ]
}
```

## 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.

[Procesamiento de recursos](https://blockstudio.dev/es/docs/blocks/assets/)

script.js

```
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`.

[Leer la guía](https://blockstudio.dev/es/guides/block-tags/)

blockstudio.json

```
{
  "blockTags": {
    "enabled": true,
    "prefixes": {
      "acme": ["acme"],
      "ui": ["acme-ui"]
    },
    "deny": ["acme-ui/admin-*"]
  }
}
```

## 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.

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

[Obtener Plus](https://blockstudio.dev/es/plus/)
