Dokumentacija za vidžet
Kompletan vodič za ugradnju i prilagođavanje Currency.Wiki vidžeta za konverziju valuta na vaš sajt.
Sadržaj
1 Početak
Dodavanje vidžeta za konverziju valuta na vaš sajt je jednostavno. Pratite ove korake:
- Idite na stranicu Kreatora vidžeta i prilagodite izgled svog vidžeta
- Izaberite željeni stil vidžeta, valute i temu
- Kopirajte generisani kod za ugradnju (Skript ili Iframe)
- Nalepite kod u HTML svog sajta gde želite da se vidžet pojavi
Savet: Koristite brze početne predloške u Kreatoru vidžeta za brzi početak sa unapred podešenim vidžetom.
2 Metode ugradnje
Skript ugradnja (preporučeno)
Metoda ugradnje skripta direktno ubacuje vidžet na vašu stranicu. Padajući meniji valuta prikazuju se ispred sadržaja radi lakšeg izbora.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Padajući meniji izvan okvira vidžeta
- Najbolje za interaktivni izbor valuta
- Besprekorno uklapanje sa vašom stranicom
Iframe ugradnja
Metoda ugradnje iframe-a kreira izolovani kontejner za vidžet. Ova metoda je bezbedna i radi u okruženjima sa strogim politikama sadržaja.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Potpuno izolovano od stilova vaše stranice
- Radi sa strogim Content Security Policy pravilima
- Jednostavna i bezbedna implementacija
Napomena: Koristite Skript ugradnju za punu interaktivnost (padajući meniji iznad sadržaja). Koristite Iframe ugradnju kada vam je potrebna izolacija ili imate CSP ograničenja.
3 Stilovi vidžeta
Izaberite jedan od 11 različitih stilova vidžeta da odgovara dizajnu vašeg sajta. Svaki stil je optimizovan za različite potrebe i veličine prikaza.
mini
250x140px
Kompaktan konvertor u jednom redu. Savršen za zaglavlja ili uske prostore.
square
250x250px
Vidžet odnosa 1:1 sa dugmetom za zamenu. Odličan za bočne trake.
compact
300x180px
Mali konvertor sa svim osnovnim funkcijama.
inline
480x56px
Horizontalni raspored. Idealan za ugradnju u sadržaj ili navigaciju.
tall
200x280px
Vertikalni raspored bočne trake sa klasičnim oznakama.
mini-chart
250x260px
Kompaktan konvertor sa mini grafikom istorije kursa.
multi-expandable
300x320px
Konvertor sa više valuta. Korisnici mogu dodavati/uklanjati valute.
multi-fixed
300x300px
Fiksna lista kurseva. Najbolje za prikaz specifičnih kurseva.
rates-compact
250x320px
Sažeta lista kurseva sa vremenom poslednjeg ažuriranja.
rates-viewer
300x500px
Puni prikaz grafikona sa detaljnim informacijama o kursu.
rates-viewer-compact
300x400px
Kompaktna verzija prikaza kurseva sa grafikonima.
4 URL parametri
Prilagodite svoj vidžet pomoću URL parametara. Ovi parametri rade sa oba metoda ugradnje: Skript i Iframe.
| Parametar | Podrazumevano | Opis |
|---|---|---|
| style | compact | Stil vidžeta (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Boja teme (light, dark, ili auto) |
| from | USD | Kod izvorne valute (npr. USD, EUR, GBP) |
| to | EUR | Kod ciljne valute (npr. EUR, USD, JPY) |
| amount | 1000 | Podrazumevani iznos za konverziju |
| accent | #2563eb | Boja akcenta u hex formatu (bez #) |
| lang | en | Kod jezika vidžeta (npr. en, es, fr, de) |
| flags | 1 | Prikaži zastave država (1=prikaži, 0=sakrij) |
| display | iso | Format prikaza valute (iso=USD, symbol=$) |
| lock | 0 | Zaključaj valute (1=zaključano, 0=otključano) |
| currencies | EUR,GBP,JPY | Zarezom odvojena lista valuta za vidžete sa više valuta |
| dropdown | all | Valute u padajućem meniju (all, top10, top20, ili zarezom odvojena lista) |
| branding | 1 | Prikaži brendiranje (1=prikaži, 0=sakrij) |
| brandinglink | 1 | Brendiranje kao link (1=link, 0=samo tekst) |
| format | auto | Format broja (auto, us, eu, french, indian) |
| decimals | 2 | Broj decimalnih mesta (0-6) |
| chart | 0 | Omogući grafikon (1=omogućeno, 0=onemogućeno) |
| chartperiod | 7d | Period grafikona (7d, 14d, 30d, 90d) |
Primeri
Kompaktan konvertor sa tamnom temom:
?style=compact&theme=dark&from=USD&to=EUR
Kursevi za više valuta:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Mini konvertor sa 30-dnevnim grafikonom:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Prikaz simbola valute umesto kodova:
?style=compact&display=symbol&from=USD&to=EUR
Zaključane valute sa prilagođenim iznosom:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Opcije prilagođavanja
Opcije teme
- light - Svetla pozadina sa tamnim tekstom
- dark - Tamna pozadina sa svetlim tekstom
- auto - Automatski prati podešavanja sistema korisnika
Format prikaza valute
- iso - Prikazuje ISO kodove kao USD, EUR, GBP
- symbol - Prikazuje simbole valuta kao $, €, £
Formati brojeva
- auto - Automatski detektuje podešavanja pretraživača posetioca
- us - US format: 1,234.56
- eu - Evropski format: 1.234,56
- french - Francuski format: 1 234,56
- indian - Indijski format: 1,23,456.78
Opcije valuta u padajućem meniju
- all - Sve podržane valute (170+)
- top10 - Top 10 najpopularnijih valuta
- top20 - Top 20 valuta po obimu trgovanja
- USD,EUR,GBP,... - Prilagođena lista specifičnih valuta
Savet: Koristite Kreator vidžeta za vizuelno podešavanje svih ovih opcija i automatsko generisanje koda za ugradnju.
6 Rešavanje problema
Vidžet se ne prikazuje
Uverite se da je kod za ugradnju pravilno postavljen u vaš HTML. Za skript ugradnju, proverite da li kontejner div postoji sa ispravnim ID-jem. Proverite konzolu pretraživača za JavaScript greške.
Padajući meni ne radi
Ako koristite iframe ugradnju, padajući meniji će se skrolovati unutar vidžeta. Za punu funkcionalnost sa preklapanjem, koristite skript ugradnju.
Sukobi stilova
Ako CSS vašeg sajta utiče na izgled vidžeta, probajte iframe ugradnju koja izoluju stilove vidžeta od vaše stranice.
Problemi sa Content Security Policy
Ako imate strogu CSP, možda ćete morati da dodate currency.wiki u dozvoljene direktive script-src i frame-src. Primer: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Treba vam pomoć?
Ne možete da pronađete šta tražite? Naš tim za podršku je tu da pomogne.
