תוספים
תוספים מרחיבים את Ogma באמצעות עמודי ממשק מותאמים אישית, עיבוד בצד השרת, נקודות חיבור לאירועים ולוחות הגדרות, והכול בכפוף להרשאות שהתוסף מצהיר עליהן.
מה תוספים יכולים להוסיף
- עמודי ממשק מותאמים אישית הנגישים מהניווט משמאל.
- נתיבים בצד השרת המעבדים בקשות או תגובות.
- נקודות חיבור לאירועים המופעלות בעקבות תעבורה שנלכדה.
- עמודי הגדרות לתצורה ייעודית של התוסף.
- פקודות שניתן לרשום בלוח הפקודות.
התקנה מתיקייה
- לחצו על התקנה בתצוגת התוספים.
- בחרו נתיב התיקייה.
- בחרו את תיקיית השורש של התוסף. התיקייה חייבת להכיל מניפסט תקין של התוסף ואת הקבצים המוצהרים במניפסט.
- Ogma מאמת את החבילה ורושם אותה.
- הפעילו את התוסף כדי להכניסו לפעולה.
התקנה מארכיון Zip
- לחצו על התקנה בתצוגת התוספים.
- בחרו קובץ ZIP.
- בחרו את קובץ
.zipשל התוסף. - בדקו את שם התוסף והגרסה שזוהו.
- לחצו על התקנה, ואז הפעילו את התוסף.
התקנות Zip מועתקות לתיקיית התוספים שבניהול Ogma. ניתן למחוק את הארכיון המקורי לאחר ההתקנה.
אזהרות תאימות
לאחר ההתקנה, Ogma עשוי להציג אזהרות בעמוד פרטי התוסף. הן נועדו לידיעה ואינן מונעות את הפעלת התוסף.
אזהרות נפוצות:
- קבצים ללא הפניה - קבצים הנמצאים בחבילה אך אינם מוצהרים במניפסט.
- חסרה שכבת תאימות בזמן ריצה - התוסף משתמש ב-API המחייב שכבת תאימות שאינה קיימת בגרסה זו של Ogma.
בדקו את האזהרות לפני הפעלת תוסף שאינכם מכירים.
הפעלה והשבתה
שנו את המתג מופעל בשורת התוסף כדי להפעילו או להשביתו. תוספים מושבתים נשארים מותקנים אך אינם פועלים. הפעלה מחדש משחזרת את התוסף בלי להתקינו שוב.
לשוניות פרטי התוסף
בחרו תוסף כדי לפתוח את לוח הפרטים שלו. הלוח כולל את הלשוניות הבאות.
| לשונית | תוכן |
|---|---|
| סקירה כללית | שם התוסף, גרסה, מחבר, תיאור ומקור. |
| אזהרות | בעיות תאימות שזוהו בעת ההתקנה או ההפעלה. |
| הרשאות | מה התוסף ביקש ומה Ogma העניק בזמן הריצה. |
| קבצים | רשימת הקבצים בחבילת התוסף. |
| יומנים | פלט זמן הריצה של התוסף, עם הדגשת תחביר לשורות יומן מובנות. |
| ממשק | העמוד המותאם אישית של התוסף, המוצג בתוך הלוח. |
הרשאות
לשונית ההרשאות מציגה כל הרשאה שהתוסף הצהיר עליה במניפסט ואת מצב ההענקה הנוכחי. קריאות לצד השרת נאכפות בשרת. הממשק משקף את המצב העדכני של כל הרשאה.
אם תוסף אינו פועל כמצופה, בדקו בלשונית ההרשאות שההרשאות הנדרשות הוענקו.
מצב פיתוח
תוספים המותקנים מתיקייה מציגים תג פיתוח וכפתור טעינה מחדש.
לחצו על טעינה מחדש כדי להחיל שינויי קוד בלי התקנה מחדש. התוסף מופעל מחדש ורושם שוב את כל נקודות החיבור והנתיבים. זהו מחזור העבודה המקובל למפתחי תוספים.
תוספים במצב פיתוח נשארים מקושרים לתיקיית המקור. שינויים בקבצים בתיקייה זו נכנסים לתוקף בטעינה מחדש הבאה.
חנות התוספים
לשונית חנות תוספים מציגה תוספים מהקהילה מתוך מאגר Awesome Ogma Plugins.
- עיינו ברשימת התוספים או חפשו בה.
- לחצו על תוסף כדי לראות את תיאורו, גרסתו ומטא-נתוני התאימות.
- לחצו על התקנה להתקנה ישירה.
- אם קיימת גרסה תואמת חדשה יותר לתוסף מותקן מהחנות, הפעולה משתנה ל-עדכון.
התקנה מהחנות מחייבת חיבור לרשת כדי להוריד את החבילה.