Documentazione App Shopify
Tutto ciò che ti serve per configurare e personalizzare la conversione valuta sul tuo negozio Shopify
Indice
1 Installazione
Installa dallo Shopify App Store
- Visita la pagina dell'app Currency.Wiki su Shopify App Store
- Clicca su 'Aggiungi app' e autorizza l'installazione
- L'app si aprirà e ti guiderà nella procedura guidata
- Completa la procedura guidata per iniziare a convertire i prezzi
Suggerimento: La procedura guidata richiede circa 2 minuti e ti accompagna in ogni passaggio.
2 Procedura Guidata
La procedura guidata ti aiuta a configurare correttamente l'app. Ti guida nell'aggiornamento del formato valuta e nell'abilitazione dell'app embed.
Passo 1: Benvenuto
Rivedi cosa comporta la procedura e clicca su 'Iniziamo'.
Passo 2: Aggiorna Formato Valuta
Vai su Shopify Admin → Impostazioni → Generali → Predefiniti negozio. Trova la tua valuta e clicca sul menu a tre puntini → 'Cambia formattazione valuta'. Aggiorna i campi HTML con la nostra classe wrapper:
HTML con valuta:
<span class="cwiki">${{amount}} USD</span>
HTML senza valuta:
<span class="cwiki">${{amount}}</span>
Importante: La classe wrapper cwiki è essenziale. Indica all'app quali elementi sono prezzi, così convertiamo solo i prezzi reali e non numeri di telefono o ID ordini.
Passo 3: Abilita App Embed
Abilita l'app nella sezione app embed del tuo tema:
- Vai su Negozio Online → Temi → Personalizza
- Cerca 'App embeds' nella barra laterale sinistra
- Trova 'Currency.Wiki App' e attivalo
- Clicca Salva nell'editor tema
Passo 4: Verifica Configurazione
Clicca su 'Scansiona il mio negozio' per verificare che la configurazione sia completa. La procedura controllerà la presenza della classe cwiki e dell'app embed. Se tutto va bene, sei pronto!
3 Stili Widget
Scegli tra 6 stili di widget per adattarli al design del tuo negozio. Ogni stile può essere personalizzato con i colori del tuo brand.
Menu a Tendina Minimale
Integrazione compatta nell'intestazione con una semplice lista a tendina. Ideale per posizionamento in alto a destra.
Pillola Flottante
Pulsante mobile-friendly con pannello espandibile. Ottimo per negozi mobile-first. Si posiziona negli angoli.
Sidebar a Scomparsa
Pannello a tutta altezza con funzione di ricerca. Ideale per negozi con molte valute.
Popup Modale
Overlay centrato con layout a griglia. Rende la selezione valuta un'esperienza focalizzata.
Switcher a Tab In Linea
Tab orizzontali per valute popolari. Cambio rapido senza aprire menu.
Badge d'Angolo
Icona minimalista nell'angolo che si espande al clic. Il meno invasivo per design puliti.
Suggerimento: Usa la pagina Impostazioni Widget nell'admin dell'app per visualizzare in anteprima tutti gli stili con i colori del tuo negozio.
4 Dashboard Admin
La dashboard admin ti dà il pieno controllo su come funziona la conversione valuta nel tuo negozio.
Home Dashboard
Attiva/disattiva il widget, visualizza le statistiche di conversione e vedi un'anteprima dal vivo del tuo widget.
Impostazioni Widget
Scegli stile, posizione, colori, dimensione, raggio bordo e opzioni bandiera del widget.
Gestione Valute
Abilita/disabilita valute, riordina la lista, configura il comportamento di auto-detection e imposta preferenze tassi di cambio.
Analisi
Visualizza grafici di conversione, vedi le valute più usate e comprendi la distribuzione internazionale dei clienti.
Tema & Aspetto
Scegli modalità tema (auto, chiaro, scuro, personalizzato), imposta colori, abilita effetti glassmorphism e configura il comportamento della modalità scura.
Messaggio Checkout
Abilita un messaggio nelle pagine carrello/checkout per informare i clienti sulla valuta di pagamento.
5 Impostazioni Avanzate
Le impostazioni avanzate danno agli utenti Pro più controllo su formattazione prezzi e comportamento di conversione.
Formattazione Prezzi (Pro)
- Cifre Decimali - Controlla quante cifre decimali mostrare (0-6).
- Formato Numero - Scegli lo stile di formato (Auto, US, EU, Indiano, Spazio•Punto, Spazio•Virgola).
- Posizione Simbolo - Posiziona il simbolo valuta prima o dopo l'importo, oppure auto per valuta.
- Arrotondamento - Standard, sempre in eccesso, sempre in difetto o nessun arrotondamento. Opzione per arrotondare a .99 più vicino.
Integrazione Tema (Pro)
Incorpora manualmente il widget o l'avviso carrello ovunque nel tema usando questi snippet HTML:
Incorpora widget (aggiungi a header.liquid o qualsiasi sezione):
<div class="cwiki-widget"></div>
Incorpora avviso carrello (aggiungi a cart.liquid):
<div class="cwiki-banner"></div>
Opzioni Sviluppatore (Pro)
- Override Stili - Inserisci CSS personalizzato per modificare lo stile del widget.
- Listener Click - Riconverti i prezzi quando vengono cliccati elementi specifici (es. selettori taglia, opzioni prodotto).
- Elementi Prezzo Extra - Targetizza elementi prezzo aggiuntivi oltre al wrapper .cwiki predefinito.
- Pattern URL - Riscansiona i prezzi quando l'URL contiene stringhe specifiche (per contenuti AJAX, scroll infinito).
- Ritardo Conversione - Attendi prima di convertire i prezzi (per contenuti che si caricano dopo il caricamento pagina).
Attenzione: Queste opzioni sono per utenti avanzati. Testa su un tema di anteprima prima di pubblicare.
6 Risoluzione dei Problemi
I prezzi non si convertono?
Assicurati che la classe wrapper cwiki sia nelle impostazioni formato valuta. Vai su Impostazioni → Generali → Predefiniti negozio e controlla la formattazione HTML. Verifica anche che l'app embed sia attiva nel personalizzatore tema.
Il widget non si visualizza?
Controlla che l'app embed sia attiva nella sezione App Embeds del tema. Prova ad aprire il personalizzatore tema, trova App Embeds e assicurati che Currency.Wiki sia attivo. Salva e aggiorna il negozio.
I prezzi sfarfallano al caricamento?
La nostra app è progettata per caricamento senza sfarfallio. Se noti sfarfallio, controlla se hai plugin di cache che interferiscono. Assicurati anche che l'app embed si carichi nella sezione head del tema.
Viene rilevata la valuta sbagliata?
La geo-detection si basa sull'indirizzo IP del visitatore. VPN o reti aziendali possono influire. I visitatori possono sempre selezionare manualmente la valuta preferita. Puoi anche impostare una valuta di fallback predefinita nelle impostazioni.
Il widget non si adatta al mio tema?
Usa le impostazioni Tema & Aspetto per personalizzare i colori, oppure abilita la modalità Auto per rilevare automaticamente i colori del tema. Puoi anche usare CSS personalizzato nelle Impostazioni Avanzate per uno stile preciso.
Serve Aiuto?
Il nostro team di supporto è pronto ad aiutarti per qualsiasi domanda su configurazione o impostazioni.
