Motifs
Les motifs sont des modèles basés sur des fichiers, enregistrés comme motifs de blocs WordPress. Ils apparaissent dans l’outil d’insertion de blocs et les utilisateurs peuvent les placer n’importe où.
Contrairement aux pages, les motifs sont enregistrés en mémoire et ne créent pas d’entrées dans la base de données.
pattern.json
Chaque dossier de motif nécessite un fichier de configuration pattern.json :
{
"name": "hero-section",
"title": "Hero Section",
"description": "A hero section with heading and CTA",
"categories": ["featured", "header"],
"keywords": ["hero", "banner", "cta"]
}
Propriétés
| Propriété | Type | Valeur par défaut | Description |
|---|---|---|---|
name |
string |
obligatoire | Identifiant unique (préfixé par blockstudio/) |
title |
string |
obligatoire | Titre affiché dans l’outil d’insertion de blocs |
description |
string |
"" |
Description affichée dans l’outil d’insertion |
categories |
string[] |
[] |
Catégories de motifs (e.g, featured, header, footer) |
keywords |
string[] |
[] |
Mots-clés de recherche dans l’outil d’insertion |
viewportWidth |
number |
– | Largeur de prévisualisation en pixels |
blockTypes |
string[] |
[] |
Types de blocs associés |
postTypes |
string[] |
[] |
Limitation à certains types de publication |
inserter |
boolean |
true |
Affichage ou non dans l’outil d’insertion |
Exemple
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>
Chemins personnalisés
Par défaut, Blockstudio analyse get_template_directory() . '/patterns'. Ajoutez des chemins supplémentaires avec le filtre :
add_filter( 'blockstudio/patterns/paths', function( $paths ) {
$paths[] = get_stylesheet_directory() . '/custom-patterns';
$paths[] = MY_PLUGIN_PATH . '/patterns';
return $paths;
} );
Les intégrations d’exécution qui composent des fichiers provenant de plusieurs racines peuvent remplacer l’analyse du système de fichiers par une source de découverte logique. Les manifestes de motifs et les modèles source sont résolus à partir de l’inventaire logique final visible.
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();
Comparaison avec les pages
| Aspect | Pages | Motifs |
|---|---|---|
| Stockage | Synchronisés dans la base de données en tant que publications | Enregistrés en mémoire |
| Configuration | page.json |
pattern.json |
| Synchronisation | Explicite, avec wp bs pages sync |
Aucune synchronisation nécessaire |
| Verrouillage du modèle | Oui | Non |
| Cas d’utilisation | Contenu de page prédéfini | Modèles de blocs réutilisables |