{"id":231085,"date":"2022-12-14T16:26:00","date_gmt":"2022-12-14T13:26:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=231085"},"modified":"2022-12-14T16:27:12","modified_gmt":"2022-12-14T13:27:12","slug":"widgets-wordpress-commencer-par-les-normes","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/widgets-wordpress-commencer-par-les-normes\/","title":{"rendered":"Widgets WordPress\u00a0: commencer par les normes"},"content":{"rendered":"\n

Le but de cette s\u00e9rie est de commencer \u00e0 approfondir le travail avec la programmation orient\u00e9e objet dans le contexte de WordPress.<\/p>\n

Et puisque l’API WordPress Widgets est l’une des API qui utilise des pratiques orient\u00e9es objet, c’est un point de d\u00e9part logique. De plus, cela nous donnera quelques techniques fondamentales que nous pourrons utiliser pour les appliquer \u00e0 des travaux futurs, car nous verrons comment cr\u00e9er davantage de projets orient\u00e9s objet sur WordPress dans les futures s\u00e9ries.<\/p>\n

Jusqu’\u00e0 pr\u00e9sent, nous avons couvert les \u00e9l\u00e9ments suivants\u00a0:<\/p>\n

    \n
  1. Widgets WordPress: une approche orient\u00e9e objet<\/a>. L’API Widgets fournit un test d\u00e9cisif solide et un exemple de la fa\u00e7on de d\u00e9marrer avec la programmation orient\u00e9e objet dans WordPress.<\/li>\n
  2. Widgets WordPress: comment d\u00e9tecter la programmation orient\u00e9e objet<\/a>. Le but est de vous armer de tout ce dont vous avez besoin pour d\u00e9tecter les pratiques orient\u00e9es objet.<\/li>\n<\/ol>\n

    Si vous n’\u00eates pas rattrap\u00e9, c’est le moment id\u00e9al pour le faire. Et si vous avez, alors vous vous souviendrez du dernier message, nous avons termin\u00e9 avec la note suivante\u00a0:<\/p>\n

    \n

    Autrement dit, nous allons revoir le WordPress Widget Boilerplate<\/a><\/strong> et je vais le refactoriser dans son \u00e9tat actuel pour adopter des normes PHP plus modernes.<\/p>\n<\/blockquote>\n

    Pour commencer \u00e0 mettre \u00e0 jour le WordPress Widget Boilerplate pour suivre lesdites normes, nous devons faire quelques choses :<\/p>\n

      \n
    1. cr\u00e9er une branche \u00e0 partir du passe-partout existant,<\/li>\n
    2. installer des outils de qualit\u00e9 de code,<\/li>\n
    3. assurez-vous que notre IDE est correctement configur\u00e9,<\/li>\n
    4. et commencer \u00e0 refactoriser le code selon ces normes.<\/li>\n<\/ol>\n

      Et c’est ce que nous allons commencer \u00e0 faire avec ce post.<\/p>\n

      Commencer par les normes<\/h2>\n

      Si vous \u00eates membre de ce site depuis un certain temps, vous savez que je pr\u00e9f\u00e8re utiliser Visual Studio Code. Sinon, j’ai toute une s\u00e9rie d’articles<\/a><\/strong> consacr\u00e9s \u00e0 la fa\u00e7on dont je l’utilise (et donc \u00e0 la fa\u00e7on dont nous l’utiliserons tout au long de cette s\u00e9rie d’articles).<\/p>\n

      Et si vous \u00eates int\u00e9ress\u00e9 par la couverture concernant les normes de codage, le d\u00e9bogage, les IDE, les environnements de d\u00e9veloppement, etc., consultez The Independent WordPress Developer<\/a><\/strong>.<\/p>\n

      Cependant, je suppose que si vous lisez ceci, vous avez lu le mat\u00e9riel ci-dessus ou vous \u00eates \u00e0 l’aise de parcourir tout le mat\u00e9riel ci-dessus.<\/p>\n

      Cela dit, commen\u00e7ons.<\/p>\n

      T\u00e9l\u00e9chargement du r\u00e9f\u00e9rentiel<\/h3>\n

      La premi\u00e8re chose que vous allez vouloir faire est de cloner une copie du r\u00e9f\u00e9rentiel. Je pr\u00e9f\u00e8re le faire via la ligne de commande.<\/p>\n

      De plus, je pense aussi que cela vaut la peine de le faire contre la derni\u00e8re version de WordPress<\/a><\/strong>. Si vous n’avez pas de copie de la copie principale de Subversion de WordPress, vous pouvez lire comment la configurer ici ; cependant, ceci est purement facultatif. Vous pouvez suivre le reste de ce tutoriel tr\u00e8s bien avec n’importe quelle version de WordPress que vous souhaitez.<\/p>\n

      Faire cela,<\/p>\n

        \n
      1. Assurez-vous que vous \u00eates dans le r\u00e9pertoire des plugins<\/strong> de votre installation WordPress<\/li>\n
      2. Et puis entrez les commandes suivantes dans une copie de votre terminal<\/li>\n<\/ol>\n
        $ <\/code><\/pre>\n
        Cela cr\u00e9era un\u00a0 r\u00e9pertoire WordPress-Widget-Boilerplate<\/strong> dans votre\u00a0 r\u00e9pertoire de plugins<\/strong>. Vous pouvez y acc\u00e9der en tapant simplement\u00a0:<\/p>\n
        $ cd WordPress-Widget-Boilerplate<\/code><\/pre>\n
        Les r\u00e9sultats du clonage du r\u00e9f\u00e9rentiel devraient ressembler \u00e0 ceci\u00a0:<\/p>\n
        Ensuite, vous devez vous assurer que vous passez \u00e0 la\u00a0 branche develop<\/strong> que j’ai cr\u00e9\u00e9e. C’est vraiment facile \u00e0 faire. Mais avant cela, pourquoi ne pas configurer le projet dans Visual Studio ?<\/p>\n
        Configuration du code Visual Studio<\/h3>\n
        Les \u00e9tapes de configuration du projet dans Visual Studio Code sont simples\u00a0:<\/p>\n
          \n
        1. Faites glisser le r\u00e9pertoire du Boilerplate dans l’IDE,<\/li>\n
        2. Ouvrez la borne int\u00e9gr\u00e9e,<\/li>\n
        3. \u00c9changer des succursales<\/li>\n<\/ol>\n
          Tout comme je l’ai fait ci-dessus, je vais fournir un screencast sur la fa\u00e7on de faire tout cela. Faire glisser un r\u00e9pertoire dans Visual Studio Code devrait \u00eatre assez facile, mais \u00e9changer des branches sur la ligne de commande peut \u00eatre un peu diff\u00e9rent.<\/p>\n
          Tout d’abord, configurez le projet dans Visual Studio Code\u00a0:<\/p>\n<\/p>\n
          Notez ici que j’ouvre \u00e9galement le terminal int\u00e9gr\u00e9 en appuyant sur le raccourci CMD+P (je suis sur macOS donc votre raccourci peut \u00eatre diff\u00e9rent). Ensuite, j’entre la commande pour v\u00e9rifier la branche develop .<\/strong><\/p>\n
          Une fois que vous avez fait cela, votre r\u00e9f\u00e9rentiel local devrait basculer vers la branche develop. Vous pouvez confirmer qu’il s’agit de la succursale \u00e0 partir de laquelle vous travaillez en tapant\u00a0:<\/p>\n
          $ git branch<\/code><\/pre>\n
          Et puis revoir le contenu du terminal. Strictement parlant, d\u00e9velopper<\/strong> doit \u00eatre mis en \u00e9vidence.<\/p>\n
          \"Widgets<\/a><\/p>\n
          \u00c0 ce stade, nous allons introduire quelques nouveaux fichiers dans le projet. \u00c0 la fin de ce didacticiel, vous pouvez former un pull<\/strong> pour obtenir tout ce que je suis sur le point de documenter ici. Mais parce que le but de ce que nous faisons est double, il est important de s’assurer que nous le faisons dans le bon ordre car la premi\u00e8re \u00e9tape est quelque chose que j’utilise dans chaque projet pour WordPress \u00e0 ce stade.<\/p>\n
          Donc, cela dit, jetons un coup d’\u0153il.<\/p>\n
          Compositeur et qualit\u00e9 du code<\/h3>\n
          La premi\u00e8re chose que j’aime faire est de mettre en place une s\u00e9rie d’outils pour faire respecter la qualit\u00e9 du code. Ceci est r\u00e9alis\u00e9 par une vari\u00e9t\u00e9 de packages Composer. Ceux-ci inclus:<\/p>\n