Un développeur indépendant nous a contactés, un peu désabusé : son thème avait passé la revue technique du répertoire officiel WordPress.org sans difficulté particulière, le code respectait scrupuleusement les standards de codage recommandés, mais les téléchargements restaient désespérément proches de zéro plusieurs mois après la publication. La question n’était pas technique, elle était éditoriale : comment présenter un thème pour qu’il soit réellement trouvé et choisi parmi des milliers d’alternatives.
Après avoir accompagné plusieurs auteurs de thèmes sur ce point précis, un constat revient systématiquement : la qualité technique conditionne l’acceptation dans le répertoire, mais c’est la présentation de la fiche qui conditionne le téléchargement. Ce sont deux problèmes différents, qui demandent des efforts différents.
Le screenshot.png, premier filtre visuel
Le fichier screenshot.png, placé à la racine du thème et affiché en vignette dans les résultats de recherche du répertoire, est l’élément qui détermine si un utilisateur va cliquer sur la fiche ou passer au résultat suivant. Un screenshot flou, mal cadré, ou qui ne montre qu’un bloc de texte sans structure visuelle claire, élimine le thème avant même que sa description ne soit lue.
Les captures qui fonctionnent le mieux, d’après nos observations sur plusieurs thèmes accompagnés, montrent une mise en page complète et reconnaissable au premier coup d’œil : en-tête, contenu structuré, pied de page, plutôt qu’un gros plan sur un seul élément décoratif du thème.
La description : des mots-clés pensés pour la recherche

Le champ description de la fiche, rédigé dans le fichier readme.txt du thème selon le format standardisé, doit intégrer naturellement les termes que les utilisateurs tapent réellement dans le champ de recherche du répertoire : type de site visé (« thème blog », « thème portfolio »), fonctionnalité distinctive (« thème bloc », « compatible WooCommerce »), plutôt qu’un discours marketing générique sans mots-clés identifiables.
- Le titre du thème doit rester court et mémorable, la description peut développer les cas d’usage précis.
- Les tags déclarés dans
readme.txt(baliseTags:) influencent directement l’apparition du thème dans les filtres de recherche par fonctionnalité du répertoire. - Une description qui répète le nom du thème sans expliquer à qui il s’adresse ne donne aucune prise à la recherche par mot-clé.
La fréquence de mise à jour, signal de confiance et de classement
Le répertoire officiel affiche la date de dernière mise à jour d’un thème directement sur sa fiche, un indicateur que les utilisateurs expérimentés vérifient systématiquement avant d’installer quoi que ce soit. Un thème non mis à jour depuis plus d’un an, même parfaitement fonctionnel, inspire une méfiance légitime. Au-delà de la confiance utilisateur, une activité de mise à jour régulière influence également, dans une certaine mesure, le classement de recherche interne du répertoire, qui valorise les thèmes activement maintenus.
Un thème irréprochable techniquement mais présenté comme un projet abandonné dans sa fiche se comporte, aux yeux des utilisateurs, exactement comme un projet abandonné.
Checklist avant publication d’une fiche
Voici, dans l’ordre où nous les appliquons désormais avec les auteurs de thèmes accompagnés, les vérifications à faire avant chaque publication de version sur le répertoire :
- Le
screenshot.pngmontre-t-il une mise en page complète et reconnaissable, pas un simple détail décoratif isolé ? - Le champ
Tags:dureadme.txtcouvre-t-il les termes de recherche réellement utilisés par la cible visée, sans excès de mots-clés hors sujet ? - La description mentionne-t-elle explicitement à qui s’adresse le thème (type de site, secteur), pas seulement ce qu’il permet techniquement ?
- La date de dernière mise à jour affichée sur la fiche date-t-elle de moins de six mois ?
- Le changelog du
readme.txtreflète-t-il des évolutions réelles, pas uniquement des corrections mineures répétées sans explication ?
Ce qui ne joue pas, contrairement à une idée reçue
Contrairement à une croyance répandue chez certains auteurs de thèmes, la quantité de fonctionnalités listées dans la description n’a que peu d’effet si elle n’est pas accompagnée d’un screenshot qui les rend visibles et crédibles. Une liste de fonctionnalités sans preuve visuelle immédiate se lit comme une promesse marketing, pas comme un fait vérifiable, et convertit nettement moins bien qu’une capture qui montre concrètement le résultat.
Ce qui a changé après ces ajustements
Sur le thème du développeur mentionné en introduction, le remplacement du screenshot par une mise en page plus représentative, la réécriture de la description avec des mots-clés ciblés, et une reprise du rythme de mise à jour ont suffi à faire progresser sensiblement les téléchargements dans les semaines suivantes, sans aucune modification du code du thème lui-même.
Pour aller plus loin
Passer la revue technique du répertoire WordPress.org est une condition nécessaire mais pas suffisante pour qu’un thème trouve son public. La fiche de présentation — screenshot, description, régularité des mises à jour — relève d’un travail éditorial distinct du travail de développement, trop souvent négligé par des auteurs de thèmes pourtant rigoureux sur le code.