תיעוד ווידג'ט
מדריך מלא להטמעה והתאמה של ווידג'ט ממיר המטבע של Currency.Wiki באתר שלך.
תוכן עניינים
1 התחלה מהירה
הוספת ווידג'ט ממיר מטבע לאתר שלך זה קל. בצע את השלבים הפשוטים הבאים:
- גש לעמוד בונה הווידג'ט והתאם את מראה הווידג'ט
- בחר את סגנון הווידג'ט, המטבעות וערכת הנושא המועדפים עליך
- העתק את קוד ההטמעה שנוצר (Script או Iframe)
- הדבק את הקוד ל-HTML של האתר שלך במקום בו תרצה שהווידג'ט יופיע
טיפ: השתמש בהגדרות התחלה מהירה בבונה הווידג'ט כדי להתחיל במהירות עם ווידג'ט מוגדר מראש.
2 שיטות הטמעה
הטמעה ב-Script (מומלץ)
שיטת ההטמעה ב-Script מזריקה את הווידג'ט ישירות לדף שלך. תפריטי המטבע יוצגו מעל התוכן שמסביב לנוחות בחירה.
<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>
- מבודד לחלוטין מסגנונות הדף שלך
- עובד עם מדיניות אבטחת תוכן מחמירה
- יישום פשוט ומאובטח
הערה: השתמש ב-Script להטמעה אינטראקטיבית מלאה (תפריטים מוצגים מעל התוכן). השתמש ב-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. פרמטרים אלו עובדים עם שתי שיטות ההטמעה.
| פרמטר | ברירת מחדל | תיאור |
|---|---|---|
| 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 שלך. להטמעה ב-Script, ודא שמיכל ה-div קיים עם ה-ID הנכון. בדוק את קונסולת הדפדפן לשגיאות JavaScript.
התפריט הנפתח לא עובד
אם אתה משתמש בהטמעה ב-Iframe, התפריטים יגללו בתוך אזור הווידג'ט. לפונקציונליות מלאה עם שכבות-על, השתמש בשיטת ההטמעה ב-Script.
התנגשות סגנונות
אם ה-CSS של האתר שלך משפיע על מראה הווידג'ט, נסה להשתמש בהטמעה ב-Iframe שמבודדת את הסגנונות.
בעיות מדיניות אבטחת תוכן
אם יש לך CSP מחמיר, ייתכן שתצטרך להוסיף את currency.wiki ל-script-src ו-frame-src שלך. דוגמה: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
