5 péchés cardinaux du développement du thème WordPress

Nous parlons beaucoup sur ce site de trucs et astuces pour obtenir ce que vous voulez de WordPress… mais aujourd'hui, nous allons prendre du recul par rapport à la technique pour examiner certaines pratiques, les mauvaises habitudes et le codage des faux pas qui seraient mieux laissé dans notre passé. Alors, pardonnez le titre de poteau (haha!), Nous parlons de cinq pratiques étonnamment communes qui sont des taches sur la plate-forme.

Deux des plus belles choses à propos de travailler sur des thèmes WordPress est le fait que nous arrivons à cibler dans un environnement incroyablement flexible (c’est-à-dire le Web) et nous avons documentation solide pour nous guider dans le processus (c'est-à-dire le Codex WordPress).

Après tout, si le thème fonctionne, le code propre et maintenable est-il important?

Mais le développement de thèmes présente également un danger: nous pouvons complètement renoncer aux meilleures pratiques pour travailler avec le Web et ignorer complètement la documentation.. Plus précisément, rien ne nous oblige à écrire du code propre et maintenable. Après tout, si le thème fonctionne, le code propre et maintenable est-il important? De plus, pourquoi suivre les meilleures pratiques de WordPress si le thème semble bien fonctionner?

Des arguments faibles, non? Je ne sais pas - plus je travaille dans l’espace WordPress, plus je suis surpris de l’existence réelle du mauvais code. En tant que tel, j'ai pensé qu'il serait amusant de décrire cinq péchés capitaux de WordPress Theme Development..


Ignorer le codex WordPress

Comme avec la plupart des langages de programmation, des frameworks ou des bibliothèques, WordPress inclut une énorme quantité de documentation. WordPress Codex est sans doute la meilleure ressource dont disposent les développeurs pour travailler avec WordPress. Après tout, il fournit de la documentation pour la majorité des applications.

Toutefois, WordPress Codex va souvent au-delà de la documentation standard: outre ses noms et paramètres de fonction, le Codex fournit de nombreux exemples d'utilisation de la plupart des fonctions de l'API. Après avoir lu un article donné, vous auriez beaucoup de mal à ne pas trouver un exemple clair de la façon dont la fonction en question.

En plus de l'API, le Codex contient également une variété d'autres articles liés au développement:

  • Action et Filtrer les références
  • Développement de plugins
  • Référence complète de la fonction
  • Liste de fonctions obsolètes

Chaque fois que je travaille sur un thème ou un plugin et que je pense avoir besoin d'écrire une fonction personnalisée pour obtenir quelque chose, je commence par effectuer une recherche dans le Codex. La plupart du temps, une fonction est déjà disponible pour m'aider à répondre à mes besoins.

Tout développeur WordPress sérieux devrait utiliser régulièrement le Codex lorsqu'il travaille sur un projet de développement lié à WordPress. L'ignorer peut souvent conduire à des solutions créatives, mais non testées et instables, susceptibles de causer plus de tort que de bien à long terme..


Ne pas localiser votre thème

Il y a quelques années, si vous deviez me demander ce que je pense de la localisation d'un thème WordPress, j'aurais dit que cela dépendrait du marketing que vous ciblez. Autrement dit, si vous pensez que le public va utiliser un langage autre que le vôtre, faites-le définitivement. sinon, il n'y a rien de mal à laisser le thème traduit dans votre propre langue.

Quelques années plus tard, WordPress «propulse des millions de sites sur Internet. Des sites du monde entier utilisent l'application pour gérer le contenu de leur site. En plus de cela, il est de plus en plus courant que les développeurs complètent leurs revenus, voire vivent du travail avec WordPress..

Parce que WordPress a été si largement adopté et qu'Internet a rendu le monde aussi plat, le marché d'un thème donné ne se limite pas à une seule langue. En plus de cela, WordPress rend la localisation de votre thème incroyablement facile et nécessite si peu d'effort supplémentaire que je soutiens maintenant que la localisation de votre thème n'est plus facultative..

Pour l'essentiel, vous devez comprendre trois choses:

  • La fonction
  • La fonction _e ()
  • POEdit

À part cela, il y a très peu de frais généraux supplémentaires liés à la localisation d'un thème. Cependant, je vous recommande de consulter l'article sur la traduction de WordPress dans le Codex. Il décrit les trois choses ci-dessus et va plus en profondeur sur chaque.


Désorganisation des fichiers thématiques

Les développeurs parlent beaucoup d’organisation de code et de maintenabilité. Personnellement, je pense qu’il est beaucoup plus facile de mettre en avant ces principes que de les appliquer, mais ils sont importants..

Le problème est qu’ils ont une apparence différente pour chaque type de projet. Certaines applications sont écrites dans une seule langue et s'exécutent sur un ordinateur de bureau. Certaines applications utilisent deux langues et s'exécutent sur un appareil mobile. D'autres projets, tels que Thèmes WordPress, peuvent en utiliser de trois (HTML, CSS et PHP) à quatre ( via JavaScript) langues. De plus, certains composants du thème fonctionnent côté client, certains côté serveur, certaines communautés directement avec WordPress et d'autres communiquent directement avec la base de données..

Dire qu'il est possible de sacrifier la maintenabilité est un euphémisme.

Mais cela ne doit pas poser de problème, car WordPress suggère certaines normes pour organiser vos fichiers de thème. Plus précisément, le Codex explique en détail comment organiser vos fichiers de modèles PHP, vos feuilles de style, vos sources JavaScript et vos images..

  • La liste de contrôle des fichiers de modèles fournit une liste des fichiers qui composent un thème de base et détaille ce que chacun doit inclure..
  • La hiérarchie des modèles fournit une explication sur la manière dont tous les fichiers de thème s’associent et sur la manière dont WordPress les restitue au cours de son cycle de vie de page..
  • Stepping Into Templates fournit également une ventilation détaillée des modèles et la structure de la page WordPress pour chaque.
  • Développement de thème est un article massif qui englobe tout ce qui concerne le développement de thème.

Bien sûr, il faut un peu plus d'effort pour organiser vos fichiers plutôt que d'en faire assez pour "le faire fonctionner", mais les dividendes rapportent au fil du temps lorsque vous commencez à travailler sur la prochaine version de votre thème ou que plusieurs développeurs commencent à travailler de la même manière. base de code.


Ignorer les normes de codage

Bien entendu, l’organisation des fichiers n’est qu’une partie du processus de développement qui affecte l’organisation et la maintenabilité. Ensuite, nous devons nous concentrer sur la manière dont nous écrivons le code qui réside dans nos fichiers..

Après tout, nous devrions non seulement vouloir fournir des fichiers bien organisés, mais aussi un code facile à suivre et conforme aux normes. Encore une fois, le codex WordPress fournit un ensemble standard pour les principales langues qui contribuent au code de base d'un thème:

  • CSS
  • PHP
  • HTML

Beaucoup à traiter, hein? Le fait est que passer du temps à se familiariser avec tout ce qui précède rapporte des dividendes au fil du temps. L'application de ces normes au début du développement coûte exponentiellement moins cher que de devoir refactoriser un thème ou un plugin existant.

De plus, cela contribue à fournir un meilleur code à la communauté.


Ne pas tester votre travail

Une fois qu'un thème a été développé et prêt à être publié, vous devez au moins effectuer un seul test. En d'autres termes, vous devez vérifier que les différents styles de publication de données sont correctement formatés, que votre thème n'utilise aucune fonction obsolète ou qu'il n'utilise aucune fonction de manière incorrecte..

Heureusement, le Codex fournit un certain nombre de suggestions et d’outils pour faciliter ce processus..

  • Le mode débogage aide à éliminer les avertissements et / ou erreurs PHP
  • Le test d'unité par thème est un fichier de données comprenant des données de publication pré-formatées que vous pouvez exécuter dans votre environnement de développement local.
  • Theme Check est un plugin qui examinera la base de code de votre thème et fournira des notes sur ce qui doit être traité ainsi que des recommandations pour améliorer la base de code..

Bien sûr, vous pouvez également effectuer des tests supplémentaires, tels que les tests inter-navigateurs, la conformité aux normes HTML / CSS, etc. Le Codex présente encore plus de suggestions de test dans l'article sur le processus de test par thème.


Quels sont vos propres animaux Peeves?

Ils disent que vous apprenez souvent de vos erreurs et je serai le premier à admettre que depuis que je suis avec WordPress, je les ai toutes cassées. Mais, comme le reste de la communauté de développement, vous apprenez et commencez à construire de meilleurs projets avec l'expérience.

Ceci est le premier de ce type d'articles sur la "culture WordPress" que nous publierons sur le site… alors partagez vos expériences ci-dessous - ou mieux encore, écrivez-les longuement et nous les publierons si c'est bon!

Cela dit, ce n'est certainement pas la liste définitive et je suis sûr qu'il y a autre chose à ajouter (nous n'avons même pas touché au piratage du noyau, au harcèlement de la base de données, ni aux éléments de codage définitifs qui devraient avoir des options). Laisse tomber tes propres bêtes noires dans les commentaires!

Quelles sont les pratiques les plus ennuyeuses, nuisibles ou non durables que vous avez rencontrées??