# ปลั๊กอินแบบแพ็กเกจและ WebAssembly

> ปลั๊กอินแบบ static ด้วยเทมเพลต บล็อก และการตั้งค่า (ไม่มีโค้ดฝั่งเซิร์ฟเวอร์) และปลั๊กอินที่มีโค้ด Go คอมไพล์เป็น WebAssembly หรือรันเป็น service แยก

ที่มา: https://anasaki.live/docs/developers/package-wasm-plugins

นอกจาก [ปลั๊กอิน JavaScript](/docs/developers/js-plugins) แล้ว ยังมีอีกสองแบบ:

| แบบ | เหมาะกับ | โค้ดฝั่งเซิร์ฟเวอร์ |
| --- | --- | --- |
| **แพ็กเกจ (static)** | บล็อกในหน้าออกแบบ แบนเนอร์ สคริปต์หน้าเว็บ webhook | ไม่มี — ผ่านการตรวจเร็วที่สุด |
| **service (WASM / แยก)** | งานที่ต้องใช้ภาษาอื่น (เช่น Go) หรือ container ของตัวเอง | WebAssembly ในกล่องปิดของ CMS หรือโปรแกรมแยก |

## ปลั๊กอินแบบแพ็กเกจ

```text
hello-banner/
├── manifest.json
├── README.md
├── assets/banner.css      → <link rel=&#34;stylesheet&#34;> ทุกหน้า
├── assets/banner.js       → <script defer> ทุกหน้า
└── templates/
    ├── body.html          → แทรกก่อน </body>
    ├── card.html          → เทมเพลตของบล็อก
    └── card.css           → CSS ของบล็อก (จำกัดขอบเขตให้อัตโนมัติ)
```

```json
{
  &#34;id&#34;: &#34;hello-banner&#34;,
  &#34;name&#34;: &#34;Hello Banner&#34;,
  &#34;version&#34;: &#34;1.0.0&#34;,
  &#34;icon&#34;: &#34;📣&#34;,
  &#34;category&#34;: &#34;marketing&#34;,
  &#34;minCore&#34;: &#34;2.0.0&#34;,
  &#34;permissions&#34;: [&#34;head&#34;, &#34;bodyEnd&#34;, &#34;blocks&#34;, &#34;settings&#34;],
  &#34;settings&#34;: [
    { &#34;key&#34;: &#34;text&#34;, &#34;type&#34;: &#34;text&#34;, &#34;label&#34;: { &#34;th&#34;: &#34;ข้อความ&#34;, &#34;en&#34;: &#34;Text&#34; }, &#34;default&#34;: &#34;สวัสดี&#34; },
    { &#34;key&#34;: &#34;background&#34;, &#34;type&#34;: &#34;color&#34;, &#34;label&#34;: { &#34;th&#34;: &#34;สีพื้นหลัง&#34;, &#34;en&#34;: &#34;Background&#34; }, &#34;default&#34;: &#34;#4f46e5&#34; }
  ],
  &#34;head&#34;: [&#34;assets/banner.css&#34;, &#34;assets/banner.js&#34;],
  &#34;bodyEnd&#34;: &#34;templates/body.html&#34;,
  &#34;blocks&#34;: [{
    &#34;type&#34;: &#34;card&#34;,
    &#34;name&#34;: { &#34;th&#34;: &#34;การ์ด&#34;, &#34;en&#34;: &#34;Card&#34; },
    &#34;icon&#34;: &#34;🧩&#34;,
    &#34;template&#34;: &#34;templates/card.html&#34;,
    &#34;css&#34;: &#34;templates/card.css&#34;,
    &#34;props&#34;: [{ &#34;key&#34;: &#34;title&#34;, &#34;type&#34;: &#34;text&#34;, &#34;label&#34;: &#34;Title&#34;, &#34;default&#34;: &#34;Hi&#34; }]
  }]
}
```

```html
<!-- templates/body.html — ทุกค่าถูก escape HTML อัตโนมัติ -->
<div class=&#34;hb&#34; style=&#34;--hb-bg: {{settings.background}}&#34;>{{settings.text}}</div>
```

- ตัวแทนค่า: `{{settings.key}}`, `{{props.key}}` (บล็อก), `{{site.title}}`, `{{post.title}}`, `{{item.key}}` (ในรายการข้อมูล) — ไม่มีลูปหรือเงื่อนไข
- **ห้าม** วางตัวแทนค่าใน `` หรือ `` — ส่งข้อมูลให้ JS ผ่าน `data-*` แทน
- ชนิดการตั้งค่า: `text`, `textarea`, `number`, `color`, `boolean`, `select`, `url`, `image`
- CSS ของบล็อกถูกจำกัดขอบเขตใต้ `.pb--` (ใช้ `:scope` หรือ `&` แทนตัวครอบ)
- webhook: `&#34;webhooks&#34;: [{ &#34;event&#34;: &#34;post.published&#34;, &#34;url&#34;: &#34;{{settings.webhookUrl}}&#34; }]` — event ของระบบ `post.published`, `user.created`, `media.uploaded` หรือ event ของปลั๊กอินอื่น เช่น `form.submitted`

## ปลั๊กอิน WebAssembly (service ใน CMS)

ใส่ `plugin.wasm` ในแพ็กเกจพร้อมส่วน `service` — ติดตั้งคลิกเดียว CMS รันในกล่องปิด (ไม่มีไฟล์ เครือข่าย หรือฐานข้อมูล นอกจาก API ที่ขอ) หน่วยความจำ 256 MB

```json
{
  &#34;id&#34;: &#34;hello-service&#34;, &#34;name&#34;: &#34;Hello Service&#34;, &#34;version&#34;: &#34;1.0.0&#34;, &#34;icon&#34;: &#34;🛰&#34;,
  &#34;permissions&#34;: [&#34;service&#34;, &#34;blocks&#34;],
  &#34;service&#34;: {
    &#34;runtime&#34;: &#34;wasm&#34;,
    &#34;module&#34;: &#34;plugin.wasm&#34;,
    &#34;public&#34;: [&#34;/hello&#34;],
    &#34;api&#34;: [&#34;site&#34;, &#34;content&#34;, &#34;storage&#34;]
  }
}
```

เขียนด้วย Go SDK (`sdk/go/anasaki` ใน repository) แล้วคอมไพล์เป็น `wasip1`:

```go
p := anasaki.New(anasaki.Config{Name: &#34;Hello Service&#34;, Version: &#34;1.0.0&#34;})
p.Public(&#34;GET /hello&#34;, func(w http.ResponseWriter, r *http.Request) {
    anasaki.Page(w, http.StatusOK, &#34;Hello&#34;, &#34;<h1>Hello!</h1>&#34;)   // แสดงในหัว/ท้ายของเว็บ
})
p.Block(&#34;greeting&#34;, func(in anasaki.BlockInput) anasaki.BlockOutput { return anasaki.BlockOutput{HTML: &#34;…&#34;} })
log.Fatal(anasaki.Run(p, &#34;:9300&#34;))
```

```sh
GOOS=wasip1 GOARCH=wasm go build -trimpath -ldflags=&#34;-s -w&#34; -o package/plugin.wasm .
```

- สิทธิ์ API: `site`, `mail`, `content`, `users`, `events`, `storage` (ที่เก็บ key/value ของปลั๊กอิน), `http` (เฉพาะ `service.hosts`)
- เวลา: บล็อกและรายการข้อมูล 3 วินาที, หน้าสาธารณะ 30 วินาที, หน้าจัดการ 60 วินาที — โมดูลรันใหม่ทุกคำขอ เก็บสถานะไว้ใน storage ไม่ใช่ตัวแปร global
- ประกาศ `service.functions` เพื่อให้โค้ด JavaScript เรียกด้วย `plugins.call('', '', input)` ได้

## service แยก (container ของตัวเอง)

โค้ดชุดเดียวกัน build เป็นโปรแกรมปกติ (`go build`) แล้วรันข้าง CMS ใน `docker-compose.yml`:

```yaml
  hello-service:
    image: example/hello-service:1.0.0
    environment:
      ANASAKI_PLUGIN_ID: hello-service
      ANASAKI_PLUGIN_SECRET: ${HELLO_SERVICE_SECRET}
      ANASAKI_URL: http://studio:8090
    restart: unless-stopped
```

เจ้าของเว็บใส่ที่อยู่ของ service และส่งรหัสลับที่หน้าตั้งค่าปลั๊กอิน ([ติดตั้งปลั๊กอิน](/docs/store/install-plugins)) — CMS เซ็นทุกคำขอด้วย HMAC-SHA256 (SDK ตรวจให้) และ service ไม่ต้องเปิดพอร์ตสู่ภายนอก

> [!NOTE]
> ข้อกำหนดเต็ม (ขีดจำกัดแพ็กเกจ, โปรโตคอล, ลายเซ็น v1/v2, คุกกี้ `pl__*`) อยู่ใน `docs/plugins.md` ของ repository ตัวอย่างครบ: `examples/plugins/` และ `examples/service-plugins/hello-service`
