Comment publier dans le référentiel de plugins WordPress

Tous les développeurs de plugins WordPress doivent prendre en compte le moyen de publier leur travail. De nombreux plugins premium optent pour leur site Web, leur documentation et leur passerelle d’achat. Toutefois, si vous souhaitez publier un plugin gratuit ou une version allégée d’un plugin premium, utilisez le référentiel de plugins WordPress, une excellente option..

WordPress.org offre un contrôle de la source, un suivi des statistiques et informe automatiquement les utilisateurs des mises à jour, et ce, gratuitement. Le classement du site par les moteurs de recherche ne fait pas de mal, d'autant plus que votre plugin peut en bénéficier!

Dans cet article, nous verrons comment configurer un référentiel de plug-in WordPress et gérer votre projet tout au long de son cycle de développement. Notez que cet article suppose que vous connaissez bien Subversion..


Étape 1 Demander un accès

Avant de demander l'accès à votre projet, vous devez avoir un compte avec WordPress.org. Ils sont gratuits et faciles à installer.

Tout d'abord, accédez à cette page et fournissez les informations demandées. Une fois votre compte configuré et confirmé, vous pouvez configurer le référentiel. Accédez au centre de développement WordPress. Sur la page d'accueil de WordPress.org, cliquez sur Étendre et plugins. Ensuite, cliquez sur "Ajouter votre plugin:"

Sur l'écran suivant, vous serez invité à entrer le nom de votre plugin, une brève description et l'URL de la page d'accueil du projet. Cela ne doit pas nécessairement être approfondi, mais voici quelques astuces qui vous aideront à demander l'accès:

  • Assurez-vous que le nom du plugin est final. Une fois que vous avez accès au référentiel, vous ne pouvez pas changer le nom. Réfléchissez de manière stratégique à ce que vous voulez nommer le plugin. Pour de meilleurs résultats, il est souvent préférable de nommer le plugin, quelque chose de simple, lié aux recherches des utilisateurs dans un moteur de recherche..
  • Ne passez pas trop de temps à rédiger une description de votre plugin à ce stade. Une description concise en une phrase suffit. Le fichier README du plugin fournira plus de détails une fois le projet lancé..
  • L'URL de la page d'accueil de votre plugin ne doit pas nécessairement être valide, mais assurez-vous que l'adresse URL que vous spécifiez correspond à l'emplacement réel de la page d'accueil du plugin..

Une fois que vous avez fourni les informations, envoyez la demande. Vous recevrez un courrier électronique contenant les informations d'identification de votre référentiel dans un délai de 24 à 48 heures, après quoi vous pourrez effectuer votre premier commit..


Étape 2: Configuration du référentiel

Après avoir reçu l'URL du référentiel, vous pouvez effectuer votre extraction initiale. À l'aide de votre client Subversion préféré (j'utilise TortoiseSVN dans ce tutoriel), effectuez une extraction à l'aide de l'URL du référentiel:

Cela créera un répertoire avec le nom du plugin que vous avez spécifié à la première étape de ce tutoriel. Il initialisera également les répertoires branches, tags et trunk:

Une note rapide sur la structure du répertoire:

  • Le tronc du référentiel est votre répertoire de travail. Ceci est le répertoire dans lequel vous faites tout votre développement principal.
  • Les balises sont des versions, ou des instantanés, du tronc à des moments spécifiques de son cycle de développement. Souvent, vous pouvez marquer le coffre chaque fois que vous souhaitez effectuer une libération..
  • Le répertoire de branche est une copie du tronc utilisée à un moment donné pour un développement intensif. Si vous envisagez un développement intensif, il est préférable de créer une branche. Ainsi, vous conservez la qualité du tronc..

Vous pouvez en savoir plus sur la structure des répertoires Subversion ici.


Étape 4 Validation des modifications

À ce stade, vous pouvez commencer à travailler à partir du référentiel. S'il s'agit de votre première utilisation, votre répertoire de lignes réseau doit être vide. Si vous avez déjà travaillé sur votre plugin avant d'initialiser le répertoire, continuez et copiez les fichiers dans le coffre maintenant. sinon, n'hésitez pas à commencer à travailler sur votre plugin.

Une fois que vous avez terminé la copie ou que vous avez commencé à travailler sur le plug-in, vous devez ajouter les fichiers au contrôle de source. Pour ce faire, exécutez la commande add:

Ceci indiquera à subversion de commencer à suivre ces fichiers. Ensuite, exécutez la commande commit:

Cette étape soumettra effectivement le code du plugin au référentiel de plugins WordPress.

Bien sûr, vous n'avez pas encore publié votre plugin jusqu'à ce que vous le marquiez. Avant cela, assurez-vous que vous avez correctement configuré l’en-tête de votre plugin et son fichier README. Vous pouvez également en savoir plus à ce sujet dans la série Widgets WordPress Writing Maintenainable..


Étape 3 Marquage et libération

En supposant que vous ayez terminé une version de travail de votre plugin et configuré l'en-tête et le fichier README, il est temps de publier une version de votre plugin. Pour ce faire, exécutez la commande Branch / Tag [TODO] sur le répertoire trunk..

Auparavant, assurez-vous de mettre à jour la balise de version dans l'en-tête du plugin:

Et mettez également à jour la balise stable du fichier README:

Ensuite, validez les modifications dans le coffre..

Après cela, vous êtes prêt à taguer:

Ce faisant, Subversion vous demandera quel répertoire vous souhaitez baliser la version. Il est très important de mettre à jour le chemin du plug-in vers le chemin des balises - la plupart des clients Subversion rempliront la destination avec la direction du tronc. Ceci est incorrect - au lieu de cela, vous voudrez changer le chemin en /tags/1.0 (mais si vous balisez 1.5 ou 2.0, vous changerez le numéro):

À ce stade, votre plug-in a été archivé dans le contrôle de source et étiqueté en tant que version spécifique. Dans les 20 minutes, votre plugin devrait apparaître dans le référentiel WordPress Plugin à l'URL que vous avez spécifiée lors de la demande du référentiel..

La vérification des versions futures du plug-in fonctionne de la même manière que dans les étapes précédentes. Au fil du temps, vous pourrez continuer à développer le plug-in et à suivre les statistiques de téléchargement à partir de la page du projet..


Conclusion

C'est tout! J'espère que vous avez maintenant une bonne idée de ce qu'il faut pour publier officiellement votre plugin via le référentiel de plugins WordPress. Nous avons récemment examiné comment commencer à créer des plugins. vous devriez donc avoir une base solide pour commencer à créer vos propres plugins personnalisés! La grande chose à propos de tout cela est que cela contribue à contribuer à la plate-forme déjà exceptionnelle qu'est WordPress. Les développeurs et les concepteurs les plus talentueux que nous puissions créer en créant des plugins utiles, meilleure sera la plate-forme!

Ressources supplémentaires

Si vous souhaitez en savoir plus sur le développement de plug-in WordPress, consultez nos services de plug-in WordPress dans Envato Studio pour plus de ressources et d'informations sur le sujet.!