Documentazione Plugin WordPress
Scopri come installare, configurare e personalizzare il tuo widget convertitore di valuta
Indice
1 Installazione
Metodo 1: Installa da WordPress (Consigliato)
- Vai alla dashboard amministrativa di WordPress
- Naviga su Plugin > Aggiungi Nuovo
- Cerca "Currency.Wiki Converter"
- Clicca su "Installa ora" e poi su "Attiva"
Metodo 2: Installazione Manuale
- Scarica il plugin da WordPress.org
- Vai su Plugin > Aggiungi Nuovo > Carica Plugin
- Seleziona il file ZIP scaricato e clicca su "Installa ora"
- Attiva il plugin dopo l'installazione
2 Utilizzo Blocco Gutenberg
Il modo più semplice per aggiungere il convertitore di valuta alle tue pagine:
- Modifica qualsiasi pagina o articolo utilizzando l'editor Gutenberg
- Clicca sul pulsante + per aggiungere un nuovo blocco
- Cerca "Currency Converter" o sfoglia la categoria Widget
- Configura il widget tramite il pannello laterale a destra
Suggerimento: Puoi vedere un'anteprima dal vivo del tuo widget mentre cambi le impostazioni nell'editor a blocchi.
3 Utilizzo Shortcode
Puoi anche aggiungere il widget utilizzando gli shortcode in articoli, pagine o template del tema:
Utilizzo Base
[currencywiki_converter]
Attributi Disponibili
| Attributo | Predefinito | Descrizione |
|---|---|---|
| style | compact | Stile widget (compatto, in linea, alto, mini-grafico, ecc.) |
| theme | auto | Tema colore (auto, chiaro, scuro) |
| from | USD | Valuta di origine predefinita (codice ISO a 3 lettere) |
| to | EUR | Valuta di destinazione predefinita (codice ISO a 3 lettere) |
| amount | 1 | Importo predefinito da convertire |
| accent | #3b82f6 | Colore accento (codice hex come #3b82f6) |
| embed | script | Metodo di incorporamento (script o iframe) |
| width | auto | Larghezza personalizzata in pixel |
| height | auto | Altezza personalizzata in pixel |
Esempi
Widget tema scuro:
[currencywiki_converter theme="dark"]
Valute e importo personalizzati:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
Stile mini-grafico:
[currencywiki_converter style="mini-chart"]
Utilizzo incorporamento iframe (per compatibilità tema):
[currencywiki_converter embed="iframe"]
4 Stili Widget
Scegli tra diversi stili di widget per adattarli al design del tuo sito:
mini
Convertitore minimale, perfetto per spazi ridotti (250x140px)
square
Convertitore quadrato rapporto 1:1 (250x250px)
compact
Convertitore piccolo e compatto (280x200px)
inline
Layout orizzontale, ideale per intestazioni (450x120px)
tall
Layout verticale con etichette classiche (220x360px)
mini-chart
Convertitore compatto con grafico storico (250x260px)
multi-expandable
Conversione in più valute, gli utenti possono aggiungere/rimuovere (300x400px)
multi-fixed
Elenco fisso di conversioni multiple (280x360px)
rates-compact
Elenco semplice tassi di cambio (260x260px)
rates-viewer
Visualizzatore tassi completo con grafico (350x420px)
rates-viewer-compact
Visualizzatore tassi compatto con grafico (300x340px)
Suggerimento: Usa il Widget Builder nell'admin di WordPress per visualizzare in anteprima tutti gli stili prima di aggiungerli al tuo sito.
5 Opzioni di Configurazione
La pagina delle impostazioni del plugin nel tuo admin WordPress ti permette di configurare le opzioni predefinite:
Opzioni Tema
- auto - Si adatta automaticamente allo schema colori del tuo sito
- light - Usa sempre sfondo chiaro
- dark - Usa sempre sfondo scuro
Metodo di Incorporamento
- script - Predefinito. Il widget si carica in linea con tutte le funzionalità. I menu a tendina delle valute si sovrappongono ai contenuti circostanti.
- iframe - Opzione alternativa. Il widget si carica in un iframe isolato. Usalo se riscontri conflitti di stile con il tuo tema.
Nota: Se i menu a tendina delle valute appaiono dietro altri elementi o vengono tagliati, prova a passare alla modalità iframe.
6 Risoluzione dei Problemi
Il widget non si visualizza?
Assicurati che il plugin sia attivo. Controlla se ci sono plugin di cache da svuotare. Prova a usare il metodo iframe se lo script non funziona.
Il widget appare rotto o ci sono conflitti di stile?
Alcuni temi WordPress possono entrare in conflitto con lo script del widget. Passa alla modalità iframe aggiungendo embed="iframe" allo shortcode.
Menu a tendina delle valute nascosto o tagliato?
Questo può succedere quando gli elementi contenitore hanno overflow:hidden. Prova la modalità iframe o modifica il CSS del tema per consentire overflow sul contenitore del widget.
Il widget mostra tassi vecchi?
I tassi di cambio si aggiornano automaticamente. Se usi un plugin di cache, escludi gli script del widget dalla cache o svuota la cache dopo le modifiche.
Serve Aiuto?
Non trovi ciò che cerchi? Il nostro team di supporto è qui per aiutarti.
