Utilisation des normes de codage avec WordPress

J’écris beaucoup sur les normes de codage avec WordPress et l’importance que je crois qu’elles ont pour les individus, les équipes et le travail avec l’application principale, c’est-à-dire WordPress lui-même.

Au cours de la dernière année environ, j’ai cessé de travailler principalement avec les normes de codage WordPress et j’ai commencé à utiliser les recommandations standard PHP pour le codage.

Notez que je n’ai pas dit que j’avais abandonné les normes de codage WordPress ni que j’élevais les recommandations PSR au-dessus d’elles, mais j’ai des raisons pour lesquelles j’utilise chacune d’entre elles. Et pour tous ceux qui travaillent avec des projets basés sur WordPress, je pense qu’il est important de reconnaître quand il est approprié d’utiliser chacun.

Et c’est le but de ce billet.

Normes de codage avec WordPress

Avant de discuter de chacune des variantes des normes de codage, je tiens à préciser que rien de ce que je dis ne doit être considéré comme une règle absolue. Au mieux, peut-être une règle empirique. Au pire, complètement ignoré, non? 🙃

Sérieusement, cependant, malgré les efforts habituels et les points de discussion pour plaider en faveur d’une norme plutôt qu’une autre, je suis d’avis qu’il y a un moment et un endroit où chacun devrait être utilisé.

Au moment d’écrire ces lignes, je travaille sur deux projets et un utilisant les normes de codage WordPress ; les autres utilisent le PSR.

Voici le truc :

La décision n’est pas de savoir quel ensemble de normes de codage est le meilleur. Les gens aiment discuter de ce point, et c’est très bien pour eux. Je ne sais pas. Au lieu de cela, j’essaie d’adopter la position d’être aussi pragmatique que possible.

Et pour ce faire, j’essaie d’utiliser un ensemble de questions pour prendre des décisions sur les normes de codage à utiliser

Un filtre pour la prise de décision

Avant même d’aborder les deux types de normes, il est important de reconnaître qu’il existe un processus de réflexion – un filtre à travers lequel – vous pouvez exécuter toutes vos idées pour prendre la décision la plus éclairée possible compte tenu de votre projet.

J’ai fait de mon mieux pour capturer l’ordre dans lequel je considère quel ensemble de normes utiliser et je les partage ici. Dans aucun ordre particulier.

• WordPress. Êtes-vous en train d’écrire quelque chose qui devra être compatible avec autant d’installations WordPress (sans tenir compte des versions PHP) ?
• WordPress Travaillez-vous sur la maintenance d’un projet qui a été écrit pour une ancienne version de PHP ou ce qui a été écrit en utilisant les normes de codage WordPress ?
• WordPress. Avez-vous hérité d’un projet ou maintenez-vous un projet qui n’a pas le budget pour refactoriser la base de code ?
• WordPress ou PSR. Travaillez-vous avec une équipe qui utilise cela comme principal ensemble de normes de codage ?
• RPS. Pouvez-vous convaincre votre client d’utiliser PHP7+ ?
• RPS. Avez-vous un contrôle total sur l’environnement dans lequel le projet est déployé ?
• RPS. Avez-vous un projet qui a été précédemment écrit dans une ancienne version de PHP qui a le budget pour un serveur plus récent et une refactorisation ?
• RPS. Voulez-vous écrire dans une base de code qui vous aidera à faire entrer vos compétences en PHP dans une ère plus moderne tout en apportant WordPress avec lui ?

Et enfin, une autre question que je poserais est celle-ci :

Quelles normes de codage avez-vous sur votre système, est-il facile de configurer votre IDE ? Laissez le temps de le configurer et répondez au guide de questions ci-dessus quel ensemble de normes vous utilisez.

En fin de compte, l’objectif est de rendre aussi simple que possible la détermination de la norme à utiliser.

Un article final ?

Avant de conclure cette série, je souhaite fournir une liste de ressources supplémentaires qui, à mon avis, sont utiles pour ceux qui travaillent avec WordPress dans une certaine mesure.

Peut-être êtes-vous un développeur expérimenté, peut-être êtes-vous juste en train de devenir standard, ou peut-être êtes-vous quelque part entre les deux.

Quoi qu’il en soit, il y a quelque chose pour nous tous, et si je peux partager autant d’informations que possible pour vous aider à devenir un meilleur développeur WordPress indépendant, alors j’atteindrai une partie de l’objectif que j’ai défini avec cette série particulière .

Pour l’instant, cependant, réfléchissez au contour des normes de codage ci-dessus et voyez si cela ne vous aide pas à gérer certains de vos projets existants.

Une note sur la programmation orientée objet

Notez également qu’en début de semaine, j’ai commencé – ou repris, selon le temps que vous avez lu ce matériel – sur la programmation orientée objet dans WordPress. Donc, si vous souhaitez également vous lancer dans ce domaine, vous pouvez commencer par cet article (car il fait également référence à certains des autres).