# TranslatePress : traduire un site WordPress directement depuis la page affichée

> Contrairement à WPML ou Polylang, TranslatePress traduit en surimpression de la page réelle. Prise en main complète de cette approche visuelle.

- Auteur : Clément Hadrot
- Publié le : 2023-01-17
- Mis à jour le : 2023-01-17
- Catégorie : Multilingue
- URL : https://wpmoderne.dev.wordpress-developpement.fr/multilingue/translatepress-traduction-visuelle-tutoriel/

## L’essentiel

- La traduction se fait en surimpression sur le rendu réel de la page
- Aucun contenu n'est dupliqué en base par défaut
- La traduction automatique s'active en une seule option

WPML et Polylang partagent une logique commune : traduire depuis l'écran d'édition de chaque contenu, un post à la fois. TranslatePress renverse cette approche avec un principe différent : ouvrir la page telle qu'elle s'affiche réellement au visiteur, et traduire chaque élément de texte directement en surimpression, sans quitter la vue du rendu final. Ce tutoriel détaille la prise en main de cette extension, ses avantages concrets, et ses limites.

Nous prenons pour exemple une page d'accueil comportant un titre, un texte d'introduction, un bouton d'appel à l'action, et un widget de témoignages clients — un mélange typique de contenu géré par l'éditeur et de texte généré par le thème.

## Installation et premier lancement

Après installation de l'extension gratuite (une version premium ajoute la traduction automatique via DeepL et la gestion multidevise), la configuration initiale se fait depuis **Réglages → TranslatePress** : langue par défaut du site, langues à ajouter, et choix du service de traduction automatique éventuel.

Une fois les langues configurées, un bouton « Traduire le site » apparaît dans la barre d'administration WordPress. Cliquer dessus ouvre l'éditeur visuel de traduction : la page s'affiche exactement comme un visiteur la verrait, avec un panneau latéral listant chaque chaîne de texte détectée sur la page, et un survol qui met en surbrillance l'élément correspondant directement dans l'aperçu.

## Traduire un élément de texte

Pour traduire une chaîne, il suffit de cliquer sur le petit icône crayon qui apparaît au survol du texte dans l'aperçu (ou de le sélectionner dans le panneau latéral), puis de saisir la traduction dans le champ qui s'affiche. La sauvegarde est immédiate, sans rechargement complet de la page.

Cette approche présente un avantage concret pour les non-développeurs : un rédacteur qui ne connaît pas la structure interne de WordPress voit exactement où se trouve chaque texte à traduire, dans son contexte visuel réel, ce qui réduit fortement les erreurs de traduction hors contexte (traduire un mot ambigu sans savoir s'il s'agit d'un titre ou d'un libellé de bouton, par exemple).

> L'essentiel à retenir : La traduction se fait en surimpression sur le rendu réel de la page ; Aucun contenu n'est dupliqué en base par défaut ; La traduction automatique s'active en une seule option

## Où sont stockées les traductions

Contrairement à WPML et Polylang, TranslatePress ne duplique pas le contenu en nouveaux posts : les traductions sont stockées dans une table dédiée (`wp_trp_dictionary_dynamic` et une table de traduction de contenu spécifique par paire de langues) qui associe le texte source à sa traduction, indépendamment de sa position dans un post ou un widget. Cette architecture explique pourquoi TranslatePress peut traduire des chaînes générées par n'importe quelle extension ou par le thème lui-même, sans qu'aucune déclaration préalable de compatibilité ne soit requise contrairement à WPML pour les CPT personnalisés.

La contrepartie de cette souplesse : la traduction est liée au texte exact, pas à un identifiant de contenu. Si le texte source change (une faute corrigée, une reformulation), la traduction existante devient orpheline et doit être ressaisie, puisque TranslatePress ne fait pas nécessairement le lien entre l'ancienne et la nouvelle version du texte source selon l'ampleur du changement.

## Traduction automatique intégrée

La version premium de TranslatePress propose une intégration native avec Google Translate et DeepL : à l'ouverture de l'éditeur visuel, chaque chaîne non encore traduite manuellement peut être pré-remplie automatiquement, à charge pour l'utilisateur de relire et corriger. C'est une différence de philosophie notable par rapport à WPML, où la traduction automatique se configure généralement depuis un tableau de gestion centralisé plutôt que directement dans la vue de la page.

```
// Extrait de configuration (wp-config.php) pour activer le mode debug
// de TranslatePress lors du diagnostic d'un problème d'affichage
define( 'TRP_DEBUG', true );
```

## Limites à connaître avant de choisir cette approche

- **Contenu généré côté serveur après chargement** : certains contenus injectés dynamiquement par JavaScript après le chargement initial de la page (un widget tiers, un composant React embarqué) peuvent échapper à la détection automatique de TranslatePress, qui s'appuie principalement sur l'analyse du HTML généré côté serveur.
- **Gestion des taxonomies et champs personnalisés avancés** : pour des besoins de traduction très structurés (une taxonomie avec des centaines de termes à gérer finement, une synchronisation complexe de champs ACF), WPML ou Polylang restent généralement mieux outillés, avec des interfaces de gestion dédiées à ces cas.
- **Volume de contenu** : sur un site avec plusieurs milliers de pages, l'approche « une page à la fois » de TranslatePress peut devenir plus longue à parcourir que les tableaux de traduction centralisés de WPML, qui permettent de filtrer et trier le travail restant sur l'ensemble du site en une seule vue.

## Pour quel type de projet TranslatePress est-il pertinent

TranslatePress convient particulièrement bien à des sites de taille moyenne, gérés par des équipes non techniques qui préfèrent voir concrètement ce qu'elles traduisent plutôt que de naviguer dans des tableaux de gestion abstraits. C'est également un choix pertinent pour un site déjà en production, construit sans anticipation multilingue : parce que TranslatePress ne demande aucune déclaration préalable de compatibilité pour chaque type de contenu, il peut être ajouté après coup avec un minimum de configuration technique.

> Pour un client qui nous dit « je veux traduire mon site moi-même, sans avoir besoin d'un développeur à chaque changement », TranslatePress est souvent la recommandation la plus honnête, précisément parce que son interface colle au rendu final plutôt qu'à la structure technique du contenu.

## En résumé

TranslatePress propose une approche radicalement différente de WPML et Polylang : traduire en surimpression de la page réelle plutôt que depuis l'écran d'édition du contenu. Cette approche visuelle réduit la barrière d'entrée pour les équipes non techniques et s'installe facilement sur un site existant, au prix d'une gestion moins structurée pour des besoins de traduction très complexes sur des volumes de contenu importants.