විජට්ටු ලේඛන
Currency.Wiki මුදල් පරිවර්තක විජට්ටුව ඔබගේ වෙබ්අඩවියට ඇතුළත් කිරීම සහ අභිරුචි කිරීම සඳහා සම්පූර්ණ මාර්ගෝපදේශය.
අන්තර්ගතය
1 ආරම්භය
ඔබගේ වෙබ්අඩවියට මුදල් පරිවර්තක විජට්ටුවක් එක් කිරීම පහසුයි. මෙම සරල පියවර අනුගමනය කරන්න:
- විජට්ටු නිර්මාණය පිටුවට ගොස් ඔබගේ විජට්ටුවේ පෙනුම අභිරුචි කරන්න
- ඔබ කැමති විජට්ටු විලාසය, මුදල් සහ තේමාව තෝරන්න
- උත්පාදනය වූ embed කේතය (Script හෝ Iframe) පිටපත් කරන්න
- කේතය ඔබගේ වෙබ්අඩවියේ HTML එකට, විජට්ටුව පෙනෙන ස්ථානයට ඇලවන්න
ඉඟිය: ඉක්මන් ආරම්භ Presets භාවිතා කර, පෙර සකස් කළ විජට්ටුවක් සමඟ ඉක්මනින් ආරම්භ කරන්න.
2 Embed ක්රම
Script Embed (නිර්දේශිතයි)
Script embed ක්රමය විජට්ටුව ඔබගේ පිටුවට සෘජුවම ඇතුළත් කරයි. මුදල් dropdown මෙනු අවට අන්තර්ගතයට ඉදිරියෙන් පෙන්වයි.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Dropdown විජට්ටු බාහිර පෙන්වයි
- ක්රියාකාරී මුදල් තේරීම සඳහා හොඳයි
- ඔබගේ පිටුව සමඟ සම්පූර්ණ ඒකාබද්ධතාවය
Iframe Embed
Iframe embed ක්රමය විජට්ටුව සඳහා වෙන්වූ බහිර කොටසක් සාදයි. මෙම ක්රමය ආරක්ෂිතයි සහ දැඩි අන්තර්ගත ප්රතිපත්ති වලදී ක්රියා කරයි.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- ඔබගේ පිටුවේ විලාසිතා වලින් සම්පූර්ණයෙන්ම වෙන්වී ඇත
- දැඩි Content Security Policies සමඟ ක්රියා කරයි
- සරල සහ ආරක්ෂිත ක්රියාත්මක කිරීම
සටහන: සම්පූර්ණ ක්රියාකාරීත්වය සඳහා Script embed භාවිතා කරන්න (dropdown අන්තර්ගතය ඉහළින් පෙන්වයි). වෙන්වීමක් අවශ්ය නම් හෝ CSP සීමා තිබේ නම් Iframe embed භාවිතා කරන්න.
3 විජට්ටු විලාසිතා
ඔබගේ වෙබ්අඩවියේ නිර්මාණයට ගැළපෙන විජට්ටු විලාසිතා 11ක් අතරින් තෝරන්න. සෑම විලාසයකම විවිධ භාවිතයන් සහ ප්රදර්ශන ප්රමාණ සඳහා හොඳින් සකස් කර ඇත.
mini
250x140px
සංක්ෂිප්ත එක් පේළි පරිවර්තකය. ශීර්ෂක හෝ තද ස්ථාන සඳහා සුදුසුයි.
square
250x250px
1:1 අනුපාත විජට්ටුව හුවමාරු බොත්තම සමඟ. පැති තීරු සඳහා හොඳයි.
compact
300x180px
අත්යවශ්ය විශේෂාංග සියල්ල සමඟ කුඩා පරිවර්තකය.
inline
480x56px
තිරස් පිරිසැලසුම. අන්තර්ගතය හෝ නාවිගේෂන් තුළ embed කිරීමට සුදුසුයි.
tall
200x280px
සිරස් පැති තීරු පිරිසැලසුම සාම්ප්රදායික ලේබල් සමඟ.
mini-chart
250x260px
සංක්ෂිප්ත පරිවර්තකය අනුපාත ඉතිහාසය පෙන්වන sparkline ප්රස්ථාරය සමඟ.
multi-expandable
300x320px
බහු මුදල් පරිවර්තකය. පරිශීලකයන්ට මුදල් එකතු/ඉවත් කළ හැක.
multi-fixed
300x300px
ස්ථිර විනිමය අනුපාත ලැයිස්තුව. විශේෂ අනුපාත පෙන්වීමට හොඳයි.
rates-compact
250x320px
අවසන් යාවත්කාලීන වේලාව සමඟ සංක්ෂිප්ත විනිමය අනුපාත ලැයිස්තුව.
rates-viewer
300x500px
සම්පූර්ණ ප්රස්ථාර දසුන විස්තරාත්මක අනුපාත තොරතුරු සමඟ.
rates-viewer-compact
300x400px
ප්රස්ථාර සමඟ සංක්ෂිප්ත rates viewer.
4 URL පරාමිතීන්
URL පරාමිතීන් භාවිතා කර ඔබගේ විජට්ටුව අභිරුචි කරන්න. මෙම පරාමිතීන් Script සහ Iframe embed ක්රම දෙකම සමඟ ක්රියා කරයි.
| පරාමිතිය | පෙරනිමිය | විස්තරය |
|---|---|---|
| style | compact | විජට්ටු විලාසය (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | වර්ණ තේමාව (light, dark, හෝ auto) |
| from | USD | මූලාශ්ර මුදල් කේතය (උදා: USD, EUR, GBP) |
| to | EUR | ඉලක්ක මුදල් කේතය (උදා: EUR, USD, JPY) |
| amount | 1000 | පරිවර්තනය සඳහා පෙරනිමි ප්රමාණය |
| accent | #2563eb | ඉස්මතු වර්ණය hex ආකාරයෙන් (# නැතිව) |
| lang | en | විජට්ටු භාෂා කේතය (උදා: en, es, fr, de) |
| flags | 1 | රටේ කොඩි පෙන්වන්න (1=පෙන්වන්න, 0=සඟවන්න) |
| display | iso | මුදල් පෙන්වීමේ ආකෘතිය (iso=USD, symbol=$) |
| lock | 0 | මුදල් අගුළු දමන්න (1=අගුළු, 0=අනඅගුළු) |
| currencies | EUR,GBP,JPY | බහු මුදල් විජට්ටුව සඳහා මුදල් ලැයිස්තුව comma වලින් වෙන් කර |
| dropdown | all | Dropdown එකේ මුදල් (all, top10, top20, හෝ comma වලින් වෙන් කළ ලැයිස්තුව) |
| branding | 1 | වෙළඳ නාමය පෙන්වන්න (1=පෙන්වන්න, 0=සඟවන්න) |
| brandinglink | 1 | වෙළඳ නාමය ක්ලික් කළ හැකිද (1=සබැඳිය, 0=පෙළ පමණක්) |
| format | auto | අංක ආකෘතිය (auto, us, eu, french, indian) |
| decimals | 2 | දශම ස්ථාන ගණන (0-6) |
| chart | 0 | ප්රස්ථාරය සක්රීය කරන්න (1=සක්රීය, 0=අක්රීය) |
| chartperiod | 7d | ප්රස්ථාර කාල පරාසය (7d, 14d, 30d, 90d) |
උදාහරණ
අඳුරු තේමා සංක්ෂිප්ත පරිවර්තකය:
?style=compact&theme=dark&from=USD&to=EUR
බහු මුදල් විනිමය අනුපාත:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
දින 30 ප්රස්ථාරය සමඟ කුඩා පරිවර්තකය:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
මුදල් කේත වෙනුවට සංකේත පෙන්වන්න:
?style=compact&display=symbol&from=USD&to=EUR
අභිරුචි ප්රමාණය සහිත අගුළු මුදල්:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 අභිරුචි විකල්ප
තේමා විකල්ප
- light - ආලෝකමත් පසුබිම සහ අඳුරු පෙළ
- dark - අඳුරු පසුබිම සහ ආලෝකමත් පෙළ
- auto - පරිශීලකයාගේ පද්ධති කැමැත්තට ස්වයංක්රීයව ගැළපේ
මුදල් පෙන්වීමේ ආකෘතිය
- iso - USD, EUR, GBP වැනි ISO කේත පෙන්වයි
- symbol - $, €, £ වැනි මුදල් සංකේත පෙන්වයි
අංක ආකෘති
- auto - පරිශීලකයාගේ බ්රව්සර සැකසුම් ස්වයංක්රීයව හඳුනාගනී
- us - US ආකෘතිය: 1,234.56
- eu - යුරෝපීය ආකෘතිය: 1.234,56
- french - ප්රංශ ආකෘතිය: 1 234,56
- indian - ඉන්දියානු ආකෘතිය: 1,23,456.78
Dropdown මුදල් විකල්ප
- all - සහාය ලබන සියලුම 170+ මුදල්
- top10 - වැඩිපුරම ජනප්රිය මුදල් 10
- top20 - වෙළඳ පරිමාව අනුව ඉහළම 20 මුදල්
- USD,EUR,GBP,... - විශේෂ මුදල් ලැයිස්තුව
ඉඟිය: මෙම සියලු විකල්ප දෘශ්යමය ලෙස සකස් කර embed කේතය ස්වයංක්රීයව ජනනය කිරීමට විජට්ටු නිර්මාණය භාවිතා කරන්න.
6 ගැටළු විසඳීම
විජට්ටුව පෙන්වන්නේ නැහැ
Embed කේතය ඔබගේ HTML එකේ නිවැරදිව තැබූ බව තහවුරු කරන්න. Script embed සඳහා, නිවැරදි ID එක සහිත container div එක තිබේදැයි බලන්න. ඔබගේ බ්රව්සරයේ console එකේ JavaScript දෝෂ පරීක්ෂා කරන්න.
Dropdown ක්රියා නොකරයි
Iframe embed භාවිතා කරන විට, dropdown විජට්ටුව තුළම ස්ක්රෝල් වේ. Overlay සමඟ සම්පූර්ණ dropdown ක්රියාකාරීත්වය සඳහා script embed ක්රමය භාවිතා කරන්න.
විලාසිතා ගැටලු
ඔබගේ වෙබ්අඩවියේ CSS විජට්ටුවේ පෙනුමට බලපාන්නේ නම්, විජට්ටුවේ විලාසිතා වෙන්වීම සඳහා iframe embed ක්රමය උත්සාහ කරන්න.
Content Security Policy ගැටලු
ඔබට දැඩි CSP තිබේ නම්, currency.wiki ඔබගේ script-src සහ frame-src අනුමත ලැයිස්තුවට එක් කළ යුතුයි. උදාහරණයක්: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
උදව් අවශ්යද?
ඔබ සොයන දේ සොයාගත නොහැකිද? අපගේ සහාය කණ්ඩායම උදව් කිරීමට සූදානම්.
