Aller au contenu principal

Introduction

🎯 Que fait ce module ?​

Le module Locales vous permet de gérer le support multilingue dans votre projet OneEntry - récupérer les langues disponibles, détecter la locale de l'utilisateur et construire des applications internationalisées qui servent du contenu dans plusieurs langues.

Considérez-le comme votre gestionnaire de langues - au lieu de coder en dur les langues dans votre application, vous récupérez dynamiquement la liste des langues actives depuis OneEntry, permettant à votre contenu de s'adapter automatiquement à différentes locales (anglais, russe, arabe, espagnol, etc.).

📖 Explication Simple​

Dans les applications modernes, vous devez souvent prendre en charge plusieurs langues :

  • 🌍 Sites de commerce Ă©lectronique - Servir des clients dans diffĂ©rents pays (anglais, français, allemand)
  • đŸ“± Applications mobiles - Adapter l'interface utilisateur Ă  la langue de l'appareil de l'utilisateur
  • 🌐 Sites Web - Afficher le contenu dans la langue prĂ©fĂ©rĂ©e du visiteur
  • 📚 Documentation - Fournir de l'aide dans plusieurs langues
  • 🎼 Jeux - Traduire l'interface et le contenu

Le problĂšme avec le codage en dur des langues :

ProblĂšmes :

  • 🔄 Difficile Ă  mettre Ă  jour - NĂ©cessite un redĂ©ploiement pour ajouter de nouvelles langues
  • 🌍 Non synchronisĂ© - Les langues de l'application peuvent diffĂ©rer des langues du CMS
  • ❌ IncohĂ©rences de traduction - Le contenu existe dans le CMS mais pas dans l'application
  • 🔧 Maintenance manuelle - Mettre Ă  jour le code chaque fois que les langues changent

La solution Locales :

Avantages :

  • 🔄 Toujours synchronisĂ© - Les langues correspondent Ă  ce qui est configurĂ© dans OneEntry
  • 🌍 Dynamique - Ajouter/retirer des langues sans modifications de code
  • ✅ ValidĂ© - Afficher uniquement les langues qui ont du contenu
  • 🎯 CentralisĂ© - GĂ©rer les langues en un seul endroit

✹ Concepts ClĂ©s​

Qu'est-ce qu'une Locale ?​

Une locale est une combinaison de langue et de région qui détermine comment le contenu est affiché :

  • Code de langue - Code de langue ISO 639-1 (par exemple, en, ru, ar)
  • Code de rĂ©gion - Code de pays ISO 3166-1 (par exemple, US, GB, RU)
  • Identifiant de locale - Format combinĂ© : language_REGION (par exemple, en_US, ru_RU, ar_SA)

Exemples :

Code de LocaleLangueRĂ©gionDescription
en_USAnglaisÉtats-UnisAnglais amĂ©ricain
en_GBAnglaisGrande-BretagneAnglais britannique
ru_RURusseRussieRusse
es_ESEspagnolEspagneEspagnol européen
es_MXEspagnolMexiqueEspagnol mexicain
ar_SAArabeArabie SaouditeArabe (Arabie Saoudite)
fr_FRFrançaisFranceFrançais
de_DEAllemandAllemagneAllemand

Structure de Locale​

Chaque locale dans OneEntry a :

{
  id: 146,                      // ID unique
  shortCode: 'en',              // code court
  code: 'en_US',                // code complet
  name: 'English (USA)',        // nom
  nativeName: 'English (USA)',  // nom natif
  isActive: true,               // est actif
  image: null,                  // image
  position: 1,                  // position
}

Pourquoi utiliser le module Locales ?​

AvantageDescription
Support multilingueServir du contenu dans la langue préférée de l'utilisateur
Liste de langues dynamiqueLes langues se synchronisent avec la configuration de OneEntry
Détection de locale par défautIdentifier automatiquement la langue par défaut
Filtrage des locales activesAfficher uniquement les langues activées
Gestion centraliséeMettre à jour les langues dans le panneau d'administration, pas dans le code
Expérience utilisateurPermettre aux utilisateurs de choisir leur langue

Cas d'utilisation courants​

Cas d'utilisationDescriptionExemple
SĂ©lecteur de langueMenu dĂ©roulant pour changer de langueEn-tĂȘte du site Web avec des drapeaux de langue
Localisation de contenuRécupérer le contenu dans la langue de l'utilisateurArticles de blog en anglais ou en russe
RoutageStructure d'URL par langue/en/about, /ru/about
Logique de secoursAfficher la langue par défaut si la traduction est manquanteAfficher l'anglais si l'espagnol n'est pas disponible
Préférences utilisateurSe souvenir du choix de langue de l'utilisateurEnregistrer la locale dans les cookies/localStorage

📋 Ce que vous devez savoir​

Les Locales sont configurĂ©es dans le panneau d'administration​

Vous ne pouvez pas créer de locales via le SDK - elles sont configurées dans le panneau d'administration de OneEntry :

Panneau d'administration OneEntry → ParamĂštres → Langues → Ajouter une langue → SĂ©lectionner une locale

Le SDK est destiné à récupérer les informations de locale, pas à créer des locales.

Locales actives vs inactives​

Toutes les locales configurĂ©es peuvent ne pas ĂȘtre actives :

StatutSignificationQuand l'utiliser
Actif (isActive: true)La locale est activée et a du contenuAfficher dans le sélecteur de langue
Inactif (isActive: false)La locale est désactivée ou en préparationCacher aux utilisateurs

Meilleure pratique : Toujours filtrer par isActive lors de la construction des sélecteurs de langue

Locale par dĂ©faut​

Chaque projet OneEntry a une locale par défaut :

  • Locale par dĂ©faut (isDefault: true) - La langue principale
  • UtilisĂ©e lorsque aucune locale n'est spĂ©cifiĂ©e
  • Fallback lorsque la traduction est manquante

Code de locale vs code court​

Chaque locale a deux formats de code :

ChampFormatExempleUtilisé pour
codelanguage_REGIONen_US, ru_RUIdentification complĂšte de la locale
shortCodelanguageen, ruIdentification uniquement de la langue

📊 Tableau de RĂ©fĂ©rence Rapide​

MĂ©thodeDescriptionCas d'utilisation
getLocales()Obtenir toutes les locales (actives et inactives)Récupérer les langues disponibles

❓ Questions FrĂ©quemment PosĂ©es (FAQ)​

Comment ajouter de nouvelles langues à mon projet ?​

Vous ne pouvez pas ajouter de locales via le SDK. Les locales sont configurées dans le panneau d'administration de OneEntry.

Comment dĂ©finir la langue par dĂ©faut ?​

Vous ne pouvez pas définir la locale par défaut via le SDK. La locale par défaut est configurée dans le panneau d'administration de OneEntry :

Remarque : Une seule locale peut ĂȘtre par dĂ©faut Ă  la fois.

Dois-je montrer les locales inactives aux utilisateurs ?​

Non ! Toujours filtrer par isActive :

Pourquoi ? Les locales inactives peuvent :

  • Être en dĂ©veloppement (contenu pas prĂȘt)
  • Être temporairement dĂ©sactivĂ©es
  • Ne pas avoir de traductions pour tout le contenu

Comment gĂ©rer les traductions manquantes ?​

Utilisez la logique de secours

Puis-je mettre en cache les locales ?​

Oui ! Les locales changent rarement, donc le caching est recommandé.

Puis-je utiliser les Locales avec Next.js i18n ?​

Oui ! Intégrez les locales OneEntry avec Next.js.

Comment regrouper les locales par langue ?​

Groupez les variantes de la mĂȘme langue

Que faire si j'ai besoin de traduire des Ă©lĂ©ments d'interface utilisateur (pas de contenu CMS) ?​

Le module Locales de OneEntry est uniquement pour les locales de contenu CMS. Pour la traduction de l'interface utilisateur :

Option 1 : Utilisez une bibliothĂšque i18n (react-i18next, next-i18next)

Option 2 : Stockez les traductions de l'interface utilisateur dans OneEntry

Créez un type de page "traductions" et récupérez les chaßnes de traduction

💡 Notes Importantes​

Les Locales sont en lecture seule​

Le module Locales est en lecture seule :

  • ✅ RĂ©cupĂ©rer les locales
  • ✅ Filtrer par statut actif
  • ✅ Trouver la locale par dĂ©faut
  • ❌ Ne peut pas crĂ©er de locales
  • ❌ Ne peut pas mettre Ă  jour les locales
  • ❌ Ne peut pas supprimer les locales

Pour modifier : Utilisez le panneau d'administration de OneEntry.

Toujours filtrer les locales actives​

Afficher uniquement les locales actives aux utilisateurs

Pourquoi ? Les locales inactives peuvent ne pas avoir de traductions complĂštes.

Le caching est recommandé​

Les locales changent rarement - implémentez le caching

Synchronisez avec les locales de contenu​

Assurez-vous que les langues de l'interface utilisateur correspondent au contenu disponible

🎓 Meilleures Pratiques​

  • Toujours filtrer les locales actives - Afficher uniquement les langues activĂ©es
  • Mettre en cache les locales - Elles changent rarement, mettez en cache pour la performance
  • Utiliser la locale par dĂ©faut comme secours - GĂ©rer les traductions manquantes
  • Enregistrer la prĂ©fĂ©rence utilisateur - Se souvenir du choix de langue
  • Valider les codes de locale - VĂ©rifier que la locale existe avant de l'utiliser
  • DĂ©tecter la langue du navigateur - SĂ©lectionner automatiquement la langue de l'utilisateur
  • Grouper par langue - Afficher logiquement les variantes de langue

Plus d'informations sur l'interface utilisateur du module https://doc.oneentry.cloud/docs/category/languages

DĂ©finition du module Locales​

Le module 'Locales' permet le support multilingue dans OneEntry.

Grùce au support de plusieurs langues dans la plateforme OneEntry, vous pouvez personnaliser de maniÚre flexible l'interface de votre tableau de bord et gérer commodément les langues dans votre projet. Dans cette section, vous pouvez apprendre les principes de travail avec les langues.


const { Locales } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 Documentation Connexe​