Su questa pagina
Plugin e configurazioni richieste
Aggiunta di un selettore delle valute
Impostazione dei gateway di pagamento
Impostare i tassi di cambio automatici
Opzioni di formattazione della valuta e regole di arrotondamento
Configurazione di prezzi personalizzati per diverse valute
Impostazione di tariffe di spedizione diverse per ciascuna valuta
Filtrare gli ordini e le analisi di WooCommerce per valuta
Informazioni per gli sviluppatori – Impostare la propria logica multicurrency
Plugin e configurazioni richieste
Versione autonoma gratuita per WooCommerce Multilingual
Se siete interessati a utilizzare la versione gratuita e autonoma di WooCommerce Multilingual, installatela e attivatela:
- WooCommerce
- WooCommerce Multilingual
Configurazione della versione autonoma
Dopo aver installato e attivato i plugin, vai su WooCommerce → WooCommerce Multilingual & Multicurrency per abilitare la modalità multicurrency.
WooCommerce Multilingual con WPML
Per creare un negozio multilingue e multivaluta con WooCommerce Multilingual e WPML, consulta la nostra pagina di documentazione su WooCommerce Multilingual.
Configurazione delle valute
Potete configurare le valute in due modi: in base alla lingua o in base alla posizione del cliente.
Valute per lingua
Questa opzione richiede un account CMS Multilingual CMS o account Agency di WPML .
Potete scegliere di mostrare valute specifiche in base alla lingua selezionata dal cliente. Questo aiuta nelle situazioni in cui i prodotti in determinate lingue devono essere ordinati solo in una specifica valuta.
Potete anche configurare la valuta predefinita per ogni lingua. In questo modo gli utenti, quando passano a una lingua diversa sul front-end, visualizzano i prezzi dei prodotti in una determinata valuta.
Per impostare le valute da utilizzare per ogni lingua, vai su WooCommerce → WooCommerce Multilingual & Multicurrency e clicca sulla scheda Multicurrency.
Scegliere l’opzione Mantieni per la valuta di default in una determinata lingua significa che la valuta del negozio non cambierà quando si passa a quella lingua.
Per impostazione predefinita, quando viene aggiunta una nuova valuta, questa viene inclusa per tutte le lingue. Potete regolarla utilizzando le apposite caselle di controllo.
Valute per posizione
Questa opzione può essere utilizzata con o senza WPML.
Se avete clienti in Paesi che parlano la stessa lingua ma usano valute diverse, potreste voler configurare le valute in base all’indirizzo IP o all’indirizzo di fatturazione dei vostri clienti.
Questa funzione è utile se volete:
- Imporre agli utenti determinate valute in base alla loro posizione o all’indirizzo di fatturazione.
- Implementa una politica di prezzi basata sulla posizione.
Ad esempio, potete decidere di fissare un prezzo più alto per i clienti degli Stati Uniti (che pagano in USD) piuttosto che per quelli del Regno Unito (che pagano in GBP). Potete impostarlo in modo che i clienti non vedano i prezzi nella valuta dell’altro Paese, anche se entrambi i clienti parlano inglese.
Per impostare le valute per ogni località, vai su WooCommerce → WooCommerce Multilingual & Multicurrency e clicca sulla scheda Multicurrency.
WooCommerce utilizza MaxMind Geolocation per determinare la posizione di un cliente tramite l’indirizzo IP. Per ottenere risultati ottimali, crea un account MaxMind gratuito e genera una nuova chiave di licenza per determinare la posizione del cliente.
Una volta inserita la chiave nelle impostazioni Multicurrency, sei pronto a personalizzare le valute per paese.
Clicca su Aggiungi valuta per aggiungere un’altra valuta al tuo sito. Puoi scegliere per quali paesi desideri che questa valuta sia disponibile. Oppure puoi escludere paesi specifici.
Una volta abilitate le valute in base alla posizione del cliente, i clienti connessi vedranno le valute in base al loro indirizzo di fatturazione. Per gli altri clienti WCML utilizzerà il loro indirizzo IP per visualizzare la valuta corretta.
Attenzione: la visualizzazione delle valute in base all’indirizzo IP potrebbe non funzionare perfettamente. Questo perché:
- Il database di MaxMind determina la geolocalizzazione del cliente. I clienti vedranno la valuta di default del tuo negozio se il loro indirizzo IP non corrisponde a quello del database di MaxMind.
- I transitori e le sessioni di WooCommerce salvano gli indirizzi IP per mostrare contenuti specifici ai clienti che si trovano in determinate località. Di conseguenza, i prezzi possono apparire nella stessa valuta per gli utenti VPN di diversi paesi.
- Se hai scelto di limitare i luoghi di vendita del tuo negozio a paesi specifici, WooCommerce mostrerà ai clienti di questi paesi le valute assegnate. Tutti gli altri clienti vedranno la valuta di default del tuo negozio.
Puoi sovrascrivere il paese geolocalizzato di WooCommerce Multilingual utilizzando il gancio del filtro wcml_geolocation_get_user_country.
Aggiungere un selettore di valuta sul front-end
Una volta aggiunto il supporto per più valute, dovreste visualizzare un selettore di valuta nel tema del vostro sito. Potete visualizzare il selettore di valuta con un codice abbreviato o come hook.
Widget del selettore di valuta
Il selettore di valuta può essere aggiunto a un modello come widget classico di WordPress. Vi preghiamo di notare che il selettore di valuta non è ancora disponibile come widget a blocchi.
Per configurarlo, vai alla scheda WooCommerce → WooCommerce Multilingual & Multicurrency → Multicurrency .
Le opzioni del selettore di valuta vi consentono di:
- Mostra un selettore delle valute sul modello della Pagina del prodotto
- Visualizza in anteprima l’aspetto dello switcher sul frontend prima di applicare le modifiche
- Imposta lo stile dello switcher
- Drag and drop dell’ordine delle valute nel selettore.
- Regola l’uscita del commutatore
Potete personalizzare il modello utilizzato per il selettore di valuta utilizzando quattro parametri:
- %name% – nome completo della valuta, ad esempio “Euro”.
- %symbol% – il simbolo standard che rappresenta la valuta, ad esempio “$” o “€”.
- %code% – il codice standard che rappresenta la valuta, ad esempio USD per il dollaro degli Stati Uniti.
- %subtotal% – il costo totale dell’ordine corrente (carrello), senza le spese di spedizione e le tasse aggiuntive. Il subtotale è il prezzo formattato e include il simbolo della valuta posizionato in base alle opzioni di valuta impostate nelle impostazioni di WooCommerce.
WooCommerce Multilingual & Multicurrency ti permette anche di utilizzare i seguenti tag HTML per personalizzare l’output del selettore: img, span, em, strong e u. Tieni presente che questi tag possono essere utilizzati solo quando lo stile del selettore delle valute è impostato su Elenco delle valute. Questo deriva dagli standard HTML ufficiali per il tag select .
Codice abbreviato del selettore di valuta
Se volete aggiungere il selettore di valuta in altri punti del sito potete farlo utilizzando un codice abbreviato.
Shortcode: [currency_switcher]
Attributo: format (Tag disponibili: %name%, %code%, %symbol%) Default: %name% (%symbol%)
Esempio di utilizzo: [currency_switcher format="%code% (%symbol%)"]
La versione Shortcode è la più comoda quando visualizzi il selettore delle valute in linea con i contenuti di WordPress, ad esempio in un modello di contenuti del plugin Toolset Blocks. Devi utilizzare il blocco Campi e Testo per includere lo Shortcode nel modello.
Selettore di valuta come codice PHP
Potete anche aggiungere e personalizzare i selettori di valuta utilizzando il codice PHP.
do_action('wcml_currency_switcher', array('format' => '%name% (%symbol%)'));
Oltre al formato, puoi utilizzare il seguente parametro:
switcher_style: wcml-dropdown, wcml-dropdown-click, wcml-horizontal-list, wcml-vertical-list
Questo produce un menu a tendina di base con codici di valuta per i valori delle opzioni. Verrà selezionata automaticamente la valuta corrente del cliente o la valuta predefinita configurata per una lingua specifica.
Utilizzo dei selettori personalizzati
Oltre a queste opzioni predefinite di Selettore_stile, puoi anche utilizzarne di personalizzate, definite dal Selettore delle valute personalizzato che hai progettato utilizzando i file modello. In questo caso, devi utilizzare lo slug corretto che identifica il tuo Selettore delle valute personalizzato.
Lo slug del tuo switcher personalizzato viene generato in base al nome sanificato del tuo modello, definito nel suo file config.json, e alla posizione del modello stesso:
| Posizione del selettore delle valute personalizzato | Come viene generato lo slug |
| Cartella del tema | Campo dati dinamico del tema + nome del selettore sanificato |
| Cartella del plug-in | Campo dati dinamico del plug-in + nome del selettore sanificato |
| Cartella dei caricamenti | “caricamenti” + nome del selettore sanificato |
Prendiamo in considerazione il seguente esempio:
- Il nome del tuo selettore delle valute personalizzato è Il mio selettore personalizzato.
- Stai utilizzando il tema Twenty Seventeen e i file dei modelli per gli interruttori si trovano nella cartella del tema.
Lo slug da utilizzare con il tuo switcher personalizzato è twenty-seventeen-my-custom-switcher, come mostrato nel seguente esempio.
Using custom currency switcher in PHP templates
do_action('wcml_currency_switcher', array(
'format' => '%name% (%symbol%)',
'switcher_style' => 'twenty-seventeen-my-custom-switcher'
));
La versione del codice PHP è migliore quando si aggiunge manualmente il selettore di valuta ai modelli PHP.
Impostazioni dei gateway di pagamento
Puoi impostare i gateway di pagamento per il tuo negozio andando su WooCommerce → Impostazioni → Pagamenti. Per default, tutti i gateway di pagamento che hai impostato saranno disponibili per tutte le valute del tuo sito.
Questa funzione è compatibile con i pagamenti WooCommerce PayPal, Stripe e bonifici bancari diretti.
Configurazione di gateway di pagamento diversi per ogni valuta
Questa funzionalità richiede un account di WPML Multilingual CMS o un account di agenzia .
Potete scegliere di impostare gateway di pagamento specifici per ciascuna delle valute del vostro sito. Può essere utile se, ad esempio:
- Il tuo negozio utilizza trasferimenti bancari diretti e vuoi utilizzare conti bancari locali per ogni valuta.
- Il tuo negozio utilizza PayPal e vuoi creare diversi account PayPal per ogni valuta.
Per farlo:
- Vai su WooCommerce → WooCommerce Multilingual & Multicurrency e clicca sulla scheda Multicurrency.
- Clicca sull’icona della matita accanto a una delle valute del tuo sito.
- Attiva i gateway di pagamento. Viene visualizzato un elenco di tutti i gateway di pagamento che hai impostato.
Impostazione della valuta in cui ricevere i pagamenti
Questa funzionalità richiede un account di WPML Multilingual CMS o un account di agenzia .
WooCommerce Multilingual ti permette di scegliere la valuta in cui addebitare i costi ai clienti e ricevere i pagamenti per ogni gateway di pagamento.
Ad esempio, puoi impostare il tuo negozio in modo che:
- I tuoi clienti possono fare acquisti in sterline (GBP) e scegliere di pagare con Stripe
- Riceverai il pagamento da Stripe in euro (EUR)
Quando scegli di ricevere il pagamento in una valuta diversa da quella utilizzata dal tuo cliente, quest’ultimo vedrà l’importo totale nella valuta convertita durante il checkout.
Per configurarlo:
- Modifica una delle valute del tuo sito.
- Usa l’elenco a discesa Valuta per selezionare la valuta in cui vuoi che vengano addebitati i costi ai tuoi clienti.
Nell’esempio qui sotto, puoi vedere che per i clienti che acquistano in sterline (GBP) abbiamo i bonifici bancari diretti e Stripe come gateway di pagamento. Per quanto riguarda Stripe, abbiamo scelto di addebitare e ricevere i pagamenti in euro (EUR).
Se vuoi che tutti i pagamenti siano effettuati in una valuta di default, devi modificare ogni valuta del tuo sito. Quindi, devi impostare la tua valuta di default come valuta di transazione per ogni gateway di pagamento.
Scelta dei gateway di pagamento da visualizzare in base alla posizione del cliente
Questa funzionalità richiede un account di WPML Multilingual CMS o un account di agenzia .
Alcuni gateway di pagamento sono disponibili solo in determinati Paesi. Se è stata impostata la geolocalizzazione per visualizzare le valute in base alla posizione del cliente, potete determinare quali gateway di pagamento visualizzare.
Per regolare i paesi in cui appare un determinato gateway di pagamento, vai su WooCommerce → Impostazioni e clicca sulla scheda Pagamenti. Clicca sul metodo di pagamento che desideri modificare e vedrai l’opzione per cambiare la disponibilità del paese.
Utilizzo di altri plugin per gateway di pagamento
Se vuoi utilizzare un altro plugin per il gateway di pagamento, consulta il nostro elenco di plugin consigliati per informazioni sulla compatibilità e la documentazione disponibile.
Impostare un tasso di cambio automatico
Questa funzionalità può essere utilizzata con o senza WPML.
WooCommerce Multilingual ti permette di impostare i tassi di cambio automatici per il tuo negozio andando su WooCommerce → WooCommerce Multilingual & Multicurrency e cliccando sulla scheda Multicurrency. Spunta la casella per abilitare i tassi di cambio automatici.
Per questa funzione sono disponibili tre impostazioni:
- Fonte tassi di cambio – Seleziona la fonte dei dati sui tassi di cambio. Puoi scegliere tra quattro rinomati servizi: Fixer.io, currencylayer, Exchange Rates API e Open Exchange Rates.
- Tassa di sollevamento – Puoi impostare una percentuale aggiuntiva per aggiustare il tasso di cambio effettivo finale. Questo è utile per le transazioni internazionali che possono aggiungere costi aggiuntivi.
Questo è il modo in cui viene calcolata la tariffa effettiva, basata sulla tariffa di sollevamento impostata:Tariffa effettiva = Tariffa di servizio x (1 + Canone di sollevamento / 100)
- Frequenza di aggiornamento – Imposta la frequenza con cui il cambio automatico controlla e aggiorna i tassi di cambio del tuo negozio. La frequenza può essere oraria, giornaliera, settimanale o mensile. Di default è impostato l’aggiornamento manuale. Nota bene: l’aggiornamento dei tassi di cambio su base oraria genera circa 744 chiamate API al mese. Verifica che la tua fonte di tassi di cambio sia in grado di gestire questo utilizzo più elevato.
Opzioni di valuta e regole di arrotondamento
La formattazione della valuta varia a seconda dei paesi e delle lingue. Ad esempio, mentre alcuni paesi usano la virgola per separare le migliaia, altri usano il punto decimale.
Quando aggiungi una valuta secondaria, WooCommerce Multilingual gestisce automaticamente la formattazione della valuta. Imposta i dettagli specifici del locale come la posizione della valuta, il separatore decimale e il numero di decimali. Se vuoi cambiare questi preset, puoi modificare in modo indipendente ogni valuta e configurare le sue impostazioni.
Nella stessa schermata di modifica della valuta, WooCommerce Multilingual ti permette di impostare prezzi specifici per ogni valuta, assicurandoti che i prezzi abbiano un aspetto “ordinato”. I prezzi determinati automaticamente possono essere arrotondati al numero intero più vicino.
Ecco come funziona l’arrotondamento al numero intero più vicino:
- Se il valore di incremento è impostato su 1, un prezzo come 1454,07 sarà arrotondato a 1454.
- Se il valore di incremento è impostato a 10, lo stesso prezzo di 1454,07 sarà arrotondato per difetto a 1450.
- Se il valore di incremento è impostato su 100, allora 1454,07 diventa 1500.
Autosottrazione dell’importo: ti permette di sottrarre un determinato valore dall’importo precedentemente arrotondato.
Per 1454.07, quando l’incremento per l’intero più vicino è 100 e l’autosottrazione è 1, l’importo finale sarà 1499.
Configurare prezzi personalizzati per valute diverse
Questa funzionalità può essere utilizzata con o senza WPML.
Configurazione dei prezzi dei prodotti per valuta
WooCommerce Multilingual vi consente di impostare prezzi personalizzati in valute diverse.
Puoi impostare i prezzi personalizzati in diverse valute nella schermata di modifica del prodotto, nei campi Prezzo personalizzato e Prezzo di vendita (per la valuta di default).
Questi sono fissi e sostituiscono i prezzi determinati automaticamente dal tasso di cambio. Per tornare a utilizzare i prezzi automatici dovete rimuovere i prezzi personalizzati e aggiornare il prodotto.
Un’interfaccia simile è presente nella schermata di modifica dei prodotti variabili.
Impostazione delle spese di spedizione per valuta
Inoltre potete configurare spese di spedizione diverse per valuta per i seguenti metodi di spedizione standard di WooCommerce:
- Tariffa forfettaria – Imposta la tariffa forfettaria principale e la tariffa per la classe di spedizione (se sono state definite).
- Spedizione gratuita – Imposta l’importo minimo
- Ritiro locale – Imposta le spese di gestione
Per impostare spese di spedizione personalizzate:
- Vai su WooCommerce → Impostazioni e clicca sulla scheda Spedizione.
- Imposta le zone di spedizione e aggiungi i metodi di spedizione che vuoi utilizzare.
- Clicca su Modifica sotto il metodo di spedizione che desideri personalizzare e apparirà una finestra pop-up.
- Usa il campo Costo per definire il costo della spedizione nella tua valuta di default.
- Dal menu a tendina Abilita costi in valute personalizzate, seleziona Imposta manualmente i costi di spedizione in altre valute.
- Inserisci i prezzi personalizzati per le altre valute nei campi che appaiono.
Visualizzazione di ordini e analisi per valuta
Questa funzionalità può essere utilizzata con o senza WPML.
Gli ordini hanno una valuta specifica associata. È la valuta che l’utente stava utilizzando quando ha effettuato l’ordine. Puoi visualizzare i totali di ogni ordine nella valuta corrispondente nella pagina WooCommerce → Ordini. In questa pagina è anche possibile filtrare gli ordini per valuta.
Poiché tutti gli ordini creati hanno una valuta associata, WooCommerce Analytics può essere suddiviso per valuta.
Informazioni per sviluppatori: per impostare la vostra logica multivaluta usate gli hook di basso livello
WooCommerce Multilingual definisce una serie di filtri e ganci che possono essere utilizzati da plugin di terze parti per implementare la logica multicurrency quando WooCommerce e WooCommerce Multilingual sono impostati e funzionanti. In questo modo gli utenti possono vedere i prezzi nella loro valuta preferita (gli importi dei prezzi vengono determinati in base al tasso di cambio della valuta). Gli ordini vengono effettuati nella valuta selezionata dall’utente nel frontend.
