Дакументацыя па віджэце
Поўнае кіраўніцтва па ўбудаванні і наладцы віджэта канвэртара валют 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>
- Поўная ізаляцыя ад стыляў вашай старонкі
- Працуюць з жорсткімі палітыкамі бяспекі кантэнту
- Простая і бяспечная рэалізацыя
Заўвага: Выкарыстоўвайце ўбудаванне праз скрыпт для поўнай інтэрактыўнасці (выпадальныя меню паверх змесціва). Выкарыстоўвайце iframe, калі патрэбна ізаляцыя або ёсць абмежаванні CSP.
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, якая ізалюе стылі віджэта ад вашай старонкі.
Праблемы з палітыкай бяспекі кантэнту (CSP)
Калі ў вас строгі CSP, вам можа спатрэбіцца дадаць currency.wiki у дазволеныя script-src і frame-src. Прыклад: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Патрэбна дапамога?
Не можаце знайсці тое, што шукаеце? Наша каманда падтрымкі гатова дапамагчы.
