ເອກະສານ Widget
ຄູ່ມືຄົບຖ້ວນສຳລັບຝັງ ແລະປັບແຕ່ງ widget ແປສະກຸນເງິນ Currency.Wiki ໃນເວັບໄຊຂອງທ່ານ.
ສາລະບານເນື້ອໃນ
1 ເລີ່ມຕົ້ນ
ການເພີ່ມ widget ແປສະກຸນເງິນໃສ່ເວັບໄຊງ່າຍຫຼາຍ. ປະຕິບັດຕາມຂັ້ນຕອນງ່າຍໆນີ້:
- ໄປທີ່ໜ້າ Widget Builder ແລະປັບແຕ່ງຮູບລັກສະນະ 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>
- ເມນູສະກຸນຢູ່ນອກ container widget
- ເໝາະສຳລັບການເລືອກສະກຸນແບບ interactive
- ປະສານກັບໜ້າເວັບຢ່າງລົມລືນ
ຝັງ Iframe
ວິທີຝັງ iframe ຈະສ້າງ container ແຍກສຳລັບ widget. ວິທີນີ້ປອດໄພ ແລະເຮັດວຽກໃນສະພາບແວດລ້ອມທີ່ມີນະໂຍບາຍ CSP ເຂັ້ມງວດ.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- ແຍກອອກຈາກຮູບແບບໜ້າເວັບທັງໝົດ
- ເຮັດວຽກກັບ CSP ເຂັ້ມງວດ
- ຕິດຕັ້ງງ່າຍ ແລະປອດໄພ
ໝາຍເຫດ: ໃຊ້ Script ຝັງເພື່ອຄວາມ interactive (ເມນູສະກຸນທັບເນື້ອຫາ). ໃຊ້ Iframe ຝັງເມື່ອຕ້ອງການແຍກຫຼືມີຂໍ້ຈຳກັດ CSP.
3 ຮູບແບບ Widget
ເລືອກຮູບແບບ widget 11 ຮູບແບບເພື່ອໃຫ້ກົງກັບດີໄຊເວັບໄຊຂອງທ່ານ. ແຕ່ລະຮູບແບບປັບໃຫ້ເໝາະກັບການໃຊ້ງານແລະຂະໜາດສະແດງ.
mini
250x140px
ຕົວແປກະທັດຮັດແຖວດຽວ. ເໝາະສຳລັບຫົວໜ້າ ຫຼືພື້ນທີ່ຈຳກັດ.
square
250x250px
Widget ສັດສ່ວນ 1:1 ມີປຸ່ມສະຫຼັບ. ເໝາະສຳລັບແຖບຂ້າງ.
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
ປັບແຕ່ງ widget ຂອງທ່ານດ້ວຍພາຣາມິເຕີ 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, 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 | ລາຍຊື່ສະກຸນເງິນແບບ comma ສຳລັບ widget ຫຼາຍສະກຸນ |
| dropdown | all | ສະກຸນໃນ dropdown (all, top10, top20, ຫຼືລາຍຊື່ comma) |
| branding | 1 | ສະແດງ branding (1=ສະແດງ, 0=ບໍ່ສະແດງ) |
| brandinglink | 1 | ໃຫ້ branding ຄລິກໄດ້ (1=link, 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 - ສະແດງລະຫັດ ISO ເຊັ່ນ USD, EUR, GBP
- 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,... - ລາຍຊື່ສະກຸນກຳນົດເອງ
ເຄັດລັບ: ໃຊ້ Widget Builder ເພື່ອກຳນົດທຸກຕົວເລືອກແລະສ້າງລະຫັດຝັງອັດຕະໂນມັດ.
6 ແນະນຳແກ້ໄຂບັນຫາ
Widget ບໍ່ສະແດງ
ແນ່ໃຈວ່າຝັງລະຫັດຖືກຕ້ອງໃນ HTML. ສຳລັບ script ຝັງ, ແນ່ໃຈວ່າ div container ມີຄ່າ ID ຖືກຕ້ອງ. ກວດສອບ console ເບຣາເຊີສຳລັບຂໍ້ຜິດພາດ JavaScript.
Dropdown ບໍ່ເຮັດວຽກ
ຖ້າໃຊ້ iframe ຝັງ, dropdown ຈະເລື່ອນໃນ widget. ສຳລັບ dropdown ທີ່ສະແດງທັບເນື້ອຫາ, ໃຊ້ script ຝັງແທນ.
ຮູບແບບຊົງກັນ
ຖ້າ CSS ເວັບໄຊຂອງທ່ານມີຜົນຕໍ່ widget, ລອງໃຊ້ iframe ຝັງເພື່ອແຍກຮູບແບບອອກ.
ບັນຫາ Content Security Policy
ຖ້າມີ CSP ເຂັ້ມງວດ, ອາດຕ້ອງເພີ່ມ currency.wiki ໃນ script-src ແລະ frame-src. ຕົວຢ່າງ: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
ຕ້ອງການຄວາມຊ່ວຍເຫຼືອ?
ຫາບໍ່ພົບສິ່ງທີ່ຄົ້ນຫາ? ທີມງານສະຫນັບສະຫນຸນພ້ອມຊ່ວຍເຫຼືອ.
