Communitygithub.com

wordpress-theme-build

Transformez un design statique HTML/CSS/JS en un thème WordPress personnalisé que le client peut modifier. Couvre la structure du thème, theme.json, l'optimisation des scripts, les blocs patterns, les types de publication personnalisés et le contenu éditable. Utilisez-le à chaque fois que quelqu'un souhaite convertir un design ou un site statique en WordPress, construire un thème personnalisé ou bloc, rendre des sections modifiables dans Gutenberg, ajouter GSAP ou d'autres scripts correctement, ou demande pourquoi ses modifications de thème sont perdues ou son contenu est codé en dur.

Qu'est-ce que wordpress-theme-build ?

Ce skill guide la conversion d'un design statique (HTML/CSS/JS) en un thème WordPress fonctionnel, en mettant l'accent sur une séparation claire entre design et contenu éditable. Il décrit trois approches principales : thème bloc (via theme.json et templates HTML), thème classique hybride (templates PHP avec theme.json et patterns) et thème enfant. Le flux de travail de conversion inclut le gel de la version statique, la découpe en fichiers modèles (header, footer, sections), le déplacement des tokens de design (couleurs, polices, espacements) dans theme.json, l'optimisation correcte des scripts, et la mise en place du contenu éditable via types de publication personnalisés, patterns, champs personnalisés, etc. Le skill fournit également des conseils sur l'animation (GSAP, défilement), la gestion des dépendances, l'échappement des sorties, et une checklist de remise au client. Il est compatible avec les environnements de développement WordPress standard (CLI, Webcraft, IDE).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/wordpress-theme-build

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

ApprocheChoisir 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 enfantModification 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

  1. Geler la version statique. Terminez d'abord le HTML, CSS et JS et validez-le. Convertir une cible mouvante double le travail.
  2. Diviser en parties. L'en-tête et le pied de page vont dans header.php et footer.php avec wp_head() et wp_footer(). Chaque section de la page d'accueil devient un fichier dans template-parts/, chargé avec get_template_part().
  3. 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 CLI webcraft est disponible, webcraft tokens "#brand" --format theme-json -o theme.json écrit un fichier version 3 à partir des mêmes valeurs que tokens.css.
  4. 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() et wp_nav_menu().
  1. Échapper tout ce qui est affiché : esc_html(), esc_attr(), esc_url(), wp_kses_post() pour le texte enrichi. Enveloppez les chaînes avec __() ou esc_html__() avec le domaine de texte.
  2. Images : utilisez wp_get_attachment_image() pour que srcset, sizes, les dimensions et le chargement paresseux soient générés. Enregistrez les tailles nécessaires avec add_image_size().
  3. 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, pas enqueue_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 avec WP_DEBUG activé.
  • 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.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

design-tokens

Create a website's visual system as CSS custom properties, covering color palette, typography scale, spacing, radius and shadows, with contrast checked. Use this whenever someone asks for a color scheme, a palette from one brand color, font pairing, a type scale, "make it look consistent", dark mode, a rebrand of an existing site into new colors, or starts a build with no defined styles.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

launch-qa

Run a pre-launch quality check on a website covering performance, accessibility, SEO basics, forms, cross-device behavior and content, and report findings ranked by severity with fixes. Use this whenever someone says a site is "ready to launch", "going live", asks "can you check my site", wants a QA pass, a website audit, a Lighthouse-style review, or wants to know why a page is slow or scoring badly.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

Skills associés