WP STAGING et configuration WPML

Tu utilises un Plugin multilingue de qualité comme WPML, Weglott, Polyglot ou un autre, et tu as configuré les réglages de langue pour utiliser des dossiers personnalisés avec le code de langue, ex. tondomaine.com/fr/ ?
Tu peux rencontrer un problème où l’ouverture d’une page sur un site de staging génère une erreur 404. Cela peut se produire si les permaliens du site de staging sont désactivés.

Option 1 : créer le site de staging dans un sous-domaine

Tu peux cloner ton site WordPress vers un sous-domaine. Si tu fais cela, tu n’auras plus de problèmes de structure de liens, car la structure d’URL imite celle du site de production.

Option 2 : modifier le format d’URL de langue WPML

Tu peux basculer les réglages de langue WPML sur ton site de staging WP Staging vers une langue basée sur l’URL comme tondomaine.com/staging-site?lang=fr

Tu peux modifier cela sous WPML > Langues.

Remarque : si tu pousses le site de staging vers la production, il est recommandé de rétablir ce réglage sur le site de staging avant d’effectuer le push pour éviter de modifier la structure des permaliens sur le site en production.

Option 3 : activer les permaliens basés sur le nom de l’article

Tu peux essayer d’activer les permaliens basés sur le nom de l’article sur le site de staging en suivant cet article.

Option 4 : créer un site de staging avec des domaines différents par langue

Disons que tu as un site en production avec le domaine « example.com » pour la version anglaise, « example.fr » pour la française et « example.de » pour l’allemande, et que tu veux créer des clones des sites sur staging.example.com, staging.example.fr et staging.example.de.

Ce que tu dois faire, c’est utiliser ce snippet de code comme mu-plugin : (Modifie-le pour l’adapter à tes domaines) :

PHP
function wpstg_cloning_custom_params($args)
{
      $args['search_for'] = array_merge(
         $args['search_for'],
         ['example.fr', 'example.fr']
      );

      $args['replace_with'] = array_merge(
         $args['replace_with'],
         ['staging.example.fr', 'staging.example.de']
      );

      return $args;
}

add_filter('wpstg_clone_searchreplace_params', 'wpstg_cloning_custom_params'); 

Ensuite, crée ton site de staging sur le sous-domaine « staging.example.com » en suivant ce guide. Bien sûr, le sous-domaine doit d’abord être créé via le panneau de contrôle de ton hébergeur.

N’oublie pas de faire pointer ces nouveaux sous-domaines (staging.example.fr, staging.example.de) vers l’IP du site de staging principal via le gestionnaire DNS du domaine.

Conserver la clé de licence WPML après le push du site de staging vers le site en production

Si tu veux conserver les données de licence WPML du site en production telles quelles et ne pas les écraser avec les données du site de staging après le processus de push, tu peux créer un fichier mu-plugin et y ajouter ce snippet de code :

PHP
<?php
/*
Plugin Name: mu-plugin to keep the WPML license of the live site
Description: After you push the staging site to the live site, the live site's WPML license won't change
Version: 1.0
Author: WPSTAGING
*/

function wpstg_push_preserve_options($options){
    $preserveOptions = ['wp_installer_settings'];
    return array_merge($options, $preserveOptions );
}
add_filter('wpstg_preserved_options','wpstg_push_preserve_options');

Ensuite, pousse le site de staging vers le site en production, et tu conserveras la même clé de licence WPML qui ne sera pas écrasée.

Options de dépannage WPML

Après avoir poussé ou cloné ton site WordPress avec WP Staging, les traductions WPML peuvent ne pas fonctionner comme prévu. La gestion interne du cache de WPML en est souvent la cause. Heureusement, WPML propose quelques options de dépannage puissantes que tu peux utiliser pour purger et actualiser le cache WPML.

Les informations sur cette page s’adressent aux utilisateurs avancés de WPML. Si tu n’es pas sûr de ce que tu dois faire, contacte le support WPML avant d’exécuter toute option de dépannage WPML.

Tu peux ouvrir la page de dépannage WPML depuis WPML > Support.
Clique sur le lien de dépannage.

Comment accéder aux options de dépannage WPML
Comment accéder aux options de dépannage WPML 

Crée un Backup de ton site WordPress avant d’exécuter toute action listée sur cette page d’options.

La page des options de dépannage WPML
La page des options de dépannage WPML

Dans le tableau ci-dessous, tu trouveras une description des commandes les plus importantes et des scénarios d’utilisation possibles :

Commande Quand l’utiliser
Vider le cache dans WPML
  • Si une affectation de traduction ne fonctionne pas.
  • Si tu as des blocages de base de données liés aux chaînes.
  • Si les chaînes n’apparaissent pas et que tu obtiens une erreur du type « WordPress database error Deadlock found when trying to get lock ». Cela se produit surtout après une migration d’un environnement de développement local vers la production. Essaie aussi de redémarrer la transaction pour la requête INSERT IGNORE INTO.
  • Problèmes avec le sélecteur de langue.
Supprimer les entrées fantômes des tables de traduction
  • Supprimer les entrées de la table WPML si elles ne sont pas correctement liées après des mises à jour ou des corrections de bugs.
  • Supprimer les chaînes inutilisées.
  • Lors de la réception d’erreurs pendant le déplacement de produits avec le statut Brouillon vers la corbeille.
Corriger la collation element_type
  • À utiliser si le contenu traduit est manquant après la traduction.
  • À utiliser pour corriger des erreurs du type : « post_type est X mais la collation est Y ».
  • Si tu ne peux pas voir une liste d’articles ou de pages après l’installation de WPML.
  • Les produits ne sont pas listés pour la traduction dans WooCommerce.
Corriger la collation des tables WPML
  • Si tu obtiens des erreurs liées au mélange illégal de collations. Par exemple, si tu obtiens l’erreur « WordPress database error Illegal mix of collations utf8_general/utf8mb4 ».
Définir les informations de langue
  • Si tu as créé du contenu alors que WPML était inactif, ou si d’autres Plugins créent du contenu en contournant l’API WordPress, ce contenu peut ne pas avoir d’informations de langue et ne s’affichera pour aucune langue. Cette action résoudra le problème.
  • Si les articles traduits ne sont pas connectés à l’original.
Nettoyer et optimiser les tables de chaînes
  • À utiliser uniquement si tu as un site qui a été traduit avec WPML avant la version 4.3. L’utilisation de cette commande supprimera le contenu de la table de cache des chaînes (_icl_strings_url et _icl_strings_pages) et optimisera la table icl_strings. Elle ne fonctionnera que lorsque tous les fichiers MO sont correctement créés. Dans d’autres situations, tu pourras cliquer sur le bouton mais aucune action ne sera déclenchée. Si le bouton ne fonctionne pas, va sur la page WPML → Localisation des thèmes et extensions et scanne les thèmes et Plugins pour les fichiers MO manquants.

Source :
https://wpml.org/documentation/support/wpml-troubleshooting-options/

Articles connexes

Updated on mai 23, 2026

Rene Hermenau

Auteur : Rene Hermenau

About the author: René Hermenau is the founder of WP STAGING. He works on WordPress backups, staging, migrations, database handling, and safe deployment workflows.