Tutoriel Wordpress & Woocommerce

Introduction

Le plug-in WordPress WEB-T – eTranslation Multilingual permet de traduire automatiquement le contenu de sites Web. Le site Web doit être monolingue et fonctionner avec la version 3.1.0 de WordPress ou une version plus récente. L’utilisation simultanée avec d’autres solutions multilingues peut provoquer des problèmes techniques inattendus ou des difficultés d’utilisation. 

How it works

L’outil multilingue WEB-T–eTranslation Multilingual permet de traduire le contenu d’une page Web dans la langue souhaitée en utilisant un sélecteur de langue. Pour prétraduire le contenu d’un site Web en une seule fois, il suffit de cliquer sur WEB-T – eTranslation Multilingual settings > Advanced > Manage translations. Toutes les traductions sont enregistrées dans la base de données, ce qui vous permet de les modifier à l’aide de l’éditeur de traduction. 

1. IInstaller le plug-in. 
2. Récupérer l’accès du fournisseur de traduction automatique (TA) : MT provider access.
3. Configurer le fournisseur de traduction dans les paramètres du plug-in. 
4. Configurer les langues et les domaines de traduction. 
5. Traduire le site page par page ou prétraduire tout le contenu en une seule fois. 
6. Utiliser l’éditeur de traduction pour améliorer la qualité des textes traduits. Les corrections s’affichent instantanément sur le site Web.

Installer le plug-in

Depuis le répertoire des plug-in WordPress

Vous pouvez télécharger le plug-in depuis le répertoire des extensions WordPress :  https://wordpress.org/plugins/etranslation-multilingual/

Pour installer le plug-in : 

1. Connectez-vous au tableau de bord WordPress. 
2. Ouvrez la section Plugins. 
3. En haut de la page, cliquez sur Add new. 
4. Recherchez le plug-in WEB-T – eTranslation Multilingual
5. Cliquez sur Install Now
6. Une fois l’installation terminée, cliquez sur Activate

Installer manuellement à partir d’un fichier ZIP

Pour installer le plug-in : 

1. Connectez-vous au tableau de bord WordPress. 
2. Ouvrez la section Plugins. 
3. En haut de la page, cliquez sur Add new. 
4. Cliquez sur Upload Plugin. 
5. Cliquez sur Choose file, puis téléchargez le fichier .zip du plug-in. Le fichier ZIP peut être téléchargé ici : https://website-translation.language-tools.ec.europa.eu/solutions/web-t-wordpress_en 
6. Cliquez sur Install Now. 
7. Une fois l’installation terminée, cliquez sur Activate Plugin. 

Vous pouvez également télécharger le dossier décompressé du plug-in dans le répertoire /wp-content/plugins/.

Vue d’ensemble

La page des paramètres du plug-in est divisée en plusieurs onglets :

• General – définir les langues de traduction, personnaliser le sélecteur de langue, régler l’affichage des langues et utiliser un sous-répertoire pour la langue par défaut.
• Translate site – ouvrir l’éditeur de traduction.
• Automated translation – définir le fournisseur de traduction, bloquer les robots d’indexation, gérer la visibilité de l’avertissement de TA.
• Advanced – gérer les traductions (prétraduction et suppression) et les options de dépannage, exclure du contenu de la traduction, ajouter les balises SEO spécifiques à la traduction, l’option débogage et d’autres options.

L’éditeur de traduction comprend :

• Visual editor – visualiser les modifications apportées aux traductions, y compris celles liées au SEO.
• String translation – modifier la chaîne de caractères gettext (chaînes de thème et de plug-in) et traduire les e-mails.

Configure translation provider

Avant de continuer : 
Vous devez disposer d'un compte fournisseur de traduction compatible avec eTranslation ou WEB-T.
Vous avez obtenu les identifiants API d'eTranslation ou l'URL de base et la clé API de votre prestataire de traduction.

Pour configurer le fournisseur de traduction : 

1. Dans le tableau de bord WordPress, ouvrez la section Plugins. 
2. Recherchez WEB-T – eTranslation Multilingual. 
3. Cliquez sur Settings. 
4. Dans l’onglet Automated Translation, activez la traduction automatique.
5. Sur la ligne Translation Engine, choisissez le moteur de traduction. Vous pouvez utiliser eTranslation ou un fournisseur personnalisé.
6. En fonction de votre choix, saisissez les informations d’identification :
   1. username (nom d’utilisateur) et password (mot de passe) utilisés pour eTranslation
   2. ou base URL et API Key si vous choisissez un fournisseur personnalisé.
7. En bas de la page, cliquez sur Save Changes. 

Configurer les langues et les domaines de traduction

Pour configurer les langues de traduction : 

1. Dans le tableau de bord WordPress, ouvrez la section Plugins. 
2. Recherchez WEB-T – eTranslation Multilingual. 
3. Cliquez sur Settings. 
4. Dans l’onglet General, définissez la langue par défaut de votre site. 
5. Dans la section All Languages, sélectionnez une ou plusieurs langues et domaines, puis cliquez sur Add. 
6. En bas de la page, cliquez sur Save Changes. 

Pour déterminer l’ordre d’affichage des langues dans le sélecteur de langue, faites-les glisser et placer-les dans l’ordre souhaité.

Vérifier la bonne configuration du plug-in

Pour s’assurer que le plug-in est configuré correctement : 

1. Ouvrez votre site Web. 
2. En haut de la page, repérez un sélecteur de langue flottant. 
3. Sélectionnez une langue. 
4. La page s’actualise et s’affiche automatiquement dans la langue sélectionnée. 
5. Un avertissement de TA s’affiche. 

Personnaliser le sélecteur de langue

Vous avez le choix entre trois options : l’utilisation d’un shortcode, l’intégration dans les menus ou la présentation sous forme d’un sélecteur flottant. 

Dans cette section :

• Floating language switcher:
  • Change floating language switcher appearance
  • Change floating language switcher position
  • Disable default floating language switcher
• Shortcode language switcher
  • Add shortcode language switcher to a page
  • Add shortcode language switcher to a header, footer, or sidebar
• Languages as menu items

Sélecteur de langue flottant

Par défaut, l’écran affiche un sélecteur de langue flottant en haut à droite de la page.

Personnaliser l’apparence du sélecteur de langue flottant

Vous avez le choix entre trois thèmes : le bleu (celui par défaut), le clair et le sombre :

Pour personnaliser l’affichage du sélecteur de langue flottant : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet General. 
2. En bas de la page, repérez la section Language switcher. 
3. Sous l’option Floating language selection, sélectionnez un thème. 
4. Cliquez sur Save Changes. 

Modifier la position du sélecteur de langue flottant 

Vous pouvez placer le sélecteur de langue en haut à droite, en haut à gauche, en bas à droite ou en bas à gauche.

Pour modifier la position du sélecteur de langue flottant à l’écran : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet General. 
2. En bas de la page, repérez la section Language switcher. 
3. Sous l’option Floating language selection, choisissez la position du sélecteur sur la page. 
4. Cliquez sur Save Changes. 

Désactiver le sélecteur de langue flottant par défaut

Si vous utilisez un shortcode ou si vous avez intégré votre sélecteur de langue à un menu, vous pouvez masquer le sélecteur de langue flottant qui s’affiche par défaut.

Pour désactiver le sélecteur de langue flottant : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet General. 
2. En bas de la page, repérez la section Language switcher. 
3. Décochez la case à côté de l’option Floating language selection. 
4. Cliquez sur Save Changes.

Sélecteur de langue en utilisant un shortcode

À l’aide d’un shortcode [language-switcher], vous pouvez intégrer un sélecteur de langue sur n’importe quelle page.

Intégrer un sélecteur de langue à une page en utilisant un shortcode  

Pour ajouter un sélecteur de langue sur une seule page à l’aide d’un shortcode : 

1. Ouvrez la page à modifier dans l’éditeur. 
2. Ajoutez une zone de texte, puis saisissez [language-switcher]. 
3. En haut de la page, cliquez sur Update. 

Intégrer un sélecteur de langue dans l’en-tête, le pied de page ou la barre latérale en utilisant un shortcode 

Pour ajouter un sélecteur de langue dans l’en-tête, le pied de page ou la barre latérale à l’aide d’un shortcode : 

1. Dans le tableau de bord WordPress, ouvrez Appearance > Widgets. 
2. Repérez les widgets de l’en-tête, du pied de page et de la barre latérale. 
3. Cliquez sur +, puis ajoutez un bloc de texte. 
4. Saisissez [language-switcher]. 
5. En haut de la page, cliquez sur Update.  

Sélecteur de langue dans un menu

Pour intégrer un sélecteur de langue dans n’importe quel menu : 

1. Dans le tableau de bord WordPress, ouvrez Appearance > Menus. 
2. Créez un menu ou modifiez un menu existant. 
3. Sous l’option Add menu items, cliquez sur Language Switcher pour dérouler les options. 
4. Sélectionnez les langues. 
5. Cliquez sur Add to menu. 
6. Choisissez l’emplacement du menu. 
7. Enregistrez les modifications. 

Modifier l’affichage des langues

Pour afficher les langues en utilisant leur dénomination native : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet General. 
2. À côté de l’option Native language name, sélectionnez Yes dans le menu déroulant. 
3. Cliquez sur Save Changes. 

Pour modifier les paramètres d’affichage des langues : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet General. 
2. En bas de la page, repérez la section Language switcher. 
3. Sous le sélecteur de langue choisi, sélectionnez le style d’affichage des langues.  
4. Cliquez sur Save Changes. 

Personnaliser l’avertissement de TA

Par défaut, une barre de notification s’affiche en haut des pages qui ont été traduites automatiquement, afin d’avertir le lecteur. Elle propose également de basculer le contenu dans la langue de départ. L’avertissement est également traduit automatiquement.

Pour modifier l’avertissement dans la barre de notification : 

1. Ouvrez Translation editor. 
2. Survolez la barre de notification avec la souris, puis cliquez sur . 
3. Modifiez la traduction. 
4. En haut de la page, cliquez sur Save translation. 

Pour afficher l’avertissement en anglais : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. Recherchez la section Exclude strings. 
3. Sous l’option Exclude selectors only from automated translation, ajoutez « translation-notice » à la liste des sélecteurs à exclure. 
4. En bas de la page, cliquez sur Save Changes. 

Pour désactiver totalement la barre de notification : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Automated translation. 
2. À côté de l’option Show machine translation notice, sélectionnez No. 

Traduire et éditer du contenu

L’éditeur de traduction permet de sélectionner et de traduire le texte qui s’affiche à l’écran. La traduction se fait en traitant chaque chaîne de caractères individuellement. Par exemple, lorsqu’un lien est inclus dans une phrase, le lien et la phrase sont considérés comme deux chaînes de caractères distinctes. Avant de modifier la traduction de plusieurs pages différentes, vous devez d’abord ouvrir la page concernée.

Dans cette section :

• Open Translation editor
• Translate a single page or article
• Translate all pages and posts (Pre-translation)
• Edit Automated translations or add manual
• Merge text into blocks
• Translate SEO meta data
• Display different image for each language
• Translate Gettext strings
• Translate emails

Ouvrir l’éditeur de traduction

Pour ouvrir l’éditeur de traduction : 

1. Dans la page des paramètres du plug-in, cliquez sur l’onglet Translate site. 

   ou 

2. En haut de la page, dans la barre d’outils d’administration WordPress, cliquez sur Translate Page. 

Traduire une page ou un article

Pour traduire une page ou un article :

1. Ouvrez la page.
2. Sélectionnez une langue dans le sélecteur de langue.
3. La page s’actualise et s’affiche automatiquement dans la langue sélectionnée. 
4. Un avertissement de TA s’affiche. 

Pour traduire une page dans l’éditeur de traduction :

1. Ouvrez Translation editor. 
2. Sous l’onglet Visual editor, sélectionnez la langue de traduction. 
3. Patientez le temps que la traduction se termine.

Traduire l’ensemble des pages et des publications (prétraduction)

Pour traduire l’ensemble des pages et des publications :

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. Sous l’option Manage translations, cliquez sur Translate all.

Modifier une traduction automatique ou intégrer une traduction manuelle

Pour modifier une traduction automatique ou intégrer une traduction manuelle : 

3. Ouvrez Translation editor. 
4. Sous l’onglet Visual editor, sélectionnez la langue de traduction. 
5. Choisissez la chaîne de caractères à traduire :
   1. Dans la barre latérale, repérez le menu déroulant, puis sélectionnez la chaîne de caractères à traduire, ou 
   2. Repérez la chaîne de caractères texte sur la page, survolez-la avec la souris, puis cliquez sur . 
6. Modifiez la traduction. 
7. En haut de la page, cliquez sur Save translation.

Fusionner le texte pour former des blocs

Pour fusionner le texte et former des blocs plus grands : 

1. Repérez le texte que vous souhaitez fusionner. 
2. Survolez-le avec la souris, puis cliquez sur. 

Traduire les métadonnées SEO

Pour modifier la traduction de métadonnées SEO ou ajouter des traductions manuelles : 

1. Ouvrez Translation editor. 
2. Dans la barre latérale, choisissez la langue de traduction souhaitée. 
3. Sélectionnez la chaîne de caractères SEO à traduire. 
4. Modifiez la traduction. 
5. En haut de la page, cliquez sur Save translation.

Pour activer la traduction de chaîne de caractères SEO supplémentaire, consultez "Additional SEO meta tags".

Pour modifier une image : 

1. Ouvrez Translation editor. 
2. Repérez l’image sur la page, survolez-la avec votre souris, puis cliquez sur . 
3. Dans la barre latérale, cliquez sur Add media. 
4. Sélectionnez une image. 
5. En haut de la page, cliquez sur Save translation. 

Traduire les chaînes de caractères gettext

Pour traduire un thème et un plug-in, basculez sur String Translation, puis cliquez sur l’onglet Gettext. Vous pouvez alors traduire des éléments comme des champs de formulaire ou des fenêtres contextuelles (ou pop-up). Pour afficher toutes les chaînes de caractères, cliquez sur Rescan plugins and theme settings. Sinon, seules celles déjà visualisées sur le site Web s’affichent dans le tableau. Pour une meilleure visualisation des chaînes de caractères, vous pouvez appliquer des filtres en fonction du statut de la traduction, du domaine ou du texte.

Pour afficher, modifier ou ajouter des traductions manuelles, gettext string :

1. Ouvrez l’éditeur de traduction : Open the Translation editor. 
2. Dans la barre latérale, cliquez sur String translation. 
3. Dans le tableau, appliquez le filtre de langue.
4. Repérez la chaîne de caractères qui vous intéresse, puis cliquez sur Edit.
5. Modifiez la traduction. 
6. En haut de la page, cliquez sur Save translation.

Traduire un e-mail

Les e-mails WooCommerce sont envoyés dans la langue préférée du client. Pour vérifier que chaque chaîne de caractères d’e-mail est correctement traduite et apporter des modifications, vous pouvez rechercher chaque chaîne de caractères à l’aide de la fonction de recherche Search email strings. Si la chaîne de caractères que vous recherchez ne figure pas dans la liste, consultez l’onglet Gettext.

Pour visualiser une traduction automatique, la modifier ou pour intégrer une traduction manuelle des e-mails : 

7. Ouvrez l’éditeur de traduction : Open the Translation editor. 
8. Dans la barre latérale, cliquez sur String translation. 
9. Sélectionnez l’onglet Emails.
10. Dans le tableau, appliquez le filtre de langue.
11. Repérez la chaîne de caractères qui vous intéresse, puis cliquez sur Edit.
12. Modifiez la traduction. 
13. En haut de la page, cliquez sur Save translation.

Si vos e-mails ne sont pas visibles, cliquez sur Rescan plugins and theme for strings.

FAQ

Comment changer le moteur de TA et actualiser les traductions ?

Pour changer le moteur de TA et actualiser les traductions des contenus du site Web : 

1. Pour supprimer les anciennes traductions, reportez-vous à la section  "How to delete translations"?
2. Pour configurer de nouvelles langues, reportez-vous aux sections "Configure translation provider" et "Configure translation languages and domains".
3. Pour traduire le contenu, reportez-vous à la section "Content translation and editing".

Comment supprimer les traductions ?

Pour supprimer tous les contenus traduits avec le plug-in WEB-T :

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. Sous l’option Manage translations, cliquez sur Delete translations.

Comment exclure une partie du contenu lors de la traduction ?

Pour ne pas traduire certains éléments : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. Recherchez la section Exclude strings. 

3. Sous l’option Exclude Gettext Strings, ajoutez les chaînes de caractères gettext à exclure 

   ou 

4. Sous l’option Exclude selectors from translation, ajoutez des sélecteurs HTML.  
5. En bas de la page, cliquez sur Save Changes. 

Comment exclure une partie du contenu de la traduction automatique ?

Pour exclure du contenu de la traduction automatique : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. Recherchez la section Exclude strings. 
3. Sous l’option Exclude strings from Automated translation, ajoutez les chaînes de caractères (noms, jargon technique...). 
4. En bas de la page, cliquez sur Save Changes. 

Comment exclure certaines pages de la traduction ?

Pour exclure des chemins de la traduction : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. Recherchez la section Exclude strings. 
3. Sous Do not translate certain paths, sélectionnez entre « Exclude Paths from Translation » et « Translate Only Certain Paths ». 
4. Ajoutez les chemins. 
5. En bas de la page, cliquez sur Save Changes.

Puis-je ignorer la détection dynamique de contenu ?

Pour ignorer la détection dynamique de contenu : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. Recherchez la section Exclude strings. 
3. Sous l’option Exclude from dynamic translation, ajoutez les sélecteurs d’éléments. 
4. En bas de la page, cliquez sur Save Changes. 

Comment puis-je ajouter un slug de langue à l’URL de la langue par défaut ?

Le plug-in permet de traduire les slugs d’URL pour un meilleur référencement. Vous pouvez afficher les slugs par catégorie et modifier les traductions pour chaque langue de la même manière que vous le feriez pour les autres traductions. 

Pour traduire les slugs d’URL : 

1. Ouvrez Translation editor. 
2. En bas de la barre latérale, cliquez sur URL Slug Editor. 
3. Repérez le slug d’URL que vous souhaitez modifier, survolez-le avec la souris, puis cliquez sur Edit. 
4. Modifiez la traduction. 
5. En haut de la page, cliquez sur Save Changes. 

Pour activer la traduction automatique de slugs d’URL : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Automated translation. 
2. À côté de l’option Automatically Translate Slugs, cochez Yes. 
3. En bas de la page, cliquez sur Save Changes. 

Est-ce que l’extension traduit des images ?

L’utilisateur doit localiser lui-même les images et les ajouter aux pages traduites.

Est-ce que la traduction affecte le temps de chargement du site Web ?

Le temps de chargement ne varie pas de manière significative entre la version traduite et la version originale du contenu. Si une page n’est pas prétraduite, le visiteur devra simplement attendre sa traduction.

Dépannage

La traduction ne fonctionne pas

Si eTranslation est activé dans le plug-in WEB-T, le site Web doit alors être publié et accessible depuis le service eTranslation. Si ce n’est pas le cas, la traduction avec eTranslation ne fonctionne pas.

Pour résoudre ce problème, mettez en ligne ces sites Web et vérifiez si leurs URL sont accessibles depuis l’extérieur (par exemple en effectuant des requêtes HTTP POST) : 

{{WEBSITE_URL}}/wp-json/etranslation/v1/document/destination/123

La traduction est lente

La vitesse de traduction dépend du fournisseur de traduction. Un très grand nombre d’utilisateurs utilisent les systèmes proposés par l’outil eTranslation. Cette lourde charge de travail peut entraîner des ralentissements.

Lorsque vous chargez le contenu d’une page pour la première fois, sa traduction peut prendre un peu de temps. Cependant, la traduction sera sauvegardée et elle s’affichera instantanément la prochaine fois.

La traduction comporte des erreurs

La traduction automatique ne peut pas remplacer complètement les traducteurs humains. Il est essentiel de faire réviser et éditer les traductions par un être humain. La qualité de la traduction dépend du moteur de traduction automatique utilisé et du fournisseur.

Certaines fonctionnalités ne fonctionnent pas dans la page traduite 

Le code HTML est peut-être invalide ou mal formaté dans le thème WordPress utilisé ou dans d’autres plug-in. Le plug-in peut essayer de corriger une partie du code HTML. 

Pour essayer de corriger automatiquement le code HTML : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. En haut de la page, repérez la section Troubleshooting. 
3. À côté de Fix broken HTML, cochez Yes. 

Le contenu chargé dynamiquement ne s’affiche pas dans la traduction 

Si le contenu inséré en JavaScript n’est pas inclus dans la traduction, le plug-in peut afficher le contenu dynamique dans la langue d’origine avant que la traduction ne soit terminée. 

Pour essayer de corriger automatiquement le code HTML : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. En haut de la page, repérez la section Troubleshooting. 
3. À côté de Fix missing dynamic content, cochez Yes. 

Les titres de la publication ou de la page ne s’affichent pas correctement ou ne s’affichent pas du tout dans la version traduite 

Pour désactiver les balises conteneurs de la publication pour les titres de la publication : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. Repérez la section Debug. 
3. À côté de Disable post container tags for post title, cochez Yes. 

Le filtrage du gettext wrapping (enrobage) des contenus, des titres ou des publications méta 

Pour filtrer le gettext wrapping (enrobage) tel que #!trpst#trp-gettext des publications (actualisées ou futures) : 

1. Dans la page des paramètres du plug-in, ouvrez l’onglet Advanced. 
2. En haut de la page, repérez la section Troubleshooting. 

3. À côté de Filter Gettext wrapping from post content and title, cochez Yes. 

   ou 

4. À côté de Filter Gettext wrapping from post meta, cochez Yes. 
5. En bas de la page, cliquez sur Save Changes. 

(!) Avant d’activer ces paramètres, sauvegardez votre base de données.