Selettore di valuta: configurazione e aiuto

Carica e installa lo ZIP mprcurrencyselector in "Modules > Module Manager". Apri "Configure" per Selettore simbolo valuta.

Prepara almeno due valute attive nella schermata di gestione delle valute di PrestaShop, in "International > Localization > Currencies" nelle versioni moderne. Mantieni disattivata la modalità catalogo mentre provi il selettore.

Richiede PrestaShop da 1.6.1 a 9.x e PHP 7.1 o successivo. Il selettore usa displayNav2 su PrestaShop 1.7 o successivo e displayNav su PrestaShop 1.6; assicurati che il tema mostri l’hook corrispondente alla tua versione di PrestaShop.

Il modulo Impostazioni selettore valuta contiene le schede Generale e "Theme styles". Fai clic su Salva configurazione dopo le modifiche.

Il selettore usa le tue valute PrestaShop attive. Crea e gestisci le valute in PrestaShop.

Apri "Theme styles" per regolare i controlli condivisi degli stili del tema generati da ThemeDetector. I valori predefiniti provengono dai valori rilevati nel tema. Il modulo mappa questi token:

Per personalizzare il CSS del tema, usa .mprcurrency-dropdown, .mprcurrency-dropdown__toggle, .mprcurrency-dropdown__menu e .mprcurrency-dropdown__option--active. Ad esempio:

.mprcurrency-dropdown__menu {
  border-radius: 8px;
}

Il modulo non registra una mappatura --mprcurrency-primary-hover.

Il pulsante chiuso mostra il simbolo della valuta corrente, con il codice ISO come alternativa se il simbolo non è disponibile. Il menu a tendina evidenzia la valuta attiva. La selezione di un’altra opzione invia la richiesta nativa di PrestaShop SubmitCurrency=1&id_currency=... alla pagina iniziale del negozio. Il modulo non mantiene la pagina del prodotto o della categoria corrente nel link generato.

PrestaShop gestisce la persistenza della valuta, i tassi di cambio, i prezzi convertiti, gli arrotondamenti e le restrizioni sulle valute di pagamento. Configurali separatamente in PrestaShop.

Il selettore non restituisce markup in modalità catalogo o quando è attiva una sola valuta. Viene visualizzato tramite displayNav2 su PrestaShop 1.7 o successivo e displayNav su PrestaShop 1.6. Se gestisci un’intestazione personalizzata, visualizza l’hook corrispondente nella posizione prevista. Questo esempio è per PrestaShop 1.7 o successivo; su PrestaShop 1.6 usa invece displayNav:

{hook h='displayNav2'}

Il modulo registra views/css/currency-selector.css e views/js/currency-selector.js tramite actionFrontControllerSetMedia. Il suo CSS nasconde il contenitore nativo per desktop #_desktop_ps_currencyselector e il contenitore di PrestaShop 1.6 #header #currencies-block-top. Il foglio di stile e il JavaScript del selettore vengono caricati solo quando il modulo è registrato sull’hook della tua versione di PrestaShop per il negozio e il dispositivo correnti, la modalità catalogo è disattivata e sono attive più valute. Questo impedisce il caricamento della regola che nasconde il selettore nativo quando tali condizioni non sono soddisfatte. Un tema personalizzato con un altro contenitore richiede controlli specifici di posizionamento e stile.

1. Apri una pagina del negozio con due valute attive e la modalità catalogo disattivata.
2. Controlla il simbolo corrente, apri il menu a tendina e scegli un’altra valuta.
3. Verifica che l’opzione attiva cambi e che PrestaShop mostri i prezzi previsti.
4. Prova l’intestazione su desktop e dispositivi mobili.

Se il selettore non appare, controlla il numero di valute attive, la modalità catalogo, il posizionamento dell’hook e le risorse caricate. Se appaiono entrambi i selettori, esamina il contenitore nativo usato dal tema. Se i prezzi o le valute disponibili al checkout sono errati, controlla le impostazioni delle valute e dei pagamenti di PrestaShop.

Disinstalla da "Module Manager". Il modulo rimuove il proprio menu e le impostazioni e annulla la registrazione dei propri stili del tema. Se la pulizia degli stili del tema non riesce, la disinstallazione restituisce un errore prima di rimuovere la configurazione rimanente del modulo. Risolvi l’errore e riprova. Le valute e i tassi di cambio restano gestiti da PrestaShop. Rimuovi le eventuali personalizzazioni manuali dell’intestazione che hai aggiunto.