Widget-dokumentation
Komplet guide til indlejring og tilpasning af Currency.Wiki valutakonverter-widget på din hjemmeside.
Indholdsfortegnelse
1 Kom godt i gang
Det er nemt at tilføje en valutakonverter-widget til din hjemmeside. Følg disse enkle trin:
- Gå til Widget Builder-siden og tilpas widgettens udseende
- Vælg din foretrukne widget-stil, valutaer og tema
- Kopiér den genererede indlejringskode (Script eller Iframe)
- Indsæt koden i din hjemmesides HTML, hvor du ønsker, at widgetten skal vises
Tip: Brug Hurtigstart-skabelonerne i Widget Builder for hurtigt at komme i gang med en forudkonfigureret widget.
2 Indlejringsmetoder
Script-indlejring (anbefalet)
Script-indlejringsmetoden indsætter widgetten direkte på din side. Valuta-dropdownmenuer vises foran det omgivende indhold for nemt valg.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Dropdowns vises uden for widget-containeren
- Bedst til interaktiv valutavalg
- Problemfri integration med din side
Iframe-indlejring
Iframe-indlejringsmetoden opretter en isoleret container til widgetten. Denne metode er sikker og fungerer i miljøer med strenge indholdsregler.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Fuldstændig isoleret fra dine sidestilarter
- Fungerer med strenge Content Security Policies
- Simpel og sikker implementering
Bemærk: Brug Script-indlejring for fuld interaktivitet (dropdowns vises over indhold). Brug Iframe-indlejring hvis du har brug for isolation eller har CSP-begrænsninger.
3 Widget-stilarter
Vælg mellem 11 forskellige widget-stilarter, der matcher din hjemmesides design. Hver stil er optimeret til forskellige brugsscenarier og visningsstørrelser.
mini
250x140px
Kompakt konverter på én linje. Perfekt til overskrifter eller små områder.
square
250x250px
1:1 ratio-widget med bytteknap. God til sidebars.
compact
300x180px
Lille konverter med alle nødvendige funktioner.
inline
480x56px
Vandret layout. Ideel til indlejring i indhold eller navigation.
tall
200x280px
Vertikal sidebar-layout med klassiske etiketter.
mini-chart
250x260px
Kompakt konverter med minigraf, der viser kursudvikling.
multi-expandable
300x320px
Multi-valutakonverter. Brugere kan tilføje/fjerne valutaer.
multi-fixed
300x300px
Fast liste over valutakurser. Bedst til visning af specifikke kurser.
rates-compact
250x320px
Kondenseret valutakursliste med sidste opdateringstid.
rates-viewer
300x500px
Fuld grafvisning med detaljeret kursinformation.
rates-viewer-compact
300x400px
Kompakt version af kursvisning med grafer.
4 URL-parametre
Tilpas din widget med URL-parametre. Disse parametre virker med både Script- og Iframe-indlejring.
| Parameter | Standard | Beskrivelse |
|---|---|---|
| style | compact | Widget-stil (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Farvetema (light, dark eller auto) |
| from | USD | Kildevalutakode (f.eks. USD, EUR, GBP) |
| to | EUR | Målvalutakode (f.eks. EUR, USD, JPY) |
| amount | 1000 | Standardbeløb til konvertering |
| accent | #2563eb | Accentfarve i hex-format (uden #) |
| lang | en | Widgetsprogkode (f.eks. en, es, fr, de) |
| flags | 1 | Vis landeflag (1=vis, 0=skjul) |
| display | iso | Valutavisningsformat (iso=USD, symbol=$) |
| lock | 0 | Lås valutaer (1=låst, 0=ulåst) |
| currencies | EUR,GBP,JPY | Kommasepareret liste over valutaer til multi-valuta-widgets |
| dropdown | all | Valutaer i dropdown (all, top10, top20 eller kommasepareret liste) |
| branding | 1 | Vis branding (1=vis, 0=skjul) |
| brandinglink | 1 | Gør branding klikbar (1=link, 0=kun tekst) |
| format | auto | Talformat (auto, us, eu, french, indian) |
| decimals | 2 | Antal decimaler (0-6) |
| chart | 0 | Aktivér graf (1=aktiveret, 0=deaktiveret) |
| chartperiod | 7d | Grafperiode (7d, 14d, 30d, 90d) |
Eksempler
Mørkt tema kompakt konverter:
?style=compact&theme=dark&from=USD&to=EUR
Multi-valutakurser:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Mini-konverter med 30-dages graf:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Vis valutategn i stedet for koder:
?style=compact&display=symbol&from=USD&to=EUR
Låste valutaer med brugerdefineret beløb:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Tilpasningsmuligheder
Temaindstillinger
- light - Lys baggrund med mørk tekst
- dark - Mørk baggrund med lys tekst
- auto - Matcher automatisk brugerens systempræference
Valutavisningsformat
- iso - Viser ISO-koder som USD, EUR, GBP
- symbol - Viser valutategn som $, €, £
Talformater
- auto - Registrerer automatisk besøgendes browserindstillinger
- us - US-format: 1,234.56
- eu - Europæisk format: 1.234,56
- french - Fransk format: 1 234,56
- indian - Indisk format: 1,23,456.78
Dropdown-valutamuligheder
- all - Alle 170+ understøttede valutaer
- top10 - Top 10 mest populære valutaer
- top20 - Top 20 valutaer efter handelsvolumen
- USD,EUR,GBP,... - Brugerdefineret liste over specifikke valutaer
Tip: Brug Widget Builder til visuelt at konfigurere alle disse muligheder og automatisk generere indlejringskoden.
6 Fejlfinding
Widget vises ikke
Sørg for, at indlejringskoden er placeret korrekt i din HTML. For script-indlejring, sørg for at container-div'en eksisterer med korrekt ID. Tjek din browserkonsol for JavaScript-fejl.
Dropdown virker ikke
Hvis du bruger iframe-indlejring, vil dropdowns rulle inden for widgetområdet. For fuld dropdownfunktionalitet med overlays, brug i stedet script-indlejringsmetoden.
Stilkonflikter
Hvis din hjemmesides CSS påvirker widgettens udseende, prøv at bruge iframe-indlejring, som isolerer widgetstilarter fra din side.
Content Security Policy-problemer
Hvis du har en streng CSP, skal du muligvis tilføje currency.wiki til dine tilladte script-src og frame-src direktiver. Eksempel: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Brug for hjælp?
Kan du ikke finde det, du leder efter? Vores supportteam er klar til at hjælpe.
