Vidina dokumentatsioon
Täielik juhend Currency.Wiki valuutakalkulaatori vidina paigaldamiseks ja kohandamiseks oma veebilehel.
Sisukord
1 Alustamine
Valuutakalkulaatori vidina lisamine oma veebilehele on lihtne. Järgi neid samme:
- Mine vidina koostaja lehele ja kohanda vidina välimust
- Vali soovitud vidina stiil, valuutad ja teema
- Kopeeri loodud paigalduskood (skript või iframe)
- Kleebi kood oma veebilehe HTML-i sinna, kuhu soovid vidina kuvada
Nipp: Kasuta vidina koostajas kiiralustuse eelseadeid, et kiiresti alustada eelhäälestatud vidinaga.
2 Paigaldusmeetodid
Skripti paigaldus (soovitatav)
Skripti paigaldusmeetod lisab vidina otse sinu lehele. Valuutade rippmenüüd kuvatakse sisu ees lihtsaks valimiseks.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Rippmenüüd kuvatakse vidina konteinerist väljaspool
- Parim interaktiivseks valuutavalikuks
- Sujuv integreerimine sinu lehega
Iframe paigaldus
Iframe paigaldusmeetod loob vidinale isoleeritud konteineri. See meetod on turvaline ja töötab ka range sisupoliitikaga keskkondades.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Täielikult isoleeritud sinu lehe stiilidest
- Töötab range sisupoliitikaga (CSP)
- Lihtne ja turvaline lahendus
Märkus: Kasuta skripti paigaldust täielikuks interaktiivsuseks (rippmenüüd kuvatakse sisu ees). Kasuta iframe'i, kui vajad isoleeritust või CSP piiranguid.
3 Vidina stiilid
Vali 11 erineva vidina stiili vahel, et sobitada oma veebilehe disainiga. Iga stiil on optimeeritud erinevateks kasutusjuhtudeks ja ekraanisuurusteks.
mini
250x140px
Kompaktne üherealine kalkulaator. Sobib päisesse või kitsastesse kohtadesse.
square
250x250px
1:1 suhtega vidin vahetusnupuga. Hea külgribale.
compact
300x180px
Väikese jalajäljega kalkulaator kõigi põhifunktsioonidega.
inline
480x56px
Horisontaalne paigutus. Sobib sisu või navigeerimise sisse.
tall
200x280px
Vertikaalne külgriba paigutus klassikaliste siltidega.
mini-chart
250x260px
Kompaktne kalkulaator koos kursi ajaloo minigraafikuga.
multi-expandable
300x320px
Mitme valuutaga kalkulaator. Kasutajad saavad valuutasid lisada/eemaldada.
multi-fixed
300x300px
Fikseeritud vahetuskursside nimekiri. Parim konkreetsete kurside kuvamiseks.
rates-compact
250x320px
Kondenseeritud vahetuskursside nimekiri viimase uuenduse ajaga.
rates-viewer
300x500px
Täisgraafikuga vaade detailse kursiteabega.
rates-viewer-compact
300x400px
Kompaktne kursivaate versioon graafikutega.
4 URL parameetrid
Kohanda oma vidinat URL parameetritega. Need töötavad nii skripti kui iframe paigaldusmeetodiga.
| Parameeter | Vaikimisi | Kirjeldus |
|---|---|---|
| style | compact | Vidina stiil (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Värviteema (light, dark või auto) |
| from | USD | Lähtevaluuta kood (nt USD, EUR, GBP) |
| to | EUR | Sihtvaluuta kood (nt EUR, USD, JPY) |
| amount | 1000 | Vaikimisi teisendatav summa |
| accent | #2563eb | Aktsentvärv heksavormingus (ilma # märgita) |
| lang | en | Vidina keelekood (nt en, es, fr, de) |
| flags | 1 | Näita riigilippe (1=kuva, 0=peida) |
| display | iso | Valuuta kuvamisvorming (iso=USD, symbol=$) |
| lock | 0 | Lukusta valuutad (1=lukus, 0=avatud) |
| currencies | EUR,GBP,JPY | Komaga eraldatud valuutade nimekiri mitme valuutaga vidinate jaoks |
| dropdown | all | Rippmenüü valuutad (all, top10, top20 või komaga eraldatud nimekiri) |
| branding | 1 | Näita brändingut (1=kuva, 0=peida) |
| brandinglink | 1 | Muuda bränding klikitavaks (1=link, 0=ainult tekst) |
| format | auto | Numbrivorming (auto, us, eu, french, indian) |
| decimals | 2 | Kümnendkohtade arv (0-6) |
| chart | 0 | Luba graafik (1=lubatud, 0=keelatud) |
| chartperiod | 7d | Graafiku periood (7d, 14d, 30d, 90d) |
Näited
Tume teema kompaktne kalkulaator:
?style=compact&theme=dark&from=USD&to=EUR
Mitme valuutaga vahetuskursid:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Mini kalkulaator 30-päevase graafikuga:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Kuva valuutasümbolid koodide asemel:
?style=compact&display=symbol&from=USD&to=EUR
Lukustatud valuutad ja kohandatud summa:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Kohandamisvõimalused
Teemavalikud
- light - Hele taust tumeda tekstiga
- dark - Tume taust heleda tekstiga
- auto - Sobitub automaatselt kasutaja süsteemiseadetega
Valuuta kuvamisvorming
- iso - Kuvab ISO koodid nagu USD, EUR, GBP
- symbol - Kuvab valuutasümbolid nagu $, €, £
Numbrivormingud
- auto - Tuvastab automaatselt külastaja brauseri seaded
- us - USA vorming: 1,234.56
- eu - Euroopa vorming: 1.234,56
- french - Prantsuse vorming: 1 234,56
- indian - India vorming: 1,23,456.78
Rippmenüü valuutavalikud
- all - Kõik 170+ toetatud valuutat
- top10 - 10 kõige populaarsemat valuutat
- top20 - 20 enim kaubeldud valuutat
- USD,EUR,GBP,... - Kohandatud nimekiri konkreetsetest valuutadest
Nipp: Kasuta vidina koostajat, et visuaalselt seadistada kõik need valikud ja saada paigalduskood automaatselt.
6 Veaotsing
Vidin ei kuvata
Veendu, et paigalduskood on õigesse kohta HTML-is lisatud. Skripti paigalduse puhul kontrolli, et konteineri div on olemas ja õige ID-ga. Kontrolli brauseri konsoolis JavaScripti vigu.
Rippmenüü ei tööta
Iframe paigalduse puhul kerivad rippmenüüd vidina sees. Täieliku rippmenüü funktsionaalsuse jaoks kasuta skripti paigaldust.
Stiilide konfliktid
Kui sinu veebilehe CSS mõjutab vidina välimust, proovi iframe paigaldust, mis isoleerib vidina stiilid sinu lehe omadest.
Sisu turvapoliitika probleemid
Kui sul on range CSP, lisa currency.wiki lubatud script-src ja frame-src direktiividesse. Näide: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
