# ฮุก ประเภทเนื้อหา และงานเบื้องหลัง

> filter และ event, ประเภทเนื้อหาและช่องข้อมูลของตัวเอง, สมาชิกของเว็บ, ส่งอีเมล, เรียก API ภายนอก, ค่าลับ, งานเบื้องหลัง cron, webhook และหน้าในหลังบ้าน

ที่มา: https://anasaki.live/docs/developers/hooks-jobs

## Filter และ event

```ts
// แก้ HTML ของเนื้อหาบทความ
site.filter('post.content', (html, { post }) => html + '<p class=&#34;sig&#34;>ขอบคุณที่อ่าน</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… | `` ของหน้าที่ออกแบบ |
| `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 วินาที

## ประเภทเนื้อหาและช่องข้อมูล

```ts
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/` (แม่แบบเลือกได้ที่ ตั้งค่าเว็บไซต์ → การแสดงผล → ประเภทเนื้อหาจากโค้ด) และหน้ารวม `/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)

> [!NOTE]
> ตั้งแต่ CMS 2.0.5 ปลั๊กอิน JavaScript ก็ประกาศประเภทเนื้อหาของตัวเองได้ (scope `post-types`, id แบบ `_` เช่น `docs_doc`, และ `public: false` เพื่อเสิร์ฟหน้าเอง) — ดู [สร้างปลั๊กอิน JavaScript](/docs/developers/js-plugins) ส่วน Site Code ใช้ id ใดก็ได้ที่ไม่ชนกับ type ของปลั๊กอินที่เปิดอยู่ (ชนกัน = เผยแพร่ไม่ได้) และใช้ `public: false` ได้เช่นกัน

## สมาชิกของเว็บ (site.visitor)

CMS ไม่มีระบบสมาชิกในตัว — โค้ดบอกเองว่าผู้เยี่ยมชมคือใคร:

```ts
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 ภายนอก และค่าลับ

```ts
mail.send({ to: 'owner@example.com', 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

```ts
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 ขาเข้า

```ts
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 };
});
```

## หน้าในหลังบ้าน

```ts
site.adminPage('orders', {
  label: { th: 'ออเดอร์', en: 'Orders' }, icon: '🧾', access: ['editor'],
  render: ({ query }) => ({
    title: 'Orders',
    html: `<header class=&#34;ak-page-head&#34;><h1>ออเดอร์</h1></header>
           <button class=&#34;ak-btn&#34; onclick=&#34;anasaki.call('ship', {id: 1}).then(r => AK.toast(r.message))&#34;>จัดส่ง</button>`,
  }),
});
```

หน้าแสดงใน iframe แบบ sandbox พร้อมชุด UI `ak-*` และ `window.AK` (ตาราง กราฟ toast ฯลฯ) — รายละเอียดใน [Plugin API](/docs/developers/plugin-api)
