Nyaraka za Wijeti
Mwongozo kamili wa kuweka na kubadilisha wijeti ya kigeuzi cha sarafu ya Currency.Wiki kwenye tovuti yako.
Orodha ya Yaliyomo
1 Kuanza
Kuongeza wijeti ya kigeuzi cha sarafu kwenye tovuti yako ni rahisi. Fuata hatua hizi:
- Nenda kwenye ukurasa wa Mjengaji wa Wijeti na ubadilishe muonekano wa wijeti yako
- Chagua mtindo wa wijeti, sarafu, na mandhari unayopendelea
- Nakili msimbo wa kuweka uliotengenezwa (Script au Iframe)
- Bandika msimbo kwenye HTML ya tovuti yako mahali unapotaka wijeti ionekane
Kidokezo: Tumia Mipangilio ya Haraka kwenye Mjengaji wa Wijeti kuanza haraka na wijeti iliyosanidiwa tayari.
2 Mbinu za Kuweka
Kuweka kwa Script (Inapendekezwa)
Mbinu ya kuweka script inaweka wijeti moja kwa moja kwenye ukurasa wako. Menyu za kushuka za sarafu zitaonekana mbele ya maudhui mengine kwa urahisi wa kuchagua.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Menyu za kushuka zinaonekana nje ya kontena la wijeti
- Inafaa kwa uteuzi wa sarafu wa mwingiliano
- Inaunganika vizuri na ukurasa wako
Kuweka kwa Iframe
Mbinu ya kuweka iframe huunda kontena lililotengwa kwa ajili ya wijeti. Mbinu hii ni salama na inafanya kazi kwenye mazingira yenye sera kali za maudhui.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Imetengwa kabisa na mitindo ya ukurasa wako
- Inafanya kazi na Sera Kali za Usalama wa Maudhui
- Utekelezaji rahisi na salama
Kumbuka: Tumia kuweka Script kwa mwingiliano kamili (menyu za kushuka zinaonekana juu ya maudhui). Tumia kuweka Iframe unapohitaji utengano au una vikwazo vya CSP.
3 Mitindo ya Wijeti
Chagua kutoka mitindo 11 tofauti ya wijeti ili kulinganisha na muundo wa tovuti yako. Kila mtindo umeboreshwa kwa matumizi na ukubwa tofauti wa maonyesho.
mini
250x140px
Kigeuzi kifupi cha mstari mmoja. Inafaa kwa vichwa au maeneo yenye nafasi ndogo.
square
250x250px
Wijeti ya uwiano wa 1:1 na kitufe cha kubadilisha. Inafaa kwa upau wa pembeni.
compact
300x180px
Kigeuzi kidogo chenye vipengele vyote muhimu.
inline
480x56px
Mpangilio wa mlalo. Inafaa kuweka ndani ya maudhui au urambazaji.
tall
200x280px
Mpangilio wa upau wa pembeni wima na lebo za kawaida.
mini-chart
250x260px
Kigeuzi kifupi chenye chati ya mstari inayoonyesha historia ya viwango.
multi-expandable
300x320px
Kigeuzi cha sarafu nyingi. Watumiaji wanaweza kuongeza/kutoa sarafu.
multi-fixed
300x300px
Orodha isiyobadilika ya viwango vya kubadilisha. Inafaa kuonyesha viwango maalum.
rates-compact
250x320px
Orodha iliyoshikana ya viwango vya kubadilisha na muda wa mwisho wa kusasishwa.
rates-viewer
300x500px
Muonekano kamili wa chati na taarifa za kina za viwango.
rates-viewer-compact
300x400px
Toleo fupi la muonekano wa viwango na chati.
4 Vigezo vya URL
Badilisha wijeti yako kwa kutumia vigezo vya URL. Vigezo hivi vinafanya kazi na mbinu zote za kuweka Script na Iframe.
| Kigezo | Chaguo-msingi | Maelezo |
|---|---|---|
| style | compact | Mtindo wa wijeti (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Mandhari ya rangi (nyeupe, giza, au otomatiki) |
| from | USD | Msimbo wa sarafu chanzo (mf. USD, EUR, GBP) |
| to | EUR | Msimbo wa sarafu lengwa (mf. EUR, USD, JPY) |
| amount | 1000 | Kiasi chaguo-msingi cha kubadilisha |
| accent | #2563eb | Rangi ya msisitizo kwa hex (bila #) |
| lang | en | Msimbo wa lugha ya wijeti (mf. en, es, fr, de) |
| flags | 1 | Onyesha bendera za nchi (1=onyesha, 0=ficha) |
| display | iso | Muundo wa kuonyesha sarafu (iso=USD, symbol=$) |
| lock | 0 | Funga sarafu (1=imefungwa, 0=imefunguliwa) |
| currencies | EUR,GBP,JPY | Orodha ya sarafu zilizotenganishwa kwa koma kwa wijeti za sarafu nyingi |
| dropdown | all | Sarafu kwenye menyu ya kushuka (zote, top10, top20, au orodha maalum) |
| branding | 1 | Onyesha chapa (1=onyesha, 0=ficha) |
| brandinglink | 1 | Fanya chapa iweze kubonyezwa (1=kiungo, 0=maandishi pekee) |
| format | auto | Muundo wa nambari (auto, us, eu, french, indian) |
| decimals | 2 | Idadi ya nafasi za decimal (0-6) |
| chart | 0 | Washa chati (1=imewashwa, 0=imezimwa) |
| chartperiod | 7d | Kipindi cha chati (7d, 14d, 30d, 90d) |
Mifano
Kigeuzi kifupi cha mandhari ya giza:
?style=compact&theme=dark&from=USD&to=EUR
Viwango vya kubadilisha sarafu nyingi:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Kigeuzi kifupi na chati ya siku 30:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Onyesha alama za sarafu badala ya misimbo:
?style=compact&display=symbol&from=USD&to=EUR
Sarafu zilizofungwa na kiasi maalum:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Chaguzi za Kubadilisha
Chaguzi za Mandhari
- light - Mandhari nyeupe na maandishi meusi
- dark - Mandhari ya giza na maandishi meupe
- auto - Inalingana kiotomatiki na mapendeleo ya mfumo wa mtumiaji
Muundo wa Kuonyesha Sarafu
- iso - Inaonyesha misimbo ya ISO kama USD, EUR, GBP
- symbol - Inaonyesha alama za sarafu kama $, €, £
Miundo ya Nambari
- auto - Hutambua kiotomatiki mipangilio ya kivinjari cha mgeni
- us - Muundo wa Marekani: 1,234.56
- eu - Muundo wa Ulaya: 1.234,56
- french - Muundo wa Kifaransa: 1 234,56
- indian - Muundo wa Kihindi: 1,23,456.78
Chaguzi za Sarafu kwenye Menyu ya Kushuka
- all - Sarafu zote 170+ zinazoungwa mkono
- top10 - Sarafu 10 maarufu zaidi
- top20 - Sarafu 20 bora kwa kiasi cha biashara
- USD,EUR,GBP,... - Orodha maalum ya sarafu
Kidokezo: Tumia Mjengaji wa Wijeti kusanidi chaguzi hizi zote na kupata msimbo wa kuweka kiotomatiki.
6 Utatuzi wa Matatizo
Wijeti Haionekani
Hakikisha msimbo wa kuweka umewekwa vizuri kwenye HTML yako. Kwa kuweka script, hakikisha kontena la div lipo na ID sahihi. Angalia console ya kivinjari kwa makosa ya JavaScript.
Menyu ya Kushuka Haifanyi Kazi
Ukitumia kuweka iframe, menyu za kushuka zitajizungusha ndani ya eneo la wijeti. Kwa utendakazi kamili wa menyu za kushuka, tumia mbinu ya kuweka script.
Migongano ya Mtindo
Ikiwa CSS ya tovuti yako inaathiri muonekano wa wijeti, jaribu kutumia kuweka kwa iframe ambayo hutenga mitindo ya wijeti na ukurasa wako.
Masuala ya Sera ya Usalama wa Maudhui
Ikiwa una CSP kali, unaweza kuhitaji kuongeza currency.wiki kwenye ruhusa zako za script-src na frame-src. Mfano: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Unahitaji Msaada?
Huwezi kupata unachotafuta? Timu yetu ya msaada ipo tayari kusaidia.
