Guide des Traductions

Méthode 1 : Via l'onglet Traductions

Quand les objets sont chargés via le context processor, les champs contiennent déjà les valeurs traduites :

{# Les valeurs sont déjà traduites automatiquement #}
{{ article.title }}
{{ slide.subtitle }}
{{ menu_item.title }}
{{ event.description }}

Méthode 2 : Filtre |translate

Pour les cas où l'objet n'a pas été pré-traduit :

{% load traduction_tags %}

{{ article|translate:'title' }}
{{ category|translate:'name' }}
{{ person|translate:'bio' }}

Méthode 3 : Textes statiques

Pour traduire des textes codés en dur dans les templates :

{% load traduction_tags %}

{% trans_text 'Accueil' 'Home' 'Startseite' %}
{% trans_text 'Lire la suite' 'Read more' 'Weiterlesen' %}
{% trans_text 'Contactez-nous' 'Contact us' 'Kontaktieren Sie uns' %}

{# Format: {% trans_text 'FR' 'EN' 'DE' %} #}

Variables de contexte disponibles

{# Langue courante #}
{{ current_language_code }}  {# ex: 'en' #}
{{ current_language }}       {# objet Language complet #}
{{ current_language.name }}  {# ex: 'English' #}

{# Toutes les langues actives #}
{% for lang in available_languages %}
    {{ lang.code }} - {{ lang.name }}
{% endfor %}

Méthode optimisée pour charger les traductions d'une liste d'objets en une seule requête :

from traduction.helpers import prefetch_translations

# Charger les articles
articles = list(NewsArticle.objects.filter(is_published=True)[:10])

# Appliquer les traductions (modifie les objets en place)
prefetch_translations(articles, language_code='en')

# Maintenant article.title contient la version anglaise
for article in articles:
    print(article.title)  # Affiche le titre en anglais

Récupérer une traduction unique

from traduction.helpers import get_translated_value

# Récupérer la traduction d'un champ spécifique
title_en = get_translated_value(article, 'title', language_code='en')
title_de = get_translated_value(article, 'title', language_code='de')

# Avec fallback automatique si traduction inexistante
title = get_translated_value(article, 'title', language_code='en', fallback=True)

Définir une traduction

from traduction.models import Dictionnaire, Language

# Récupérer la langue
english = Language.objects.get(code='en')

# Définir/mettre à jour la traduction
Dictionnaire.set_translation(
    obj=article,
    field='title',
    language=english,
    translation='My Article Title in English'
)

# La méthode crée ou met à jour automatiquement

Dans une vue (Class-Based View)

from django.views.generic import ListView
from traduction.helpers import TranslatedViewMixin, prefetch_translations

class ArticleListView(TranslatedViewMixin, ListView):
    model = NewsArticle
    template_name = 'news/list.html'
    translate_fields = ['title', 'content']

    def get_queryset(self):
        queryset = NewsArticle.objects.filter(is_published=True)
        # translate_queryset applique automatiquement les traductions
        return self.translate_queryset(queryset)

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        lang_code = self.get_current_language_code()

        # Traduire d'autres objets manuellement
        categories = list(NewsCategory.objects.all())
        prefetch_translations(categories, language_code=lang_code)
        context['categories'] = categories

        return context

Flux de traduction

1. Utilisateur clique sur "English" ou ?lang=en
           ↓
2. LanguageMiddleware détecte et stocke en session
           ↓
3. request.current_language_code = 'en'
           ↓
4. Context processor charge les données
           ↓
5. prefetch_translations() récupère les traductions
           ↓
6. Les champs des objets sont remplacés par les traductions
           ↓
7. Template affiche {{ object.field }} → valeur traduite

Structure de la table Dictionnaire

CREATE TABLE traduction_dictionnaire (
    id              INT PRIMARY KEY AUTO_INCREMENT,
    content_type_id INT NOT NULL,      -- FK vers ContentType (ex: 'news.newsarticle')
    object_id       INT NOT NULL,      -- ID de l'objet traduit
    field           VARCHAR(100),      -- Nom du champ (ex: 'title')
    language_id     INT NOT NULL,      -- FK vers Language
    translation     TEXT,              -- Le texte traduit
    created_at      DATETIME,
    updated_at      DATETIME,

    UNIQUE KEY unique_translation (content_type_id, object_id, field, language_id)
);

Les traductions ne s'affichent pas

from traduction.models import Dictionnaire
from django.contrib.contenttypes.models import ContentType
from news.models import NewsArticle

ct = ContentType.objects.get_for_model(NewsArticle)
article = NewsArticle.objects.get(pk=1)

translations = Dictionnaire.objects.filter(
    content_type=ct,
    object_id=article.pk
)
for t in translations:
    print(f"{t.field} ({t.language.code}): {t.translation[:50]}")

# Dans une vue ou template
print(request.current_language_code)  # Devrait afficher 'en', 'de', etc.

python manage.py shell -c "from django.core.cache import cache; cache.clear()"

Les menus ne sont pas traduits

Assurez-vous d'utiliser le tag {% get_menu %} qui applique automatiquement les traductions :

{% load cms_tags %}

{# ✅ Correct - utilise get_menu #}
{% get_menu 'front-menu' as nav_menu %}
{% for item in nav_menu.get_root_items %}
    {{ item.title }}  {# Traduit automatiquement #}
{% endfor %}

{# ❌ Incorrect - accès direct sans traduction #}
{% for item in menu.items.all %}
    {{ item.title }}  {# NON traduit #}
{% endfor %}

Performance : Éviter les requêtes N+1

for article in articles:
    # Fait une requête par article !
    title = get_translated_value(
        article, 'title', 'en'
    )

# Une seule requête pour toutes les traductions
prefetch_translations(articles, language_code='en')

for article in articles:
    title = article.title  # Déjà traduit