Ҳуҷҷатгузории виджет
Дастури пурра барои ҷойгиркунӣ ва фармоишии виджети табдили асъори Currency.Wiki дар вебсайти шумо.
Феҳристи мавзӯъҳо
1 Оғози кор
Илова кардани виджети табдили асъор ба вебсайти шумо осон аст. Ин қадамҳои соддаро иҷро кунед:
- Ба саҳифаи Сохтани Виджет рафта, намуди онро фармоиш диҳед
- Услуб, асъорҳо ва мавзӯи дилхоҳро интихоб кунед
- Коди ҷойгиркунии тавлидшуда (Скрипт ё Iframe)-ро нусха бардоред
- Кодро ба HTML-и вебсайти худ дар ҷое, ки мехоҳед виджет пайдо шавад, гузоред
Маслиҳат: Аз пешнамоишҳои зуд оғоз дар Сохтани Виджет истифода баред, то зуд бо виджети пешфарз оғоз кунед.
2 Усулҳои ҷойгиркунӣ
Ҷойгиркунии скрипт (Тавсияшаванда)
Усули ҷойгиркунии скрипт виджетро мустақиман ба саҳифаи шумо ворид мекунад. Менюҳои афтандаи асъор дар болои муҳтавои атроф барои интихоби осон пайдо мешаванд.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Менюҳо берун аз контейнер пайдо мешаванд
- Барои интихоби интерактивии асъор беҳтарин аст
- Интегратсияи бефосила бо саҳифаи шумо
Ҷойгиркунии Iframe
Усули ҷойгиркунии iframe контейнереро барои виджет эҷод мекунад. Ин усул бехатар аст ва дар муҳитҳои дорои сиёсати сахти муҳтаво кор мекунад.
<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 кор мекунад
- Имплементи содда ва бехатар
Эзоҳ: Барои интерактивии пурра (менюҳо дар болои муҳтаво) скриптро истифода баред. Барои изолятсия ё маҳдудиятҳои CSP, iframe-ро истифода баред.
3 Услубҳои виджет
Аз 11 услуби гуногуни виджет интихоб кунед, то бо тарҳи вебсайти шумо мувофиқат кунад. Ҳар услуб барои ҳолатҳои гуногун ва андозаҳои намоиш оптимизатсия шудааст.
mini
250x140px
Табдилдиҳандаи яксатрии фишурда. Барои сарлавҳа ё ҷойҳои танг беҳтарин аст.
square
250x250px
Виджети нисбати 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
Версияи фишурдаи намоишгари қурбҳо бо диаграммаҳо.
4 Параметрҳои URL
Виджети худро бо истифода аз параметрҳои URL фармоиш диҳед. Ин параметрҳо бо ҳарду усули ҷойгиркунӣ (Скрипт ва Iframe) кор мекунанд.
| Параметр | Пешфарз | Тавсиф |
|---|---|---|
| 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 | Рӯйхати асъорҳо барои виджетҳои бисёр-асъор (бо вергул ҷудо кунед) |
| 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
Табдилдиҳандаи хурд бо диаграммаи 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 - Формати ИМА: 1,234.56
- eu - Формати аврупоӣ: 1.234,56
- french - Формати фаронсавӣ: 1 234,56
- indian - Формати ҳинду: 1,23,456.78
Имконоти менюи афтандаи асъор
- all - Ҳамаи 170+ асъори дастгиришаванда
- top10 - Топ 10 асъори машҳур
- top20 - Топ 20 асъор аз рӯи ҳаҷми савдо
- USD,EUR,GBP,... - Рӯйхати фармоишии асъорҳои мушаххас
Маслиҳат: Аз Сохтани Виджет истифода баред, то ҳамаи ин имконотро визуалӣ танзим кунед ва коди ҷойгиркуниро худкор тавлид намоед.
6 Масъалаҳои техникӣ
Виджет намоиш дода намешавад
Боварӣ ҳосил кунед, ки коди ҷойгиркунӣ дуруст ба HTML-и шумо гузошта шудааст. Барои ҷойгиркунии скрипт, санҷед, ки div-и контейнер бо ID дуруст мавҷуд аст. Консоли браузери худро барои хатогиҳои JavaScript санҷед.
Менюи афтанда кор намекунад
Агар шумо iframe-ро истифода баред, менюҳои афтанда дар дохили минтақаи виджет ҳаракат мекунанд. Барои имконоти пурраи меню бо қабатҳо, усули ҷойгиркунии скриптро истифода баред.
Мухолифати услуб
Агар CSS-и вебсайти шумо ба намуди виджет таъсир расонад, усули ҷойгиркунии iframe-ро истифода баред, ки услубҳоро ҷудо мекунад.
Масъалаҳои Content Security Policy
Агар шумо CSP-и сахт дошта бошед, лозим аст currency.wiki-ро ба script-src ва frame-src-и иҷозатдодаатон илова кунед. Масалан: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Ба кӯмак ниёз доред?
Ҷавоби лозимаро пайдо накардед? Гурӯҳи дастгирии мо барои кӯмак дар хидмати шумост.
