Dokumentazzjoni tal-Widget
Gwida sħiħa dwar kif tinkorpora u tippersonalizza l-widget tal-konvertitur tal-munita Currency.Wiki fuq il-websajt tiegħek.
Tabella tal-Kontenut
1 Bidu
Żid widget tal-konvertitur tal-munita mal-websajt tiegħek faċilment. Segwi dawn il-passi sempliċi:
- Mur fil-paġna tal-Widget Builder u ippersonalizza d-dehra tal-widget tiegħek
- Agħżel l-istil, il-muniti, u t-tema preferuti tiegħek
- Ikkopja l-kodiċi tal-inkorporazzjoni ġġenerat (Script jew Iframe)
- Waħħal il-kodiċi fil-HTML tal-websajt tiegħek fejn trid li jidher il-widget
Parir: Uża l-Quick Start Presets fil-Widget Builder biex tibda malajr b'widget prekonfigurat.
2 Metodi ta' Inkorporazzjoni
Inkorporazzjoni Script (Rakkomandat)
Il-metodu ta' inkorporazzjoni script jintegra l-widget direttament fil-paġna tiegħek. Il-dropdowns tal-munita jintwerew quddiem il-kontenut tal-paġna biex jagħmlu l-għażla faċli.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Dropdowns jintwerew barra l-kontenitur tal-widget
- L-aħjar għal għażla interattiva tal-muniti
- Integrazjoni bla xkiel mal-paġna tiegħek
Inkorporazzjoni Iframe
Il-metodu ta' inkorporazzjoni iframe joħloq kontenitur iżolat għall-widget. Dan il-metodu huwa sigur u jaħdem f'ambjenti b'policies ta' kontenut stretti.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Kompletament iżolat mill-istili tal-paġna tiegħek
- Jaħdem ma' Content Security Policies stretti
- Implimentazzjoni sempliċi u sigura
Nota: Uża Script embed għal interattività sħiħa (dropdowns jintwerew fuq il-kontenut). Uża Iframe embed meta għandek bżonn iżolament jew għandek restrizzjonijiet CSP.
3 Stili tal-Widget
Agħżel minn 11-il stil differenti ta' widget biex jaqbel mad-disinn tal-websajt tiegħek. Kull stil huwa ottimizzat għal każijiet u daqsijiet differenti.
mini
250x140px
Konvertitur kompatt f'linja waħda. Perfett għal headers jew spazji żgħar.
square
250x250px
Widget proporzjon 1:1 b'buttuna swap. Kbir għal sidebars.
compact
300x180px
Konvertitur b'footprint żgħir b'karatteristiċi essenzjali kollha.
inline
480x56px
Layout orizzontali. Ideali biex tinkorpora fil-kontenut jew navigazzjoni.
tall
200x280px
Layout vertikali sidebar b'labels klassiċi.
mini-chart
250x260px
Konvertitur kompatt b'chart żgħir li juri storja tar-rata.
multi-expandable
300x320px
Konvertitur multi-munita. L-utenti jistgħu jżidu/jneħħu muniti.
multi-fixed
300x300px
Lista fissa ta' rati tal-kambju. L-aħjar biex turi rati speċifiċi.
rates-compact
250x320px
Lista kondensata ta' rati tal-kambju b'ħin ta' aġġornament.
rates-viewer
300x500px
Vista sħiħa tal-graff b'informazzjoni dettaljata tar-rata.
rates-viewer-compact
300x400px
Verżjoni kompattata ta' rates viewer b'charts.
4 Parametri tal-URL
Ippersonalizza l-widget tiegħek bl-użu ta' parametri tal-URL. Dawn jaħdmu kemm ma' Script kif ukoll ma' Iframe.
| Parametru | Default | Deskrizzjoni |
|---|---|---|
| style | compact | Stil tal-widget (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Tema tal-kulur (light, dark, jew auto) |
| from | USD | Kodiċi tal-munita sors (eż. USD, EUR, GBP) |
| to | EUR | Kodiċi tal-munita mira (eż. EUR, USD, JPY) |
| amount | 1000 | Ammont default għall-konverżjoni |
| accent | #2563eb | Kulur tal-aċċent f'format hex (mingħajr #) |
| lang | en | Kodiċi tal-lingwa tal-widget (eż. en, es, fr, de) |
| flags | 1 | Uri bandieri tal-pajjiżi (1=uri, 0=moħbi) |
| display | iso | Format tal-wiri tal-munita (iso=USD, symbol=$) |
| lock | 0 | Iblokka muniti (1=imblukkat, 0=mhux imblukkat) |
| currencies | EUR,GBP,JPY | Lista separata b'virgola ta' muniti għal widgets multi-munita |
| dropdown | all | Muniti fid-dropdown (all, top10, top20, jew lista separata b'virgola) |
| branding | 1 | Uri branding (1=uri, 0=moħbi) |
| brandinglink | 1 | Agħmel branding clickable (1=link, 0=test biss) |
| format | auto | Format tan-numru (auto, us, eu, french, indian) |
| decimals | 2 | Numru ta' postijiet deċimali (0-6) |
| chart | 0 | Attiva chart (1=attivat, 0=diżattivat) |
| chartperiod | 7d | Perjodu tal-graff (7d, 14d, 30d, 90d) |
Eżempji
Konvertitur kompatt b'tema skura:
?style=compact&theme=dark&from=USD&to=EUR
Rati tal-kambju multi-munita:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Konvertitur żgħir b'grafika ta' 30 jum:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Uri simboli tal-munita minflok kodiċijiet:
?style=compact&display=symbol&from=USD&to=EUR
Muniti imblukkati b'ammont personalizzat:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Għażliet ta' Personalizzazzjoni
Għażliet tat-Tema
- light - Sfondo ħafif b'test skur
- dark - Sfondo skur b'test ħafif
- auto - Jaqbel awtomatikament mal-preferenza tas-sistema tal-utent
Format tal-Wiri tal-Munita
- iso - Juri kodiċijiet ISO bħal USD, EUR, GBP
- symbol - Juri simboli tal-munita bħal $, €, £
Formati tan-Numru
- auto - Jiskopri awtomatikament is-settings tal-browser tal-viżitatur
- us - Format US: 1,234.56
- eu - Format Ewropew: 1.234,56
- french - Format Franċiż: 1 234,56
- indian - Format Indjan: 1,23,456.78
Għażliet tal-Muniti fid-Dropdown
- all - Il-muniti kollha 170+ appoġġjati
- top10 - L-iktar 10 muniti popolari
- top20 - Top 20 muniti skont il-volum tal-kummerċ
- USD,EUR,GBP,... - Lista personalizzata ta' muniti speċifiċi
Parir: Uża l-Widget Builder biex tikkonfigura viżwalment dawn l-għażliet u tiġġenera l-kodiċi tal-inkorporazzjoni awtomatikament.
6 Soluzzjoni tal-Problemi
Il-Widget Mhux Qed Jidher
Kun żgur li l-kodiċi tal-inkorporazzjoni huwa mqiegħed sew fil-HTML tiegħek. Għal script embed, kun żgur li l-container div jeżisti bl-ID korrett. Iċċekkja l-console tal-browser għal żbalji JavaScript.
Dropdown Mhux Qed Jaħdem
Jekk tuża iframe embed, id-dropdowns jiskrolljaw ġewwa l-qasam tal-widget. Għal funzjonalità sħiħa tad-dropdown b'overlays, uża l-metodu script embed.
Kunflitti ta' Stil
Jekk is-CSS tal-websajt tiegħek qed jaffettwa d-dehra tal-widget, ipprova tuża l-metodu iframe embed li jżomm l-istili tal-widget iżolati mill-paġna tiegħek.
Problemi ta' Content Security Policy
Jekk għandek CSP strett, jista' jkollok bżonn iżżid currency.wiki mal-direttivi script-src u frame-src permessi tiegħek. Eżempju: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Għandek bżonn Għajnuna?
Ma tistax issib dak li qed tfittex? It-tim ta' appoġġ tagħna hawn biex jgħinek.
