Selettore di lingua, selettore di bandiera: configurazione e aiuto

Carica e installa lo ZIP mprflagselector in "Modules > Module Manager", quindi apri "Configure" per Flag Language Selector. Usa la pagina di caricamento moduli corrispondente nelle versioni meno recenti di PrestaShop.

Crea e attiva le lingue del negozio in PrestaShop. Nelle versioni moderne, usa "International > Localization > Languages". Servono almeno due lingue attive assegnate al negozio corrente perché appaia un selettore. Il modulo non crea traduzioni.

Richiede PHP 7.1 o successivo.

Fai clic su Salva.

Il menu a tendina desktop usa displayNav2 su PrestaShop 1.7 e versioni successive, o displayNav sulle versioni precedenti. Un tema personalizzato deve visualizzare l’hook applicabile. Ad esempio:

{hook h='displayNav2'}

Il selettore mobile usa un hook separato. Aggiungilo al menu mobile o al pannello delle lingue se il tema non lo visualizza già:

{hook h='displayMobileLanguageSelector'}

L’output mobile è un elemento select. Cambiando il suo valore si apre l’URL della lingua selezionata. Il modulo registra anche actionFrontControllerSetMedia per le proprie risorse.

Il foglio di stile nasconde #_desktop_ps_languageselector. Controlla le intestazioni personalizzate per individuare contenitori nativi diversi o blocchi di lingue duplicati.

Il menu a tendina mostra le lingue attive del negozio corrente. Usa i link alle altre lingue forniti dalla pagina quando disponibili e, altrimenti, i link delle lingue di PrestaShop. Mantiene i parametri di query e i frammenti, incluso id_lang, necessario quando la riscrittura degli URL è disattivata.

Per le pagine PrestaShop dei prodotti più venduti, dei nuovi prodotti e delle offerte, il selettore può usare l’URL tradotto della lingua di destinazione. Negli elenchi integrati con versioni compatibili di MPR Filter Revolution può tradurre il percorso dei filtri. Quando un elenco supporta i link di paginazione MPR, mantiene la parola chiave di pagina tradotta e il numero di pagina, oppure un parametro di query page senza riscrittura degli URL. Questi adattamenti non si applicano alle pagine fornite dai moduli.

Cambiare lingua non traduce i contenuti mancanti. Il carrello continua a seguire il normale cambio di lingua di PrestaShop.

Le bandiere SVG incluse si trovano in /modules/mprflagselector/views/img/flags/. La mappatura include:

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

Un’opzione può comunque apparire senza immagine se non esiste un SVG corrispondente. Il modulo delle impostazioni non offre uno strumento per caricare bandiere personalizzate.

Usa .mprflag-dropdown, .mprflag-dropdown__toggle, .mprflag-dropdown__menu, .mprflag-dropdown__option e .mprflag-dropdown__option--active nel foglio di stile del tema.

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

Per modifiche al markup, usa il percorso di override del tema:

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

1. Apri una pagina prodotto tradotta e cambia lingua dall’intestazione.
2. Controlla la lingua e la pagina di destinazione.
3. Ripeti su una categoria e, se applicabile, su un elenco filtrato o suddiviso in pagine.
4. Prova il selettore mobile separatamente.
5. Prova con l’impostazione effettiva di riscrittura degli URL del negozio.

Se non appare alcun selettore, controlla che siano attive due lingue nel negozio corrente e che venga visualizzato l’hook corretto. Se manca una bandiera, controlla il codice ISO della lingua e la mappatura degli SVG inclusi. Se un link porta a una pagina di ripiego, esamina gli URL forniti da PrestaShop o dal controller. Se i link duplicano un percorso di filtro o di pagina, controlla l’integrazione compatibile degli elenchi MPR e svuota le cache del tema dopo le modifiche ai template.

Disinstalla tramite "Module Manager". Il modulo rimuove le proprie impostazioni e il menu amministrativo. Le lingue e le traduzioni di PrestaShop restano gestite separatamente. Rimuovi le chiamate agli hook, il CSS o gli override dei template aggiunti manualmente che non servono più.