Les normes de codage WordPress une introduction

En ce qui concerne la création de produits basés sur WordPress, nous sommes un peu maudits (ou bénis, selon votre perception), avec une arme à double tranchant: WordPress étant écrit en PHP, il est relativement facile d'obtenir WordPress projet lui-même - faire ce que nous voulons faire tout en évitant les meilleures pratiques.

Mais cela soulève la question suivante: à quoi sert une API ou des normes de codage formelles si nous voulons simplement les ignorer?

Nous avons beaucoup écrit sur les API WordPress dans des articles précédents, et nous avons abordé les normes de codage WordPress, mais nous n'avons jamais vraiment plongé dans les normes de codage, en comprenant chaque aspect, et pourquoi elles matière.

Donc, dans cette série, nous allons faire exactement cela.

Pourquoi s'embêter avec les normes de codage?

Avant d’examiner tout ce que nous allons couvrir, je pense qu’il est important de comprendre pourquoi les normes de codage importent même..

WordPress est largement utilisé par beaucoup des personnes utilisant beaucoup de sites. Il y a beaucoup de code utilisé qui est basé sur l'application principale. Cela signifie que certains développeurs et concepteurs travaillent à la maintenance de ces bases de code..

Le défi survient lorsque la personne qui n'a pas initialement écrit le code est confrontée à l'amélioration, la gestion et la correction des bogues du projet. Disons que la première personne n'a pas respecté les normes de codage, mais que la personne qui gère maintenant le code est habituée à suivre les meilleures pratiques..

Ils doivent maintenant traiter avec du code qui ne ressemble en rien à ce que le code WordPress devrait ressembler.

Et c’est vraiment le noeud du problème: le code qui compose nos thèmes, nos plugins et nos applications doit idéalement ressembler à un développeur ayant écrit le code..

C'est quelles normes de codage appliquent.

Malheureusement, les normes sont soit ignorées, soit pas assez évangélisées, bien qu'elles soient bien documentées. C’est là que cette série d’articles entre en jeu: nous allons examiner en détail chacune des normes pour évangéliser, comprendre et s’encourager mutuellement à faire un meilleur travail..

Un regard sur les normes de codage

Cette série comprendra sept articles en plus de cette introduction..

Voici où nous nous dirigeons avec cette série particulière:

Conventions de dénomination et arguments de fonction - Nous verrons comment nommer nos variables, méthodes et classes de manière à ce qu'elles soient claires, faciles à comprendre et à suivre par nous-mêmes et par les autres développeurs..
L'utilisation de citations simples et doubles - Les guillemets simples et les guillemets doubles ont un comportement différent en PHP et il y a un moment et un endroit pour utiliser lesquels dans WordPress. Dans cet article, nous examinerons des exemples de chacun et la raison de ce que nous faisons..
Indentation, utilisation de l'espace et espaces de fin - Les espaces blancs jouent un rôle important dans l'écriture de code basé sur WordPress. Cet article va explorer les raisons pour lesquelles l’indentation et l’espace importent, ainsi que quand utiliser des tabulations et quand utiliser des espaces.
Style d'accolade, expressions régulières et balises PHP - Différents langages de style C utilisent une syntaxe différente. Cet article examinera la bonne façon de placer des accolades dans votre code WordPress. Nous allons également examiner la manière appropriée d'inclure des expressions régulières, ainsi que certains pièges et meilleures pratiques liés à l'utilisation de balises PHP..
L'opérateur ternaire et les conditions de Yoda - Les instructions conditionnelles sont une pierre angulaire de la programmation et sont utilisées généreusement dans WordPress. PHP offre un raccourci pour les instructions if / else, et WordPress choisit d’évaluer les conditions conditionnelles différemment de celles prises en charge par d’autres langues. Ici, nous allons jeter un oeil à tout ce qui précède.
Requêtes de base de données et formatage de requêtes SQL - Il existe une API complète pour l'exécution de requêtes sur la base de données WordPress, mais il existe également des moyens d'exécuter du SQL brut. Si vous avez besoin de suivre cette voie, il y a une bonne façon de le faire. Cet article examinera exactement cela.
Tout rassembler - Enfin, nous allons résumer tout ce que nous avons discuté tout au long de la série pour nous assurer que nous sommes tous sur la même page et pour nous exhorter à progresser dans le respect des normes..

Conclusion

En ce qui concerne les blogs, il est souvent supposé que l'auteur est un expert en la matière, mais la vérité demeure, bien que je sois fermement convaincu que nous devrions respecter les normes de codage et essayer de les respecter au mieux de mes capacités. , J'apprends des choses chaque semaine.

J'ai souvent enfreint les normes de codage, et je suis sûr que certains d'entre vous l'ont déjà fait..

Le but de cette série est de passer en revue les normes ensemble afin que nous puissions tous devenir de meilleurs développeurs une fois que nous aurons terminé.

Code