Patrones
Los patrones son plantillas basadas en archivos registradas como patrones de bloques de WordPress. Aparecen en el insertador de bloques y los usuarios pueden colocarlos en cualquier parte.
A diferencia de las páginas, los patrones se registran en memoria y no crean entradas en la base de datos.
pattern.json
Cada carpeta de patrones necesita un archivo de configuración pattern.json:
{
"name": "hero-section",
"title": "Hero Section",
"description": "A hero section with heading and CTA",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta"]
}
Propiedades
| Propiedad | Tipo | Predeterminado | Descripción |
|---|---|---|---|
name |
string |
obligatorio | Identificador único (con el prefijo blockstudio/) |
title |
string |
obligatorio | Título que se muestra en el insertador de bloques |
description |
string |
"" |
Descripción que se muestra en el insertador |
categories |
string[] |
[] |
Categorías del patrón (e.g., featured, header, footer) |
keywords |
string[] |
[] |
Palabras clave de búsqueda del insertador |
viewportWidth |
number |
– | Ancho de vista previa en píxeles |
blockTypes |
string[] |
[] |
Tipos de bloques asociados |
postTypes |
string[] |
[] |
Restringir a tipos de contenido específicos |
inserter |
boolean |
true |
Si se muestra en el insertador |
Ejemplo
pattern.json:
{
"name": "hero-with-cta",
"title": "Hero with CTA",
"description": "A full-width hero section with heading and call-to-action buttons",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta", "landing"],
"viewportWidth": 1200
}
index.php:
<block name="core/cover" url="https://example.com/hero-bg.jpg" dimRatio="60">
<h1>Build Something Amazing</h1>
<p>Create beautiful websites with the power of blocks.</p>
<block name="core/buttons">
<block name="core/button" url="/get-started">Get Started</block>
<block name="core/button" url="/learn-more" className="is-style-outline">Learn More</block>
</block>
</block>
Rutas personalizadas
De forma predeterminada, Blockstudio busca en get_template_directory() . '/patterns'. Añada otras rutas con el filtro:
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
Las integraciones de ejecución que componen archivos desde varias raíces pueden reemplazar la búsqueda del sistema de archivos por una fuente de descubrimiento lógica. Los manifiestos de patrones y las plantillas de origen se resuelven a partir del inventario lógico visible final.
PHP API
// Get all registered patterns
$patterns = Blockstudio\Patterns::patterns();
// Get a specific pattern
$pattern = Blockstudio\Patterns::get_pattern('hero-section');
// Get registered paths
$paths = Blockstudio\Patterns::get_registered_paths();
Comparación con las páginas
| Aspecto | Páginas | Patrones |
|---|---|---|
| Almacenamiento | Sincronizadas con la base de datos como entradas | Registrados en memoria |
| Configuración | page.json |
pattern.json |
| Sincronización | Explícita, con wp bs pages sync |
No se necesita sincronización |
| Bloqueo de plantilla | Sí | No |
| Caso de uso | Contenido de página predefinido | Plantillas de bloques reutilizables |