ปลั๊กอิน
ปลั๊กอินแบบแพ็กเกจและ WebAssembly
ปลั๊กอินแบบ static ด้วยเทมเพลต บล็อก และการตั้งค่า (ไม่มีโค้ดฝั่งเซิร์ฟเวอร์) และปลั๊กอินที่มีโค้ด Go คอมไพล์เป็น WebAssembly หรือรันเป็น service แยก
นอกจาก ปลั๊กอิน JavaScript แล้ว ยังมีอีกสองแบบ:
| แบบ | เหมาะกับ | โค้ดฝั่งเซิร์ฟเวอร์ |
|---|---|---|
| แพ็กเกจ (static) | บล็อกในหน้าออกแบบ แบนเนอร์ สคริปต์หน้าเว็บ webhook | ไม่มี — ผ่านการตรวจเร็วที่สุด |
| service (WASM / แยก) | งานที่ต้องใช้ภาษาอื่น (เช่น Go) หรือ container ของตัวเอง | WebAssembly ในกล่องปิดของ CMS หรือโปรแกรมแยก |
ปลั๊กอินแบบแพ็กเกจ#
hello-banner/
├── manifest.json
├── README.md
├── assets/banner.css → <link rel="stylesheet"> ทุกหน้า
├── assets/banner.js → <script defer> ทุกหน้า
└── templates/
├── body.html → แทรกก่อน </body>
├── card.html → เทมเพลตของบล็อก
└── card.css → CSS ของบล็อก (จำกัดขอบเขตให้อัตโนมัติ)
{
"id": "hello-banner",
"name": "Hello Banner",
"version": "1.0.0",
"icon": "📣",
"category": "marketing",
"minCore": "2.0.0",
"permissions": ["head", "bodyEnd", "blocks", "settings"],
"settings": [
{ "key": "text", "type": "text", "label": { "th": "ข้อความ", "en": "Text" }, "default": "สวัสดี" },
{ "key": "background", "type": "color", "label": { "th": "สีพื้นหลัง", "en": "Background" }, "default": "#4f46e5" }
],
"head": ["assets/banner.css", "assets/banner.js"],
"bodyEnd": "templates/body.html",
"blocks": [{
"type": "card",
"name": { "th": "การ์ด", "en": "Card" },
"icon": "🧩",
"template": "templates/card.html",
"css": "templates/card.css",
"props": [{ "key": "title", "type": "text", "label": "Title", "default": "Hi" }]
}]
}
<!-- templates/body.html — ทุกค่าถูก escape HTML อัตโนมัติ -->
<div class="hb" style="--hb-bg: {{settings.background}}">{{settings.text}}</div>
- ตัวแทนค่า:
{{settings.key}},{{props.key}}(บล็อก),{{site.title}},{{post.title}},{{item.key}}(ในรายการข้อมูล) — ไม่มีลูปหรือเงื่อนไข - ห้าม วางตัวแทนค่าใน
<script>หรือ<style>— ส่งข้อมูลให้ JS ผ่านdata-*แทน - ชนิดการตั้งค่า:
text,textarea,number,color,boolean,select,url,image - CSS ของบล็อกถูกจำกัดขอบเขตใต้
.pb-<plugin>-<type>(ใช้:scopeหรือ&แทนตัวครอบ) - webhook:
"webhooks": [{ "event": "post.published", "url": "{{settings.webhookUrl}}" }]— event ของระบบpost.published,user.created,media.uploadedหรือ event ของปลั๊กอินอื่น เช่นform.submitted
ปลั๊กอิน WebAssembly (service ใน CMS)#
ใส่ plugin.wasm ในแพ็กเกจพร้อมส่วน service — ติดตั้งคลิกเดียว CMS รันในกล่องปิด (ไม่มีไฟล์ เครือข่าย หรือฐานข้อมูล นอกจาก API ที่ขอ) หน่วยความจำ 256 MB
{
"id": "hello-service", "name": "Hello Service", "version": "1.0.0", "icon": "🛰",
"permissions": ["service", "blocks"],
"service": {
"runtime": "wasm",
"module": "plugin.wasm",
"public": ["/hello"],
"api": ["site", "content", "storage"]
}
}
เขียนด้วย Go SDK (sdk/go/anasaki ใน repository) แล้วคอมไพล์เป็น wasip1:
p := anasaki.New(anasaki.Config{Name: "Hello Service", Version: "1.0.0"})
p.Public("GET /hello", func(w http.ResponseWriter, r *http.Request) {
anasaki.Page(w, http.StatusOK, "Hello", "<h1>Hello!</h1>") // แสดงในหัว/ท้ายของเว็บ
})
p.Block("greeting", func(in anasaki.BlockInput) anasaki.BlockOutput { return anasaki.BlockOutput{HTML: "…"} })
log.Fatal(anasaki.Run(p, ":9300"))
GOOS=wasip1 GOARCH=wasm go build -trimpath -ldflags="-s -w" -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('<id>', '<fn>', input)ได้
service แยก (container ของตัวเอง)#
โค้ดชุดเดียวกัน build เป็นโปรแกรมปกติ (go build) แล้วรันข้าง CMS ใน docker-compose.yml:
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 และส่งรหัสลับที่หน้าตั้งค่าปลั๊กอิน (ติดตั้งปลั๊กอิน) — CMS เซ็นทุกคำขอด้วย HMAC-SHA256 (SDK ตรวจให้) และ service ไม่ต้องเปิดพอร์ตสู่ภายนอก
ข้อกำหนดเต็ม (ขีดจำกัดแพ็กเกจ, โปรโตคอล, ลายเซ็น v1/v2, คุกกี้ pl_<id>_*) อยู่ใน docs/plugins.md ของ repository ตัวอย่างครบ: examples/plugins/ และ examples/service-plugins/hello-service
