Dokumentacioni i Widget-it
Udhëzues i plotë për integrimin dhe personalizimin e widget-it të konvertuesit të monedhës Currency.Wiki në faqen tuaj.
Përmbajtja
1 Si të Filloni
Shtimi i një widget-i të konvertuesit të monedhës në faqen tuaj është i lehtë. Ndiqni këto hapa të thjeshtë:
- Shkoni te faqja e Ndërtuesit të Widget-it dhe personalizoni pamjen
- Zgjidhni stilin, monedhat dhe temën e preferuar të widget-it
- Kopjoni kodin e krijuar të integrimit (Script ose Iframe)
- Ngjitni kodin në HTML-në e faqes tuaj ku dëshironi të shfaqet widget-i
Këshillë: Përdorni Paracaktimet e Shpejta në Ndërtuesin e Widget-it për të filluar shpejt me një widget të parakonfiguruar.
2 Metodat e Integrimit
Integrim me Script (Rekomandohet)
Metoda e integrimit me script e fut widget-in drejtpërdrejt në faqen tuaj. Menutë zbritëse të monedhave do të shfaqen mbi përmbajtjen përreth për përzgjedhje të lehtë.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Menutë zbritëse shfaqen jashtë kontejnerit të widget-it
- Më e përshtatshme për përzgjedhje interaktive të monedhave
- Integrim i pandërprerë me faqen tuaj
Integrim me Iframe
Metoda e integrimit me iframe krijon një kontejner të izoluar për widget-in. Kjo metodë është e sigurt dhe funksionon në mjedise me politika të rrepta të përmbajtjes.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Plotësisht i izoluar nga stilet e faqes tuaj
- Punon me politika të rrepta të sigurisë së përmbajtjes
- Zbatim i thjeshtë dhe i sigurt
Shënim: Përdorni integrimin me Script për interaktivitet të plotë (menutë zbritëse shfaqen mbi përmbajtjen). Përdorni integrimin me Iframe kur ju nevojitet izolim ose keni kufizime CSP.
3 Stilet e Widget-it
Zgjidhni nga 11 stile të ndryshme widget-i për t'iu përshtatur dizajnit të faqes tuaj. Çdo stil është optimizuar për raste të ndryshme përdorimi dhe madhësi shfaqjeje.
mini
250x140px
Konvertues kompakt me një rresht. I përsosur për header ose hapësira të ngushta.
square
250x250px
Widget me raport 1:1 dhe buton ndërrimi. I shkëlqyer për anësore.
compact
300x180px
Konvertues me hapësirë të vogël dhe të gjitha funksionet thelbësore.
inline
480x56px
Paraqitje horizontale. Ideal për integrim brenda përmbajtjes ose navigimit.
tall
200x280px
Paraqitje vertikale anësore me etiketa klasike.
mini-chart
250x260px
Konvertues kompakt me grafik të vogël që tregon historikun e kursit.
multi-expandable
300x320px
Konvertues shumë-monedhësh. Përdoruesit mund të shtojnë/heqin monedha.
multi-fixed
300x300px
Listë fikse e kurseve të këmbimit. Më e përshtatshme për shfaqjen e kurseve specifike.
rates-compact
250x320px
Listë e kondensuar e kurseve të këmbimit me kohën e fundit të përditësimit.
rates-viewer
300x500px
Pamje e plotë e grafikut me informacione të detajuara të kursit.
rates-viewer-compact
300x400px
Version kompakt i shikuesit të kurseve me grafikë.
4 Parametrat e URL-së
Personalizoni widget-in tuaj duke përdorur parametra të URL-së. Këta parametra funksionojnë me të dyja metodat e integrimit Script dhe Iframe.
| Parametri | Parazgjedhja | Përshkrimi |
|---|---|---|
| style | compact | Stili i widget-it (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Tema e ngjyrave (light, dark, ose auto) |
| from | USD | Kodi i monedhës burimore (p.sh. USD, EUR, GBP) |
| to | EUR | Kodi i monedhës së synuar (p.sh. EUR, USD, JPY) |
| amount | 1000 | Shuma e parazgjedhur për konvertim |
| accent | #2563eb | Ngjyra aksentuese në formatin hex (pa #) |
| lang | en | Kodi i gjuhës së widget-it (p.sh. en, es, fr, de) |
| flags | 1 | Shfaq flamujt e vendeve (1=shfaq, 0=fshih) |
| display | iso | Formati i shfaqjes së monedhës (iso=USD, symbol=$) |
| lock | 0 | Blloko monedhat (1=bllokuar, 0=zhbllokuar) |
| currencies | EUR,GBP,JPY | Listë e ndarë me presje e monedhave për widget-et shumë-monedhëshe |
| dropdown | all | Monedhat në menunë zbritëse (all, top10, top20, ose listë e ndarë me presje) |
| branding | 1 | Shfaq markën (1=shfaq, 0=fshih) |
| brandinglink | 1 | Bëj markën të klikueshme (1=lidhje, 0=vetëm tekst) |
| format | auto | Formati i numrit (auto, us, eu, french, indian) |
| decimals | 2 | Numri i shifrave dhjetore (0-6) |
| chart | 0 | Aktivizo grafikët (1=aktivizuar, 0=çaktivizuar) |
| chartperiod | 7d | Periudha e grafikut (7d, 14d, 30d, 90d) |
Shembuj
Konvertues kompakt me temë të errët:
?style=compact&theme=dark&from=USD&to=EUR
Kurse këmbimi shumë-monedhëshe:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Konvertues i vogël me grafik 30-ditor:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Shfaq simbolet e monedhave në vend të kodeve:
?style=compact&display=symbol&from=USD&to=EUR
Monedha të bllokuara me shumë të personalizuar:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Opsionet e Personalizimit
Opsionet e Temës
- light - Sfond i ndritshëm me tekst të errët
- dark - Sfond i errët me tekst të ndritshëm
- auto - Përshtatet automatikisht me preferencat e sistemit të përdoruesit
Formati i Shfaqjes së Monedhës
- iso - Shfaq kode ISO si USD, EUR, GBP
- symbol - Shfaq simbolet e monedhave si $, €, £
Formatet e Numrave
- auto - Zbulon automatikisht cilësimet e shfletuesit të vizitorit
- us - Format SHBA: 1,234.56
- eu - Format Europian: 1.234,56
- french - Format Frëngjisht: 1 234,56
- indian - Format Indian: 1,23,456.78
Opsionet e Monedhave në Menu Zbritëse
- all - Të gjitha 170+ monedhat e mbështetura
- top10 - Top 10 monedhat më të njohura
- top20 - Top 20 monedhat sipas volumit të tregtimit
- USD,EUR,GBP,... - Listë e personalizuar e monedhave specifike
Këshillë: Përdorni Ndërtuesin e Widget-it për të konfiguruar vizualisht të gjitha këto opsione dhe për të gjeneruar automatikisht kodin e integrimit.
6 Zgjidhja e Problemeve
Widget-i Nuk Shfaqet
Sigurohuni që kodi i integrimit të jetë vendosur saktë në HTML-në tuaj. Për integrimin me script, sigurohuni që div-i i kontejnerit ekziston me ID-në e duhur. Kontrolloni konsolën e shfletuesit për ndonjë gabim JavaScript.
Menuja Zbritëse Nuk Punon
Nëse përdorni integrimin me iframe, menutë zbritëse do të lëvizin brenda zonës së widget-it. Për funksionalitet të plotë të menuseve me mbivendosje, përdorni metodën e integrimit me script.
Konflikte Stilesh
Nëse CSS-ja e faqes suaj ndikon në pamjen e widget-it, provoni të përdorni integrimin me iframe që izolon stilet e widget-it nga faqja juaj.
Çështje me Politikat e Sigurisë së Përmbajtjes
Nëse keni një CSP të rreptë, mund t'ju duhet të shtoni currency.wiki në direktivat e lejuara script-src dhe frame-src. Shembull: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Keni Nevojë për Ndihmë?
Nuk po gjeni atë që kërkoni? Ekipi ynë i mbështetjes është këtu për t'ju ndihmuar.
