สำหรับนักพัฒนา

ปลั๊กอิน

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

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

อ่าน 7 นาทีอัปเดตล่าสุด

ดูเป็น Markdown

ในหน้านี้

นอกจาก ปลั๊กอิน 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