Site Code
ฮุก ประเภทเนื้อหา และงานเบื้องหลัง
filter และ event, ประเภทเนื้อหาและช่องข้อมูลของตัวเอง, สมาชิกของเว็บ, ส่งอีเมล, เรียก API ภายนอก, ค่าลับ, งานเบื้องหลัง cron, webhook และหน้าในหลังบ้าน
ในหน้านี้
Filter และ event#
// แก้ HTML ของเนื้อหาบทความ
site.filter('post.content', (html, { post }) => html + '<p class="sig">ขอบคุณที่อ่าน</p>', { priority: 20 });
// ตรวจก่อนบันทึกโพสต์ — คืน { error } เพื่อปฏิเสธ
site.filter('post.beforeSave', (p) => p.title === 'x' ? { error: 'ห้ามใช้ชื่อนี้' } : { ...p, excerpt: p.excerpt || p.title });
// ฮุกของคุณเอง (Site Code ใช้ชื่อขึ้นต้น site.)
site.on('site.orderPaid', (data) => log.info('paid', data.id));
site.emit('site.orderPaid', { id: 7 }); // ภายใน handler, ส่งแบบ async
| filter หลัก | ค่า | ใช้ที่ |
|---|---|---|
post.content | HTML ของเนื้อหา | ชิ้นเนื้อหาบทความ |
post.beforeSave | {type, title, slug, status, excerpt, content, meta} | การบันทึกโพสต์ทุกทาง |
page.head / page.meta | title, description, canonical, og… | <head> ของหน้าที่ออกแบบ |
collection.items | รายการ | หลังโหลด collection |
action.input / action.result | input / ผลลัพธ์ | รอบ site.action |
mail.beforeSend | {to, subject, html, text, replyTo} | ก่อนส่งอีเมล (null = ยกเลิก) |
sitemap.urls / robots.txt | รายการ URL / ข้อความ | /sitemap.xml, /robots.txt |
event ของระบบ: post.published, post.saved, post.deleted, user.created, media.uploaded และ event ของปลั๊กอิน เช่น form.submitted จากปลั๊กอิน Forms — handler รันหลังเกิดเหตุการณ์ ครั้งละไม่เกิน 10 วินาที
ประเภทเนื้อหาและช่องข้อมูล#
site.postType('event', {
label: { th: 'อีเวนต์', en: 'Events' }, icon: '📅', slug: 'events',
fields: {
date: { type: 'datetime', required: true, label: { th: 'วันที่', en: 'Date' } },
place: 'text',
seats: { type: 'number', min: 0 },
},
access: { edit: ['editor', 'author'] },
});
site.fields('post', { readingTime: 'number' }); // เพิ่มช่องให้บทความ
- เมนู อีเวนต์ ขึ้นในกลุ่มเนื้อหาของหลังบ้านทันทีหลังเผยแพร่ ช่องข้อมูลอยู่ในส่วน ข้อมูลเพิ่มเติม ของหน้าแก้ไข
- บนเว็บ:
/events/<slug>(แม่แบบเลือกได้ที่ ตั้งค่าเว็บไซต์ → การแสดงผล → ประเภทเนื้อหาจากโค้ด) และหน้ารวม/events - ในหน้าออกแบบใช้
{{post.meta.date}}; ในโค้ดdb.posts.list({ type: 'event', where: { 'meta.date': { gte: '2026-01-01' } }, orderBy: '-meta.date' }) - ชนิดช่อง:
text, textarea, number, bool, date, datetime, select, url, image, email, json - ลบ type ออกจากโค้ด: โพสต์ยังอยู่ในฐานข้อมูลแต่ถูกซ่อนจนกว่าจะประกาศ type อีกครั้ง
เขียนเนื้อหาจากโค้ด: db.posts.create(post), db.posts.update(id, patch), db.posts.delete(id) (ตรวจสิทธิ์ของผู้เรียกเหมือนหลังบ้าน) หรือครอบด้วย db.asSystem(() => …) เพื่อใช้สิทธิ์ระบบ (ถูกบันทึกใน audit)
ตั้งแต่ CMS 2.0.5 ปลั๊กอิน JavaScript ก็ประกาศประเภทเนื้อหาของตัวเองได้ (scope post-types, id แบบ <id ปลั๊กอิน>_<ชื่อ> เช่น docs_doc, และ public: false เพื่อเสิร์ฟหน้าเอง) — ดู สร้างปลั๊กอิน JavaScript ส่วน Site Code ใช้ id ใดก็ได้ที่ไม่ชนกับ type ของปลั๊กอินที่เปิดอยู่ (ชนกัน = เผยแพร่ไม่ได้) และใช้ public: false ได้เช่นกัน
สมาชิกของเว็บ (site.visitor)#
CMS ไม่มีระบบสมาชิกในตัว — โค้ดบอกเองว่าผู้เยี่ยมชมคือใคร:
site.visitor(({ request }) => {
const s = request.cookies.sid && db.table('member_sessions').where('id', crypto.hash('sha256', request.cookies.sid)).first();
return s ? { id: s.member_id, name: s.name, groups: ['member', s.tier] } : null;
});
site.visitorGroups(['member', 'gold']);
แล้วใช้ access: ['group:member'] ใน route/collection/action และ visitor.is.member ในเงื่อนไขของหน้าออกแบบ (คุกกี้ของโค้ดคือ pl_site_* และตั้งด้วย response.setCookie(...))
อีเมล API ภายนอก และค่าลับ#
mail.send({ to: '[email protected]', subject: 'ออเดอร์ใหม่', html: '<p>…</p>' }); // ใช้ SMTP ของเว็บ
const res = http.fetch('https://api.example.com/rates', { timeout: 5000 }); // https เท่านั้น, timeout เป็นมิลลิวินาที
const rates = res.json();
const key = site.settings('paymentKey'); // จาก ค่าลับและการตั้งค่า
- อีเมล: ไม่เกิน 20 ผู้รับต่อครั้ง 100 ฉบับ/ชั่วโมง (ตั้งได้) — ตอนพัฒนาใช้
SITE_CODE_MAIL_SINK=logเพื่อเขียนลง log แทนการส่ง http.fetch: โดเมนต้องอยู่ในรายการที่อนุญาต (ค่าลับและการตั้งค่า) ห้าม IP ภายใน ตอบไม่เกิน 5 MB ไม่เกิน 10 วินาที- ค่าลับเข้ารหัส AES-256-GCM ด้วย
SITE_CODE_SECRET_KEY(หรือไฟล์site-code.key) — ค่าลับไม่ถูกแสดงกลับในหน้าจัดการ
งานเบื้องหลังและ cron#
site.job('sendNewsletter', { timeout: 300, retries: 3 }, ({ data, progress }) => { progress('50%'); });
jobs.enqueue('sendNewsletter', { subject: 'x' }, { delay: '10m', key: 'oct' }); // คืน job id
site.cron('0 8 * * *', 'sendNewsletter'); // ทุกวัน 8 โมง (เขตเวลาของเว็บ)
site.cron('*/15 * * * *', () => db.table('carts').where('expired', true).delete());
ดูคิว ยกเลิก ลองใหม่ และสั่งรัน cron ทันทีได้ที่แท็บ งานเบื้องหลัง งานที่ล้มจะลองใหม่แบบเว้นระยะเพิ่มขึ้นจนครบ retries
Webhook ขาเข้า#
site.route('POST /hooks/pay', { access: ['*'], rawBody: true, maxBody: 65536 }, ({ request }) => {
const ok = crypto.timingSafeEqual(crypto.hmac('sha256', site.settings('paySecret'), request.rawBody), request.headers['x-signature'] ?? '');
if (!ok) return { status: 401, body: 'bad signature' };
// …
return { received: true };
});
หน้าในหลังบ้าน#
site.adminPage('orders', {
label: { th: 'ออเดอร์', en: 'Orders' }, icon: '🧾', access: ['editor'],
render: ({ query }) => ({
title: 'Orders',
html: `<header class="ak-page-head"><h1>ออเดอร์</h1></header>
<button class="ak-btn" onclick="anasaki.call('ship', {id: 1}).then(r => AK.toast(r.message))">จัดส่ง</button>`,
}),
});
หน้าแสดงใน iframe แบบ sandbox พร้อมชุด UI ak-* และ window.AK (ตาราง กราฟ toast ฯลฯ) — รายละเอียดใน Plugin API
