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 |