Comment aider avec le débogage du plugin WordPress

Les développeurs de JoomUnited travaillent toujours pour que vos plugins fonctionnent de la manière la plus optimale possible, bien sûr dans certains cas, un certain type de panne peut survenir, par exemple, une incompatibilité générée à cause d'un troisième plugin et que voulons-nous quand ces types des échecs se produisent-ils ? Bien sûr, ils sont résolus rapidement...    

Dans cet article, nous allons vous apprendre à donner les informations correctes au développeur afin qu'il puisse comprendre et résoudre l'erreur rapidement. Cet article sera séparé en 3 étapes que nous allons suivre pour donner les bonnes informations à un développeur lorsqu'un problème survient:

• Activer le journal de débogage
• Installer le plugin de dépannage
• Vérifier les erreurs javascript

Activez le système de débogage et de journalisation WordPress

Tout d’abord, nous devons savoir ce qu’est WP_DEBUG ; Comme on peut le voir sur Wikipédia, « WP_DEBUG est une PHP (une variable globale permanente) qui peut être utilisée pour déclencher le mode « debug » dans WordPress. Il est supposé être faux par défaut et est généralement défini sur vrai dans le fichier wp-config.php sur les copies de développement de WordPress.

Comme nous pouvons le voir, WP_DEBUG est une constante qui est désactivée par défaut, mais nous pouvons l'activer à des fins de débogage temporaire.

En plus de cela, il existe une autre constante PHP appelée WP_DEBUG_LOG qui nous aidera à créer automatiquement un fichier texte avec toutes les erreurs de vos plugins et c'est ce que nous allons envoyer aux développeurs.

Nous allons vous apprendre exactement comment nous pouvons l'activer et à quoi cela ressemblera s'il y a une erreur avec votre plugin, WP Meta SEO va être utilisé pour cet exemple mais vous pouvez suivre les mêmes étapes pour tous nos plugins. Dans ce cas, nous avons un problème avec WP Meta SEO , cela pourrait être n'importe quel problème donc ce que nous allons faire est d'ouvrir le fichier wp-config.php cela pourrait être fait avec votre logiciel d'édition de texte préféré, avec le Bloc-notes, Visual Studio Code, Brackets par exemple, ouvrez simplement wp-config.php .

Le fichier se trouve à la racine de votre serveur, là où votre site WordPress est installé.

Ouvrez-le avec l'éditeur de texte puis appuyez sur CTRL + F ou cliquez sur Edition > Rechercher… vous pourrez voir une boîte où vous pourrez taper le mot que vous allez trouver, dans ce cas, nous allons taper " WP_DEBUG" et cliquez sur Entrée jusqu'à ce que vous trouviez :
"define( 'WP_DEBUG', false )"

Maintenant que nous sommes sur cette ligne, supprimez le "false" et tapez true, cliquez sur Entrée et dans la ligne suivante, copiez define ('WP_DEBUG_LOG', true); et enregistrez le fichier, il devrait ressembler à l'image suivante.

Si ces deux lignes sont modifiées, un fichier appelé « debug.php » apparaîtra sur /wp-content/

Et c'est fait… nous avons terminé la première étape, c'est l'un des fichiers dont nos développeurs auront besoin pour accélérer le processus de résolution de votre problème. Toutes les erreurs seront surveillées et écrites dans ce même fichier texte.

Installer le plugin de dépannage WordPress

Le plugin Health Check & Troubleshooting est un plugin qui vous permet d'effectuer une vérification des conflits sans affecter les visiteurs normaux de votre site, il est vraiment facile à utiliser et à installer, nous allons toujours utiliser WP Meta SEO pour cet exemple. Suivez ces étapes pour installer et exécuter une vérification des conflits avec Health Check & Troubleshooting :

• Connectez-vous à votre site Wordpress, vous serez sur le tableau de bord de votre site
• Cliquez sur « Plugins », dans la partie gauche de votre page
• Cliquez sur « Ajouter un nouveau »
• Tapez "Health Check & Troubleshooting" dans la barre de recherche, comme indiqué ci-dessous

• Cliquez sur « Installer maintenant » , la liste des plugins se chargera automatiquement, cherchez le droit et cliquez sur « Installer maintenant » puis sur « Activer »

• Cliquez sur « Santé du site » , dans le menu de gauche se trouve une section intitulée « Outils ». Cliquez dessus, puis sur « Santé du site ».

• Cliquez sur l' « Dépannage » , lisez les informations d'avertissement et cliquez sur « Entrer en mode de dépannage ». 

Le mode de dépannage désactive automatiquement tous les plugins et passe à un thème par défaut. Le mode de dépannage n'affecte pas les visiteurs normaux de votre site.  

• Reproduisez le problème que vous rencontriez

Dans l'environnement par défaut sans plugins actifs et sans thème par défaut, si le problème se produit, cela signifie que notre plugin ne provoque pas de comportement inattendu.

• Cliquez sur « Plugins » > « Plugins installés »

  Le menu « Plugins » s'agrandira et vous offrira des options supplémentaires. Cliquez sur « Plugins installés »

• Cliquez sur « Activer pendant le dépannage » à côté de WP Meta SEO

• Reproduisez le problème que vous rencontrez avec uniquement WP Meta SEO actif et un thème par défaut. Si le problème se produit, le problème est causé par notre plugin.

C'est en quelque sorte une bonne nouvelle car vous avez déjà identifié une partie du problème. Maintenant, il faut que le développeur se connecte à votre site Web et corrige le problème avant de publier une nouvelle version! Sinon, répétez les étapes pour activer le prochain plugin désactivé que vous pouvez reproduire l'erreur.

Vérification et débogage des erreurs Javascript dans les plugins WordPress

Nous allons rechercher des erreurs Javascript avec la console Chrome ou Firefox. En fonction de votre navigateur, son nom est légèrement différent, mais après Chrome et FireFox, nous l'appellerons la «console». Pour ouvrir la console, suivez simplement ces étapes:  

• Faites un clic droit sur inspecter, sur le frontend dans n'importe quelle partie du site

• Sélectionnez la console , cela ouvrira les outils de développement sur le côté droit de la page, cliquez sur « Console »

Vérifiez les erreurs , avec la console ouverte, reproduisez l'erreur que vous attendiez et regardez sur la console, les erreurs sont des textes en rouge qui décrivent où se situe le conflit javascript

Si vous avez trouvé une erreur JavaScript, veuillez prendre une capture d'écran de la version étendue de l'erreur pour l'inclure dans votre ticket/publication.

Envoyer / partager votre rapport de problème

Maintenant que vous avez toutes ces informations, vous aiderez le développeur à accélérer le processus, allez simplement pour toutes les informations que vous avez collectées et vers votre ticket / poste, rappelons-nous, les éléments sont:  

• journal de débogage
• Remarque avec les plugins qui provoquent des conflits
• Une capture de la console javascript avec l'erreur

Si vous suivez ces étapes et envoyez-nous les informations correctes, le développeur sera en mesure de faire un travail de débogage plus rapide et nous vous remercions beaucoup à l'avance :)    

Créer et partager un nouveau compte utilisateur WordPress à des fins d'assistance

La création d'un nouvel utilisateur administrateur est parfois un moyen rapide de montrer à l'équipe de support de quoi s'agit votre problème. Avant de commencer ce processus, un petit rappel:

• Nous ne stockons pas les anciennes informations d'identification une fois le problème résolu (pour des raisons de sécurité)
• Nous vous recommandons de supprimer les comptes d'utilisateurs administrateur créés à des fins d'assistance
• Toutes les informations partagées avec notre équipe sont sécurisées et resteront privées

Afin de créer un nouvel utilisateur, vous devez d’abord vous connecter à votre site d’administration. Après vous être connecté avec succès, vous êtes dans le tableau de bord Wordpress.

Ensuite, vous devez aller dans le menu de gauche > Utilisateurs .

Après cela, accédez à l'écran supérieur, cliquez sur le Ajouter un nouveau ou passez au Ajouter un nouveau dans le menu de gauche.

Ensuite, le Ajouter un nouvel utilisateur apparaîtra sur votre écran. Il y a 2 champs obligatoires pour remplir les informations : Nom d'utilisateur, Email .

Dans le champ Mot de passe , vous pouvez utiliser un générateur de mot de passe aléatoire ou définir le vôtre. Et vous pouvez cocher l' option Envoyer une notification utilisateur si vous souhaitez envoyer un e-mail à un nouvel utilisateur concernant son compte.

Ensuite, vous choisissez un rôle pour l'utilisateur dans la liste déroulante. Il s'agit d'une étape importante pour définir l'autorisation des utilisateurs sur votre site. "Administrateur" est le niveau le plus élevé et permet à l'utilisateur d'accéder à toutes les fonctionnalités de votre site Web. Vous pouvez définir d'autres rôles si vous souhaitez limiter votre accès utilisateur.

Enfin, cliquez sur Ajouter un nouvel utilisateur en bas. C'est déjà fait, bonne chance !