Guide complet : Publier et maintenir un plugin sur WordPress.org
Ce guide vous accompagne pas à pas, de la préparation initiale de votre code jusqu’à la publication des mises à jour, en passant par la gestion des visuels.
1. La préparation et la soumission initiale
Avant d’envoyer votre code à WordPress.org, votre extension doit respecter quelques règles de base :
- Fichier principal PHP : Il doit contenir un en-tête d’informations standard.
- Fichier
readme.txt: Il fournit la description, les consignes d’installation et la gestion des versions selon la syntaxe WordPress.
Étape 1 : Demande de validation
- Créez un compte sur WordPress.org.
- Rendez-vous sur la page de Soumission d’extension.
- Envoyez votre fichier
.zipcontenant l’extension. - L’équipe d’examen de WordPress va analyser votre code (comptez quelques jours d’attente).
Une fois l’extension approuvée, vous recevrez un e-mail confirmant l’accès à votre dépôt SVN officiel (avec l’URL de votre slug).
2. Configuration des outils SVN (Windows & macOS)
WordPress utilise Subversion (SVN) pour la gestion du code et des visuels.
Sur Windows
Le moyen le plus simple est d’utiliser un client graphique :
- Téléchargez et installez TortoiseSVN.
- Créez un dossier sur votre ordinateur (ex:
MonPlugin-SVN). Vous pouvez faire un dossier de type « Plugin WP » si vous comptez en faire plusieurs. - Faites un clic droit sur ce dossier et sélectionnez SVN Checkout….
- Dans URL of repository, entrez l’URL fournie par WordPress (
[https://plugins.svn.wordpress.org/mon-plugin-slug](https://plugins.svn.wordpress.org/mon-plugin-slug)). - Cliquez sur OK.
Sur macOS
Vous pouvez utiliser le Terminal (avec un outil comme MacPorts ou un binaire SVN) ou un client graphique (comme SnailSVN Lite sur le Mac App Store) :
- Créez un dossier de travail.
- Dans le Terminal, allez dans ce dossier et exécutez la commande :
svn checkout https://plugins.svn.wordpress.org/mon-plugin-slug
Dans les deux cas, vous obtiendrez trois dossiers principaux :
trunk/: Contient le code source principal de l’extension.tags/: Contient les versions figées de votre code (ex:1.0.0,1.0.1).assets/: Contient les bannières, icônes et captures d’écran.
3. Publier la première version
Étape 1 : Placer le code dans trunk
Copiez vos fichiers source (mon-plugin.php, readme.txt, dossiers CSS/JS, etc.) à l’intérieur du dossier trunk/.
Étape 2 : Envoyer le code (Commit)
- Sur Windows (TortoiseSVN) :
- Clic droit sur le dossier
trunk> TortoiseSVN > Add…. - Clic droit sur le dossier principal > SVN Commit….
- Indiquez un message (ex: « Première publication ») et validez avec vos identifiants WordPress.org.
- Clic droit sur le dossier
- Sur macOS (Terminal) :
cd /chemin/vers/dossier-du-pluginsvn add trunk/* --forcesvn commit -m "Première version stable du plugin"
4. Personnaliser la fiche (Bannières & Icônes)
Les visuels graphiques se placent dans le dossier assets/ (et non dans trunk).
Formats d’images recommandés :
icon-128x128.png: L’icône affichée dans les recherches.banner-728x90.png: La bannière d’en-tête de la page de l’extension.screenshot-1.png,screenshot-2.png: Captures d’écran montrant l’extension.
Associer les captures d’écran dans readme.txt :
Dans votre fichier trunk/readme.txt, ajoutez la section suivante :
Plaintext
== Screenshots ==
1. Aperçu de la fonctionnalité principale sur le site public.
2. Interface de réglages dans l'administration WordPress.
Envoyer les visuels :
- Windows : Clic droit sur
assets> TortoiseSVN Add…, puis SVN Commit. - macOS :
svn add assets/* --forcesvn commit -m "Ajout des éléments graphiques"
5. Publier une mise à jour de code
Une fois votre plugin validé sur WordPress.org, il n’y a plus besoin de passer par une validation manuelle pour publier des mises à jour.
Pour publier une nouvelle version (par exemple 1.0.1) :
- Mettre à jour la version dans les fichiers :
- Dans le fichier PHP principal :
Version: 1.0.1 - Dans
trunk/readme.txt:Stable tag: 1.0.1
- Dans le fichier PHP principal :
- Mettre à jour le dossier
trunk: Remplacez les fichiers modifiés danstrunk/. - Créer une copie d’archivage (Tag) :
- Windows : Clic droit sur
trunk> TortoiseSVN > Branch/tag… > Régler le chemin vers/tags/1.0.1/. - macOS :
svn copy trunk tags/1.0.1
- Windows : Clic droit sur
- Envoyer la mise à jour :
svn commit -m "Mise à jour vers la version 1.0.1"
Dès la validation du commit, les serveurs de WordPress.org détecteront le nouveau numéro de version et proposeront automatiquement la mise à jour aux utilisateurs !