Comment résoudre des problèmes d’affichage dans l’administration WordPress

Vous êtes sur votre interface d’administration et faites face à différents bugs : des scripts vous semblent ne pas se dérouler correctement, des ressources manques, des bugs d’affichage surviennent à différents endroits de l’administration WordPress.

Exemples :

• Votre éditeur de pages et d’articles n’affiche pas correctement vos saisies.
• Certains menus ne fonctionnent plus
• L’ajout de médias est difficile voir impossible
• Certaines fonctionnalités sont inopérantes

L’administration ne charge pas correctement

WordPress utilise une fonctionnalité de « concaténation » des scripts, permettant de charger tous vos fichiers javascript du back-office en une seule requête.

Les dépendances seront alors toutes chargées d’un coup.

Malheureusement, parfois cela peut occasionner des conflits entre scripts. Parfois ceux-ci apparaissent avec certains thèmes ou certains plugins.

Autre cause de cette erreur, un problème de cache. Certains éditeurs sont plus sujets à ce problème que d’autres.

Une dernière cause peut être un fichier .htaccess trop restrictif. Un fichier .htaccess sert à la configuration de certains paramètres serveurs, permettant de définir différentes règles, notamment d’accès ou de réécriture. Ce fichier est beaucoup utilisé pour améliorer la sécurité de votre site, configurer la réécriture d’URL, effectuer des redirections ou encore rediriger des messages d’erreur.

Une solution « facile » pour contourner ce problème est de désactiver cette fonctionnalité. Mais en faisant ceci vous en perdrez les avantages. Néanmoins, cela peut vous permettre de mettre en évidence le problème rencontré.

Pour ce faire, il vous suffit, dans le fichier wp-config.php, d’ajouter ou de modifier la ligne suivante ainsi :

define( 'CONCATENATE_SCRIPTS', false );

Vous pourrez alors recharger la page d’administration et voir si le résultat est meilleur.

Pour un meilleur diagnostic, nous vous conseillons aussi, temporairement, d’activer le debug sur votre installation WordPress.

Toujours dans ce même fichier wp-config.php, situé à la racine de votre installation WordPress, activez le débug avec cette ligne dans votre fichier, avec la valeur à « true » au lieu de « false » :

define( 'WP_DEBUG', true );

Si vous travaillez sur un thème ou un plugin et que vous souhaitez enlever les versions minifiées de vos scripts (javascript, CSS…), vous pouvez également activer le debug des scripts grâce à cette ligne :

define( 'SCRIPT_DEBUG', true );

Enfin, utilisez la console de votre navigateur à la recherche d’erreurs ou de problèmes, que l’option de concaténation soit activée ou non. Lorsque cette dernière est désactivée, vous pouvez identifier précisément le ou les script(s) fautifs. Pour activer la console : F12 sous Firefox / Chrome, CTRL + SHIFT + C sous Opera ; puis cliquer sur l’intitulé de l’onglet « Console »). Vous y retrouverez alors des erreurs ou des messages d’attention le cas échéant, ciblant certains éléments de votre site.

Rappel : en production, les mods debug doivent être désactivés. Pensez donc à bien remettre à « false » les deux derniers paramètres vus précédemment.

Nous avons vu que ce genre de problème peut venir également d’un cache. Il suffit pour vous de vider le cache de votre navigateur (voir selon votre navigateur la procédure à adopter) et de réessayer. Contrôler et vider si besoin également votre cache serveur ou de certains plugins si besoin. Contrôlez également vos plugins et thèmes des fois que. Enfin, si vous utilisez une solution CDN (Réseau de diffusion de contenu), pensez à contrôler sa configuration.

Enfin, nous évoquions un fichier .htaccess trop restrictif. Il conviendra de contrôler ce fichier pour identifier d’éventuelles règles ou restrictions pouvant interférer avec le chargement de scripts. N’hésitez pas à faire appel à une personne de métier pour analyser ce fichier, tant il est important pour la sécurité et le bon fonctionnement de votre site web.