# ติดตั้ง อัปเดต และลบปลั๊กอิน

> เพิ่มความสามารถให้เว็บ เช่น SEO แบบฟอร์ม สถิติ — ติดตั้งจาก Plugin Store ในคลิกเดียว อัปเดต ปิด/เปิด หรือลบ โดยข้อมูลไม่หาย

ที่มา: https://anasaki.live/docs/store/install-plugins

ปลั๊กอินคือส่วนเสริมที่เพิ่มความสามารถให้เว็บ เปิด/ปิดได้ตลอดเวลา และข้อมูลไม่หายเมื่อปิด จัดการได้ที่เมนู **ปลั๊กอิน** (กลุ่ม การตั้งค่า, ต้องมีสิทธิ์ `manage_options`) ซึ่งมีแท็บ **ที่ติดตั้งเพิ่ม**, **ร้านปลั๊กอิน** และ **อัปโหลด .zip**

## ติดตั้งจาก Plugin Store

1. ไปที่ **ปลั๊กอิน → ร้านปลั๊กอิน** (หรือปุ่ม 🛍 **ค้นหาปลั๊กอิน**)
2. ค้นหา หรือเรียงตาม ยอดนิยม / ดาวน์โหลดมากสุด / คะแนนสูงสุด / ใหม่ล่าสุด / มาแรง
3. เปิดปลั๊กอินเพื่อดูรายละเอียด เวอร์ชัน รีวิว และ **สิทธิ์ที่ปลั๊กอินขอ** แล้วกด **ติดตั้ง**
4. หน้าต่างยืนยันแสดงสิทธิ์ทั้งหมด ตรวจแล้วกด **อนุมัติและติดตั้ง**
5. ปลั๊กอินที่เพิ่งติดตั้งยัง **ปิดอยู่** — กด **เปิดใช้งานเลย** ในแถบแจ้งเตือนด้านล่างจอ (CMS 2.3.0) หรือไปที่แท็บ **ที่ติดตั้งเพิ่ม** แล้วกด **เปิดใช้งาน** เมนู หน้าจัดการ และบล็อกของปลั๊กอินจะขึ้นมาให้ใช้ทันที
6. ถ้าปลั๊กอินมีค่าที่ต้องตั้ง กด **ตั้งค่า** ที่การ์ดของปลั๊กอิน

> [!NOTE]
> ถ้าปลั๊กอิน **ต้องใช้ปลั๊กอินอื่นก่อน** หน้าต่างจะแสดงรายการพร้อมเวอร์ชันที่ต้องการ กด **ติดตั้งทั้งหมด** ได้เลย (แต่ละตัวจะถามสิทธิ์แยกกัน) ส่วนปลั๊กอินใน **ใช้ร่วมกับ** ไม่บังคับติดตั้ง

## ลายเซ็นของแพ็กเกจ

ตั้งแต่ CMS 2.4.0 ทุกแพ็กเกจจาก Plugin Store ทางการมี **ลายเซ็นดิจิทัล** (Ed25519) และระบบตรวจก่อนติดตั้งทุกครั้ง แพ็กเกจที่ถูกแก้หลังออกจากร้าน ถูกสลับเป็นเวอร์ชันอื่น หรือไม่มีลายเซ็น จะ **ไม่ถูกติดตั้ง** — ไม่ต้องตั้งค่าอะไร

ถ้าใช้ Plugin Store ของตัวเอง (`STORE_URL`) ระบบจะจำกุญแจของร้านนั้นตั้งแต่ครั้งแรกที่ร้านเซ็นแพ็กเกจ แล้วไม่ยอมรับกุญแจอื่นอีก หรือกำหนดกุญแจเองด้วย `STORE_PUBLIC_KEY` (ดู [ตัวแปรใน .env](/docs/studio/env-variables))

## ติดตั้งจากไฟล์ .zip

ใช้เมื่อได้ไฟล์ปลั๊กอินมาเอง หรือเซิร์ฟเวอร์เชื่อมต่อ Store ไม่ได้ (ดาวน์โหลด `.zip` ได้จากหน้าปลั๊กอินบนเว็บของร้าน)

1. ไปที่ **ปลั๊กอิน → อัปโหลด .zip**
2. ลากไฟล์มาวาง หรือกด **เลือกไฟล์ .zip** (ไฟล์ต้องมี `manifest.json` อยู่ด้านใน)
3. อนุมัติสิทธิ์ แล้วเปิดใช้งานที่แท็บ **ที่ติดตั้งเพิ่ม**

> [!WARNING]
> ติดตั้งจากไฟล์เฉพาะปลั๊กอินที่คุณไว้ใจ ไฟล์ที่ไม่ได้มาจาก Store ไม่ผ่านการตรวจสอบของทีมงาน

## อัปเดต

เมื่อ Store มีเวอร์ชันใหม่ การ์ดปลั๊กอินจะขึ้น **มีเวอร์ชันใหม่ vX** — กด **อัปเดต** การตั้งค่าและสถานะเปิด/ปิดยังอยู่ครบ (อัปเกรดด้วยการอัปโหลด `.zip` เวอร์ชันที่สูงกว่าก็ได้)

- ถ้าเวอร์ชันใหม่ **ขอสิทธิ์เพิ่ม** ปลั๊กอินจะถูกปิดไว้ก่อน พร้อมรายการสิทธิ์ใหม่ — กด **อนุมัติและเปิดใช้** เมื่อพร้อม
- ถ้าการอัปเดตจะแก้ตารางข้อมูลแบบที่อาจทำให้ข้อมูลหาย ระบบถามให้ติ๊ก &#34;เข้าใจแล้วว่าข้อมูลอาจหาย&#34; ก่อน และสำรองตารางไว้ให้ก่อนแก้

## ปิดใช้งาน

กด **ปิดใช้งาน** ที่การ์ด — ข้อมูลยังอยู่ครบ เปิดใหม่ได้ทุกเมื่อ ระหว่างที่ปิด บล็อกของปลั๊กอินในหน้าเว็บจะไม่แสดง (หน้าไม่เสีย) และกลับมาเมื่อเปิดอีกครั้ง

ถ้ามีปลั๊กอินอื่นที่ต้องใช้ตัวนี้ ระบบจะเตือนว่าตัวนั้นจะถูกปิดด้วย (**ปิดทั้งหมด**)

## ลบปลั๊กอิน

1. กด **ลบ** ที่การ์ด
2. เลือกว่าจะ **ลบข้อมูลของปลั๊กอินด้วย** หรือไม่:
   - ไม่เลือก — ข้อมูลถูกเก็บไว้ และใช้ต่อได้เมื่อติดตั้งใหม่
   - เลือก — ตารางข้อมูลของปลั๊กอิน (`p__*`) การตั้งค่า และงานเบื้องหลังถูกลบ โดยระบบสำรองตารางไว้ 7 วันก่อนลบ
3. กด **ลบปลั๊กอิน**

## รีวิวปลั๊กอิน

ในหน้ารายละเอียดของปลั๊กอิน (แท็บ **รีวิว**) ให้คะแนน 1–5 ดาวและเขียนรีวิวสั้น ๆ แล้วกด **ส่งรีวิว** (รีวิวได้ 1 ครั้งต่อปลั๊กอินต่อวัน)

## ปลั๊กอินที่ต้องรันโปรแกรมแยก

ปลั๊กอินแบบ service ภายนอกจะมีป้าย &#34;โปรแกรมฝั่งเซิร์ฟเวอร์ · ยังไม่เชื่อมต่อ&#34; — เปิด **ตั้งค่า** ของปลั๊กอิน แล้ว:

1. รันโปรแกรมของปลั๊กอิน (เช่นเพิ่มเป็น service ใน `docker-compose.yml` ของ CMS ตามตัวอย่างในหน้าตั้งค่า) และส่ง **รหัสลับ (secret)** ให้เป็น `ANASAKI_PLUGIN_SECRET`
2. ใส่ **ที่อยู่ของโปรแกรมปลั๊กอิน** เช่น `http://ชื่อ-service:9000`
3. กด **ทดสอบการเชื่อมต่อ** แล้วเปิดใช้งาน

ปลั๊กอินแบบ WebAssembly และ JavaScript ไม่ต้องทำขั้นตอนนี้ — ติดตั้งแล้วใช้ได้เลย
