Language Switcher, Flag Selector: setup and help

Upload and install the mprflagselector ZIP in Modules > Module Manager, then open Configure for Flag Language Selector. Use the corresponding module upload page on older PrestaShop versions.

Create and activate your shop languages in PrestaShop. On modern versions, use International > Localization > Languages. You need at least two active languages assigned to the current shop for a selector to appear. The module does not create translations.

Requires PHP 7.1 or later.

Click Save.

The desktop dropdown uses displayNav2 on PrestaShop 1.7 and newer, or displayNav on earlier versions. A custom theme must render the applicable hook. For example:

{hook h='displayNav2'}

The mobile selector uses a separate hook. Add it to your mobile menu or language panel if your theme does not already render it:

{hook h='displayMobileLanguageSelector'}

The mobile output is a select element. Changing its value opens the selected language URL. The module also registers actionFrontControllerSetMedia for its assets.

The stylesheet hides #_desktop_ps_languageselector. Inspect custom headers for different native wrappers or duplicated language blocks.

The dropdown shows active languages for the current shop. It uses the page’s alternative-language links when available and otherwise uses PrestaShop’s language links. It preserves query parameters and fragments, including id_lang needed when URL rewriting is disabled.

For PrestaShop’s best-seller, new-product and price-drop pages, the selector can use the target language’s translated URL. On listings integrated with compatible MPR Filter Revolution versions, it can translate the filter path. When a listing supports MPR pagination links, it preserves the translated page keyword and page number, or a page query parameter without URL rewriting. These listing adjustments do not apply to pages supplied by modules.

Switching languages does not translate missing content. Cart behavior continues through PrestaShop's normal language switch.

Bundled SVG flags are in /modules/mprflagselector/views/img/flags/. The mapping includes:

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

An option can still appear without an image if no corresponding SVG exists. There is no custom flag uploader in the settings form.

Use .mprflag-dropdown, .mprflag-dropdown__toggle, .mprflag-dropdown__menu, .mprflag-dropdown__option, and .mprflag-dropdown__option--active in your theme stylesheet.

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

For markup changes, use the theme override path:

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

1. Open a translated product page and change language from the header.
2. Check the destination language and page.
3. Repeat on a category and, if applicable, a filtered or paginated listing.
4. Test the mobile selector separately.
5. Test with your shop's actual URL rewriting setting.

If no selector appears, check that two languages are active in the current shop and that the correct hook renders. If a flag is missing, check the language ISO code and bundled SVG mapping. If a link goes to a fallback page, inspect the URLs provided by PrestaShop or the controller. If links duplicate a filter or page path, check the compatible MPR listing integration and clear theme caches after template changes.

Uninstall through Module Manager. The module removes its settings and admin menu. Your PrestaShop languages and translations remain separately managed. Remove any manually added hook calls, CSS, or template overrides that are no longer needed.