Widget Dokumentazioa
Gida osoa Currency.Wiki-ren moneta bihurgailu widget-a zure webgunean txertatzeko eta pertsonalizatzeko.
Edukien Aurkibidea
1 Hasteko
Moneta bihurgailu widget bat zure webgunean gehitzea erraza da. Jarraitu urrats hauek:
- Joan Widget Sortzaile orrira eta pertsonalizatu widget-aren itxura
- Aukeratu nahi duzun widget estiloa, monetak eta gaia
- Kopiatu sortutako txertatze kodea (Script edo Iframe)
- Itsatsi kodea zure webguneko HTML-an widget-a agertzea nahi duzun tokian
Aholkua: Erabili Hasiera Azkarreko Aurrezarpenak Widget Sortzailean widget aurrekonfiguratua lortzeko.
2 Txertatze Metodoak
Script Txertaketa (Gomendatua)
Script txertatze metodoak widget-a zuzenean zure orrian sartzen du. Moneta jaitsiera menuak edukien gainean bistaratuko dira hautaketa errazteko.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Jaitsiera menuak widget edukionditik kanpo bistaratzen dira
- Egokiena moneta hautaketa interaktiborako
- Integratze erraza zure orrian
Iframe Txertaketa
Iframe txertatze metodoak widget-arentzako edukiontzi isolatua sortzen du. Metodo hau segurua da eta edukien segurtasun politika zorrotzak dituzten inguruneetan funtzionatzen du.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Erabat isolatua zure orriaren estiloetatik
- Edukien Segurtasun Politika zorrotzekin funtzionatzen du
- Inplementazio sinple eta segurua
Oharra: Erabili Script txertaketa interaktibitate osoa nahi baduzu (jaitsiera menuak edukien gainean). Erabili Iframe txertaketa isolamendua edo CSP murrizketak behar badituzu.
3 Widget Estiloak
Aukeratu 11 widget estilo ezberdinen artean zure webgunearen diseinura egokitzeko. Estilo bakoitza erabilera eta pantaila tamaina ezberdinetarako optimizatuta dago.
mini
250x140px
Trinkoa, lerro bakarreko bihurgailua. Egokia goiburu edo leku estuetarako.
square
250x250px
1:1 erlazioa duen widget-a aldaketa botoiarekin. Alboko barrarako bikaina.
compact
300x180px
Azalera txikiko bihurgailua funtzio nagusi guztiekin.
inline
480x56px
Diseinu horizontala. Edukian edo nabigazioan txertatzeko aproposa.
tall
200x280px
Alboko barra bertikala etiketa klasikoekin.
mini-chart
250x260px
Trinkoa bihurgailua sparkline grafikoarekin tasa historiaren erakusgarri.
multi-expandable
300x320px
Moneta anitzeko bihurgailua. Erabiltzaileek monetak gehitu/kendu ditzakete.
multi-fixed
300x300px
Truke-tasa zerrenda finkoa. Egokiena tasa zehatzak erakusteko.
rates-compact
250x320px
Truke-tasa zerrenda trinkoa azken eguneratzearekin.
rates-viewer
300x500px
Grafiko osoa tasa xehetasunekin.
rates-viewer-compact
300x400px
Grafikoarekin ikusle trinkoaren bertsioa.
4 URL Parametroak
Pertsonalizatu zure widget-a URL parametroak erabiliz. Parametro hauek Script eta Iframe txertatze metodoetan funtzionatzen dute.
| Parametroa | Lehenetsia | Deskribapena |
|---|---|---|
| style | compact | Widget estiloa (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Kolore gaia (argi, ilun edo auto) |
| from | USD | Jatorrizko moneta kodea (adib. USD, EUR, GBP) |
| to | EUR | Helburu moneta kodea (adib. EUR, USD, JPY) |
| amount | 1000 | Bihurketarako kopuru lehenetsia |
| accent | #2563eb | Azentu kolorea hex formatuan (# gabe) |
| lang | en | Widget hizkuntza kodea (adib. en, es, fr, de) |
| flags | 1 | Erakutsi herrialde banderak (1=erakutsi, 0=ezkutatu) |
| display | iso | Moneta bistaratze formatua (iso=USD, symbol=$) |
| lock | 0 | Blokeatu monetak (1=blokeatuta, 0=desblokeatuta) |
| currencies | EUR,GBP,JPY | Komaz bereizitako moneta zerrenda moneta anitzeko widget-entzat |
| dropdown | all | Jaitsiera menuan dauden monetak (guztiak, top10, top20 edo komaz bereizitako zerrenda) |
| branding | 1 | Erakutsi marka (1=erakutsi, 0=ezkutatu) |
| brandinglink | 1 | Marka klikagarria izan dadin (1=esteka, 0=testu hutsa) |
| format | auto | Zenbaki formatua (auto, us, eu, french, indian) |
| decimals | 2 | Hamartar kopurua (0-6) |
| chart | 0 | Grafikoa gaitu (1=gaituta, 0=desgaituta) |
| chartperiod | 7d | Grafiko epea (7d, 14d, 30d, 90d) |
Adibideak
Gai iluneko bihurgailu trinkoa:
?style=compact&theme=dark&from=USD&to=EUR
Moneta anitzeko truke-tasak:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Mini bihurgailua 30 eguneko grafikoarekin:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Erakutsi moneta ikurrak kodeen ordez:
?style=compact&display=symbol&from=USD&to=EUR
Blokeatutako monetak eta kopuru pertsonalizatua:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Pertsonalizazio Aukerak
Gai Aukerak
- light - Atzeko plano argia eta testu iluna
- dark - Atzeko plano iluna eta testu argia
- auto - Erabiltzailearen sistemaren hobespenarekin bat egiten du automatikoki
Moneta Bistaratze Formatua
- iso - Erakutsi ISO kodeak, adib. USD, EUR, GBP
- symbol - Erakutsi moneta ikurrak, adib. $, €, £
Zenbaki Formatuak
- auto - Automatikoki detektatzen du bisitariaren nabigatzailearen ezarpenak
- us - AEB formatua: 1,234.56
- eu - Europako formatua: 1.234,56
- french - Frantziako formatua: 1 234,56
- indian - Indiar formatua: 1,23,456.78
Jaitsiera Moneta Aukerak
- all - Onartutako 170+ moneta guztiak
- top10 - 10 moneta ezagunenak
- top20 - Bolumenaren arabera 20 moneta nagusiak
- USD,EUR,GBP,... - Moneta zehatz zerrenda pertsonalizatua
Aholkua: Erabili Widget Sortzailea aukera guztiak bisualki konfiguratzeko eta txertatze kodea automatikoki sortzeko.
6 Arazoak Konpontzea
Widget-a ez da agertzen
Ziurtatu txertatze kodea zure HTML-an behar bezala kokatuta dagoela. Script txertatzean, ziurtatu edukiontziaren div-a ID egokiarekin dagoela. Egiaztatu nabigatzailearen kontsolan JavaScript erroreak.
Jaitsiera ez dabil
Iframe txertaketa erabiltzen baduzu, jaitsiera menuak widget barruan korrituko dira. Funtzionalitate osoa nahi baduzu gainjartzeekin, erabili script txertatze metodoa.
Estilo gatazkak
Zure webguneko CSS-ak widget-aren itxuran eragina badu, saiatu iframe txertaketa erabiltzen, widget-aren estiloak zure orritik isolatzeko.
Edukien Segurtasun Politika Arazoak
CSP zorrotza baduzu, currency.wiki gehitu behar duzu zure script-src eta frame-src zuzentarauetan. Adibidez: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Laguntza behar duzu?
Ez duzu bilatzen ari zarenik aurkitzen? Gure laguntza taldea prest dago laguntzeko.
