Vidjet Sənədləşməsi
Currency.Wiki valyuta çevirici vidjetinin vebsaytınıza yerləşdirilməsi və fərdiləşdirilməsi üçün tam bələdçi.
Mündəricat
1 Başlanğıc
Vebsaytınıza valyuta çevirici vidjeti əlavə etmək asandır. Bu sadə addımları izləyin:
- Vidjet Qurucusu səhifəsinə keçin və vidjetin görünüşünü fərdiləşdirin
- Sevdiyiniz vidjet üslubu, valyutalar və mövzu seçin
- Yaradılmış əlavə kodunu (Skript və ya Iframe) kopyalayın
- Kodu vebsaytınızın HTML hissəsinə, vidjetin görünməsini istədiyiniz yerə yapışdırın
Məsləhət: Vidjet Qurucusunda Sürətli Başlanğıc Şablonlarından istifadə edərək tez bir zamanda əvvəlcədən qurulmuş vidjetlə başlayın.
2 Əlavə Üsulları
Skript Əlavə (Tövsiyə olunur)
Skript əlavə üsulu vidjeti birbaşa səhifənizə yerləşdirir. Valyuta açılan menyuları istifadəçilər üçün asan seçim üçün ətrafdakı məzmunun üzərində göstəriləcək.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Açılan menyular vidjet konteynerindən kənarda göstərilir
- İnteraktiv valyuta seçimi üçün ən yaxşısıdır
- Səhifənizlə problemsiz inteqrasiya
Iframe Əlavə
Iframe əlavə üsulu vidjet üçün izolyasiya olunmuş konteyner yaradır. Bu üsul təhlükəsizdir və sərt məzmun siyasəti olan mühitlərdə işləyir.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Səhifə üslublarınızdan tamamilə izolyasiya olunub
- Sərt Məzmun Təhlükəsizlik Siyasəti ilə işləyir
- Sadə və təhlükəsiz tətbiq
Qeyd: Tam interaktivlik üçün Skript əlavə istifadə edin (açılan menyular məzmunun üzərində göstərilir). İzolyasiya və ya CSP məhdudiyyətləri olduqda Iframe əlavə istifadə edin.
3 Vidjet Üslubları
Vebsaytınızın dizaynına uyğun 11 fərqli vidjet üslubundan birini seçin. Hər üslub müxtəlif istifadə halları və ekran ölçüləri üçün optimallaşdırılıb.
mini
250x140px
Başlıqlar və dar yerlər üçün ideal olan kompakt tək sətirli çevirici.
square
250x250px
1:1 nisbətli, dəyişmə düyməli vidjet. Yan panellər üçün əladır.
compact
300x180px
Bütün əsas funksiyalara malik kiçik ölçülü çevirici.
inline
480x56px
Üfüqi düzülüş. Məzmun və ya naviqasiyada yerləşdirmək üçün ideal.
tall
200x280px
Klassik etiketli şaquli yan panel düzülüşü.
mini-chart
250x260px
Kurs tarixçəsini göstərən qrafikli kompakt çevirici.
multi-expandable
300x320px
Çox valyutalı çevirici. İstifadəçilər valyuta əlavə/silmə edə bilər.
multi-fixed
300x300px
Sabit məzənnə siyahısı. Xüsusi kursların göstərilməsi üçün uyğundur.
rates-compact
250x320px
Son yenilənmə vaxtı ilə sıxılmış məzənnə siyahısı.
rates-viewer
300x500px
Ətraflı kurs məlumatı ilə tam qrafik görünüş.
rates-viewer-compact
300x400px
Qrafikli kurs izləyicisinin kompakt versiyası.
4 URL Parametrləri
Vidjetinizi URL parametrləri ilə fərdiləşdirin. Bu parametrlər həm Skript, həm də Iframe əlavə üsulları ilə işləyir.
| Parametr | Defolt | Təsvir |
|---|---|---|
| style | compact | Vidjet üslubu (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Rəng mövzusu (açıq, tünd və ya avtomatik) |
| from | USD | Mənbə valyuta kodu (məs., USD, EUR, GBP) |
| to | EUR | Hədəf valyuta kodu (məs., EUR, USD, JPY) |
| amount | 1000 | Konvertasiya üçün defolt məbləğ |
| accent | #2563eb | Vurğu rəngi hex formatında (# olmadan) |
| lang | en | Vidjet dil kodu (məs., en, es, fr, de) |
| flags | 1 | Ölkə bayraqlarını göstər (1=göstər, 0=gizlət) |
| display | iso | Valyuta göstərmə formatı (iso=USD, symbol=$) |
| lock | 0 | Valyutaları kilidlə (1=kilidli, 0=kilidsiz) |
| currencies | EUR,GBP,JPY | Çox valyutalı vidjetlər üçün vergüllə ayrılmış valyutalar siyahısı |
| dropdown | all | Açılan menyudakı valyutalar (all, top10, top20 və ya vergüllə ayrılmış siyahı) |
| branding | 1 | Brendi göstər (1=göstər, 0=gizlət) |
| brandinglink | 1 | Brendi kliklənə bilən et (1=link, 0=yalnız mətn) |
| format | auto | Rəqəm formatı (auto, us, eu, french, indian) |
| decimals | 2 | Onluq yerlərin sayı (0-6) |
| chart | 0 | Qrafiki aktiv et (1=aktiv, 0=passiv) |
| chartperiod | 7d | Qrafik dövrü (7d, 14d, 30d, 90d) |
Nümunələr
Tünd mövzu kompakt çevirici:
?style=compact&theme=dark&from=USD&to=EUR
Çox valyutalı məzənnələr:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
30 günlük qrafikli mini çevirici:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Valyuta kodları əvəzinə simvolları göstər:
?style=compact&display=symbol&from=USD&to=EUR
Fərdi məbləğlə kilidli valyutalar:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Fərdiləşdirmə Seçimləri
Mövzu Seçimləri
- light - Açıq fon, tünd mətn
- dark - Tünd fon, açıq mətn
- auto - İstifadəçinin sistem ayarına avtomatik uyğunlaşır
Valyuta Göstərmə Formatı
- iso - USD, EUR, GBP kimi ISO kodlarını göstərir
- symbol - $, €, £ kimi valyuta simvollarını göstərir
Rəqəm Formatları
- auto - Ziyarətçinin brauzer ayarlarını avtomatik aşkar edir
- us - ABŞ formatı: 1,234.56
- eu - Avropa formatı: 1.234,56
- french - Fransız formatı: 1 234,56
- indian - Hind formatı: 1,23,456.78
Açılan Valyuta Seçimləri
- all - 170+ dəstəklənən valyutanın hamısı
- top10 - Ən populyar 10 valyuta
- top20 - Ticarət həcminə görə Top 20 valyuta
- USD,EUR,GBP,... - Xüsusi valyutalar siyahısı
Məsləhət: Bütün bu seçimləri vizual olaraq konfiqurasiya etmək və əlavə kodunu avtomatik yaratmaq üçün Vidjet Qurucusundan istifadə edin.
6 Problemlərin Həlli
Vidjet Göstərilmir
Əlavə kodunun HTML-də düzgün yerləşdirildiyinə əmin olun. Skript əlavə üçün konteyner div-in düzgün ID ilə mövcud olduğuna baxın. Brauzer konsolunda hər hansı JavaScript xətası yoxlayın.
Açılan Menyu İşləmir
Əgər iframe yerləşdirməsindən istifadə edirsinizsə, açılan siyahılar vidjet sahəsinin içində sürüşəcək. Tam açılan siyahı funksionallığı və örtüklərlə istifadə üçün skript yerləşdirmə üsulundan istifadə edin.
Stil Ziddiyyətləri
Əgər saytınızın CSS-i vidjetin görünüşünə təsir edirsə, vidjetin üslublarını səhifənizdən ayıran iframe yerləşdirmə üsulunu sınayın.
Məzmun Təhlükəsizliyi Siyasəti Problemləri
Əgər sərt CSP istifadə edirsinizsə, allowed script-src və frame-src direktivlərinə currency.wiki əlavə etməlisiniz. Nümunə: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Köməyə ehtiyacınız var?
Axtardığınızı tapa bilmirsiniz? Dəstək komandamız sizə kömək etməyə hazırdır.
