# สิทธิ์ที่ปลั๊กอินขอ

> อ่านหน้าต่างอนุมัติสิทธิ์ให้เข้าใจ — permission ของแพ็กเกจ สิทธิ์ของโค้ด (scopes) สิทธิ์ API ของ service และโดเมนที่ปลั๊กอินเชื่อมต่อ

ที่มา: https://anasaki.live/docs/store/plugin-permissions

ปลั๊กอินทำได้เฉพาะสิ่งที่ประกาศไว้และผู้ดูแลอนุมัติแล้ว ทั้งตอนติดตั้ง ตอนเปิดใช้ และเมื่อเวอร์ชันใหม่ขอเพิ่ม รายการเดียวกันนี้แสดงบนหน้าปลั๊กอินในเว็บของร้าน (**สิทธิ์ที่ปลั๊กอินใช้**) ด้วย

## Permission ของแพ็กเกจ

| permission | ความหมายในหน้าจัดการ |
| --- | --- |
| `head` | เพิ่มโค้ดในส่วน head ของหน้าเว็บ (ไฟล์ .css/.js ทุกหน้า) |
| `bodyEnd` | เพิ่ม HTML/สคริปต์ท้ายหน้าเว็บ |
| `blocks` | เพิ่มบล็อกในหน้าออกแบบ |
| `settings` | มีหน้าตั้งค่าของตัวเอง |
| `webhooks` | ส่งข้อมูลเหตุการณ์ (เช่น มีบทความใหม่) ไปยังเว็บภายนอก |
| `code` | รันโค้ด JavaScript บนเซิร์ฟเวอร์ของเว็บ (ตามสิทธิ์ของโค้ดด้านล่าง) |
| `service` | มีโปรแกรมฝั่งเซิร์ฟเวอร์ของตัวเอง (WebAssembly ใน CMS หรือโปรแกรมแยก) |

## สิทธิ์ของโค้ด (ปลั๊กอิน JavaScript)

| scope | ทำอะไรได้ |
| --- | --- |
| `db` | ตารางข้อมูลของตัวเองและ migration (ตาราง `p__*` เท่านั้น) |
| `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 ที่ไม่ผ่านการกรองลงในทุกหน้าเว็บ |

⚠ = หน้าจัดการทำเครื่องหมาย **สิทธิ์สำคัญ — ตรวจสอบให้แน่ใจว่าเชื่อถือผู้พัฒนา**

> [!WARNING]
> `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 หรือโดเมนที่เวอร์ชันเดิมไม่มี ระบบจะ:

1. อัปเดตไฟล์ แต่ **ปิดปลั๊กอินไว้ก่อน**
2. แสดงข้อความ &#34;เวอร์ชันนี้ขอสิทธิ์เพิ่มจาก vX — ปิดไว้จนกว่าคุณจะอนุมัติ&#34; พร้อมรายการที่ขอเพิ่ม
3. เปิดใช้อีกครั้งเมื่อผู้ดูแลกด **อนุมัติและเปิดใช้**

## ดูสิทธิ์ของปลั๊กอินที่ติดตั้งแล้ว

การ์ดในแท็บ **ที่ติดตั้งเพิ่ม** แสดงสิทธิ์ของโค้ด, ที่อยู่บนเว็บที่ใช้, โดเมนที่เรียกได้ และปลั๊กอินที่ต้องใช้ โดเมนที่ปลั๊กอินเรียกด้วย `http` ต้องอยู่ในรายการที่อนุญาตของเว็บด้วย (ตั้งที่ โค้ดของเว็บไซต์ → ค่าลับและการตั้งค่า)
