Dokumentacija za pripomoček
Popoln vodnik za vgradnjo in prilagajanje valutnega pripomočka Currency.Wiki na vaši spletni strani.
Kazalo vsebine
1 Začetek
Dodajanje valutnega pripomočka na vašo spletno stran je enostavno. Sledite tem preprostim korakom:
- Pojdite na stran Graditelja pripomočka in prilagodite videz
- Izberite želeni slog pripomočka, valute in temo
- Kopirajte ustvarjeno vgradno kodo (skripta ali iframe)
- Prilepite kodo v HTML vaše spletne strani, kjer želite, da se pripomoček prikaže
Nasvet: Uporabite hitre predloge v Graditelju pripomočka za hiter začetek z vnaprej konfiguriranim pripomočkom.
2 Metode vgradnje
Vgradnja s skripto (priporočeno)
Metoda vgradnje s skripto vbrizga pripomoček neposredno na vašo stran. Spustni meniji valut bodo prikazani pred okoliško vsebino za lažjo izbiro.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Spustni meniji se prikažejo izven okvirja pripomočka
- Najbolje za interaktivno izbiro valut
- Brezhibna integracija z vašo stranjo
Iframe vgradnja
Metoda vgradnje z iframe ustvari izoliran okvir za pripomoček. Ta metoda je varna in deluje v okoljih s strogimi vsebinskimi politikami.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Popolnoma izolirano od slogov vaše strani
- Deluje s strogimi politikami varnosti vsebine
- Enostavna in varna implementacija
Opomba: Uporabite vgradnjo s skripto za polno interaktivnost (spustni meniji nad vsebino). Uporabite iframe vgradnjo, če potrebujete izolacijo ali imate CSP omejitve.
3 Slogi pripomočka
Izbirajte med 11 različnimi slogi pripomočka, ki ustrezajo dizajnu vaše spletne strani. Vsak slog je optimiziran za različne primere uporabe in velikosti prikaza.
mini
250x140px
Kompakten enovrstični pretvornik. Odličen za glave ali ozke prostore.
square
250x250px
Pripomoček v razmerju 1:1 z gumbom za zamenjavo. Odličen za stranske vrstice.
compact
300x180px
Majhen pretvornik z vsemi bistvenimi funkcijami.
inline
480x56px
Vodoravna postavitev. Idealno za vgradnjo v vsebino ali navigacijo.
tall
200x280px
Navpična postavitev stranske vrstice s klasičnimi oznakami.
mini-chart
250x260px
Kompakten pretvornik z grafom zgodovine tečaja.
multi-expandable
300x320px
Večvalutni pretvornik. Uporabniki lahko dodajajo/odstranjujejo valute.
multi-fixed
300x300px
Fiksni seznam menjalnih tečajev. Najbolje za prikaz določenih tečajev.
rates-compact
250x320px
Zgoščen seznam menjalnih tečajev z zadnjo posodobitvijo.
rates-viewer
300x500px
Celoten pogled grafikona s podrobnimi podatki o tečajih.
rates-viewer-compact
300x400px
Kompaktna različica pregledovalnika tečajev z grafikoni.
4 URL parametri
Prilagodite svoj pripomoček z uporabo URL parametrov. Ti parametri delujejo tako pri skripti kot pri iframe vgradnji.
| Parameter | Privzeto | Opis |
|---|---|---|
| style | compact | Slog pripomočka (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Barvna tema (light, dark ali auto) |
| from | USD | Koda izvorne valute (npr. USD, EUR, GBP) |
| to | EUR | Koda ciljne valute (npr. EUR, USD, JPY) |
| amount | 1000 | Privzeti znesek za pretvorbo |
| accent | #2563eb | Barva poudarka v hex obliki (brez #) |
| lang | en | Koda jezika pripomočka (npr. en, es, fr, de) |
| flags | 1 | Prikaži zastave držav (1=prikaži, 0=skrij) |
| display | iso | Oblika prikaza valute (iso=USD, symbol=$) |
| lock | 0 | Zakleni valute (1=zaklenjeno, 0=odklenjeno) |
| currencies | EUR,GBP,JPY | Z vejico ločen seznam valut za večvalutne pripomočke |
| dropdown | all | Valute v spustnem meniju (all, top10, top20 ali z vejico ločen seznam) |
| branding | 1 | Prikaži blagovno znamko (1=prikaži, 0=skrij) |
| brandinglink | 1 | Naj bo blagovna znamka klikljiva (1=povezava, 0=samo besedilo) |
| format | auto | Oblika številk (auto, us, eu, french, indian) |
| decimals | 2 | Število decimalnih mest (0-6) |
| chart | 0 | Omogoči grafikon (1=omogočeno, 0=onemogočeno) |
| chartperiod | 7d | Obdobje grafikona (7d, 14d, 30d, 90d) |
Primeri
Kompakten pretvornik v temni temi:
?style=compact&theme=dark&from=USD&to=EUR
Večvalutni menjalni tečaji:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Mini pretvornik s 30-dnevnim grafom:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Prikaz simbolov valut namesto kod:
?style=compact&display=symbol&from=USD&to=EUR
Zaklenjene valute z lastnim zneskom:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Možnosti prilagajanja
Možnosti teme
- light - Svetlo ozadje s temnim besedilom
- dark - Temno ozadje s svetlim besedilom
- auto - Samodejno se prilagodi nastavitvam sistema uporabnika
Oblika prikaza valute
- iso - Prikazuje ISO kode kot USD, EUR, GBP
- symbol - Prikazuje simbole valut kot $, €, £
Oblike številk
- auto - Samodejno zazna nastavitve brskalnika obiskovalca
- us - Oblika ZDA: 1,234.56
- eu - Evropska oblika: 1.234,56
- french - Francoska oblika: 1 234,56
- indian - Indijska oblika: 1,23,456.78
Možnosti valut v spustnem meniju
- all - Vseh 170+ podprtih valut
- top10 - Top 10 najbolj priljubljenih valut
- top20 - Top 20 valut po obsegu trgovanja
- USD,EUR,GBP,... - Seznam določenih valut po meri
Nasvet: Uporabite Graditelja pripomočka za vizualno konfiguracijo vseh teh možnosti in samodejno ustvarjanje vgradne kode.
6 Odpravljanje težav
Pripomoček se ne prikazuje
Prepričajte se, da je vgradna koda pravilno nameščena v vašem HTML-ju. Pri vgradnji s skripto preverite, da obstaja vsebniški div s pravilnim ID-jem. Preverite konzolo brskalnika za morebitne napake JavaScript.
Spustni meni ne deluje
Če uporabljate iframe vgradnjo, bodo spustni meniji drseli znotraj območja pripomočka. Za polno funkcionalnost spustnih menijev z prekrivanji uporabite metodo vgradnje s skripto.
Spori slogov
Če CSS vaše strani vpliva na videz pripomočka, poskusite z iframe vgradnjo, ki izolira sloge pripomočka od vaše strani.
Težave s politiko varnosti vsebine
Če imate strogo CSP, boste morda morali dodati currency.wiki med dovoljene v direktivah script-src in frame-src. Primer: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Potrebujete pomoč?
Ne najdete, kar iščete? Naša podpora vam je na voljo.
