#תוסף

ב-NocoBase, תוסף צד-שרת (Server Plugin) מציע דרך מודולרית להרחבת והתאמת הפונקציונליות של צד השרת. מפתחים יכולים להרחיב את מחלקת ה-Plugin מתוך @nocobase/server כדי לרשום אירועים, ממשקי API, הגדרות הרשאות ולוגיקה מותאמת אישית אחרת בשלבי מחזור חיים שונים.

#מחלקת התוסף

מבנה מחלקת תוסף בסיסית נראה כך:

import { Plugin } from '@nocobase/server';

export class PluginHelloServer extends Plugin {
  async afterAdd() {}

  async beforeLoad() {}

  async load() {}

  async install() {}

  async afterEnable() {}

  async afterDisable() {}

  async remove() {}

  async handleSyncMessage(message: Record<string, any>) {}

  static async staticImport() {}
}

export default PluginHelloServer;

#מחזור חיים

שיטות מחזור החיים של התוסף מבוצעות לפי הסדר הבא, ולכל שיטה יש עיתוי וייעוד ספציפיים משלה:

#תיאור סדר הביצוע

זרימת הביצוע הטיפוסית של שיטות מחזור החיים:

1. שלב אתחול סטטי: staticImport()
2. שלב הפעלת היישום: afterAdd() → beforeLoad() → load()
3. שלב הפעלת תוסף ראשונית: afterAdd() → beforeLoad() → load() → install()
4. שלב הפעלת תוסף חוזרת: afterAdd() → beforeLoad() → load()
5. שלב השבתת תוסף: afterDisable() מבוצעת כאשר התוסף מושבת.
6. שלב מחיקת תוסף: remove() מבוצעת כאשר התוסף נמחק.

#app וחברים קשורים

בפיתוח תוספים, ניתן לגשת למגוון ממשקי ה-API שמספק מופע היישום דרך this.app, וזהו ממשק הליבה להרחבת פונקציונליות התוסף. אובייקט ה-app מכיל את מודולי הפונקציונליות השונים של המערכת. מפתחים יכולים להשתמש במודולים אלה בשיטות מחזור החיים של התוסף כדי ליישם דרישות עסקיות.

#רשימת חברי app

הערה: לשימוש מפורט בכל מודול, אנא עיינו בפרקי התיעוד המתאימים.