Vue d'ensemble
Larapen propose plusieurs paramètres de localisation qui contrôlent la façon dont votre site web gère les langues multiples, la détection de la langue du visiteur et le comportement des URL. Ces paramètres se trouvent sous Paramètres → Général dans la section Localisation.
Paramètres disponibles
Supprimer le préfixe de la locale par défaut
| Emplacement | Paramètres → Général → Localisation |
| Options | Activé / Désactivé |
| Par défaut | Désactivé |
Contrôle si le code de la langue par défaut apparaît dans les URL :
- Activé (recommandé) : La langue par défaut utilise des URL propres sans préfixe. Exemple :
/a-proposau lieu de/fr/a-propos. Les autres langues utilisent toujours leur préfixe (ex./en/about). - Désactivé : Toutes les langues, y compris la langue par défaut, affichent leur code dans les URL. Exemple :
/fr/a-proposet/en/about.
/a-propos comme l'URL canonique et /en/about comme l'alternative anglaise.
Détection automatique de la langue
| Emplacement | Paramètres → Général → Localisation |
| Options | Désactivé / Langue du navigateur / Langue du pays |
| Par défaut | Désactivé |
Contrôle si Larapen détecte automatiquement et redirige les visiteurs vers leur langue préférée lors de leur première visite :
Désactivé
Aucune détection automatique. Tous les visiteurs voient la langue par défaut à moins qu'ils ne changent manuellement via le sélecteur de langue ou ne naviguent vers une URL avec un préfixe de langue.
Langue du navigateur
Détecte la langue préférée du visiteur depuis les paramètres de son navigateur (l'en-tête HTTP Accept-Language). Par exemple, si le navigateur d'un visiteur est configuré en français, il sera automatiquement redirigé vers la version française du site.
Fonctionnement :
- Lit les préférences linguistiques du navigateur (triées par priorité).
- Compare avec vos langues actives.
- Redirige vers la meilleure correspondance lors de la première visite.
- La détection s'exécute une seule fois par session: les pages suivantes utilisent la préférence de session.
Langue du pays
Détecte la localisation géographique du visiteur en utilisant le GeoIP (recherche IP vers pays) et le redirige vers la langue parlée dans son pays.
Fonctionnement :
- Détermine le pays du visiteur à partir de son adresse IP.
- Recherche la langue principale parlée dans ce pays.
- Si la langue parlée correspond à l'une de vos langues actives, le visiteur est redirigé.
- La détection du pays est mise en cache dans un cookie pendant 30 jours pour éviter les recherches GeoIP répétées.
ip-api.com fonctionne sans clé d'API mais a des limites de débit.
Mode langues parlées
| Emplacement | Paramètres → Général → Localisation |
| Options | Désactivé / Actives uniquement / Actives + Anglais / Actives + Par défaut |
| Par défaut | Désactivé |
Contrôle quelles langues apparaissent dans le sélecteur de langue côté public. Utile si vous avez de nombreuses langues actives mais souhaitez n'afficher qu'un sous-ensemble basé sur le pays du visiteur :
Désactivé
Toutes les langues actives sont affichées dans le sélecteur de langue. C'est le comportement standard.
Actives uniquement
N'affiche que les langues parlées dans le pays par défaut (configuré dans Paramètres → Général → Localisation → Pays par défaut). Par exemple, si votre pays par défaut est la Belgique, seuls le néerlandais, le français et l'allemand seraient affichés.
Actives + Anglais
Affiche les langues parlées dans le pays par défaut plus l'anglais (si l'anglais est actif). Utile pour les sites internationaux où l'anglais est toujours proposé.
Actives + Par défaut
Affiche les langues parlées dans le pays par défaut plus la langue par défaut. Assure que la langue principale du site est toujours accessible dans le sélecteur.
Pays par défaut
| Emplacement | Paramètres → Général → Localisation |
| Format | Code pays ISO 3166-1 alpha-2 (ex. US, FR, BE) |
| Par défaut | Vide |
Le pays par défaut est utilisé par :
- Le Mode langues parlées pour déterminer quelles langues du pays afficher.
- La détection automatique Langue du pays comme repli lorsque la détection GeoIP n'est pas disponible.
Paramètres GeoIP (pour la détection Langue du pays)
Si vous utilisez le mode de détection automatique « Langue du pays », vous devez configurer un pilote GeoIP pour résoudre les adresses IP des visiteurs en pays. Allez dans Paramètres → GeoIP et choisissez parmi les pilotes disponibles :
| Pilote | Clé d'API requise |
|---|---|
| ip-api.com (par défaut) | Non |
| ipapi.co | Non |
| ipinfo.io | Oui (jeton) |
| DB-IP | Optionnel |
| ipbase.com | Oui |
| IP2Location | Oui |
| ipgeolocation.io | Oui |
| iplocation.net | Optionnel |
| ipstack.com | Oui |
| MaxMind Web Service | Oui |
| MaxMind Database (hors ligne) | Clé de licence pour les mises à jour |
GeoLite2-City.mmdb (pas GeoLite2-Country) et le placer dans /storage/database/maxmind/GeoLite2-City.mmdb. Ce pilote est recommandé pour la production et les sites à fort trafic car il ne nécessite pas d'appels API externes.
Configurations recommandées
Site bilingue simple (ex. anglais + français)
| Paramètre | Valeur |
|---|---|
| Supprimer le préfixe de la locale par défaut | Activé |
| Détection automatique de la langue | Langue du navigateur |
| Mode langues parlées | Désactivé |
Site international multi-langues
| Paramètre | Valeur |
|---|---|
| Supprimer le préfixe de la locale par défaut | Activé |
| Détection automatique de la langue | Langue du navigateur |
| Mode langues parlées | Désactivé |
Site ciblé par pays (ex. Belgique)
| Paramètre | Valeur |
|---|---|
| Supprimer le préfixe de la locale par défaut | Activé |
| Détection automatique de la langue | Langue du pays |
| Mode langues parlées | Actives + Anglais |
| Pays par défaut | BE |
Site monolingue
| Paramètre | Valeur |
|---|---|
| Supprimer le préfixe de la locale par défaut | Activé |
| Détection automatique de la langue | Désactivé |
| Mode langues parlées | Désactivé |
Avec une seule langue active, aucun sélecteur de langue n'est affiché et aucun préfixe n'est ajouté aux URL.