Logrīka dokumentācija
Pilnīga rokasgrāmata par Currency.Wiki valūtas konvertētāja logrīka ievietošanu un pielāgošanu jūsu vietnē.
Satura rādītājs
1 Darba sākšana
Valūtas konvertētāja logrīka pievienošana jūsu vietnei ir vienkārša. Izpildiet šos soļus:
- Dodieties uz Logrīka veidotāja lapu un pielāgojiet logrīka izskatu
- Izvēlieties vēlamo logrīka stilu, valūtas un motīvu
- Nokopējiet ģenerēto iegulšanas kodu (skripts vai iframe)
- Ielīmējiet kodu savas vietnes HTML, kur vēlaties, lai logrīks parādās
Padoms: Izmantojiet ātrās sākuma sagataves Logrīka veidotājā, lai ātri sāktu ar iepriekš konfigurētu logrīku.
2 Iegulšanas metodes
Skripta iegulšana (ieteicams)
Skripta iegulšanas metode ievieto logrīku tieši jūsu lapā. Valūtu izvēlnes tiks rādītas virs apkārtējā satura ērtai izvēlei.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Izvēlnes tiek rādītas ārpus logrīka konteinera
- Vislabāk piemērots interaktīvai valūtu izvēlei
- Nevainojama integrācija ar jūsu lapu
Iframe iegulšana
Iframe iegulšanas metode izveido izolētu konteineru logrīkam. Šī metode ir droša un darbojas vidēs ar stingriem satura drošības noteikumiem.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Pilnībā izolēts no jūsu lapas stiliem
- Darbojas ar stingriem satura drošības noteikumiem
- Vienkārša un droša ieviešana
Piezīme: Izmantojiet skripta iegulšanu pilnai interaktivitātei (izvēlnes tiek rādītas virs satura). Izmantojiet iframe iegulšanu, ja nepieciešama izolācija vai ir CSP ierobežojumi.
3 Logrīka stili
Izvēlieties no 11 dažādiem logrīka stiliem, lai saskaņotu ar jūsu vietnes dizainu. Katrs stils ir optimizēts dažādiem lietošanas gadījumiem un attēlošanas izmēriem.
mini
250x140px
Kompakts vienas rindas konvertētājs. Ideāli piemērots galvenēm vai šaurām vietām.
square
250x250px
1:1 attiecības logrīks ar maiņas pogu. Lieliski piemērots sānu joslām.
compact
300x180px
Neliela izmēra konvertētājs ar visām būtiskajām funkcijām.
inline
480x56px
Horizontāls izkārtojums. Ideāli piemērots ievietošanai saturā vai navigācijā.
tall
200x280px
Vertikāls sānu joslas izkārtojums ar klasiskām etiķetēm.
mini-chart
250x260px
Kompakts konvertētājs ar līknes diagrammu, kas rāda kursu vēsturi.
multi-expandable
300x320px
Vairāku valūtu konvertētājs. Lietotāji var pievienot/noņemt valūtas.
multi-fixed
300x300px
Fiksēts kursu saraksts. Vislabāk piemērots konkrētu kursu attēlošanai.
rates-compact
250x320px
Kompakts kursu saraksts ar pēdējā atjauninājuma laiku.
rates-viewer
300x500px
Pilna diagrammas skata logrīks ar detalizētu kursu informāciju.
rates-viewer-compact
300x400px
Kompakta kursu skatītāja versija ar diagrammām.
4 URL parametri
Pielāgojiet savu logrīku, izmantojot URL parametrus. Šie parametri darbojas gan ar skripta, gan iframe iegulšanas metodēm.
| Parametrs | Noklusējums | Apraksts |
|---|---|---|
| style | compact | Logrīka stils (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Krāsu motīvs (light, dark vai auto) |
| from | USD | Avota valūtas kods (piem., USD, EUR, GBP) |
| to | EUR | Mērķa valūtas kods (piem., EUR, USD, JPY) |
| amount | 1000 | Noklusētā summa konvertācijai |
| accent | #2563eb | Akcenta krāsa heksadecimālā formātā (bez #) |
| lang | en | Logrīka valodas kods (piem., en, es, fr, de) |
| flags | 1 | Rādīt valstu karogus (1=rādīt, 0=nerādīt) |
| display | iso | Valūtas attēlošanas formāts (iso=USD, symbol=$) |
| lock | 0 | Bloķēt valūtas (1=bloķēts, 0=atbloķēts) |
| currencies | EUR,GBP,JPY | Ar komatu atdalīts valūtu saraksts vairāku valūtu logrīkiem |
| dropdown | all | Valūtas izvēlnē (all, top10, top20 vai ar komatu atdalīts saraksts) |
| branding | 1 | Rādīt zīmolu (1=rādīt, 0=nerādīt) |
| brandinglink | 1 | Padarīt zīmolu klikšķināmu (1=saite, 0=tikai teksts) |
| format | auto | Skaitļu formāts (auto, us, eu, french, indian) |
| decimals | 2 | Zīmju skaits aiz komata (0-6) |
| chart | 0 | Ieslēgt diagrammu (1=ieslēgts, 0=izslēgts) |
| chartperiod | 7d | Diagrammas periods (7d, 14d, 30d, 90d) |
Piemēri
Tumšais motīvs, kompakts konvertētājs:
?style=compact&theme=dark&from=USD&to=EUR
Vairāku valūtu kursi:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
Mini konvertētājs ar 30 dienu diagrammu:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Rādīt valūtas simbolus koda vietā:
?style=compact&display=symbol&from=USD&to=EUR
Bloķētas valūtas ar pielāgotu summu:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Pielāgošanas iespējas
Motīva opcijas
- light - Gaišs fons ar tumšu tekstu
- dark - Tumšs fons ar gaišu tekstu
- auto - Automātiski pielāgojas lietotāja sistēmas iestatījumiem
Valūtas attēlošanas formāts
- iso - Rāda ISO kodus, piemēram, USD, EUR, GBP
- symbol - Rāda valūtas simbolus, piemēram, $, €, £
Skaitļu formāti
- auto - Automātiski nosaka apmeklētāja pārlūkprogrammas iestatījumus
- us - ASV formāts: 1,234.56
- eu - Eiropas formāts: 1.234,56
- french - Franču formāts: 1 234,56
- indian - Indijas formāts: 1,23,456.78
Izkrītošās izvēlnes valūtu opcijas
- all - Visas 170+ atbalstītās valūtas
- top10 - Top 10 populārākās valūtas
- top20 - Top 20 valūtas pēc tirdzniecības apjoma
- USD,EUR,GBP,... - Pielāgots konkrētu valūtu saraksts
Padoms: Izmantojiet Logrīka veidotāju, lai vizuāli konfigurētu visas šīs opcijas un automātiski ģenerētu iegulšanas kodu.
6 Problēmu novēršana
Logrīks nerādās
Pārliecinieties, ka iegulšanas kods ir pareizi ievietots jūsu HTML. Skripta iegulšanas gadījumā pārliecinieties, ka konteinera div ir ar pareizo ID. Pārbaudiet pārlūkprogrammas konsoli, vai nav JavaScript kļūdu.
Izvēlne nedarbojas
Ja izmantojat iframe iegulšanu, izvēlnes ritinās logrīka ietvaros. Pilnai izvēlnes funkcionalitātei ar pārklājumiem izmantojiet skripta iegulšanas metodi.
Stilu konflikti
Ja jūsu vietnes CSS ietekmē logrīka izskatu, izmēģiniet iframe iegulšanas metodi, kas izolē logrīka stilus no jūsu lapas.
Satura drošības politikas problēmas
Ja jums ir stingra CSP, iespējams, jāpieļauj currency.wiki jūsu script-src un frame-src direktīvās. Piemērs: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Nepieciešama palīdzība?
Nevarat atrast, ko meklējat? Mūsu atbalsta komanda ir gatava palīdzēt.
