Aller au contenu

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 :

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:

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>

Chemins personnalisés

Par défaut, Blockstudio analyse get_template_directory() . '/patterns'. Ajoutez des chemins supplémentaires avec le filtre :

PHP
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

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

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