Վիջեթի փաստաթղթավորում
Լրիվ ուղեցույց՝ 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>
- Լիովին մեկուսացված ձեր էջի ոճերից
- Աշխատում է խիստ CSP-ով
- Պարզ և անվտանգ իրականացում
Նշում․ Օգտագործեք Սկրիպտի ներդրում՝ լիարժեք ինտերակտիվության համար (ցանկերը ցուցադրվում են բովանդակության վրա): Օգտագործեք 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, կարող է անհրաժեշտ լինել currency.wiki-ն ավելացնել թույլատրելի script-src և frame-src ցուցակներում։ Օրինակ՝ script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Օգնության կարիք ունե՞ք։
Չե՞ք գտնում այն, ինչ փնտրում եք։ Մեր աջակցման թիմը պատրաստ է օգնել։