Clés du site WPML - Comment elles fonctionnent, quand vous en avez besoin, comment les réinitialiser

WPML 5.0 Bêta

Cette page décrit WPML 5.0, actuellement en version bêta. Jusqu’à ce que WPML 5.0 soit publié, la traduction IA est facturée en crédits de traduction (4 crédits = 1 mot).

Comment fonctionnent les clés du site

Chaque site enregistré avec WPML obtient une clé du site unique liée à votre compte WPML. La clé autorise le site à utiliser la mémoire de traduction, le glossaire et le quota de mots de votre compte.

La clé de votre site actuel est visible à deux endroits :

WPML > Activer et mettre à jour. La bannière d’enregistrement affiche un suffixe masqué (par exemple, ******abcd) afin que vous puissiez identifier la clé utilisée par le site sans exposer la clé complète.
La page de votre compte WPML.org. Répertorie chaque site que vous avez enregistré et sa clé complète.

Pour enregistrer un nouveau site manuellement, générez une clé sur la page de votre compte et collez-la dans l’interface d'administration de WPML lorsque vous y êtes invité : soit dans l’Assistant de configuration lors de la prise en main, soit dans le formulaire de clé du site intégré à l’avis de migration consolidé lorsque WPML le demande.

Pour désenregistrer un site (par exemple, parce que vous le mettez hors service), cliquez sur Désenregistrer WPML de ce site dans la bannière d’enregistrement sous WPML > Activer et mettre à jour. C’est sur ce même écran que WPML installe et met à jour les extensions – la clé du site qui s’y trouve détermine à quel compte ces téléchargements appartiennent.

Supprimer l’avis « Ce site est enregistré comme site de développement »

Un compte WPML peut enregistrer un site de développement par site de production. L’avis du site de développement (« Ce site est enregistré sur WPML.org en tant que site de développement ») apparaît intentionnellement sur chaque page de l’interface d'administration de WPML sur le site de développement, afin d’éviter que les clones de développement ne soient traités comme des sites de production.

Lorsque vous êtes prêt à passer un site du développement à la production :

Ouvrez votre compte WPML et trouvez le site dans votre liste de sites enregistrés.
Modifiez son type de Développement à Production.
Enregistrez.
Sur le site lui-même, ouvrez WPML > Activer et mettre à jour et cliquez sur Vérifier les mises à jour. L’avis de site de développement disparaît une fois que la modification côté compte est synchronisée.

Si l’avis persiste après une synchronisation, exécutez WPML > Support > Vérification du système > Actualiser les données de licence. Cela efface le cache de licence local et récupère à nouveau l’état du compte.

Enregistrer automatiquement des sites via une constante PHP

Pour les flux de travail automatisés de développement/préproduction/production (où le site est déployé par un pipeline CI et où aucun humain ne peut coller une clé), vous pouvez coder en dur la clé du site dans wp-config.php à l’aide de constantes PHP. WPML les lit lors de l’activation et enregistre le site sans rien vous demander.

Dans wp-config.php, avant la ligne « That’s all, stop editing! » (C'est tout, ne touchez pas à ce qui suit !) :

define( 'OTGS_INSTALLER_SITE_KEY_WPML', 'your-site-key-here' );

WPML récupère la constante lors de son activation et ignore l’invite d’enregistrement. La même valeur de clé peut être définie sur les environnements de développement, de préproduction et de production. WPML les sépare par domaine.

C’est la bonne approche pour les environnements où :

Le site est approvisionné par des scripts Docker / Composer / WP-CLI et il n’y a aucune étape de configuration manuelle.
Vous gérez de nombreux sites et souhaitez que l’enregistrement soit déclaratif, et non via une série de clics.
L’avis de migration consolidé demande une clé sur un environnement fraîchement déployé.