Dokumentasyon ng Widget
Kumpletong gabay sa pag-embed at pag-customize ng Currency.Wiki currency converter widget sa iyong website.
Talaan ng Nilalaman
1 Pagsisimula
Madaling magdagdag ng currency converter widget sa iyong website. Sundin lang ang mga simpleng hakbang na ito:
- Pumunta sa Widget Builder page at i-customize ang itsura ng iyong widget
- Piliin ang gusto mong estilo, currency, at tema ng widget
- Kopyahin ang generated na embed code (Script o Iframe)
- I-paste ang code sa HTML ng iyong website kung saan mo gustong lumabas ang widget
Tip: Gamitin ang Quick Start Presets sa Widget Builder para mabilis makapagsimula gamit ang pre-configured na widget.
2 Mga Paraan ng Pag-embed
Script Embed (Inirerekomenda)
Ang script embed method ay direktang naglalagay ng widget sa iyong page. Ang currency dropdown menus ay lalabas sa ibabaw ng content para madaling mapili.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Ang dropdowns ay lalabas sa labas ng widget container
- Pinakamainam para sa interactive na pagpili ng currency
- Seamless na integration sa iyong page
Iframe Embed
Ang iframe embed method ay gumagawa ng hiwalay na container para sa widget. Secure ito at gumagana kahit may mahigpit na content policies.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Ganap na hiwalay sa page styles mo
- Gumagana kahit may mahigpit na Content Security Policies
- Simple at secure na implementasyon
Tandaan: Gamitin ang Script embed para sa buong interactivity (dropdowns lalabas sa ibabaw ng content). Gamitin ang Iframe embed kung kailangan ng isolation o may CSP restrictions.
3 Mga Estilo ng Widget
Pumili mula sa 11 iba't ibang estilo ng widget para bumagay sa disenyo ng iyong website. Ang bawat estilo ay optimized para sa iba't ibang gamit at sukat.
mini
250x140px
Compact na single-line converter. Perpekto para sa headers o masisikip na espasyo.
square
250x250px
1:1 ratio na widget na may swap button. Maganda para sa sidebars.
compact
300x180px
Maliit na converter na may lahat ng essential features.
inline
480x56px
Horizontal na layout. Mainam i-embed sa content o navigation.
tall
200x280px
Vertical sidebar layout na may classic labels.
mini-chart
250x260px
Compact na converter na may sparkline chart ng rate history.
multi-expandable
300x320px
Multi-currency converter. Maaaring magdagdag/magtanggal ng currency ang users.
multi-fixed
300x300px
Fixed na listahan ng exchange rates. Pinakamainam para sa partikular na rates.
rates-compact
250x320px
Masiksik na listahan ng exchange rates na may huling update na oras.
rates-viewer
300x500px
Buong chart view na may detalyadong impormasyon ng rate.
rates-viewer-compact
300x400px
Compact na bersyon ng rates viewer na may charts.
4 Mga Parameter ng URL
I-customize ang iyong widget gamit ang URL parameters. Gumagana ang mga ito sa parehong Script at Iframe embed methods.
| Parameter | Default | Paglalarawan |
|---|---|---|
| style | compact | Estilo ng widget (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Color theme (light, dark, o auto) |
| from | USD | Source currency code (hal. USD, EUR, GBP) |
| to | EUR | Target currency code (hal. EUR, USD, JPY) |
| amount | 1000 | Default na halaga para sa conversion |
| accent | #2563eb | Accent color sa hex format (walang #) |
| lang | en | Widget language code (hal. en, es, fr, de) |
| flags | 1 | Ipakita ang mga bandila ng bansa (1=ipakita, 0=itago) |
| display | iso | Format ng pagpapakita ng currency (iso=USD, symbol=$) |
| lock | 0 | I-lock ang currency (1=locked, 0=unlocked) |
| currencies | EUR,GBP,JPY | Comma-separated na listahan ng currency para sa multi-currency widgets |
| dropdown | all | Currency sa dropdown (all, top10, top20, o comma-separated na listahan) |
| branding | 1 | Ipakita ang branding (1=ipakita, 0=itago) |
| brandinglink | 1 | Gawing clickable ang branding (1=link, 0=text lang) |
| format | auto | Format ng numero (auto, us, eu, french, indian) |
| decimals | 2 | Bilang ng decimal places (0-6) |
| chart | 0 | I-enable ang chart (1=enabled, 0=disabled) |
| chartperiod | 7d | Panahon ng tsart (7d, 14d, 30d, 90d) |
Mga Halimbawa
Madilim na temang siksik na tagapagpalit:
?style=compact&theme=dark&from=USD&to=EUR
Maraming pera na palitan ng halaga:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Mini converter na may 30-araw na chart:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Ipakita ang currency symbols imbes na codes:
?style=compact&display=symbol&from=USD&to=EUR
Locked na currency na may custom na halaga:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Mga Opsyon sa Pag-customize
Mga Opsyon sa Tema
- light - Light na background na may dark na text
- dark - Dark na background na may light na text
- auto - Awtomatikong tumutugma sa system preference ng user
Format ng Pagpapakita ng Currency
- iso - Ipinapakita ang ISO codes tulad ng USD, EUR, GBP
- symbol - Ipinapakita ang currency symbols tulad ng $, €, £
Mga Format ng Numero
- auto - Awtomatikong nadedetect ang browser settings ng bisita
- us - US format: 1,234.56
- eu - European format: 1.234,56
- french - French format: 1 234,56
- indian - Indian format: 1,23,456.78
Mga Opsyon sa Dropdown Currency
- all - Lahat ng 170+ na suportadong currency
- top10 - Top 10 na pinakasikat na currency
- top20 - Top 20 na currency ayon sa trading volume
- USD,EUR,GBP,... - Custom na listahan ng partikular na currency
Tip: Gamitin ang Widget Builder para visual na i-configure ang lahat ng opsyon na ito at awtomatikong makuha ang embed code.
6 Pag-aayos ng Problema
Hindi Lumalabas ang Widget
Siguraduhing tama ang pagkakalagay ng embed code sa iyong HTML. Para sa script embed, tiyaking may container div na may tamang ID. Tingnan ang browser console para sa JavaScript errors.
Hindi Gumagana ang Dropdown
Kung iframe embed ang gamit, mag-scroll ang dropdowns sa loob ng widget area. Para sa buong dropdown functionality na may overlays, gamitin ang script embed method.
Mga Conflict sa Estilo
Kung naaapektuhan ng CSS ng iyong website ang itsura ng widget, subukan ang iframe embed method para ma-isolate ang widget styles mula sa iyong page.
Mga Isyu sa Content Security Policy
Kung mahigpit ang iyong CSP, idagdag ang currency.wiki sa allowed script-src at frame-src directives mo. Halimbawa: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Kailangan ng Tulong?
Hindi mo mahanap ang hinahanap mo? Narito ang aming support team para tumulong.
