Shopify-app-dokumentation
Allt du behöver för att konfigurera och anpassa valutakonvertering i din Shopify-butik
Innehållsförteckning
1 Installation
Installera från Shopify App Store
- Besök Currency.Wiki-appsidan i Shopify App Store
- Klicka på 'Lägg till app' och auktorisera installationen
- Appen öppnas och guidar dig genom installationsguiden
- Slutför guiden för att börja konvertera priser
Tips: Guiden tar cirka 2 minuter och leder dig genom varje steg.
2 Installationsguide
Installationsguiden hjälper dig att konfigurera appen korrekt. Den guidar dig genom att uppdatera valutainställningar och aktivera app-inbäddning.
Steg 1: Välkommen
Gå igenom vad installationsprocessen innebär och klicka på 'Kom igång'.
Steg 2: Uppdatera valutainställning
Gå till Shopify Admin → Inställningar → Allmänt → Butiksstandarder. Hitta din valuta och klicka på de tre prickarna → 'Ändra valutaformat'. Uppdatera HTML-fälten med vår wrapper-klass:
HTML med valuta:
<span class="cwiki">${{amount}} USD</span>
HTML utan valuta:
<span class="cwiki">${{amount}}</span>
Viktigt: cwiki-wrapperklassen är avgörande. Den talar om för vår app vilka element på sidan som är priser, så vi bara konverterar faktiska priser och inte telefonnummer eller order-ID.
Steg 3: Aktivera app-inbäddning
Aktivera appen i temats app-inbäddningssektion:
- Gå till Onlinebutik → Teman → Anpassa
- Leta efter 'App embeds' i vänstra sidopanelen
- Hitta 'Currency.Wiki App' och slå på den
- Klicka på Spara i temaredigeraren
Steg 4: Verifiera installation
Klicka på 'Skanna min butik' för att verifiera att installationen är klar. Guiden kontrollerar cwiki-wrapperklassen och app-inbäddningen. Om allt är korrekt är du redo!
3 Widget-stilar
Välj mellan 6 widget-stilar för att matcha din butiksdesign. Varje stil kan anpassas med dina varumärkesfärger.
Minimalistisk rullgardinsmeny
Kompakt integration i sidhuvudet med enkel meny. Bäst för placering uppe till höger.
Flytande knapp
Mobilvänlig flytande knapp med expanderbar panel. Perfekt för mobilfokuserade butiker. Placeras i hörn.
Sidopanel
Panel i full höjd med sökfunktion. Perfekt för butiker med många valutor.
Modal-popup
Centrerad överlägg med rutnätslayout. Gör valutavalet fokuserat.
Inline-flikar
Horisontella flikar för populära valutor. Snabbt byte utan menyer.
Hörn-ikon
Minimalistisk ikon i hörnet som expanderar vid klick. Minst påträngande för rena designer.
Tips: Använd sidan Widget-inställningar i appens admin för att förhandsgranska alla stilar med butikens färger.
4 Adminpanel
Adminpanelen ger dig full kontroll över hur valutakonvertering fungerar i din butik.
Dashboard-översikt
Slå på/av widgeten, se konverteringsstatistik och förhandsgranska din widget live.
Widget-inställningar
Välj widget-stil, position, färger, storlek, hörnradie och flagginställningar.
Valutahantering
Aktivera/inaktivera valutor, ändra ordning, konfigurera autodetektering och ställ in kursinställningar.
Analys
Visa konverteringsdiagram, se mest använda valutor och förstå din internationella kundfördelning.
Tema & Utseende
Välj temaläge (auto, ljust, mörkt, anpassat), ställ in färger, aktivera glassmorphism-effekter och konfigurera mörkt läge.
Kassa-meddelande
Aktivera ett meddelande på varukorg/kassasidor för att informera om kassavaluta.
5 Avancerade inställningar
Avancerade inställningar ger Pro-användare mer kontroll över prisformat och konverteringsbeteende.
Prisformat (Pro)
- Decimaler - Styr hur många decimaler som ska visas (0-6).
- Talformat - Välj formatstil (Auto, US, EU, Indiskt, Mellanslag•Punkt, Mellanslag•Komma).
- Symbolplacering - Placera valutasymbol före eller efter beloppet, eller auto per valuta.
- Avrundning - Standard, alltid upp, alltid ner eller ingen avrundning. Möjlighet att avrunda till närmaste .99.
Temaintegration (Pro)
Bädda in widgeten eller kassameddelandet manuellt var som helst i temat med dessa HTML-snippets:
Widget-inbäddning (lägg till i header.liquid eller valfri sektion):
<div class="cwiki-widget"></div>
Kassameddelande-inbäddning (lägg till i cart.liquid):
<div class="cwiki-banner"></div>
Utvecklaralternativ (Pro)
- Stilöverstyrningar - Lägg till anpassad CSS för att justera widgetens utseende.
- Klicklyssnare - Konvertera priser igen när specifika element klickas (t.ex. storleksval, produktalternativ).
- Extra priselement - Målsök ytterligare priselement utöver standard .cwiki-wrapper.
- URL-mönster - Skanna om priser när URL:en innehåller specifika strängar (för AJAX-innehåll, oändlig scroll).
- Konverteringsfördröjning - Vänta innan priser konverteras (för innehåll som laddas efter sidans färdigställande).
Observera: Dessa alternativ är för avancerade användare. Testa på ett förhandsgransknings-tema innan publicering.
6 Felsökning
Priser konverteras inte?
Kontrollera att cwiki-wrapperklassen finns i valutainställningarna. Gå till Inställningar → Allmänt → Butiksstandarder och kontrollera HTML-formatet. Kontrollera även att app-inbäddningen är aktiverad i temaanpassaren.
Widgeten visas inte?
Kontrollera att app-inbäddningen är aktiverad i temats App Embeds. Öppna temaanpassaren, hitta App Embeds och se till att Currency.Wiki är påslagen. Spara och uppdatera butiken.
Priser blinkar vid laddning?
Vår app är utformad för laddning utan blinkning. Om du ser blinkningar, kontrollera om du har cache-plugins som stör. Kontrollera även att app-inbäddningen laddas i temats head-sektion.
Fel valuta detekteras?
Geo-detektering baseras på besökarens IP-adress. VPN eller företagsnätverk kan påverka detekteringen. Besökare kan alltid välja valuta manuellt. Du kan även ställa in en standardvaluta i inställningarna.
Widgeten matchar inte mitt tema?
Använd Tema & Utseende för att anpassa färger, eller aktivera Auto-läge för att automatiskt upptäcka temafärger. Du kan även använda anpassad CSS i Avancerade inställningar för finjustering.
Behöver du hjälp?
Vårt supportteam hjälper dig gärna med frågor om installation eller konfiguration.
