Pular para o conteúdo

Padrões

Padrões são modelos baseados em arquivos, registrados como padrões de blocos WordPress. Eles aparecem no inseridor de blocos e podem ser inseridos em qualquer lugar pelos usuários.

Ao contrário das páginas, os padrões são registrados em memória e não criam entradas no banco de dados.

pattern.json

Cada pasta de padrão precisa de um arquivo de configuração pattern.json:

JSON
{
  "name": "hero-section",
  "title": "Hero Section",
  "description": "A hero section with heading and CTA",
  "categories": ["featured", "header"],
  "keywords": ["hero", "banner", "cta"]
}

Propriedades

Propriedade Tipo Padrão Descrição
name string obrigatório Identificador exclusivo (com prefixo blockstudio/)
title string obrigatório Título exibido no inseridor de blocos
description string "" Descrição exibida no inseridor
categories string[] [] Categorias do padrão (e.g., featured, header, footer)
keywords string[] [] Palavras-chave para pesquisa no inseridor
viewportWidth number – Largura da pré-visualização em pixels
blockTypes string[] [] Tipos de bloco associados
postTypes string[] [] Restringe a tipos específicos de publicação
inserter boolean true Se deve aparecer no inseridor

Exemplo

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>

Caminhos personalizados

Por padrão, Blockstudio examina get_template_directory() . '/patterns'. Adicione outros caminhos com o filtro:

PHP
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
    $paths[] = get_stylesheet_directory() . '/custom-patterns';
    $paths[] = MY_PLUGIN_PATH . '/patterns';
    return $paths;
} );

Integrações de execução que reúnem arquivos de várias raízes podem substituir a varredura do sistema de arquivos por uma fonte de descoberta lógica. Os manifestos de padrões e os modelos de origem são resolvidos a partir do inventário lógico final visível.

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();

Comparação com páginas

Aspecto Páginas Padrões
Armazenamento Sincronizados com o banco de dados como publicações Registrados em memória
Configuração page.json pattern.json
Sincronização Explícita, com wp bs pages sync Não é necessária
Bloqueio de modelo Sim Não
Caso de uso Conteúdo de página predefinido Modelos de bloco reutilizáveis