#ปลั๊กอิน

ใน NocoBase นั้น Server Plugin (ปลั๊กอินฝั่งเซิร์ฟเวอร์) เป็นวิธีที่ช่วยให้เราสามารถขยายและปรับแต่งฟังก์ชันการทำงานของฝั่งเซิร์ฟเวอร์ได้อย่างเป็นระบบครับ/ค่ะ นักพัฒนาสามารถสร้างปลั๊กอินได้โดยการสืบทอด (extend) คลาส Plugin จาก @nocobase/server เพื่อลงทะเบียนเหตุการณ์ (events), API, การตั้งค่าสิทธิ์ (permission configurations) และตรรกะที่กำหนดเองอื่น ๆ ในช่วงชีวิต (lifecycle) ต่าง ๆ ของปลั๊กอินได้เลยครับ/ค่ะ

#คลาสปลั๊กอิน

โครงสร้างคลาสปลั๊กอินพื้นฐานมีดังนี้ครับ/ค่ะ:

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;

#ช่วงชีวิต (Lifecycle)

เมธอดช่วงชีวิตของปลั๊กอินจะทำงานตามลำดับต่อไปนี้ครับ/ค่ะ โดยแต่ละเมธอดก็จะมีช่วงเวลาและวัตถุประสงค์ในการทำงานที่แตกต่างกันไป:

#ลำดับการทำงาน

ลำดับการทำงานทั่วไปของเมธอดช่วงชีวิตมีดังนี้ครับ/ค่ะ:

1. ช่วงเริ่มต้นแบบ Static: staticImport()
2. ช่วงเริ่มต้นแอปพลิเคชัน: afterAdd() → beforeLoad() → load()
3. ช่วงเปิดใช้งานปลั๊กอินครั้งแรก: afterAdd() → beforeLoad() → load() → install()
4. ช่วงเปิดใช้งานปลั๊กอินครั้งถัดไป: afterAdd() → beforeLoad() → load()
5. ช่วงปิดใช้งานปลั๊กอิน: เมธอด afterDisable() จะทำงานเมื่อปลั๊กอินถูกปิดใช้งาน
6. ช่วงลบปลั๊กอิน: เมธอด remove() จะทำงานเมื่อปลั๊กอินถูกลบ

#app และสมาชิกที่เกี่ยวข้อง

ในการพัฒนาปลั๊กอิน เราสามารถเข้าถึง API ต่าง ๆ ที่แอปพลิเคชันมีให้ผ่าน this.app ได้ครับ/ค่ะ ซึ่งเป็นอินเทอร์เฟซหลักสำหรับการขยายฟังก์ชันการทำงานของปลั๊กอิน ออบเจกต์ app จะประกอบด้วยโมดูลฟังก์ชันต่าง ๆ ของระบบ นักพัฒนาสามารถใช้โมดูลเหล่านี้ในเมธอดช่วงชีวิตของปลั๊กอินเพื่อตอบสนองความต้องการทางธุรกิจได้เลยครับ/ค่ะ

#รายการสมาชิกของ app

ข้อแนะนำ: สำหรับวิธีการใช้งานโดยละเอียดของแต่ละโมดูล โปรดดูที่บทความเอกสารที่เกี่ยวข้องครับ/ค่ะ