Construction de thèmes WordPress
L'objectif est un thème où le design est figé dans le code et le contenu est modifiable dans l'éditeur. Le texte codé en dur dans les templates est la raison la plus fréquente pour laquelle les clients reviennent pour des modifications triviales.
Choisir l'approche
| Approche | Choisir quand |
|---|---|
Thème bloc (theme.json, templates HTML) | Nouveau projet, le client modifie dans l'éditeur de site, le contenu est principalement constitué de blocs standard |
Thème classique hybride (templates PHP plus theme.json et patterns de blocs) | Balisage personnalisé complexe ou animation lourde nécessitant un contrôle HTML précis |
| Thème enfant | Modification d'un thème existant ; ne jamais modifier un thème parent directement, car les mises à jour l'écrasent |
Pour les sites marketing animés et axés sur le design, l'approche hybride est généralement pragmatique : balisage précis en PHP, contenu éditable via des patterns, des champs et l'éditeur de blocs.
Structure minimale
mon-theme/
├── style.css # en-tête de commentaire du thème (obligatoire)
├── functions.php # configuration, optimisations, enregistrements
├── theme.json # palette, échelle typographique, espacement, largeurs de mise en page
├── index.php # template de secours (classique/hybride)
├── front-page.php # page d'accueil
├── header.php footer.php
├── template-parts/ # un fichier par section
├── patterns/ # patterns de blocs (enregistrés automatiquement)
├── assets/css assets/js assets/media
└── screenshot.png # 1200x900
En-tête de style.css :
/*
Theme Name: Mon Thème
Author: Votre Nom
Version: 1.0.0
Requires at least: 6.4
Requires PHP: 8.0
Text Domain: mon-theme
*/
Flux de travail de conversion
- Geler la version statique. Terminez d'abord le HTML, CSS et JS et validez-le. Convertir une cible mouvante double le travail.
- Diviser en parties. L'en-tête et le pied de page vont dans
header.phpetfooter.phpavecwp_head()etwp_footer(). Chaque section de la page d'accueil devient un fichier danstemplate-parts/, chargé avecget_template_part(). - Déplacer les tokens dans
theme.json(palette, tailles de police, espacement, largeur de contenu) afin que l'éditeur affiche les mêmes choix que le front-end. Conservez les mêmes valeurs que les propriétés personnalisées CSS ; WordPress génère des variables--wp--preset--*que vous pouvez aliaser. Si la CLIwebcraftest disponible,webcraft tokens "#brand" --format theme-json -o theme.jsonécrit un fichier version 3 à partir des mêmes valeurs quetokens.css. - Optimiser, ne jamais coder en dur, les ressources :
add_action('wp_enqueue_scripts', function () {
$v = wp_get_theme()->get('Version');
$uri = get_theme_file_uri('assets');
wp_enqueue_style('mon-theme', "$uri/css/main.css", [], $v);
wp_enqueue_script('gsap', "$uri/js/vendor/gsap.min.js", [], '3', ['strategy' => 'defer', 'in_footer' => true]);
wp_enqueue_script('mon-theme', "$uri/js/main.js", ['gsap'], $v, ['strategy' => 'defer', 'in_footer' => true]);
});
Regroupez les bibliothèques localement plutôt que via un CDN lorsque c'est possible ; cela évite une requête tierce et une question de consentement. 5. Rendre le contenu modifiable. Choisissez par section :
- Éléments répétés avec leurs propres pages (services, portfolio, témoignages) : un type de publication personnalisé interrogé avec
WP_Query. - Texte et images de section ponctuels : patterns de blocs que le client insère et modifie, ou champs personnalisés.
- Éléments globaux (téléphone, liens sociaux, texte de pied de page) : le Customizer ou une petite page d'options.
- Navigation :
register_nav_menus()etwp_nav_menu().
- Échapper tout ce qui est affiché :
esc_html(),esc_attr(),esc_url(),wp_kses_post()pour le texte enrichi. Enveloppez les chaînes avec__()ouesc_html__()avec le domaine de texte. - Images : utilisez
wp_get_attachment_image()pour quesrcset,sizes, les dimensions et le chargement paresseux soient générés. Enregistrez les tailles nécessaires avecadd_image_size(). - Supports du thème :
title-tag,post-thumbnails,editor-styles,responsive-embeds,html5,wp-block-styles.
Animation dans WordPress
- Les scripts qui masquent du contenu ne doivent pas s'exécuter dans l'éditeur de blocs. Optimisez-les uniquement côté front-end (
wp_enqueue_scripts, pasenqueue_block_assets). - La barre d'administration décale les en-têtes fixes de 32px (46px sur mobile) ; compensez avec
body.admin-bar .header { top: var(--wp--admin--bar--height, 32px); }. - Les plugins de mise en cache et d'optimisation qui diffèrent ou combinent du JS peuvent casser l'ordre de chargement. Déclarez correctement les dépendances pour qu'elles soient respectées, et testez avec le plugin activé.
- Le contenu ajouté dans l'éditeur n'aura pas vos attributs d'animation. Appliquez les animations par classe de bloc en JS, ou fournissez des patterns qui incluent les attributs.
À ne pas faire
- Modifier le cœur de WordPress ou un thème parent.
- Mettre une fonctionnalité qui doit survivre à un changement de thème (types de publication personnalisés, shortcodes) dans le thème si le client peut changer de thème ; un petit plugin est l'endroit approprié.
- Interroger à l'intérieur de boucles sans réinitialiser (
wp_reset_postdata()). - Livrer avec des notifications
WP_DEBUG. Développez avecWP_DEBUGactivé. - Regrouper des plugins payants ou des ressources dont la licence n'autorise pas la redistribution.
Checklist de remise
- Le client peut modifier chaque texte, image, élément de menu et détail de contact visible sans toucher au code.
- Page d'accueil définie dans Réglages, Lecture ; permaliens définis sur le nom de l'article.
- Favicon (icône du site), template 404, template de recherche, page de confidentialité présent.
- Un guide d'édition d'une page avec captures d'écran.
- Exécutez ensuite le skill
launch-qa.