Aller au contenu principal

Introduction

Récupérez les langues configurées dans votre projet pour alimenter du contenu multilingue et détecter la locale.

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

🎯 Que fait ce module ?​

Le module Locales vous permet de gérer le support multilingue dans votre projet OneEntry - récupérez les langues disponibles, détectez la locale de l'utilisateur et construisez 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 - Servez des clients dans différents pays (anglais, français, allemand)
  • 📱 Applications mobiles - Adaptez l'interface utilisateur à la langue de l'appareil de l'utilisateur
  • 🌐 Sites Web - Affichez le contenu dans la langue préférée du visiteur
  • 📚 Documentation - Fournissez de l'aide dans plusieurs langues
  • 🎮 Jeux - Traduisez 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 - Mettez à 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 - Ajoutez/retirez des langues sans modifications de code
  • ✅ Validé - Affichez uniquement les langues qui ont du contenu
  • 🎯 Centralisé - Gérez 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,                      // unique ID
  shortCode: 'en',              // short code
  code: 'en_US',                // full code
  name: 'English (USA)',        // name
  nativeName: 'English (USA)',  // native name
  isActive: true,               // is active
  image: null,                  // image
  position: 1,                  // position
}

Pourquoi utiliser le module Locales ?​

AvantageDescription
Support multilingueServez 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éfautIdentifiez automatiquement la langue par défaut
Filtrage de locale activeAffichez uniquement les langues activées
Gestion centraliséeMettez à jour les langues dans le panneau d'administration, pas dans le code
Expérience utilisateurPermettez 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érez 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 secoursAffichez la langue par défaut si la traduction est manquanteAffichez l'anglais si l'espagnol n'est pas disponible
Préférences utilisateurSouvenez-vous du choix de langue de l'utilisateurEnregistrez 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 :

OneEntry Admin Panel → Settings → Languages → Add Language → Select 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 : Filtrez toujours par isActive lors de la construction de 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()Obtenez 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 ! Filtrez toujours 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 je dois 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.

Filtrez toujours les Locales Actives​

Affichez 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​

  • Filtrez toujours les locales actives - Affichez uniquement les langues activées
  • Mettez en cache les locales - Elles changent rarement, mettez en cache pour la performance
  • Utilisez la locale par défaut comme secours - Gérez les traductions manquantes
  • Enregistrez la préférence utilisateur - Souvenez-vous du choix de langue
  • Validez les codes de locale - Vérifiez que la locale existe avant de l'utiliser
  • Détectez la langue du navigateur - Sélectionnez automatiquement la langue de l'utilisateur
  • Groupez par langue - Affichez logiquement les variantes de langue

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​