Le readme.txt d’un thème : la checklist d’un premier envoi sur WordPress.org

« Un thème doit inclure un fichier readme.txt correctement formaté avant d’être accepté dans le répertoire. » Cette exigence, présente dans les recommandations officielles pour les thèmes, semble évidente une fois lue, mais elle génère pourtant une part importante des refus lors d’un premier envoi, souvent pour des détails de formatage plutôt que pour un problème de fond.

Voici une checklist commentée, pensée pour un développeur qui prépare sa première soumission, afin d’éviter les allers-retours les plus courants avec l’équipe de revue.

1. L’en-tête générale

Le fichier commence par une série de champs sur des lignes séparées, avant la première ligne vide qui marque la fin de l’en-tête.

=== Nom du thème ===
Contributors: monpseudo
Tags: blog, e-commerce, two-columns, custom-colors
Requires at least: 5.8
Tested up to: 5.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

• Le champ Tags ne doit contenir que des mots-clés reconnus par le répertoire, pas de termes libres inventés.
• Le champ Stable tag doit correspondre exactement à la version déclarée dans l’en-tête de style.css.
• Le champ Tested up to doit refléter une version de WordPress réellement testée avant l’envoi, pas une supposition optimiste.

2. La description

Juste après l’en-tête, un court paragraphe de présentation du thème est attendu, rédigé de façon neutre, sans superlatifs commerciaux excessifs ni comparaison directe avec d’autres thèmes du répertoire.

3. La section Changelog

Même pour une première soumission, une entrée de changelog est exigée, avec la version et la date de publication.

== Changelog ==

= 1.0.0 =
* Version initiale.

4. La section Ressources et licences

C’est ici que se concentre la majorité des refus constatés lors d’un premier envoi. Toute police, image, icône ou bibliothèque tierce incluse dans le thème doit être listée avec sa source et sa licence exacte, y compris pour des ressources considérées comme « libres de droits ».

== Resources ==

Photo d'en-tête par défaut, exemple-photo.jpg,
Copyright Auteur Exemple, licence CC0 1.0,
https://exemple-source-libre.test/photo-123

Une ressource dont la licence n’autorise pas explicitement la redistribution commerciale, ou dont la source n’est pas vérifiable, entraîne un refus quasi systématique, même si le reste du thème respecte parfaitement les recommandations techniques.

5. Ce que Theme Check contrôle automatiquement

L’extension officielle Theme Check, recommandée avant tout envoi, signale les incohérences les plus fréquentes entre le readme.txt et le reste du thème :

1. Version incohérente entre style.css et le champ Stable tag.
2. Absence de licence déclarée pour une ressource visiblement tierce détectée dans le dossier du thème.
3. Balises de tags non reconnues dans le champ Tags.
4. Absence de la section Changelog, même minimale.

Un conseil qui évite bien des refus : traiter le readme.txt avec autant de sérieux que le code lui-même, en particulier la section des ressources, qui reste le point le plus souvent négligé par les développeurs pressés de soumettre leur travail.

En résumé

Le readme.txt n’est pas une formalité annexe : c’est un document vérifié rigoureusement lors de la revue humaine et automatisée d’un thème soumis au répertoire officiel. Soigner chaque champ, en particulier la déclaration précise des ressources incluses, réduit considérablement le nombre d’allers-retours nécessaires avant une première acceptation.