Documentation: getConfiguration Fonction dans intlayer
Description
La fonction getConfiguration récupère l'intégralité de la configuration de l'application intlayer en extrayant les variables d'environnement. Cette fonction offre la flexibilité d'utiliser la même configuration à la fois côté client et côté serveur, garantissant la cohérence dans toute l'application.
Paramètres
La fonction ne prend aucun paramètre. Elle utilise à la place des variables d'environnement pour la configuration.
Retourne
- Type: IntlayerConfig
Description: Un objet contenant la configuration complète pour intlayer. La configuration inclut les sections suivantes :
- internationalization: Paramètres liés aux locales et au mode strict.
- middleware: Paramètres liés à la gestion des URL et des cookies.
- content: Paramètres liés aux fichiers de contenu, aux répertoires et aux modèles.
- editor: Configurations spécifiques à l'éditeur.
Voir Documentation de configuration Intlayer pour plus de détails.
Exemple d'utilisation
Récupération de la configuration complète
import { getConfiguration } from "intlayer";const config = getConfiguration();console.log(config);// Sortie :// {// internationalization: { ... },// middleware: { ... },// content: { ... },// editor: { ... }// }
Extraction de availableLocales et defaultLocale
La section internationalization de la configuration fournit des paramètres liés aux locales tels que locales (locales disponibles) et defaultLocale (langue de secours).
import { getConfiguration } from "intlayer";const { internationalization, middleware } = getConfiguration();const { locales: availableLocales, defaultLocale } = internationalization;const { cookieName } = middleware;console.log(availableLocales); // Exemple de sortie : ["en", "fr", "es"]console.log(defaultLocale); // Exemple de sortie : "en"console.log(cookieName); // Sortie : "INTLAYER_LOCALE"
Notes
- Assurez-vous que toutes les variables d'environnement requises sont correctement définies avant d'appeler cette fonction. Les variables manquantes entraîneront des erreurs lors de l'initialisation.
- Cette fonction peut être utilisée à la fois côté client et côté serveur, ce qui en fait un outil polyvalent pour gérer les configurations de manière unifiée.
Utilisation dans les applications
La fonction getConfiguration est un utilitaire clé pour initialiser et gérer la configuration d'une application intlayer. En fournissant un accès à des paramètres tels que les locales, le middleware et les répertoires de contenu, elle garantit la cohérence et l'évolutivité des applications multilingues et axées sur le contenu.
Si vous avez une idée d’amélioration pour améliorer cette documentation, n’hésitez pas à contribuer en submitant une pull request sur GitHub.
Lien GitHub de la documentation