Viðmótsleiðbeiningar
Heildarhandbók um innsetningu og sérsnið Currency.Wiki gjaldmiðlaskiptareiknivél á vefsíðuna þína.
Efnisyfirlit
1 Byrjaðu hér
Að bæta gjaldmiðlaskiptareiknivél við vefsíðuna þína er einfalt. Fylgdu þessum skrefum:
- Farðu á viðmótssmiðjusíðuna og sérsníddu útlit viðmótsins
- Veldu viðmótsstíl, gjaldmiðla og þema
- Afritaðu útbúinn innsetningarkóða (skrifta eða iframe)
- Límdu kóðann í HTML vefsíðunnar þar sem þú vilt að viðmótið birtist
Ábending: Notaðu flýtistillingar í viðmótssmiðjunni til að byrja hratt með fyrirfram stilltu viðmóti.
2 Innsetningaraðferðir
Skrifta innsetning (mælt með)
Skrifta innsetning setur viðmótið beint inn á síðuna þína. Gjaldmiðlafellivalmyndir birtast fyrir framan efni síðunnar til auðveldrar vals.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Fellivalmyndir birtast utan viðmótsins
- Best fyrir gagnvirkt gjaldmiðlaval
- Samfelld samþætting við síðuna þína
Iframe innsetning
Iframe innsetning býr til einangraðan kassa fyrir viðmótið. Þessi aðferð er örugg og virkar þar sem strangar efnisreglur gilda.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Algjörlega einangrað frá stílum síðunnar þinnar
- Virkar með ströngum efnisöryggisstefnum
- Einföld og örugg innsetning
Athugið: Notaðu skrifta innsetningu fyrir fulla gagnvirkni (fellivalmyndir birtast yfir efni). Notaðu iframe ef þú þarft einangrun eða hefur CSP takmarkanir.
3 Viðmótsstílar
Veldu úr 11 mismunandi viðmótsstílum sem passa við hönnun vefsíðunnar þinnar. Hver stíll er hannaður fyrir mismunandi notkun og skjástærðir.
mini
250x140px
Þjappaður einlínureiknir. Fullkomið fyrir haus eða þröng svæði.
square
250x250px
1:1 hlutfall með skipta-hnappi. Gott fyrir hliðarstikur.
compact
300x180px
Lítill reiknir með öllum helstu eiginleikum.
inline
480x56px
Lárétt uppsetning. Tilvalið til að setja inn í efni eða leiðarkerfi.
tall
200x280px
Lóðrétt hliðarstikuuppsetning með klassískum merkingum.
mini-chart
250x260px
Þjappaður reiknir með smálínuriti sem sýnir gengissögu.
multi-expandable
300x320px
Margra gjaldmiðla reiknir. Notendur geta bætt við/fjarlægt gjaldmiðla.
multi-fixed
300x300px
Föst listi yfir gengi. Best til að sýna ákveðin gengi.
rates-compact
250x320px
Þéttur gengislisti með síðustu uppfærslu.
rates-viewer
300x500px
Fullt línurit með ítarlegum gengisupplýsingum.
rates-viewer-compact
300x400px
Þjappað útgáfa af gengisskoðara með línuritum.
4 URL breytur
Sérsníddu viðmótið þitt með URL breytum. Þessar breytur virka bæði með skrifta og iframe innsetningu.
| Breyta | Sjálfgefið | Lýsing |
|---|---|---|
| style | compact | Viðmótsstíll (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Litaþema (ljóst, dökkt eða sjálfvirkt) |
| from | USD | Upprunagjaldmiðill (t.d. USD, EUR, GBP) |
| to | EUR | Markgjaldmiðill (t.d. EUR, USD, JPY) |
| amount | 1000 | Sjálfgefin upphæð til umreiknings |
| accent | #2563eb | Aðallitir í hex (án #) |
| lang | en | Tungumálakóði viðmóts (t.d. en, es, fr, de) |
| flags | 1 | Sýna þjóðfána (1=sýna, 0=fela) |
| display | iso | Birtingarform gjaldmiðils (iso=USD, symbol=$) |
| lock | 0 | Læsa gjaldmiðlum (1=læst, 0=opið) |
| currencies | EUR,GBP,JPY | Kommu-aðskilinn listi yfir gjaldmiðla fyrir margra gjaldmiðla viðmót |
| dropdown | all | Gjaldmiðlar í fellivalmynd (all, top10, top20 eða kommu-aðskilinn listi) |
| branding | 1 | Sýna vörumerki (1=sýna, 0=fela) |
| brandinglink | 1 | Gera vörumerki smellt (1=tengill, 0=bara texti) |
| format | auto | Talnaform (auto, us, eu, french, indian) |
| decimals | 2 | Fjöldi aukastafa (0-6) |
| chart | 0 | Virkja línurit (1=virkt, 0=óvirkt) |
| chartperiod | 7d | Línuritstímabil (7d, 14d, 30d, 90d) |
Dæmi
Dökkt þema þjappaður reiknir:
?style=compact&theme=dark&from=USD&to=EUR
Margra gjaldmiðla gengi:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Lítill reiknir með 30 daga línuriti:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Birta gjaldmiðlatákn í stað kóða:
?style=compact&display=symbol&from=USD&to=EUR
Læstir gjaldmiðlar með sérsniðinni upphæð:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Sérsnið
Þemavalkostir
- light - Ljóst bakgrunnur með dökkum texta
- dark - Dökkt bakgrunnur með ljósum texta
- auto - Passar sjálfkrafa við kerfisstillingar notanda
Birtingarform gjaldmiðils
- iso - Sýnir ISO kóða eins og USD, EUR, GBP
- symbol - Sýnir gjaldmiðlatákn eins og $, €, £
Talnaform
- auto - Greinir sjálfkrafa stillingar vafra gests
- us - Bandarískt form: 1,234.56
- eu - Evrópskt form: 1.234,56
- french - Franskt form: 1 234,56
- indian - Indverskt form: 1,23,456.78
Gjaldmiðlavalkostir í fellivalmynd
- all - Allir 170+ studdir gjaldmiðlar
- top10 - Topp 10 vinsælustu gjaldmiðlarnir
- top20 - Topp 20 gjaldmiðlar eftir veltu
- USD,EUR,GBP,... - Sérsniðinn listi yfir ákveðna gjaldmiðla
Ábending: Notaðu viðmótssmiðjuna til að stilla alla þessa valkosti sjónrænt og búa til innsetningarkóða sjálfkrafa.
6 Vandamál og lausnir
Viðmót birtist ekki
Gakktu úr skugga um að innsetningarkóðinn sé rétt staðsettur í HTML. Fyrir skrifta innsetningu, athugaðu að container div sé til með réttu auðkenni. Athugaðu vafraforritunargluggann fyrir JavaScript villur.
Fellivalmynd virkar ekki
Ef þú notar iframe innsetningu, rúlla fellivalmyndir innan viðmótsins. Fyrir fulla virkni með yfirlagi, notaðu skrifta innsetningu.
Stílavandamál
Ef CSS vefsíðunnar þinnar hefur áhrif á útlit viðmótsins, prófaðu að nota iframe innsetningu sem einangrar stílana frá síðunni þinni.
Efnisöryggisstefnu vandamál
Ef þú ert með stranga CSP þarftu hugsanlega að bæta currency.wiki við leyfðar script-src og frame-src reglur. Dæmi: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Þarftu aðstoð?
Finnurðu ekki það sem þú leitar að? Þjónustuteymið okkar er tilbúið að hjálpa.
