Dépannage

Message d'erreur

Une erreur courante dans WordPress est une Erreur interne du serveur 500 (ou parfois une page blanche ou " Le site rencontre des difficultés techniques "). Cette erreur peut ressembler à l'image ci-dessous.

Les erreurs internes du serveur dans WordPress peuvent être causées par des fonctions de plugin ou de thème, un fichier .htaccess corrompu ou la limite de mémoire PHP.

Débogage

Pour commencer à déboguer cette erreur, nous devons voir si nous pouvons obtenir plus d'informations sur cette dernière.

La première méthode permettant d'obtenir plus d'informations sur l'erreur consiste à définir WP_DEBUG sur true dans wp_config.php. Veuillez suivre les étapes ci-dessous :

1. Accédez à votre site via FTP
2. Ouvrir le fichier nommé wp-config.php
3. Trouvez la ligne où vous voyez define('WP_DEBUG', false);
4. Modifier faux en vrai et enregistrer le fichier

The next time you refresh the page you were getting an error on you should see more information about the error messages which will help in troubleshooting. If the line is already set to true you may have another plugin or server configuration which is suppressing the error output.

Et nous pouvons également en découvrir plus sur cette erreur en vérifiant si nous avons des erreurs PHP dans les journaux d'erreurs PHP.

Augmenter la limite de mémoire de WordPress

Lors de l'installation de WordPress, la limite de mémoire par défaut est généralement fixée à 64 Mo. Cependant, à mesure que vous installez des plugins, des thèmes et d'autres extensions WordPress, l'utilisation de la mémoire de votre site web peut augmenter. Si l'utilisation de la mémoire de votre site web dépasse la limite par défaut, vous pourriez commencer à rencontrer divers problèmes de performance, notamment des temps de chargement lents, des messages d'erreur et même des plantages du site web.

Pour augmenter la limite de mémoire de WordPress, vous devrez généralement modifier le fichier wp-config.php de votre site Web ou contacter votre fournisseur d'hébergement Web pour demander une augmentation.

1. Connectez-vous à votre site web via FTP
2. Ouvrir le fichier nommé wp-config.php
3. Vous devez coller ce code dans le fichier wp-config.php juste avant la ligne qui dit ‘That’s all, stop editing! Happy blogging.’
   define( 'WP_MEMORY_LIMIT', '256M' );
   
4. Enregistrer le fichier

Vous pouvez maintenant visiter votre site WordPress et l'erreur de mémoire épuisée devrait avoir disparu.

Vérification du fichier .htaccess corrompu

Assurez-vous que les permaliens « pretty » sont activés et fonctionnent. https://wordpress.org/support/article/using-permalinks/#using-pretty-permalinks

Vous savez qu'ils ne fonctionnent pas correctement car WordPress gère normalement les pages 404 et affiche une belle erreur à l'utilisateur qui ressemble à une page de votre site. Si votre page d'erreur 404 provient directement du serveur (vous n'obtenez que "L'URL demandée /sample n'a pas été trouvée sur ce serveur."), cela signifie qu'elle n'est pas correctement configurée.

Si l'erreur est une page blanche (ne provient pas du modèle de page 404 de WordPress), il est possible que votre fichier .htaccess contienne des règles de réécriture de serveur qui redirigent simplement le sous-répertoire (exemple.com/fr) ailleurs.

Cela se produit généralement en conflit avec le plugin WordPress Gtranslate et sa structure d'URL en sous-répertoire. Le plugin Gtranslate ajoutera des règles de réécriture supplémentaires à l'intérieur du fichier .htaccess pour que cette fonctionnalité fonctionne.

La désactivation de Gtranslate et l'activation de TranslatePress entraîneront le dysfonctionnement des langues secondaires de TranslatePress et provoqueront l'affichage d'une erreur « Not Found » de la part du serveur Apache.

Pour une solution rapide, il vous suffit de modifier votre fichier .htaccess et de supprimer la Section de configuration Gtranslate.

Les conflits de thèmes et de plugins se produisent lorsque des problèmes de compatibilité entre un thème WordPress et un plugin entraînent des erreurs, des fonctionnalités dégradées, un contenu manquant ou des plantages de site Web. Un conflit de thème survient lorsque le code d'un thème WordPress entre en conflit avec le code d'un plugin, provoquant des erreurs ou un comportement inattendu. Un conflit de plugin, quant à lui, se produit si les plugins utilisent les mêmes fonctions ou ressources, ou si un plugin modifie une fonctionnalité de base de WordPress dont un autre plugin dépend.

Test de conflit

Effectuer un test de conflit est une étape importante pour dépanner les problèmes de site Web WordPress causés par des conflits de plugins ou de thèmes. Voici les étapes que vous devez suivre pour effectuer un test de conflit :

1. Mettez à jour tous vos plugins et thèmesUtiliser les versions les plus récentes du logiciel de votre site web peut parfois résoudre des conflits, car les versions mises à jour contiennent souvent des corrections de bogues.
2. Créer un site de staging : Un site de staging est une copie exacte du site web en direct, créée à des fins de test ou pour apporter des modifications sans affecter le site en direct. Il permet aux développeurs d'expérimenter et de tester des changements sans risquer d'erreurs sur le site web en direct.
3. Désactiver la mise en cache : Si votre site utilise la mise en cache, désactivez-la pour vous assurer que vous testez le site réel et non une version mise en cache.
4. Désactiver tous les plugins : Désactivez tous les plugins sur votre site WordPress. Vous pouvez le faire en allant sur la page Plugins et en sélectionnant tous les plugins, puis en choisissant Désactiver dans le menu déroulant Actions groupées.
5. Passer à un thème par défaut : Changez votre thème pour un thème WordPress par défaut, tel que Twenty Twenty-Two, afin d'éliminer tout conflit causé par le thème.
6. Tester le site : Vérifiez votre site web pour voir si le problème a été résolu. Si le problème a disparu, il était causé par un conflit de plugin ou de thème.
7. Activer les plugins : Activez chaque extension une par une, et après chaque activation, vérifiez le site web pour voir si le problème se produit. Si le problème réapparaît après l'activation d'une extension spécifique, cette extension est la cause du conflit.
8. Réactiver le thème : Une fois que vous avez identifié le plugin problématique, réactivez tous les autres plugins et revenez à votre thème d'origine. Désactivez ensuite le plugin problématique et vérifiez si le problème est résolu.

En suivant ces étapes, vous pouvez identifier la source du conflit et prendre les mesures nécessaires pour résoudre le problème. N'oubliez pas de maintenir tous les plugins et thèmes à jour pour éviter que des conflits ne surviennent à l'avenir.

Dans WordPress, les fichiers journaux d'erreurs PHP sont des fichiers qui contiennent des informations sur les erreurs ou les avertissements qui se produisent dans le code PHP de votre site WordPress. Ces journaux sont utiles pour le dépannage des problèmes de votre site WordPress.

Comment activer le mode de débogage de WordPress

Pour activer le journal des erreurs PHP pour WordPress, vous devrez vous connecter à votre site à l'aide de FTP, puis modifier le fichier wp-config.php

Après avoir ouvert ce fichier, vous devrez ajouter les lignes de code suivantes avant le texte où il est indiqué "C'est tout, arrêtez de modifier ! Bonne publication."

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
/* That's all, stop editing! Happy publishing. */

This code will enable debugging mode in WordPress and write any PHP errors to a log file.

Où consulter les journaux d'erreurs de WordPress

Après avoir activé le mode de débogage de WordPress, vous devrez vous rendre dans le répertoire " wp-content " pour trouver le fichier " debug.log " (en vous connectant à nouveau à votre site via FTP), puis faites un clic droit sur ce fichier et choisissez de Visualiser/Modifier le fichier.

 

Après avoir accédé au fichier journal d'erreurs, vous pourrez consulter les messages d'erreur ainsi que leurs horodatages correspondants.

 

À désactiver le mode débogage, you will just need to set the WP_DEBUG and WP_DEBUG_LOG lines to "false".

define( 'WP_DEBUG', false );
define( 'WP_DEBUG_LOG', false );
/* That's all, stop editing! Happy publishing. */

In case you’re not experienced with connecting to your site via FTP or you were not successful in viewing the PHP Error Logs, please contact your hosting provider and ask them for help regarding this.

Si une page blanche s'affiche lorsque vous ouvrez l'interface de traduction TranslatePress, vérifiez les causes courantes suivantes :

1. Erreur de politique de sécurité du contenu (CSP) — Vérifiez ceci d'abord

Ouvrez la console du développeur de votre navigateur, onglet Console, et recherchez une erreur CSP en rouge.

Pour résoudre ce problème, installez le plugin Really Simple SSL, qui résout souvent les problèmes liés à la CSP.

2. Erreurs JavaScript dues à la minification ou à la fusion de fichiers

Certains plugins d'optimisation (par exemple, WP-Optimize) minifient ou fusionnent les fichiers JS, ce qui provoque des conflits.

• Exclure ces fichiers (Éditeur de traduction uniquement)
Ces fichiers JS sont requis pour l'éditeur de traduction et ne doivent pas être optimisés :
/wp-content/plugins/translatepress-multilingual/assets/js/trp-editor.js
/wp-content/plugins/translatepress-multilingual/assets/js/trp-string-translation-editor.js
/wp-content/plugins/translatepress-multilingual/assets/js/trp-iframe-preview-script.js
/wp-content/plugins/translatepress-multilingual/assets/js/trp-editor-overlay.js
• Exclusions facultatives (problèmes frontend)

Si vous rencontrez des erreurs JavaScript ou des problèmes de traduction sur le front-end — en particulier les articles du panier WooCommerce ou le texte généré par JavaScript — excluez-les également :


/wp-content/plugins/translatepress-multilingual/assets/js/trp-translate-dom-changes.js
/wp-content/plugins/translatepress-multilingual/assets/js/trp-frontend-compatibility.js

3. Erreurs PHP

Activer le débogage pour vérifier si les erreurs PHP empêchent le chargement de l'éditeur :

Activer WP_DEBUG and WP_DEBUG_LOG dans wp-config.php, then inspect the log at: wp-content/debug.log

Problèmes PHP courants :

• Limite de mémoire PHP atteinte → Augmentez la limite de mémoire PHP du serveur.
• Erreur fatale PHP : appel à une fonction indéfinie mb_http_output() → Le serveur n'a pas la bibliothèque Multibyte String (mbstring). Installez et activez https://www.php.net/manual/en/book.mbstring.php

Si aucune des solutions ci-dessus ne résout le problème, collectez les erreurs de la console du navigateur et du fichier debug.log, puis contactez le support pour obtenir de l'aide.

Lorsque ce problème survient, il peut être dû à certaines règles de réécriture du fichier .htaccess si vous avez utilisé le plugin GTranslate par le passé. Ce plugin semble ajouter de nouvelles règles au fichier qui ne sont pas supprimées lors de la désinstallation du plugin. Celles-ci perturbent le fonctionnement de TranslatePress si vous décidez de l'utiliser par la suite.

Veuillez essayer de supprimer la section de configuration GTranslate (elle devrait ressembler au code suivant) et tout devrait fonctionner comme prévu :

### Début de la configuration GTranslate ### Règle de réécriture ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)/(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)/(.*)$ /$1/$3 [R=301,L] RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)/(.*)$ /wp-content/plugins/gtranslate/url_addon/gtranslate.php?glang=$1&gurl;=$2 [L,QSA] RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)$ /$1/ [R=301,L] ### FIN de la configuration GTranslate ###

L'entrée de l'onglet Licence n'apparaît qu'après l'installation de la version pro / du module complémentaire payant.
Alors d'abord, allez sur votre Compte TranslatePress téléchargez le module complémentaire, puis installez-le et activez-le sur votre site Web. Le champ Licence s'affichera ensuite.

Il est possible que certaines chaînes ne puissent pas être cliquées via notre interface visuelle.

Si tel est le cas, vous devriez essayer de les chercher à l'intérieur du Liste de chaînes qui est disponible dans la langue actuelle en haut de l'interface de traduction.

 

Si du texte est manquant sur votre page traduite, essayez de corriger cela en activant l'option Corriger le contenu dynamique manquant de Paramètres -> TranslatePress -> onglet « Avancé ».

Si le problème n'est toujours pas résolu, veuillez contacter le support.

Si vous rencontrez des problèmes avec votre clé d'API Google, assurez-vous de les avoir suivis correctement notre guide pour le générer.

Soyez extra prudent à Étape 4 puisque c'est là la cause des problèmes la plupart du temps.

Si les titres de page (ou titres d'article, titres de custom post type) dans la partie traduite du site sont vides ou incorrects, la première chose à essayer est d'aller TranslatePress -> Paramètres -> Avancé -> Désactiver les balises de conteneur d'article pour le titre de l'article et l'activer.

Si cela ne fonctionne pas, veuillez contacter le support technique avec le plus de détails possible afin que nous puissions diagnostiquer le problème.

Si vous remarquez qu'un élément ne fonctionne pas correctement sur la version traduite de votre page (bouton impossible à cliquer, image qui ne s'affiche pas, etc.), veuillez essayer Options de dépannage.S'ils n'aident pas, s'il vous plaît contacter le support.

Si le texte de votre page de traduction scintille, veuillez essayer de résoudre ce problème en activant l'option Corriger le contenu dynamique manquant dans Paramètres -> TranslatePress -> onglet « Avancé ».

Si le problème n'est toujours pas résolu, veuillez contacter le support.

If your site is hosted with WP Engine, you can make it work by adding the following to your site’s wp-config.php:

define( 'WPE_GOVERNOR', false );

If you have Smush plugin, go to Smush Settings -> Lazy Load tab and Désactiver this feature.

If you click the save button but you don't get a "Saved" confirmation please make sure you access the website from HTTPS. Sometimes HTTP isn't set as a redirect towards HTTPS and can cause problems with parts of the plugin.

If in the translated part of the website there are links to different posts/pages and all of them link to the same post/page, the first thing you have to check is if you created those posts/pages using Duplicate Page greffon.

If you create a post/page, translate its slug and then duplicate it, any reference to the duplicated post/page will redirect you to the original post/page even if the link points to the duplicated page.

To fix this, open the front-end of TranslatePress and go to String Translation -> Post Slugs. Manually translate each slug of the affected posts/pages.

Le sprintf() function is used inside WordPress to replace gettext strings like "Hello %s" with "Hello John". Basically replacing %s with a dynamic strings that should not be translatable. Like a name or number.
This error means there is a gettext string that was not translated correctly and doesn't contain a %s for example. So instead of translating "Ola %s" it was translated to just "Ola", thus throwing the error.

To fix this you need to find the exact string that's being translated and exclude it from gettext translation inside TranslatePress -> Settings -> Advanced -> Exclude Gettext Strings.
In this case you need to go to that file and number and see what gettext string is being translated there and exclude it. If that doesn't work, you'll probably need to delete the translation from the .po files that automatically come with WordPress (it's possible the translation is wrong) and you can do that by using a plugin like LocoTranslate.