Valdiklio dokumentacija
Išsamus Currency.Wiki valiutų konvertavimo valdiklio įterpimo ir pritaikymo vadovas.
Turinys
1 Darbo pradžia
Valiutų konvertavimo valdiklio pridėjimas į jūsų svetainę yra paprastas. Vykdykite šiuos žingsnius:
- Eikite į Valdiklio kūrėjo puslapį ir pritaikykite valdiklio išvaizdą
- Pasirinkite norimą valdiklio stilių, valiutas ir temą
- Nukopijuokite sugeneruotą įterpimo kodą (skriptą arba iframe)
- Įklijuokite kodą į savo svetainės HTML ten, kur norite, kad būtų rodomas valdiklis
Patarimas: Naudokite greito starto šablonus Valdiklio kūrėjuje, kad greitai pradėtumėte su iš anksto sukonfigūruotu valdikliu.
2 Įterpimo būdai
Skripto įterpimas (rekomenduojama)
Skripto įterpimo būdas įterpia valdiklį tiesiai į jūsų puslapį. Valiutų išskleidžiamieji meniu bus rodomi virš turinio, kad būtų patogu pasirinkti.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Išskleidžiamieji meniu rodomi už valdiklio ribų
- Geriausia interaktyviam valiutų pasirinkimui
- Sklandi integracija su jūsų puslapiu
Iframe įterpimas
Iframe įterpimo būdas sukuria izoliuotą valdiklio konteinerį. Šis būdas yra saugus ir veikia aplinkose su griežta turinio politika.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Visiškai izoliuotas nuo jūsų puslapio stilių
- Veikia su griežtomis turinio saugumo politikomis
- Paprasta ir saugu įdiegti
Pastaba: Naudokite skripto įterpimą pilnai interaktyvumui (išskleidžiamieji meniu rodomi virš turinio). Naudokite iframe, kai reikia izoliacijos arba turite CSP apribojimų.
3 Valdiklio stiliai
Pasirinkite iš 11 skirtingų valdiklio stilių, kad atitiktų jūsų svetainės dizainą. Kiekvienas stilius optimizuotas skirtingiems naudojimo atvejams ir ekranų dydžiams.
mini
250x140px
Kompaktiškas vienos eilutės konverteris. Puikiai tinka antraštėms ar siauroms vietoms.
square
250x250px
1:1 santykio valdiklis su keitimo mygtuku. Puikiai tinka šoninėms juostoms.
compact
300x180px
Mažo ploto konverteris su visomis pagrindinėmis funkcijomis.
inline
480x56px
Horizontalus išdėstymas. Idealiai tinka įterpti į turinį ar navigaciją.
tall
200x280px
Vertikalus šoninės juostos išdėstymas su klasikinėmis etiketėmis.
mini-chart
250x260px
Kompaktiškas konverteris su mini grafiku, rodančiu kursų istoriją.
multi-expandable
300x320px
Daugiavaliutis konverteris. Naudotojai gali pridėti/pašalinti valiutas.
multi-fixed
300x300px
Fiksuotas kursų sąrašas. Geriausia rodyti konkrečius kursus.
rates-compact
250x320px
Sutrumpintas kursų sąrašas su paskutinio atnaujinimo laiku.
rates-viewer
300x500px
Pilnas grafiko vaizdas su detalia kursų informacija.
rates-viewer-compact
300x400px
Kompaktiška kursų peržiūros versija su grafikais.
4 URL parametrai
Pritaikykite savo valdiklį naudodami URL parametrus. Šie parametrai veikia tiek su skripto, tiek su iframe įterpimo būdais.
| Parametras | Numatytasis | Aprašymas |
|---|---|---|
| style | compact | Valdiklio stilius (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Spalvų tema (šviesi, tamsi arba automatinė) |
| from | USD | Pradinės valiutos kodas (pvz., USD, EUR, GBP) |
| to | EUR | Tikslo valiutos kodas (pvz., EUR, USD, JPY) |
| amount | 1000 | Numatytoji konvertavimo suma |
| accent | #2563eb | Akcento spalva šešioliktainiu formatu (be #) |
| lang | en | Valdiklio kalbos kodas (pvz., en, es, fr, de) |
| flags | 1 | Rodyti šalių vėliavas (1=rodyti, 0=nerodyti) |
| display | iso | Valiutos rodymo formatas (iso=USD, symbol=$) |
| lock | 0 | Užrakinti valiutas (1=užrakinta, 0=atrakinta) |
| currencies | EUR,GBP,JPY | Kableliais atskirtas valiutų sąrašas daugiavaliučiams valdikliams |
| dropdown | all | Valiutos išskleidžiamajame meniu (all, top10, top20 arba kableliais atskirtas sąrašas) |
| branding | 1 | Rodyti ženklinimą (1=rodyti, 0=nerodyti) |
| brandinglink | 1 | Padaryti ženklinimą paspaudžiamą (1=nuoroda, 0=tik tekstas) |
| format | auto | Skaičių formatas (auto, us, eu, french, indian) |
| decimals | 2 | Skaitmenų po kablelio skaičius (0-6) |
| chart | 0 | Įjungti grafiką (1=įjungta, 0=išjungta) |
| chartperiod | 7d | Grafiko laikotarpis (7d, 14d, 30d, 90d) |
Pavyzdžiai
Tamsios temos kompaktiškas konverteris:
?style=compact&theme=dark&from=USD&to=EUR
Daugiavaliutės valiutų kursai:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Mini konverteris su 30 dienų grafiku:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Rodyti valiutų simbolius vietoj kodų:
?style=compact&display=symbol&from=USD&to=EUR
Užrakintos valiutos su pasirinkta suma:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Pritaikymo parinktys
Temos parinktys
- light - Šviesus fonas su tamsiu tekstu
- dark - Tamsus fonas su šviesiu tekstu
- auto - Automatiškai prisitaiko prie naudotojo sistemos nustatymų
Valiutos rodymo formatas
- iso - Rodo ISO kodus, pvz., USD, EUR, GBP
- symbol - Rodo valiutų simbolius, pvz., $, €, £
Skaičių formatai
- auto - Automatiškai aptinka lankytojo naršyklės nustatymus
- us - JAV formatas: 1,234.56
- eu - Europos formatas: 1.234,56
- french - Prancūziškas formatas: 1 234,56
- indian - Indiškas formatas: 1,23,456.78
Išskleidžiamojo meniu valiutų parinktys
- all - Visos 170+ palaikomų valiutų
- top10 - Top 10 populiariausių valiutų
- top20 - Top 20 valiutų pagal prekybos apimtį
- USD,EUR,GBP,... - Individualus konkrečių valiutų sąrašas
Patarimas: Naudokite Valdiklio kūrėją, kad vizualiai sukonfigūruotumėte visas šias parinktis ir automatiškai sugeneruotumėte įterpimo kodą.
6 Trikčių šalinimas
Valdiklis nerodomas
Įsitikinkite, kad įterpimo kodas įdėtas teisingai į jūsų HTML. Naudojant skripto įterpimą, įsitikinkite, kad egzistuoja konteinerio div su teisingu ID. Patikrinkite naršyklės konsolę dėl JavaScript klaidų.
Išskleidžiamasis meniu neveikia
Naudojant iframe įterpimą, išskleidžiamieji meniu slinks valdiklio srityje. Norėdami pilno funkcionalumo su perdengimais, naudokite skripto įterpimo būdą.
Stiliaus konfliktai
Jei jūsų svetainės CSS veikia valdiklio išvaizdą, pabandykite naudoti iframe įterpimą, kuris izoliuoja valdiklio stilius nuo jūsų puslapio.
Turinio saugumo politikos problemos
Jei turite griežtą CSP, gali reikėti pridėti currency.wiki prie leidžiamų script-src ir frame-src direktyvų. Pavyzdys: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Reikia pagalbos?
Nerandate, ko ieškote? Mūsų pagalbos komanda pasiruošusi padėti.
