Vidjet hujjatlari
Saytingizga Currency.Wiki valyuta konvertori vidjetini joylashtirish va sozlash bo‘yicha to‘liq qo‘llanma.
Mundarija
1 Boshlash
Saytingizga valyuta konvertori vidjetini qo‘shish juda oson. Quyidagi oddiy bosqichlarni bajaring:
- Vidjet quruvchisi sahifasiga o‘ting va vidjet ko‘rinishini sozlang
- O‘zingizga yoqqan vidjet uslubi, valyutalar va mavzuni tanlang
- Yaratilgan joylashtirish kodini (Skript yoki Iframe) nusxalang
- Koddan vidjet chiqishini istagan joyga saytingiz HTML’iga joylashtiring
Maslahat: Vidjet quruvchisidagi tez boshlash andozalaridan foydalanib, oldindan sozlangan vidjet bilan tezda boshlang.
2 Joylashtirish usullari
Skript joylashtirish (tavsiya etiladi)
Skript joylashtirish usuli vidjetni to‘g‘ridan-to‘g‘ri sahifangizga joylashtiradi. Valyuta ochiladigan menyulari atrofdagi kontent ustida ko‘rinadi.
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- Ochiladigan menyular vidjet konteyneridan tashqarida ko‘rinadi
- Interaktiv valyuta tanlash uchun eng yaxshi
- Sahifangiz bilan mukammal integratsiya
Iframe joylashtirish
Iframe joylashtirish usuli vidjet uchun izolyatsiyalangan konteyner yaratadi. Ushbu usul xavfsiz va qat’iy kontent siyosatiga ega muhitlarda ishlaydi.
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- Sahifa uslublaridan to‘liq izolyatsiyalangan
- Qat’iy Kontent Xavfsizlik Siyosati bilan ishlaydi
- Oddiy va xavfsiz amalga oshirish
Eslatma: To‘liq interaktivlik uchun Skript joylashtirishdan foydalaning (ochiladigan menyular kontent ustida ko‘rinadi). Izolyatsiya yoki CSP cheklovlari kerak bo‘lsa, Iframe joylashtirishdan foydalaning.
3 Vidjet uslublari
Saytingiz dizayniga mos 11 xil vidjet uslubidan tanlang. Har bir uslub turli foydalanish holatlari va ko‘rsatish o‘lchamlari uchun optimallashtirilgan.
mini
250x140px
Kichik bir qatorli konvertor. Sarlavhalar yoki tor joylar uchun ideal.
square
250x250px
1:1 nisbatli vidjet almashtirish tugmasi bilan. Yon panellar uchun yaxshi.
compact
300x180px
Barcha asosiy funksiyalarga ega kichik konvertor.
inline
480x56px
Gorizontal joylashuv. Kontent yoki navigatsiyaga joylashtirish uchun ideal.
tall
200x280px
Klassik yorliqlarga ega vertikal yon panel.
mini-chart
250x260px
Kurslar tarixi ko‘rsatilgan mini grafikli kichik konvertor.
multi-expandable
300x320px
Ko‘p valyutali konvertor. Foydalanuvchilar valyutalarni qo‘shib/olib tashlashi mumkin.
multi-fixed
300x300px
Fiksatsiyalangan kurslar ro‘yxati. Maxsus kurslarni ko‘rsatish uchun eng yaxshi.
rates-compact
250x320px
So‘nggi yangilanish vaqti bilan ixcham kurslar ro‘yxati.
rates-viewer
300x500px
To‘liq grafik ko‘rinish va batafsil kurs ma’lumotlari.
rates-viewer-compact
300x400px
Grafikli kurslar ko‘ruvchisining ixcham versiyasi.
4 URL parametrlari
Vidjetingizni URL parametrlari yordamida sozlang. Ushbu parametrlardan Skript va Iframe joylashtirish usullari uchun foydalanish mumkin.
| Parametr | Standart | Tavsif |
|---|---|---|
| style | compact | Vidjet uslubi (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | Rang mavzusi (yorug‘, qorong‘i yoki avto) |
| from | USD | Manba valyuta kodi (masalan, USD, EUR, GBP) |
| to | EUR | Maqsad valyuta kodi (masalan, EUR, USD, JPY) |
| amount | 1000 | Konvertatsiya uchun standart miqdor |
| accent | #2563eb | Aksent rangi (hex formatda, #siz) |
| lang | en | Vidjet tili kodi (masalan, en, es, fr, de) |
| flags | 1 | Davlat bayroqlarini ko‘rsatish (1=ko‘rsatish, 0=berkitish) |
| display | iso | Valyuta ko‘rsatish formati (iso=USD, symbol=$) |
| lock | 0 | Valyutalarni bloklash (1=bloklangan, 0=bloklanmagan) |
| currencies | EUR,GBP,JPY | Ko‘p valyutali vidjetlar uchun vergul bilan ajratilgan valyutalar ro‘yxati |
| dropdown | all | Ochiladigan menyudagi valyutalar (all, top10, top20 yoki vergul bilan ajratilgan ro‘yxat) |
| branding | 1 | Brendni ko‘rsatish (1=ko‘rsatish, 0=berkitish) |
| brandinglink | 1 | Brendni bosiladigan qilish (1=havola, 0=faqat matn) |
| format | auto | Raqam formati (auto, us, eu, french, indian) |
| decimals | 2 | Kasr sonlar soni (0-6) |
| chart | 0 | Grafikni yoqish (1=yoqilgan, 0=o‘chirilgan) |
| chartperiod | 7d | Grafik davri (7d, 14d, 30d, 90d) |
Misollar
Qorong‘i mavzudagi ixcham konvertor:
?style=compact&theme=dark&from=USD&to=EUR
Ko‘p valyutali kurslar:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
30 kunlik grafik bilan mini konvertor:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
Valyuta kodlari o‘rniga belgilarni ko‘rsatish:
?style=compact&display=symbol&from=USD&to=EUR
Maxsus miqdor va bloklangan valyutalar:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 Sozlash variantlari
Mavzu variantlari
- light - Yorug‘ fon va qorong‘i matn
- dark - Qorong‘i fon va yorug‘ matn
- auto - Foydalanuvchi tizimi sozlamasiga avtomatik moslashadi
Valyuta ko‘rsatish formati
- iso - USD, EUR, GBP kabi ISO kodlarini ko‘rsatadi
- symbol - $, €, £ kabi valyuta belgilarini ko‘rsatadi
Raqam formatlari
- auto - Tashrif buyuruvchining brauzer sozlamasini avtomatik aniqlaydi
- us - AQSh formati: 1,234.56
- eu - Yevropa formati: 1.234,56
- french - Fransuz formati: 1 234,56
- indian - Hind formati: 1,23,456.78
Ochiladigan menyu variantlari
- all - Qo‘llab-quvvatlanadigan 170+ valyutaning barchasi
- top10 - Eng mashhur 10 ta valyuta
- top20 - Savdo hajmi bo‘yicha Top 20 valyuta
- USD,EUR,GBP,... - Maxsus valyutalar ro‘yxati
Maslahat: Barcha ushbu variantlarni vizual tarzda sozlash va joylashtirish kodini avtomatik yaratish uchun Vidjet quruvchisidan foydalaning.
6 Nosozliklarni bartaraf etish
Vidjet ko‘rinmayapti
Joylashtirish kodi HTML’da to‘g‘ri joylashtirilganiga ishonch hosil qiling. Skript joylashtirishda konteyner div to‘g‘ri ID bilan mavjud bo‘lishi kerak. Brauzer konsolida JavaScript xatolarini tekshiring.
Ochiladigan menyu ishlamayapti
Iframe joylashtirishda ochiladigan menyular vidjet ichida aylantiriladi. To‘liq funksionallik uchun skript joylashtirish usulidan foydalaning.
Uslub to‘qnashuvi
Agar saytingiz CSS’i vidjet ko‘rinishiga ta’sir qilsa, vidjet uslublarini izolyatsiya qilish uchun iframe joylashtirish usulidan foydalaning.
Kontent Xavfsizlik Siyosati muammolari
Agar qat’iy CSP bo‘lsa, currency.wiki’ni script-src va frame-src direktivalaringizga qo‘shishingiz kerak bo‘lishi mumkin. Misol: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
Yordam kerakmi?
Qidirayotgan ma’lumotni topa olmadingizmi? Bizning qo‘llab-quvvatlash jamoamiz yordam beradi.
