Документација за виджет
Целосен водич за вградување и прилагодување на виджетот за конверзија на валути од 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 Policies
- Едноставна и безбедна имплементација
Забелешка: Користете скрипта за целосна интерактивност (паѓачките менија се прикажуваат над содржината). Користете 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 кој ги изолира стиловите на виджетот од вашата страница.
Проблеми со Content Security Policy
Ако имате строга CSP, можеби ќе треба да го додадете currency.wiki во дозволените script-src и frame-src директиви. Пример: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Потребна ви е помош?
Не можете да го најдете тоа што го барате? Нашиот тим за поддршка е тука за вас.
