Imibhalo Ye-Widget
Umhlahlandlela ophelele wokufaka nokwenza kube ngokwakho i-widget ye-Currency.Wiki currency converter kuwebhusayithi yakho.
Okuqukethwe
1 Ukuqala
Ukufaka i-widget ye-currency converter kuwebhusayithi yakho kulula. Landela lezi zinyathelo ezilula:
- Hamba ekhasini le-Widget Builder bese ulungisa ukubukeka kwe-widget yakho
- Khetha isitayela se-widget, izimali, nendikimba oyithandayo
- Kopisha ikhodi yokufaka ekhiqiziwe (Script noma Iframe)
- Namathisela ikhodi ku-HTML yewebhusayithi yakho lapho ufuna ukuba khona kwe-widget
Ithiphu: Sebenzisa Izilungiselelo Zokuqala Ngokushesha ku-Widget Builder ukuze uqale ngokushesha nge-widget esilungisiwe.
2 Izindlela Zokufaka
Script Embed (Kunconyiwe)
Indlela ye-script embed ifaka i-widget ngqo ekhasini lakho. Ama-dropdown wemali azoboniswa phambi kokuqukethwe okuzungezile ukuze kube lula ukukhetha.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Ama-dropdown aboniswa ngaphandle kwe-container ye-widget
- Kuhle ukukhetha izimali ngokusebenzisana
- Ukuhlanganiswa okungenazihibe nekhasi lakho
Iframe Embed
Indlela ye-iframe embed idala i-container ehlukanisiwe ye-widget. Le ndlela iphephile futhi isebenza ezindaweni ezinemiqondo eqinile ye-content policy.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Ihlukaniswe ngokuphelele kusuka kuzitayela zekhasini lakho
- Isebenza ne-Content Security Policies eqinile
- Ukufakwa okulula nokuphephile
Qaphela: Sebenzisa i-Script embed ukuthola ukusebenzisana okuphelele (ama-dropdown aboniswa phezu kokuqukethwe). Sebenzisa i-Iframe embed uma udinga ukuhlukanisa noma unezinqinamba ze-CSP.
3 Izitayela Ze-Widget
Khetha phakathi kwezitayela ezingu-11 ze-widget ukuze zivumelane nomklamo wewebhusayithi yakho. Isitayela ngasinye silungiselelwe izimo ezahlukene zokusetshenziswa nosayizi bokubonisa.
mini
250x140px
I-converter encane yomugqa oyedwa. Ilungele ama-header noma izikhala ezincane.
square
250x250px
I-widget yesilinganiso esingu-1:1 enenkinobho yokushintsha. Ilungele ama-sidebar.
compact
300x180px
I-converter encane enazo zonke izici ezibalulekile.
inline
480x56px
Uhlaka oluvundlile. Ilungele ukufakwa phakathi kokuqukethwe noma ukuzulazula.
tall
200x280px
Uhlaka olude lwe-sidebar olunamalebula endabuko.
mini-chart
250x260px
I-converter encane eneshadi elincane elibonisa umlando wamanani.
multi-expandable
300x320px
I-converter yezimali eziningi. Abasebenzisi bangangeza/susa izimali.
multi-fixed
300x300px
Uhlu olungashintshi lwamanani okushintshanisa. Kuhle ukubonisa amanani athile.
rates-compact
250x320px
Uhlu oluncane lwamanani okushintshanisa olunokubuyekezwa kokugcina.
rates-viewer
300x500px
Ukubuka okugcwele kweshadi olunolwazi olunzulu lwamanani.
rates-viewer-compact
300x400px
Inguqulo encane ye-rates viewer enamashadi.
4 Amapharamitha e-URL
Lungisa i-widget yakho usebenzisa amapharamitha e-URL. Lawa maparamitha asebenza kuzo zombili izindlela ze-Script ne-Iframe embed.
| Ipharamitha | Okuzenzakalelayo | Incazelo |
|---|---|---|
| style | compact | Isitayela se-widget (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Indikimba yombala (light, dark, noma auto) |
| from | USD | Ikhodi yemali yomthombo (isb. USD, EUR, GBP) |
| to | EUR | Ikhodi yemali eqondiwe (isb. EUR, USD, JPY) |
| amount | 1000 | Inani elizenzakalelayo lokuguqulwa |
| accent | #2563eb | Umbala wokugqamisa nge-hex (ngaphandle kwe-#) |
| lang | en | Ikhodi yolimi lwe-widget (isb. en, es, fr, de) |
| flags | 1 | Bonisa amafulegi amazwe (1=bonisa, 0=fihla) |
| display | iso | Ifomethi yokubonisa imali (iso=USD, symbol=$) |
| lock | 0 | Vala izimali (1=kuvaliwe, 0=kuvuliwe) |
| currencies | EUR,GBP,JPY | Uhlu lwezimali oluhlukaniswe ngamakhoma lwe-widget yezimali eziningi |
| dropdown | all | Izimali ku-dropdown (all, top10, top20, noma uhlu oluhlukaniswe ngamakhoma) |
| branding | 1 | Bonisa uphawu (1=bonisa, 0=fihla) |
| brandinglink | 1 | Yenza uphawu lube isixhumanisi (1=link, 0=text kuphela) |
| format | auto | Ifomethi yenombolo (auto, us, eu, french, indian) |
| decimals | 2 | Inani lezindawo zedesimali (0-6) |
| chart | 0 | Vumela ishadi (1=kuvuliwe, 0=kuvaliwe) |
| chartperiod | 7d | Isikhathi seshadi (7d, 14d, 30d, 90d) |
Izibonelo
I-converter encane enendikimba emnyama:
?style=compact&theme=dark&from=USD&to=EUR
Amanani okushintshanisa ezimali eziningi:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
I-converter encane eneshadi lezinsuku ezingama-30:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Bonisa izimpawu zemali esikhundleni samakhodi:
?style=compact&display=symbol&from=USD&to=EUR
Izimali ezivaliwe nenani elenziwe ngokwezifiso:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Izinketho Zokwenza Ngokwakho
Izinketho Zendikimba
- light - Isizinda esikhanyayo nombhalo omnyama
- dark - Isizinda esimnyama nombhalo okhanyayo
- auto - Ivumelanisa ngokuzenzakalelayo nezilungiselelo zesistimu yomsebenzisi
Ifomethi Yokubonisa Imali
- iso - Ibonisa amakhodi e-ISO afana ne-USD, EUR, GBP
- symbol - Ibonisa izimpawu zemali ezifana no $, €, £
Amafomethi Enombolo
- auto - Ithola ngokuzenzakalelayo izilungiselelo zesiphequluli somvakashi
- us - Ifomethi yase-US: 1,234.56
- eu - Ifomethi yase-Europe: 1.234,56
- french - Ifomethi yase-France: 1 234,56
- indian - Ifomethi yase-India: 1,23,456.78
Izinketho Zemali Ku-Dropdown
- all - Zonke izimali ezisekelwayo ezingu-170+
- top10 - Izimali ezingu-10 ezidume kakhulu
- top20 - Izimali ezingu-20 ezihamba phambili ngokuhweba
- USD,EUR,GBP,... - Uhlu olwenziwe ngezifiso lwezimali ezithile
Ithiphu: Sebenzisa i-Widget Builder ukuze ulungise ngokubonakalayo zonke lezi zinketho bese ukhiqiza ikhodi yokufaka ngokuzenzakalelayo.
6 Ukuxazulula Izinselele
I-Widget Ayibonakali
Qinisekisa ukuthi ikhodi yokufaka ibekwe kahle ku-HTML yakho. Ku-script embed, qinisekisa ukuthi i-div ye-container ikhona ne-ID efanele. Hlola i-console yesiphequluli sakho noma kukhona amaphutha e-JavaScript.
I-Dropdown Ayisebenzi
Uma usebenzisa i-iframe embed, ama-dropdown azoskrola ngaphakathi kwendawo ye-widget. Ukuze uthole ukusebenza okuphelele kwe-dropdown, sebenzisa indlela ye-script embed esikhundleni salokho.
Ukungqubuzana Kwezitayela
Uma i-CSS yewebhusayithi yakho ithinta ukubukeka kwe-widget, zama ukusebenzisa indlela ye-iframe embed ehlukanisa izitayela ze-widget nekhasini lakho.
Izinkinga ze-Content Security Policy
Uma une-CSP eqinile, ungadinga ukwengeza i-currency.wiki kuzilungiselelo zakho ze-script-src ne-frame-src. Isibonelo: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Udinga Usizo?
Awukatholi okudingayo? Ithimba lethu losizo likulungele ukukusiza.