ใช้งานปลั๊กอิน
สิทธิ์ที่ปลั๊กอินขอ
อ่านหน้าต่างอนุมัติสิทธิ์ให้เข้าใจ — permission ของแพ็กเกจ สิทธิ์ของโค้ด (scopes) สิทธิ์ API ของ service และโดเมนที่ปลั๊กอินเชื่อมต่อ
ในหน้านี้
ปลั๊กอินทำได้เฉพาะสิ่งที่ประกาศไว้และผู้ดูแลอนุมัติแล้ว ทั้งตอนติดตั้ง ตอนเปิดใช้ และเมื่อเวอร์ชันใหม่ขอเพิ่ม รายการเดียวกันนี้แสดงบนหน้าปลั๊กอินในเว็บของร้าน (สิทธิ์ที่ปลั๊กอินใช้) ด้วย
Permission ของแพ็กเกจ#
| permission | ความหมายในหน้าจัดการ |
|---|---|
head | เพิ่มโค้ดในส่วน head ของหน้าเว็บ (ไฟล์ .css/.js ทุกหน้า) |
bodyEnd | เพิ่ม HTML/สคริปต์ท้ายหน้าเว็บ |
blocks | เพิ่มบล็อกในหน้าออกแบบ |
settings | มีหน้าตั้งค่าของตัวเอง |
webhooks | ส่งข้อมูลเหตุการณ์ (เช่น มีบทความใหม่) ไปยังเว็บภายนอก |
code | รันโค้ด JavaScript บนเซิร์ฟเวอร์ของเว็บ (ตามสิทธิ์ของโค้ดด้านล่าง) |
service | มีโปรแกรมฝั่งเซิร์ฟเวอร์ของตัวเอง (WebAssembly ใน CMS หรือโปรแกรมแยก) |
สิทธิ์ของโค้ด (ปลั๊กอิน JavaScript)#
| scope | ทำอะไรได้ |
|---|---|
db | ตารางข้อมูลของตัวเองและ migration (ตาราง p_<id>_* เท่านั้น) |
content | อ่านบทความและหน้าเว็บ |
content-write ⚠ | สร้าง แก้ไข และลบบทความ/หน้าเว็บ (รวมถึงในสิทธิ์ระบบ) |
content-fields ⚠ | เพิ่มช่องข้อมูลในหน้าแก้ไขโพสต์/หน้า (เก็บใน post meta ของปลั๊กอินเอง) |
mail ⚠ | ส่งอีเมลจากเว็บ |
http ⚠ | เรียกเว็บภายนอก เฉพาะโดเมนที่ปลั๊กอินประกาศ และ ที่แอดมินอนุญาต |
webhooks ⚠ | ส่ง webhook ไปยัง URL ใดก็ได้ (เฉพาะที่อยู่สาธารณะ) |
visitor ⚠ | ระบุตัวตนผู้เยี่ยมชม/สมาชิกของเว็บ |
filters-core ⚠ | แก้ไขข้อมูลของระบบผ่านตัวกรองหลัก (เนื้อหา, head, อีเมล…) |
routes | เพิ่มหน้า/ที่อยู่สาธารณะบนเว็บ (เฉพาะพาธที่ประกาศ) |
post-types | ประกาศประเภทเนื้อหาของตัวเอง (ตั้งแต่ CMS 2.0.5) |
admin-pages | เพิ่มหน้าในหลังบ้าน วิดเจ็ตแดชบอร์ด และแถบแจ้งเตือน |
jobs | งานเบื้องหลังและงานตามเวลา (cron) |
middleware | ทำงานก่อนทุกคำขอหน้าเว็บสาธารณะ (ตอบแทนหน้าเว็บ หรือ redirect ได้) |
head-scripts | แทรกสคริปต์/HTML ที่ไม่ผ่านการกรองลงในทุกหน้าเว็บ |
⚠ = หน้าจัดการทำเครื่องหมาย สิทธิ์สำคัญ — ตรวจสอบให้แน่ใจว่าเชื่อถือผู้พัฒนา
head-scripts เทียบเท่าการใส่โค้ด HTML ดิบลงทุกหน้า และ middleware ตอบแทนหน้าเว็บได้ทุกหน้า แม้หน้าจัดการจะไม่ได้ติดป้ายเตือน ก็ควรอนุมัติเฉพาะปลั๊กอินที่เชื่อถือได้ เช่น ปลั๊กอินทางการ Custom code และ Maintenance
ปลั๊กอิน JavaScript ไม่ได้ สิทธิ์ SQL ตรง (db.query) ไม่เห็นตารางของ CMS หรือของปลั๊กอินอื่น และไม่เห็นคุกกี้ของระบบหรือของปลั๊กอินอื่น
สิทธิ์ API ของ service (WebAssembly / service ภายนอก)#
| สิทธิ์ | ความหมาย |
|---|---|
site | อ่านข้อมูลเว็บ (ชื่อ โลโก้ ธีม) |
mail | ส่งอีเมลผ่านระบบอีเมลของเว็บ |
content | อ่านบทความและหน้าเว็บที่เผยแพร่ |
users | อ่านข้อมูลผู้ใช้ (ชื่อ อีเมล ตำแหน่ง) |
events | ส่งเหตุการณ์ให้ปลั๊กอินอื่น |
storage | เก็บข้อมูลของตัวเองในที่เก็บของปลั๊กอิน |
http | เรียกบริการภายนอกเฉพาะโดเมนที่ระบุ (เช่น ระบบชำระเงิน) |
เมื่อเวอร์ชันใหม่ขอสิทธิ์เพิ่ม#
ถ้าการอัปเดตขอ permission, scope, สิทธิ์ API หรือโดเมนที่เวอร์ชันเดิมไม่มี ระบบจะ:
- อัปเดตไฟล์ แต่ ปิดปลั๊กอินไว้ก่อน
- แสดงข้อความ "เวอร์ชันนี้ขอสิทธิ์เพิ่มจาก vX — ปิดไว้จนกว่าคุณจะอนุมัติ" พร้อมรายการที่ขอเพิ่ม
- เปิดใช้อีกครั้งเมื่อผู้ดูแลกด อนุมัติและเปิดใช้
ดูสิทธิ์ของปลั๊กอินที่ติดตั้งแล้ว#
การ์ดในแท็บ ที่ติดตั้งเพิ่ม แสดงสิทธิ์ของโค้ด, ที่อยู่บนเว็บที่ใช้, โดเมนที่เรียกได้ และปลั๊กอินที่ต้องใช้ โดเมนที่ปลั๊กอินเรียกด้วย http ต้องอยู่ในรายการที่อนุญาตของเว็บด้วย (ตั้งที่ โค้ดของเว็บไซต์ → ค่าลับและการตั้งค่า)
