Dokumentace widgetu
Kompletní průvodce vložením a přizpůsobením měnového konvertoru widgetu Currency.Wiki na vašem webu.
Obsah
1 Začínáme
Přidání měnového konvertoru widgetu na váš web je snadné. Postupujte podle těchto jednoduchých kroků:
- Přejděte na stránku Tvůrce widgetu a přizpůsobte vzhled widgetu
- Vyberte preferovaný styl widgetu, měny a motiv
- Zkopírujte vygenerovaný kód pro vložení (Skript nebo Iframe)
- Vložte kód do HTML vašeho webu tam, kde chcete, aby se widget zobrazil
Tip: Použijte rychlé předvolby v Tvůrci widgetu pro rychlý start s přednastaveným widgetem.
2 Metody vložení
Vložení přes Skript (Doporučeno)
Metoda vložení skriptem vloží widget přímo na vaši stránku. Rozbalovací menu měn se zobrazí před okolním obsahem pro snadný výběr.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Rozbalovací menu mimo kontejner widgetu
- Nejlepší pro interaktivní výběr měn
- Bezproblémová integrace s vaší stránkou
Vložení přes Iframe
Metoda vložení přes iframe vytvoří izolovaný kontejner pro widget. Tato metoda je bezpečná a funguje v prostředích s přísnými zásadami obsahu.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Zcela izolováno od stylů vaší stránky
- Funguje s přísnými zásadami Content Security Policy
- Jednoduchá a bezpečná implementace
Poznámka: Použijte vložení skriptem pro plnou interaktivitu (rozbalovací menu přes obsah). Použijte iframe, pokud potřebujete izolaci nebo máte omezení CSP.
3 Styly widgetu
Vyberte si z 11 různých stylů widgetu, které odpovídají designu vašeho webu. Každý styl je optimalizován pro různé případy použití a velikosti zobrazení.
mini
250x140px
Kompaktní jednoradý konvertor. Ideální pro záhlaví nebo úzká místa.
square
250x250px
Widget v poměru 1:1 s tlačítkem prohození. Skvělé pro postranní panely.
compact
300x180px
Konvertor s malou plochou a všemi základními funkcemi.
inline
480x56px
Horizontální rozložení. Ideální pro vložení do obsahu nebo navigace.
tall
200x280px
Vertikální rozložení postranního panelu s klasickými popisky.
mini-chart
250x260px
Kompaktní konvertor s minigrafem historie kurzu.
multi-expandable
300x320px
Konvertor pro více měn. Uživatelé mohou přidávat/odebírat měny.
multi-fixed
300x300px
Pevný seznam směnných kurzů. Nejlepší pro zobrazení konkrétních kurzů.
rates-compact
250x320px
Zhuštěný seznam směnných kurzů s časem poslední aktualizace.
rates-viewer
300x500px
Plný graf s detailními informacemi o kurzech.
rates-viewer-compact
300x400px
Kompaktní verze prohlížeče kurzů s grafy.
4 Parametry URL
Přizpůsobte si widget pomocí parametrů v URL. Tyto parametry fungují jak pro vložení skriptem, tak iframe.
| Parametr | Výchozí | Popis |
|---|---|---|
| style | compact | Styl widgetu (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Barevné schéma (light, dark, nebo auto) |
| from | USD | Kód zdrojové měny (např. USD, EUR, GBP) |
| to | EUR | Kód cílové měny (např. EUR, USD, JPY) |
| amount | 1000 | Výchozí částka pro převod |
| accent | #2563eb | Barva zvýraznění v hex formátu (bez #) |
| lang | en | Kód jazyka widgetu (např. en, es, fr, de) |
| flags | 1 | Zobrazit vlajky států (1=zobrazit, 0=skrýt) |
| display | iso | Formát zobrazení měny (iso=USD, symbol=$) |
| lock | 0 | Zamknout měny (1=zamčeno, 0=odemčeno) |
| currencies | EUR,GBP,JPY | Seznam měn oddělený čárkou pro widgety s více měnami |
| dropdown | all | Měny v rozbalovacím menu (all, top10, top20, nebo seznam oddělený čárkou) |
| branding | 1 | Zobrazit značku (1=zobrazit, 0=skrýt) |
| brandinglink | 1 | Značka jako odkaz (1=odkaz, 0=pouze text) |
| format | auto | Formát čísel (auto, us, eu, french, indian) |
| decimals | 2 | Počet desetinných míst (0-6) |
| chart | 0 | Povolit graf (1=povoleno, 0=zakázáno) |
| chartperiod | 7d | Období grafu (7d, 14d, 30d, 90d) |
Příklady
Kompaktní konvertor v tmavém motivu:
?style=compact&theme=dark&from=USD&to=EUR
Směnné kurzy pro více měn:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Mini konvertor s 30denním grafem:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Zobrazit měnové symboly místo kódů:
?style=compact&display=symbol&from=USD&to=EUR
Zamčené měny s vlastní částkou:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Možnosti přizpůsobení
Možnosti motivu
- light - Světlé pozadí s tmavým textem
- dark - Tmavé pozadí se světlým textem
- auto - Automaticky podle nastavení systému uživatele
Formát zobrazení měny
- iso - Zobrazuje ISO kódy jako USD, EUR, GBP
- symbol - Zobrazuje měnové symboly jako $, €, £
Formáty čísel
- auto - Automaticky detekuje nastavení prohlížeče návštěvníka
- us - US formát: 1,234.56
- eu - Evropský formát: 1.234,56
- french - Francouzský formát: 1 234,56
- indian - Indický formát: 1,23,456.78
Možnosti rozbalovacího menu měn
- all - Všech 170+ podporovaných měn
- top10 - Top 10 nejoblíbenějších měn
- top20 - Top 20 měn podle objemu obchodování
- USD,EUR,GBP,... - Vlastní seznam konkrétních měn
Tip: Použijte Tvůrce widgetu pro vizuální konfiguraci všech těchto možností a automatické vygenerování kódu pro vložení.
6 Řešení problémů
Widget se nezobrazuje
Ujistěte se, že je kód pro vložení správně umístěn ve vašem HTML. U vložení skriptem zkontrolujte, že existuje kontejner div se správným ID. Zkontrolujte konzoli prohlížeče pro případné chyby JavaScriptu.
Rozbalovací menu nefunguje
Pokud používáte vložení přes iframe, rozbalovací menu se bude rolovat uvnitř widgetu. Pro plnou funkčnost menu s překrytím použijte místo toho vložení skriptem.
Konflikty stylů
Pokud CSS vašeho webu ovlivňuje vzhled widgetu, zkuste použít vložení přes iframe, které widget izoluje od stylů vaší stránky.
Problémy s Content Security Policy
Pokud máte přísné CSP, možná budete muset přidat currency.wiki do povolených script-src a frame-src direktiv. Příklad: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Potřebujete pomoc?
Nemůžete najít, co hledáte? Náš tým podpory je tu pro vás.
