Un développeur indépendant avec qui nous collaborons ponctuellement nous a demandé un accompagnement pour publier son premier thème sur le répertoire officiel WordPress.org. Sa première soumission, faite sans préparation particulière, a été retournée avec une douzaine de remarques de la Theme Review Team, l’équipe bénévole qui valide chaque thème avant publication. Ce texte reprend la checklist que nous avons construite pour la seconde soumission, acceptée sans nouvel aller-retour.
Ce guide ne couvre pas la publication d’extensions, dont le référentiel de revue diffère sensiblement de celui des thèmes.
Installer et faire tourner Theme Check
La première étape, avant même de songer à soumettre le thème, consiste à installer l’extension Theme Check, disponible sur le répertoire officiel des extensions, et à l’exécuter sur le thème complet. Elle scanne automatiquement le code à la recherche des erreurs les plus courantes relevées par la Theme Review Team, avec un rapport classé par gravité.
wp plugin install theme-check --activate --allow-root
# puis, depuis l'administration : Apparence > Theme CheckLes erreurs les plus fréquentes relevées
- Texte non traduisible : des chaînes de caractères visibles dans l’interface sans passer par
__(),_e()ouesc_html__()avec le bon domaine de texte. - Fonctions dépréciées : usage de fonctions retirées ou déconseillées, comme certains appels directs à des variables globales plutôt qu’aux fonctions d’API dédiées.
- Absence de fichier readme.txt correctement formaté, avec les en-têtes obligatoires (
Requires at least,Tested up to,License). - Scripts et styles non enregistrés via les fonctions dédiées : un
<link>ou un<script>codé en dur dans le template plutôt qu’enregistré viawp_enqueue_style()ouwp_enqueue_script(). - Fonctionnalités masquées derrière un mur payant dans une version prétendument gratuite, ce qui est explicitement interdit par les règles de la Theme Review Team.
La checklist de préparation complète
- Faire tourner Theme Check et corriger chaque remarque, même les avertissements de gravité faible.
- Vérifier que le thème ne charge aucune ressource distante (police, script) sans que l’utilisateur en soit informé, conformément aux exigences de confidentialité de la Theme Review Team.
- S’assurer que le thème fonctionne correctement avec les extensions désactivées, sans dépendance cachée non déclarée.
- Vérifier la licence de chaque ressource incluse (polices, images de démonstration) : elle doit être compatible avec la licence GPL du thème lui-même.
- Tester le thème avec
WP_DEBUGactivé et vérifier l’absence de tout avertissement ou notice PHP dans les journaux. - Rédiger un
readme.txtcomplet, avec une description claire et les en-têtes de version requis.
Préparer le ZIP de soumission
Un ZIP mal structuré fait perdre plusieurs semaines de délai, la revue elle-même n’ayant pas de date garantie compte tenu du volume traité par une équipe bénévole. Les erreurs de structure les plus fréquentes :
| Erreur de structure | Conséquence |
|---|---|
| Dossier racine du ZIP différent du slug du thème | Rejet automatique avant même la revue manuelle |
| Fichiers de développement inclus (node_modules, .git) | Poids inutile, parfois motif de rejet direct |
| Captures d’écran absentes ou mal nommées (screenshot.png) | Retour systématique demandant leur ajout |
Ne soumettez jamais un thème « pour voir ce que dira la revue ». Chaque cycle de va-et-vient avec la Theme Review Team se compte en semaines, pas en jours : une préparation rigoureuse en amont fait gagner bien plus de temps qu’elle n’en coûte.
Après l’acceptation
Une fois le thème accepté, chaque nouvelle version soumise via le système d’intégration continue de WordPress.org repasse par une vérification automatisée proche de celle de Theme Check, mais sans nouvelle revue humaine complète sauf changement majeur signalé. Cela impose de garder la même rigueur sur les mises à jour ultérieures, pas seulement sur la soumission initiale.
En résumé
La publication d’un thème sur WordPress.org repose sur un référentiel de règles publiques et exigeant, mais largement anticipable grâce à l’extension Theme Check et à une préparation méthodique du ZIP de soumission. La très grande majorité des retours de la Theme Review Team porte sur des points détectables en amont, sans attendre le verdict d’une revue humaine qui peut prendre plusieurs semaines.
