ვიჯეტის დოკუმენტაცია
სრული სახელმძღვანელო 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 Policy-ით
- მარტივი და უსაფრთხო განხორციელება
შენიშვნა: სრული ინტერაქტივობისთვის გამოიყენეთ სკრიპტის ჩასმა (ჩამოსაშლელები კონტენტზე ზემოთ). იზოლაციის ან CSP შეზღუდვების შემთხვევაში გამოიყენეთ Iframe ჩასმა.
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;
გჭირდებათ დახმარება?
ვერ პოულობთ რასაც ეძებთ? ჩვენი მხარდაჭერის გუნდი მზადაა დაგეხმაროთ.
