Saltar al contenido

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:

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:

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:

HTML
<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:

PHP
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

PHP
// 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