ឯកសារយោង Widget
មគ្គុទេសក៍ពេញលេញសម្រាប់បញ្ចូល និងកែប្រែកម្មវិធីបម្លែងរូបិយប័ណ្ណ Currency.Wiki លើគេហទំព័ររបស់អ្នក។
មាតិកា
1 ចាប់ផ្តើម
ការបន្ថែមកម្មវិធីបម្លែងរូបិយប័ណ្ណទៅគេហទំព័ររបស់អ្នកងាយស្រួល។ អនុវត្តជំហានទាំងនេះ៖
- ចូលទៅទំព័របង្កើត Widget ហើយកែរូបរាង widget របស់អ្នក
- ជ្រើសរូបរាង widget រូបិយប័ណ្ណ និងស្បែកដែលចង់បាន
- ចម្លងកូដបញ្ចូល (Script ឬ Iframe)
- បិទភ្ជាប់កូដទៅក្នុង HTML របស់គេហទំព័ររបស់អ្នកនៅកន្លែងដែលចង់ឲ្យ widget បង្ហាញ
គន្លឹះ៖ ប្រើការកំណត់រហ័សក្នុង Widget Builder ដើម្បីចាប់ផ្តើមយ៉ាងឆាប់រហ័សជាមួយ widget ដែលកំណត់រួច។
2 វិធីបញ្ចូល
បញ្ចូល Script (ផ្ដល់អនុសាសន៍)
វិធីបញ្ចូល script នឹងបញ្ចូល widget ទៅក្នុងទំព័ររបស់អ្នកដោយផ្ទាល់។ បញ្ជីរូបិយប័ណ្ណនឹងបង្ហាញនៅលើមាតិកាផ្សេងៗសម្រាប់ជ្រើសងាយ។
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- បញ្ជីបង្ហាញក្រៅប្រអប់ widget
- ល្អសម្រាប់ជ្រើសរូបិយប័ណ្ណអន្តរកម្ម
- រួមបញ្ចូលជាមួយទំព័ររបស់អ្នកយ៉ាងរលូន
បញ្ចូល Iframe
វិធីបញ្ចូល iframe បង្កើតប្រអប់បំបែកសម្រាប់ widget។ វិធីនេះមានសុវត្ថិភាព និងដំណើរការល្អនៅកន្លែងដែលមានគោលនយោបាយសុវត្ថិភាពខ្ពស់។
<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 សម្រាប់អន្តរកម្មពេញលេញ (បញ្ជីបង្ហាញលើមាតិកា)។ ប្រើ Iframe embed ពេលត្រូវការបំបែក ឬមានកំណត់ CSP។
3 រចនាប័ទ្ម Widget
ជ្រើសរូបរាង widget ចំនួន ១១ ដើម្បីសម្របសម្រួលនឹងរចនាប័ទ្មគេហទំព័ររបស់អ្នក។ រៀងរាល់រូបរាងត្រូវបានបង្កើតសម្រាប់ករណីប្រើប្រាស់និងទំហំបង្ហាញផ្សេងៗ។
mini
250x140px
កម្មវិធីបម្លែងជួរតូច។ ល្អសម្រាប់បឋមកថា ឬកន្លែងតូច។
square
250x250px
widget សមាមាត្រ ១:១ ជាមួយប៊ូតុងប្ដូរ។ ល្អសម្រាប់របារចំហៀង។
compact
300x180px
កម្មវិធីបម្លែងតូចជាមួយមុខងារចាំបាច់។
inline
480x56px
ប្លង់ផ្ដេក។ ល្អសម្រាប់បញ្ចូលក្នុងមាតិកា ឬរុករក។
tall
200x280px
ប្លង់របារចំហៀងបញ្ចូលស្លាកបុរាណ។
mini-chart
250x260px
កម្មវិធីបម្លែងតូចជាមួយតារាងបង្ហាញប្រវត្តិអត្រា។
multi-expandable
300x320px
កម្មវិធីបម្លែងពហុរូបិយប័ណ្ណ។ អ្នកប្រើអាចបន្ថែម/ដករូបិយប័ណ្ណ។
multi-fixed
300x300px
បញ្ជីអត្រាប្តូរប្រាក់ថេរ។ ល្អសម្រាប់បង្ហាញអត្រាជាក់លាក់។
rates-compact
250x320px
បញ្ជីអត្រាប្តូរប្រាក់បង្រួមជាមួយពេលធ្វើបច្ចុប្បន្នភាពចុងក្រោយ។
rates-viewer
300x500px
ទិដ្ឋភាពតារាងពេញលេញជាមួយព័ត៌មានអត្រាលម្អិត។
rates-viewer-compact
300x400px
កំណែបង្រួមនៃ rates viewer ជាមួយតារាង។
4 ប៉ារ៉ាម៉ែត្រ URL
កែប្រែកម្មវិធីរបស់អ្នកដោយប្រើប៉ារ៉ាម៉ែត្រ URL។ ប៉ារ៉ាម៉ែត្រទាំងនេះដំណើរការជាមួយ Script និង Iframe។
| ប៉ារ៉ាម៉ែត្រ | លំនាំដើម | សេចក្ដីពិពណ៌នា |
|---|---|---|
| style | compact | រចនាប័ទ្ម widget (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | ស្បែកពណ៌ (light, dark, or auto) |
| from | USD | កូដរូបិយប័ណ្ណប្រភព (ឧ. USD, EUR, GBP) |
| to | EUR | កូដរូបិយប័ណ្ណគោលដៅ (ឧ. EUR, USD, JPY) |
| amount | 1000 | ចំនួនលំនាំដើមសម្រាប់បម្លែង |
| accent | #2563eb | ពណ៌សំឡេងជា hex (គ្មាន #) |
| lang | en | កូដភាសា widget (ឧ. en, es, fr, de) |
| flags | 1 | បង្ហាញទង់ជាតិ (1=បង្ហាញ, 0=លាក់) |
| display | iso | ទ្រង់ទ្រាយបង្ហាញរូបិយប័ណ្ណ (iso=USD, symbol=$) |
| lock | 0 | ចាក់សោរូបិយប័ណ្ណ (1=ចាក់សោ, 0=មិនចាក់សោ) |
| currencies | EUR,GBP,JPY | បញ្ជីរូបិយប័ណ្ណបំបែកដោយសញ្ញាក្បៀសសម្រាប់ widget ពហុរូបិយប័ណ្ណ |
| dropdown | all | រូបិយប័ណ្ណក្នុងបញ្ជីជ្រើសរើស (all, top10, top20, ឬបញ្ជីបំបែកដោយសញ្ញាក្បៀស) |
| 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
កម្មវិធីបម្លែងតូចជាមួយតារាង ៣០ ថ្ងៃ៖
?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 - បង្ហាញកូដ ISO ដូចជា USD, EUR, GBP
- symbol - បង្ហាញនិមិត្តសញ្ញារូបិយប័ណ្ណដូចជា $, €, £
ទ្រង់ទ្រាយលេខ
- auto - រកឃើញការកំណត់កម្មវិធីរុករករបស់អ្នកទស្សនាដោយស្វ័យប្រវត្តិ
- us - ទ្រង់ទ្រាយ US: 1,234.56
- eu - ទ្រង់ទ្រាយអឺរ៉ុប: 1.234,56
- french - ទ្រង់ទ្រាយបារាំង: 1 234,56
- indian - ទ្រង់ទ្រាយឥណ្ឌា: 1,23,456.78
ជម្រើសរូបិយប័ណ្ណក្នុងបញ្ជីជ្រើសរើស
- all - រូបិយប័ណ្ណ ១៧០+ ទាំងអស់ដែលគាំទ្រ
- top10 - កំពូល ១០ រូបិយប័ណ្ណពេញនិយមបំផុត
- top20 - កំពូល ២០ រូបិយប័ណ្ណតាមបរិមាណជួញដូរ
- USD,EUR,GBP,... - បញ្ជីផ្ទាល់ខ្លួននៃរូបិយប័ណ្ណជាក់លាក់
គន្លឹះ៖ ប្រើ Widget Builder ដើម្បីកំណត់ជម្រើសទាំងនេះដោយមើលផ្ទាល់ និងបង្កើតកូដបញ្ចូលដោយស្វ័យប្រវត្តិ។
6 ដោះស្រាយបញ្ហា
Widget មិនបង្ហាញ
ប្រាកដថាកូដបញ្ចូលត្រូវបានដាក់ត្រឹមត្រូវក្នុង HTML។ សម្រាប់ script embed ប្រាកដថា div មាន ID ត្រឹមត្រូវ។ ពិនិត្យកុងសូលកម្មវិធីរុករកសម្រាប់កំហុស JavaScript។
បញ្ជីជ្រើសរើសមិនដំណើរការ
ប្រសិនបើប្រើ iframe embed បញ្ជីជ្រើសរើសនឹងរមូរនៅក្នុង widget។ សម្រាប់មុខងារបញ្ជីជ្រើសរើសពេញលេញ ប្រើវិធី script embed។
បញ្ហារចនាប័ទ្ម
ប្រសិនបើ CSS របស់គេហទំព័ររបស់អ្នកប៉ះពាល់ widget សាកល្បងប្រើវិធី iframe embed ដើម្បីបំបែករចនាប័ទ្ម។
បញ្ហា Content Security Policy
ប្រសិនបើអ្នកមាន CSP ខ្ពស់ អ្នកអាចត្រូវបន្ថែម currency.wiki ទៅ script-src និង frame-src។ ឧទាហរណ៍: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
ត្រូវការជំនួយ?
រកមិនឃើញអ្វីដែលអ្នកកំពុងស្វែងរក? ក្រុមជំនួយរបស់យើងស្ថិតនៅទីនេះដើម្បីជួយ។
