Registro
Crear tus propios bloques con Blockstudio es muy sencillo. El plugin buscará una carpeta blockstudio en el tema que tengas activado. Se registrarán todas las subcarpetas que contengan un archivo block.json con una clave blockstudio.
block.json
{
"name": "blockstudio/native",
"title": "Native Block",
"category": "text",
"icon": "star-filled",
"description": "Native Blockstudio block.",
"blockstudio": true
}
Plantilla
Por ahora, el bloque personalizado no se registrará porque le falta una plantilla. Para solucionarlo, crea un index.php en la misma carpeta que tu archivo block.json; su contenido se renderizará automáticamente cuando se use el bloque.
<h1>My first native block.</h1>
Lógica condicional
Los bloques se pueden registrar de forma condicional mediante la clave conditions. Admite todas las variables globales que también están disponibles para los atributos.
El siguiente ejemplo solo registrará el bloque si el tipo de contenido actual es una página:
{
"blockstudio": {
"conditions": [
[
{
"type": "postType",
"operator": "==",
"value": "page"
}
]
]
}
}
Dependencias de plugins
Los bloques pueden depender de plugins WordPress activos mediante la clave pluginDependencies. Si alguno de los plugins indicados está inactivo, se omitirá el bloque durante el registro.
Las dependencias usan slugs de plugins WordPress:
{
"blockstudio": {
"pluginDependencies": [
"woocommerce",
"advanced-custom-fields"
]
}
}
Usa el formato de objeto para exigir una versión del plugin. Las restricciones de versión usan los mismos operadores que version_compare() de PHP; si no se indica un operador, se considera que la versión es >=.
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Icono personalizado
Los iconos SVG personalizados para bloques se pueden registrar así:
{
"blockstudio": {
"icon": "<svg></svg>"
}
}
WordPress no permite iconos SVG personalizados en su propia clave block.json icon; aquí solo se permiten IDs de Dashicons.
Bloques estándar de WordPress
Blockstudio también registra automáticamente los bloques estándar de WordPress que encuentra en tus directorios Blockstudio. Cualquier block.json sin clave blockstudio, pero con una propiedad name válida, se registra mediante el register_block_type() nativo de WordPress.
Esto significa que puedes colocar bloques generados con @wordpress/create-block directamente en tu carpeta blockstudio/ y se registrarán automáticamente junto con tus bloques Blockstudio. No hace falta código de registro de plugin independiente.
blockstudio/
├── hero/
│ ├── block.json ← Blockstudio block (has "blockstudio" key)
│ └── index.twig
├── my-js-block/
│ ├── block.json ← Standard WP block (no "blockstudio" key)
│ ├── index.js ← Compiled editor script
│ ├── index.css
│ ├── style-index.css
│ └── render.php
Crea tu bloque con npx wp-scripts build y luego coloca la carpeta de salida en tu directorio Blockstudio. Se registrará automáticamente.
Lo mismo ocurre con WordPress 7.0: los bloques solo de PHP: un block.json con soporte autoRegister y un render.php no necesitan scripts ni compilación, y se registran aquí como cualquier otro bloque estándar. Core limita esta opción a bloques simples con atributos de tipo cadena, entero, booleano y enumeración; cuando se necesitan bloques internos, texto enriquecido, medios o controles personalizados, se debe crear un bloque del lado del cliente o asignarle una clave blockstudio y seguir en PHP.
HTML
Blockstudio usa un analizador de elementos React para renderizar el elemento del icono, por lo que es posible usar HTML dentro de la cadena del icono.
{
"blockstudio": {
"icon": "<div>:-)</div>"
}
}
Rutas personalizadas
De forma predeterminada, Blockstudio buscará bloques recursivamente en la carpeta blockstudio del tema actual o tema hijo. Puedes cambiar este comportamiento de dos maneras.
Filtro
// Custom path within your theme.
add_filter('blockstudio/path', function () {
return get_template_directory() . '/blocks';
});
// Custom path within a plugin.
add_filter('blockstudio/path', function () {
return WP_PLUGIN_DIR . '/my-custom-plugin/blocks';
});
Para sistemas de archivos compuestos o virtuales, usa una fuente lógica de descubrimiento en lugar de añadir rutas independientes para el directorio principal y las capas superpuestas. Las fuentes lógicas permiten ocultar rutas individuales, heredar archivos hermanos, gestionar eliminaciones, conservar la identidad de la caché y registrar la procedencia. Consulta Fuentes lógicas de descubrimiento.
Instancias
Si las opciones anteriores no bastan, puedes inicializar la clase Blockstudio\Build en las carpetas que elijas:
add_action('init', function () {
Blockstudio\Build::init([
'dir' => get_template_directory() . '/client-blocks'
]);
});
Filtrar metadatos
Los metadatos se pueden filtrar antes de registrar el bloque mediante el filtro blockstudio/blocks/meta:
add_filter('blockstudio/blocks/meta', function ($meta, $block) {
if (str_starts_with($block['name'], 'marketing')) {
$meta['icon'] = 'megaphone';
}
return $meta;
}, 10, 2);
El ejemplo anterior se usa internamente para asignar el mismo icono a todos los elementos de la biblioteca Blockstudio.