Sélecteur de langue, sélecteur de drapeau : installation et aide

Importez et installez le ZIP mprflagselector dans "Modules > Module Manager", puis ouvrez "Configure" pour Flag Language Selector. Sur les anciennes versions de PrestaShop, utilisez la page d’importation de modules correspondante.

Créez et activez les langues de votre boutique dans PrestaShop. Sur les versions modernes, utilisez "International > Localization > Languages". Au moins deux langues actives doivent être associées à la boutique actuelle pour qu’un sélecteur apparaisse. Le module ne crée pas de traductions.

Nécessite PHP 7.1 ou version ultérieure.

Cliquez sur Enregistrer.

Le menu déroulant pour ordinateur utilise displayNav2 sur PrestaShop 1.7 et les versions ultérieures, ou displayNav sur les versions précédentes. Un thème personnalisé doit afficher le hook applicable. Par exemple :

{hook h='displayNav2'}

Le sélecteur mobile utilise un hook distinct. Ajoutez-le à votre menu mobile ou panneau de langues si votre thème ne l’affiche pas déjà :

{hook h='displayMobileLanguageSelector'}

Le rendu mobile est un élément select. Changer sa valeur ouvre l’URL de la langue sélectionnée. Le module enregistre aussi actionFrontControllerSetMedia pour ses ressources.

La feuille de style masque #_desktop_ps_languageselector. Inspectez les en-têtes personnalisés pour repérer des conteneurs natifs différents ou des blocs de langues en double.

Le menu déroulant affiche les langues actives de la boutique actuelle. Il utilise les liens vers les autres langues fournis par la page lorsqu’ils sont disponibles, et les liens de langues de PrestaShop sinon. Il conserve les paramètres de requête et les fragments, y compris id_lang, nécessaire lorsque la réécriture d’URL est désactivée.

Pour les pages PrestaShop des meilleures ventes, des nouveaux produits et des promotions, le sélecteur peut utiliser l’URL traduite de la langue cible. Sur les listes intégrées à une version compatible de MPR Filter Revolution, il peut traduire le chemin des filtres. Lorsqu’une liste prend en charge les liens de pagination MPR, il conserve le mot-clé de page traduit et le numéro de page, ou un paramètre de requête page sans réécriture d’URL. Ces ajustements ne s’appliquent pas aux pages fournies par des modules.

Le changement de langue ne traduit pas les contenus manquants. Le panier continue de suivre le changement de langue normal de PrestaShop.

Les drapeaux SVG fournis se trouvent dans /modules/mprflagselector/views/img/flags/. La correspondance comprend :

en: gb   cs: cz   sv: se   da: dk   el: gr
ja: jp   zh: cn   ko: kr   uk: ua

Une option peut tout de même apparaître sans image si aucun SVG correspondant n’existe. Le formulaire de paramètres ne propose aucun outil d’importation de drapeaux personnalisés.

Utilisez .mprflag-dropdown, .mprflag-dropdown__toggle, .mprflag-dropdown__menu, .mprflag-dropdown__option et .mprflag-dropdown__option--active dans la feuille de style de votre thème.

.mprflag-dropdown__toggle { padding: 4px 7px; }
.mprflag-dropdown__option--active { font-weight: 600; }

Pour modifier le balisage, utilisez le chemin de surcharge du thème :

themes/your-theme/modules/mprflagselector/views/templates/hook/flag-selector.tpl

1. Ouvrez une page produit traduite et changez de langue depuis l’en-tête.
2. Vérifiez la langue et la page de destination.
3. Répétez sur une catégorie et, si nécessaire, une liste filtrée ou paginée.
4. Testez le sélecteur mobile séparément.
5. Testez avec le réglage réel de réécriture d’URL de votre boutique.

Si aucun sélecteur n’apparaît, vérifiez que deux langues sont actives dans la boutique actuelle et que le bon hook s’affiche. S’il manque un drapeau, vérifiez le code ISO de la langue et la correspondance SVG fournie. Si un lien mène vers une page de repli, inspectez les URL fournies par PrestaShop ou le contrôleur. Si les liens dupliquent un chemin de filtre ou de page, vérifiez l’intégration compatible des listes MPR et videz les caches du thème après les modifications de templates.

Désinstallez via "Module Manager". Le module supprime ses paramètres et son menu d’administration. Vos langues et traductions PrestaShop restent gérées séparément. Supprimez les appels de hooks, le CSS ou les surcharges de templates ajoutés manuellement qui ne sont plus nécessaires.