Comment soumettre des plugins au référentiel WordPress.org

L'hébergement d'un plugin sur le référentiel WordPress.org est l'un des moyens les plus populaires (et les plus efficaces) de démarrer une entreprise freemium prospère. Si c'est la première fois que vous soumettez un plugin au référentiel, certaines des étapes peuvent être peu claires ou déroutantes, c'est pourquoi j'ai décrit le processus pour vous guider. Je vous recommande également de mettre cette page en signet si vous avez besoin de la référencer à l'avenir.

Préparation de la soumission

Tout d'abord, vous devez obtenir l'approbation de l'équipe de révision du plugin pour héberger votre produit sur le référentiel. Pour cela, vous devez avoir un compte sur WordPress.org. Vous n'en avez pas ? Pas de soucis, vous pouvez vous inscrire ici.

Création du fichier Readme.txt du plugin

Ensuite, vous devez créer un fichier readme.txt au format Markdown qui sera utilisé pour la page de liste de votre plugin sur WordPress.org. Il doit contenir les informations suivantes :

• Nom du plug-in
• Contributeurs (votre ID utilisateur WordPress.org)
• Balises de plug-in
• Nécessite au moins (version WordPress)
• Testé jusqu'à (version WordPress)
• Balise stable (version plug-in)
• Licence (GPLv2 ou ultérieure)
• URI de la licence : www.gnu.org/licenses/gpl-2.0.html
• Description (description complète de votre plugin)
• FAQ
• Captures d'écran
• Journal des modifications

Pour référence, voici un modèle de fichier readme.txt standard.

Pour vous assurer que vous avez correctement formaté et structuré le fichier readme.txt de votre plugin, utilisez le WordPress Readme Validator.

Choisissez soigneusement le nom de votre plugin

Il est important que vous preniez le temps de choisir le « bon » nom de plug-in avant la soumission initiale, car cela aura un impact sur l'URL de la liste de votre plug-in, ce qui a un impact sur le référencement de votre page WordPress.org et, éventuellement, sur l'exposition et la croissance organiques du plug-in.

Voici la section pertinente couvrant l'impact du nom depuis la page de soumission du plugin :

L'URL de votre plugin sera renseignée en fonction de la valeur du Plugin Name dans votre fichier de plugin principal (celui avec les en-têtes de plugin). Si vous définissez le vôtre comme Plugin Name: Boaty McBoatface alors votre URL sera https://wordpress.org/plugins/boaty-mcboatface et votre slug sera boaty-mcboatface par exemple. S'il existe un plugin existant avec votre nom, alors vous serez boaty-mcboatface-2 , et ainsi de suite. Il se comporte exactement comme les noms de publication WordPress.

Ainsi, lorsque vous choisissez le nom initial, pensez à l'optimiser pour le référencement plutôt que pour l'image de marque. Demandez-vous quels mots-clés vous souhaitez cibler et extrapolez-en le nom. Vous pouvez trouver quelques conseils de nommage ici.

N'oubliez pas que vous pouvez toujours changer le nom du plugin après la soumission initiale - donc même si vous choisissez un nom que vous n'aimez pas, vous pouvez le changer plus tard (et autant de fois que vous le souhaitez). Ce que vous ne pouvez pas changer, c'est le slug du plugin, par conséquent, le nom initial est important.

Notez également que le slug est créé à partir du nom du plugin dans votre fichier de plugin principal, qui peut être différent de la valeur du nom du plugin dans le fichier readme.txt.

Soumettre votre plugin

Une fois que vous avez choisi un bon nom de référencement - et que votre plugin et votre fichier readme.txt sont prêts - rendez-vous sur la page Ajouter votre plugin et soumettez-le pour examen.

Le processus de révision est manuel et peut prendre de 1 à 10 jours, selon la file d'attente de révision et la complexité de votre plugin. Si des problèmes sont détectés, vous recevrez un e-mail détaillant ces problèmes et comment vous pouvez les résoudre.

Une fois les problèmes résolus (le cas échéant), vous recevrez une approbation par e-mail. Votre plugin n'est pas public à ce stade, mais vous pouvez toujours télécharger, modifier et supprimer des fichiers via la ligne de commande ou un client SVN.

Astuce : Pour vous assurer de ne pas manquer d'e-mails importants, je vous recommande de mettre sur liste blanche [email protected] , l'adresse e-mail utilisée par l'équipe de révision des plugins WordPress.org pour communiquer avec les développeurs de plugins.

Téléchargement du plug-in

Maintenant que vous avez obtenu l'accès au référentiel SVN, l'étape suivante consiste à télécharger votre plugin sur le référentiel WordPress.org. Avant de le faire, nous vous recommandons de vous familiariser avec les bases de l'utilisation de Subversion avec WordPress.

Je vais avec l'interface de ligne de commande pour ce tutoriel. Si vous n'êtes pas fan et préférez travailler avec un client visuel, pensez à TortoiseSVN pour Windows et Cornerstone pour Mac.

Avant de pouvoir télécharger les fichiers du plug-in dans le référentiel SVN, vous devez créer un dossier local dans lequel les fichiers et les actifs seront stockés. Cette commande créera un répertoire local :

$ mkdir my-awesome-plugin

Par souci de cohérence, il est recommandé de nommer le dossier et le fichier PHP principal du plugin en fonction du slug qui vous a été attribué après la soumission initiale. Dans cet exemple, je suppose que le nom de votre plugin est My Awesome Plugin et que votre slug approuvé est my-awesome-plugin .

Maintenant, pour voir et télécharger le dépôt prédéfini :

$ svn checkout https://plugins.svn.wordpress.org/my-awesome-plugin local/path/to/my-awesome-plugin

Cela donnera le retour suivant :

A my-awesome-plugin/branches
A my-awesome-plugin/tags
A my-awesome-plugin/trunk
Checked out revision #####

Ici, A signifie que les répertoires ont été ajoutés au dossier local à partir du référentiel central. Ensuite, vous devez copier les fichiers et dossiers de votre plugin dans le dossier trunk :

$ rsync -r local/path/to/wordpress/wp-includes/plugins/my-awesome-plugin/* local/path/to/my-awesome-plugin/trunk

Et ajoutez-les au référentiel.

$ svn add trunk/*

En retour, il vous sera demandé de vous authentifier. Une fois connecté, vous obtiendrez une réponse qui ressemblera à ceci :

A trunk/my-awesome-plugin.php
A trunk/readme.txt

Important : WordPress.org traite le dossier trunk comme le dossier de niveau supérieur de votre plugin. Par conséquent, ne copiez pas l'intégralité du dossier du plugin tel quel, le trunk ne doit inclure que le contenu du plugin.

Évitez ceci : trunk/my-awesome-plugin/my-awesome-plugin.php

Après avoir ajouté tous les fichiers, validez les modifications dans le dépôt central :

$ svn commit -m 'My first plugin version'

Cela renverra la réponse suivante :

Adding trunk/my-awesome-plugin.php
Adding trunk/readme.txt
Transmitting file data.
Committed revision 9999999.

Pour télécharger une icône de plug-in, une bannière et des captures d'écran, vous pouvez créer un nouveau dossier de ressources dans votre référentiel local SVN :

$ mkdir local/path/to/my-awesome-plugin/assets

Vous pouvez apprendre comment fonctionnent les actifs du plugin ici.

Une fois vos ressources prêtes, ajoutez les ressources du plug-in au référentiel SVN :

$ svn add assets/*

Validez à nouveau les modifications :

$ svn commit -m 'Assets upload'

C'est ça! Votre plugin est maintenant disponible en téléchargement et vous pouvez commencer à le promouvoir.

Publier une nouvelle version

Pour la prochaine version de mise à jour de votre plugin, les étapes sont légèrement différentes. Avant de publier la nouvelle version, mettez à jour le champ Stable Tag dans le trunk/readme.txt file et le numéro de version dans le commentaire d'en-tête du plug-in. Une fois que vous avez vos fichiers de plug-in prêts, copiez-les dans un sous-dossier de /tags et définissez le nom du sous-dossier sur la nouvelle version, par exemple 1.0.1 .

$ svn copy trunk tags/1.0.1

  A tags/1.0.1

Validez les modifications.

$ svn commit -m 'Version 1.0.1 release'

  Adding tags/1.0.1
  Adding tags/1.0.1/my-awesome-plugin.php
  Adding tags/1.0.1/readme.txt
  Committed revision 999999.

Et voilà, la nouvelle version de votre plugin est prête !

Conseils de gestion des versions

• Vous remarquerez peut-être un certain retard entre le moment de la publication d'une nouvelle version et le moment où elle devient disponible en téléchargement sur votre page de liste de plugins WordPress.org. Donnez-lui quelques heures, et si vous ne le voyez toujours pas, vous pouvez envoyer un e-mail à [email protected] car le système a des problèmes de temps en temps.
• En règle générale, pour réduire les problèmes de synchronisation, il est recommandé que la version du plug-in dans votre dossier de trunk soit identique à la version du plug-in dans votre dernière version dans le dossier des tags .

Et après?

Par nature, les développeurs de plugins gratuits sont motivés et passionnés par la contribution de choses utiles au monde. Avant tout, nous voulons que nos produits résolvent des problèmes spécifiques que les gens peuvent rencontrer. Mais quelle que soit la qualité de votre plugin, il ne sera pas d'une grande aide si les gens ne le trouvent pas.

Une bonne prochaine étape pour améliorer la visibilité de votre plugin gratuit consiste à optimiser le fichier readme.txt pour le référencement, ce que nous explorons ici.

Si vous envisagez de gagner de l'argent avec votre plugin, il ne suffit pas d'avoir votre produit en ligne gratuitement - vous voulez que les gens le découvrent, l'utilisent, l'aiment et (espérons-le) passent à votre version payante ! De nos jours, un développeur WordPress porte de nombreux chapeaux, du fabricant de produits au propriétaire d'entreprise en passant par le marketing, et pour que votre plugin soit vu par les bonnes personnes, vous devez développer et affiner vos compétences en marketing.

C'est un sujet que nous explorons en profondeur avec notre manuel de marketing pour les fabricants de produits WordPress. Je recommande également fortement de consulter la feuille de triche ci-dessous pour vendre des plugins et des thèmes WordPress - c'est une feuille de route concise et exploitable pour créer une entreprise WordPress prospère, de l'idéation au lancement en passant par la croissance.

Procurez-vous un exemplaire gratuit de notre

Aide-mémoire pour vendre des thèmes et des plugins

Une feuille de route de croissance avec des conseils concis et exploitables pour chaque étape du développement de produits WordPress.

Partager avec un ami

Saisissez l'adresse e-mail de votre ami. Nous leur enverrons seulement ce livre par e-mail, l'honneur du scout.

Merci pour le partage

Génial - une copie de 'Cheat Sheet for Selling Themes and Plugins' vient d'être envoyée à . Vous voulez nous aider à faire passer le mot encore plus ? Allez-y, partagez le livre avec vos amis et collègues.

Merci pour votre subscription!

- nous venons d'envoyer votre copie de 'Cheat Sheet for Selling Themes and Plugins' à .

Tweet Renvoyer l'e-mail

Vous avez une faute de frappe dans votre e-mail ? cliquez ici pour modifier l'adresse e-mail et envoyer à nouveau.

Télécharger

Envisagez-vous de soumettre un plugin au référentiel WordPress.org ? Envisagez-vous d'utiliser le modèle économique freemium ? Sonnez dans les commentaires ci-dessous!