# สมัครและเผยแพร่ปลั๊กอิน

> สร้างบัญชีนักพัฒนาบน Plugin Store อัปโหลดแพ็กเกจ .zip ดูผลตรวจไฟล์ ส่งตรวจสอบ ออกเวอร์ชันใหม่ และอัปโหลดจาก CI ด้วย API token

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

ใครก็เผยแพร่ปลั๊กอินบน Anasaki Plugin Store ได้ฟรี — เมื่อผ่านแล้ว ทุกเว็บ Anasaki Studio ค้นหาและติดตั้งได้ในคลิกเดียว วิธีสร้างแพ็กเกจดูที่ [สร้างปลั๊กอิน JavaScript](/docs/developers/js-plugins) และ [ปลั๊กอินแบบแพ็กเกจและ WebAssembly](/docs/developers/package-wasm-plugins)

## 1. สมัครบัญชีนักพัฒนา

1. เปิด [storecms.anasaki.live](https://storecms.anasaki.live) → **เข้าสู่ระบบ** → **สมัครนักพัฒนา**
2. ใส่ชื่อที่แสดง (ชื่อผู้พัฒนา) อีเมล และรหัสผ่าน (อย่างน้อย 8 ตัวอักษร)
3. ติ๊กยอมรับเงื่อนไข (ปลั๊กอินเป็นของคุณ ไม่มีโค้ดอันตราย และทีมงานระงับปลั๊กอินที่ผิดกฎได้) แล้วกด **สร้างบัญชี**

## 2. อัปโหลด

1. ไปที่ **แดชบอร์ด** (แดชบอร์ดนักพัฒนา) → แท็บ **อัปโหลด**
2. ลากไฟล์ `.zip` มาวาง — **ตัวตรวจไฟล์ปลั๊กอิน** ตรวจทันทีด้วยกฎเดียวกับที่ Anasaki Studio ใช้ตอนติดตั้ง:
   - โครงสร้าง zip ปลอดภัย (ไม่มี `../`, symlink, ไฟล์ต้องห้าม) และขนาดไม่เกินกำหนด
   - `manifest.json` ถูกต้อง ประกาศ permission ครบทุกฟีเจอร์
   - ส่วนโค้ด: ไฟล์ สิทธิ์ของโค้ด โดเมน พาธ และ `requires` (หรือส่วน service และโมดูล WebAssembly)
   - สรุปสิ่งที่ควรระวัง เช่น JavaScript ทุกหน้า การส่งข้อมูลออก การเข้าถึงข้อมูลสมาชิก
3. ถ้าผ่าน กด **เผยแพร่** (หรือ **ส่งตรวจสอบ** สำหรับปลั๊กอินที่ต้องรอทีมงาน)

| ชนิดปลั๊กอิน | ผลหลังอัปโหลด |
| --- | --- |
| มีแค่ HTML/CSS (เทมเพลตไม่มีสคริปต์) | ขึ้นร้านทันที |
| รันโค้ด — JavaScript, WebAssembly / service หรือเทมเพลตที่มีสคริปต์ | สถานะ **รอตรวจสอบ** จนกว่าทีมงานจะอ่านโค้ด สิทธิ์ โดเมน และ migration แล้วอนุมัติ |

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

## กติกาสำคัญ

- **id เป็นของคุณ** — บัญชีที่อัปโหลด id นั้นเป็นคนแรกเป็นเจ้าของ ไม่มีใครอัปเวอร์ชันแทนได้ ถ้าขึ้นว่า id เป็นของคนอื่น ให้เปลี่ยน `id` ใน `manifest.json`
- **เวอร์ชันใหม่ต้องสูงกว่าเดิมเสมอ** (semver เช่น `1.0.0` → `1.1.0`) และทุกเวอร์ชันที่รันโค้ดต้องผ่านการตรวจอีกครั้ง
- id ของปลั๊กอินทางการ (`seo`, `forms`, `analytics`, `redirects`, `cookie-consent`, `maintenance`, `custom-code`) และ `backup` สงวนไว้
- ปลั๊กอินที่ถูกระงับอัปโหลดเวอร์ชันใหม่ไม่ได้ — ติดต่อผู้ดูแลร้าน

## หน้าปลั๊กอินบนร้าน

| มาจาก | แสดงเป็น |
| --- | --- |
| `name`, `description`, `icon`, `category`, `tags` ใน manifest | การ์ดและการค้นหา |
| `README.md` ที่รากของแพ็กเกจ | แท็บรายละเอียด |
| รูปในโฟลเดอร์ `screenshots/` (png, jpg, gif, webp, svg) | แท็บภาพหน้าจอ |
| `minCore`, `requires`, `optionalRequires` | &#34;ต้องการ Anasaki Studio X ขึ้นไป&#34;, &#34;ต้องใช้ปลั๊กอิน&#34;, &#34;ใช้ร่วมกับ&#34; |
| `permissions`, `code`, `service` | สิทธิ์ที่ปลั๊กอินใช้ และส่วนเซิร์ฟเวอร์ |

> [!NOTE]
> เขียน README ทั้งภาษาไทยและอังกฤษ บอกว่าปลั๊กอินทำอะไร ตั้งค่าที่ไหน และขอสิทธิ์แต่ละตัวไปเพื่ออะไร — ช่วยให้ผ่านการตรวจเร็วขึ้นและเจ้าของเว็บกล้าติดตั้ง

## อัปโหลดจากสคริปต์หรือ CI

1. ที่ **แดชบอร์ด → บัญชี** สร้าง **API token (สำหรับ CI)** — แสดงครั้งเดียว มีสิทธิ์เท่ากับบัญชีของคุณ
2. อัปโหลดด้วย header `X-Publish-Token`:

```sh
curl -X POST https://storecms.anasaki.live/api/v1/publish \
     -H &#34;X-Publish-Token: <token>&#34; \
     -F &#34;file=@my-plugin-1.0.0.zip&#34;
```

คำตอบเป็น JSON `{id, name, version, status}` โดย `status` เป็น `published` หรือ `pending` (รอตรวจ)

ต่อไป: [การตรวจสอบ ป้ายทางการ และปลั๊กอินแนะนำ](/docs/store/review-badges)
