อ้างอิง config

ตัวเลือกทั้งหมดของ easy-cms.config.ts แบ่งตามตำแหน่งที่ใส่ คำอธิบายและตัวอย่างดูได้จากลิงก์ไปยังคู่มือ มีเทสต์ตรวจหน้านี้กับ type ใน @easy-cms/core ทุกตัวเลือกจึงอยู่ในหน้านี้ครบ

Easy CMS ตรวจ config ตอนเริ่มทำงาน ตัวเลือกที่เปลี่ยนชื่อแล้วจะเป็น error ที่บอกชื่อใหม่ (เช่น admin.siteURL is now `siteURL` ) การอัปเกรดจึงไม่ทำให้ค่าที่ตั้งไว้หายไปเงียบ ๆ ส่วนตัวเลือกที่ Easy CMS ไม่รู้จักจะขึ้นเป็นคำเตือนใน log พร้อมชื่อที่ใกล้เคียงที่สุด (did you mean `maxLength`?)

import { defineConfig } from '@easy-cms/core'
 
export default defineConfig({ secret, db, collections, /* … */ })

ระดับบนสุด

ตัวเลือก	Type	ค่าเริ่มต้น
`secret`	`string`	—	จำเป็น อย่างน้อย 32 ตัวอักษร ใช้เซ็น session และ preview token
`rateLimit`	`object`	—	request ต่อนาทีต่อ IP ผู้ใช้ และ API key: `{ window, anonymous, users, apiKeys }` ใช้ `{}` เพื่อใช้ค่าเริ่มต้น (rate limit)
`previousSecrets`	`string[]`	—	secret ที่เคยใช้ก่อน `secret` สิ่งที่มันเซ็นไว้ยังตรวจผ่าน (หมุน secret)
`db`	`DatabaseAdapter`	—	จำเป็น `sqlite()` หรือ `postgres()` ฐานข้อมูล
`serverURL`	`string`	—	origin สาธารณะ (`https://example.com`) ทำให้ URL ของ media เป็น URL เต็ม
`cors`	`string[] \| '*'`	`[]`	origin ที่โค้ดใน browser เรียก API ได้ ความปลอดภัย
`cronSecret`	`string`	`CRON_SECRET`	secret แบบ Bearer สำหรับ `GET <api>/jobs/run` ยาวอย่างน้อย 32 ตัวอักษร (ถ้า `CRON_SECRET` สั้นกว่าจะเป็นคำเตือน) การตั้งเวลา
`webhooks`	`WebhookConfig[]`	`[]`	ดู webhooks
`events`	`string[]`	`[]`	event ของแอปหรือ plugin นอกจากการแก้เนื้อหา (`<area>.<what>` เช่น `order.paid`) ส่งด้วย `cms.emit()` ไปยัง webhook ที่ระบุไว้ Webhooks
`jobs`	`JobConfig[]`	`[]`	งานที่รันพร้อมงานตั้งเวลา เช่นงานเก็บกวาดของ plugin ดู jobs
`timeZone`	`string`	เขตเวลาของ server	เขตเวลา IANA ของเวลาของวันใน config (`jobs[].at`, `backups.at`) เช่น `Asia/Bangkok` หน้าแอดมินแสดงและรับวันเวลาทั้งหมดตามเขตนี้ ไม่ว่าเบราว์เซอร์จะอยู่เขตไหน ระบบจัดการ
`localization`	`LocalizationConfig \| false`	—	ดู localization
`routes`	`RoutesConfig`		ดู routes
`admin`	`AdminConfig`		ดู admin
`upload`	`UploadConfig`		ดู upload
`auth`	`AuthConfig`		ดู auth
`collections`	`CollectionConfig[]`	`[]`	ดู collections
`globals`	`GlobalConfig[]`	`[]`	ดู globals
`endpoints`	`Endpoint[]`	`[]`	ดู endpoints
`cliCommands`	`CliCommand[]`	`[]`	คำสั่ง `easy-cms <name>` เช่นจาก plugin: `{ name, description, help?, run({ cms, args, flags, log }) }` CLI
`onRequest`	`OnRequest \| OnRequest[]`: `({ headers, url, user, cms }) => { context?, user? }`	—	ทำงานทุก request ของ API เมื่อรู้ผู้ใช้แล้ว: คืน `context` ของ request (เช่น tenant) และเปลี่ยนผู้ใช้ได้ (บทบาทใน tenant นั้น, `scoped`) ปกติ plugin เป็นผู้ตั้ง ถ้าเป็นรายการจะทำงานตามลำดับ แต่ละตัวได้ผู้ใช้ที่ตัวก่อนหน้าคืนมา และรวม `context` ของทุกตัวเข้าด้วยกัน Multi-tenant
`apiKeys`	`boolean`	`false`	API key ใต้ตั้งค่า สำหรับสคริปต์และแอปอื่น API keys
`email`	`EmailAdapter`	—	ส่งอีเมลให้ plugin เช่น `smtp()` หรือ `consoleEmail()` อีเมล
`backups`	`BackupsConfig`	กดทำเองเท่านั้น	backup ฐานข้อมูลตามรอบ ดู backups
`audit`	`boolean \| AuditConfig`	ปิด	audit log: ใครแก้อะไร การเข้าสู่ระบบ การจัดการระบบ ดู audit
`countCacheSeconds`	`number`	`5`	กี่วินาทีที่ใช้ผลนับของ list (`totalDocs`, `totalPages`) ซ้ำสำหรับ query เดียวกัน ตัวเอกสารเป็นปัจจุบันเสมอ `0`: นับทุกครั้ง การนับ
`maxPage`	`number`	ไม่จำกัด	`page` ที่ลึกที่สุดที่ REST API ให้ API client (admin ที่ login ยังใช้เลขหน้าได้ทุกหน้า) ลึกกว่านั้นได้ `400` พร้อมแนะนำ `cursor` Cursor
`httpCache`	`HttpCacheConfig`	ปิด (`no-store`)	ให้ CDN cache การอ่านเนื้อหาที่ publish แล้วแบบสาธารณะ พร้อม cache tag สำหรับ purge ดู httpCache
`telemetry`	`boolean \| { traces?, metrics? }`	ปิด	span และ metric ของ OpenTelemetry ผ่าน `@opentelemetry/api` ส่งไปที่ที่ SDK ของแอปกำหนด Observability
`search`	`SearchAdapter`	—	ค้นหาแบบเรียงตามความเกี่ยวข้องใน collection ที่มี `search` เช่น `memorySearch()` ค้นหา
`outbox`	`boolean`	`false`	รัน after hook, webhook และ `httpCache.purge` จาก outbox ที่เขียนใน transaction เดียวกับการบันทึก หลังส่ง response และ retry จนสำเร็จ hook ต้องรันซ้ำได้โดยไม่เสียหาย Outbox
`logs`	`LogsConfig`	บรรทัดที่อ่านง่าย	`{ format: 'json' }` เขียน JSON บรรทัดละหนึ่ง object พร้อม request id ดู logs
`plugins`	`Plugin[]`	`[]`	`(config) => config` ทำงานตามลำดับก่อนตรวจ config `definePlugin(fn, { name, version, apiVersion? })` ตั้งชื่อให้แสดงบนแดชบอร์ด ส่วน `apiVersion` (`PLUGIN_API_VERSION`) หยุดการเริ่มทำงานถ้า plugin เขียนไว้สำหรับ plugin API เวอร์ชันอื่น Plugins
`fieldTypes`	`FieldTypeDefinition[]`	`[]`	ชนิด field จากแพ็กเกจ เช่น `color` จาก `@easy-cms/fields` ชนิด field เพิ่มเติม

routes

ตัวเลือก	Type	ค่าเริ่มต้น
`api`	`string`	`/api/cms`	ตำแหน่งของ REST API

admin

ตัวเลือก	Type	ค่าเริ่มต้น
`path`	`string`	`/admin`	ตำแหน่งของหน้า admin
`locale`	`'en' \| 'th'`	`en`	ภาษาเริ่มต้นของหน้า admin ก่อนผู้ใช้เลือกเอง
`brand`	`AdminBrand`	`{}`	ดู brand
`siteURL`	`string`	`/` (Nuxt, Next.js)	เว็บสาธารณะสำหรับปุ่ม "ดูเว็บไซต์": path หรือ URL แบบ `http(s)`
`nav`	`NavGroup[]`	—	กลุ่มของเมนู: `{ id, label, icon?, order?, children? }` children ลึกได้หนึ่งชั้น มีในตัว: `content`, `settings` (`site`, `people`, `system`) ระบบจัดการ
`commands`	`{ label, href, icon?, keywords? }[]`	—	รายการเพิ่มเติมใน command palette (⌘K) ที่เปิดหน้าของระบบจัดการ
`modules`	`string[]`	`[]`	admin module ที่มี Web Components: export ของแพ็กเกจหรือ path Admin components
`pages`	`AdminPage[]`	`[]`	หน้าของตัวเองที่ `<admin>/p/<path>` เช่น จาก plugin ดู pages
`dashboard`	`DashboardWidget[]`	`[]`	กล่องบนแดชบอร์ดต่อจากกล่องที่มีอยู่เดิม ดู dashboard
`switcher`	`{ cookie, label, options } \| false`	—	ตัวเลือกด้านบนของเมนูที่ใช้กับทั้ง admin เช่น tenant เก็บใน cookie `options` คือ path ใต้ API ที่คืน `{ options: [{ value, label }], all? }` ปกติ plugin เป็นผู้ตั้ง

brand

ตัวเลือก	Type
`name`	`string`	แสดงในเมนู หน้า login และแท็บของ browser ค่าเริ่มต้น "Easy CMS"
`logo`	`string`	path บนเว็บของคุณ หรือ URL แบบ `https://`
`color`	`string`	สีหลักแบบ `#rrggbb` ระบบสร้างเฉดสีให้

pages

ตัวเลือก	Type
`path`	`string`	จำเป็น ตัวพิมพ์เล็ก ตัวเลข และ `-` ไม่ซ้ำกัน หน้าจะอยู่ที่ `<admin>/p/<path>`
`component`	`AdminComponent`	จำเป็น เนื้อหาของหน้า ส่วนหัวหน้า admin วาดให้
`label`	`string \| { en, th }`	จำเป็น หัวข้อในส่วนหัว เมนู และแท็บของ browser
`icon`	`AdminIcon`	ไอคอนในเมนู ค่าเริ่มต้น `file-text`
`group`	`'content' \| 'settings' \| false \| string`	กลุ่มในเมนู: `content`, `settings`, id ของกลุ่ม (`admin.nav`) หรือ label `false` คือไม่แสดง ค่าเริ่มต้น `content`
`order`	`number`	ตำแหน่งในกลุ่มของเมนู ค่าน้อยมาก่อน ที่ไม่ได้ตั้งจะตามมาตามลำดับใน config
`access`	`({ user }) => boolean`	ใครเปิดได้ ตรวจฝั่ง server ค่าเริ่มต้น: ทุกคนที่ login

dashboard

ตัวเลือก	Type
`id`	`string`	ใช้ให้สิทธิ์ในหน้า Settings → Roles (`widget:<id>`) เปลี่ยน tag แล้วสิทธิ์ยังอยู่ ค่าเริ่มต้น: tag ของ component
`component`	`AdminComponent`	จำเป็น เนื้อหาของกล่อง
`width`	`'half' \| 'full'`	`half` (ค่าเริ่มต้น): คอลัมน์ข้าง `full`: ใต้ทั้งสองคอลัมน์ บนมือถือเป็นคอลัมน์เดียว
`label`	`Label`	ชื่อของกล่องในหน้า Settings → Roles (`auth.rbac`) ค่าเริ่มต้น: tag ของ component
`access`	`({ user }) => boolean`	ใครเห็น ตรวจฝั่ง server ค่าเริ่มต้น: ทุกคนที่ login

วิธีเขียนดูที่ หน้าของ plugin และกล่องบนแดชบอร์ด

backups

ตัวเลือก	Type	ค่าเริ่มต้น
`frequency`	`'daily' \| 'weekly'`	—	backup อัตโนมัติ ถ้าไม่ตั้ง admin กดทำเองได้
`at`	`string`	`03:00`	เวลา `HH:MM` ตามเขตเวลาของ server
`keep`	`number`	`7`	จำนวน backup ที่สำเร็จที่จะเก็บ ชุดที่เก่ากว่าจะถูกลบ
`dir`	`string`	`backups`	โฟลเดอร์ของที่เก็บในเครื่อง ไม่เปิดเป็น URL สาธารณะ
`storage`	`StorageAdapter`	ดิสก์ในเครื่อง	เช่น `s3Storage()` กับ bucket ส่วนตัว ถ้าให้ URL สาธารณะจะมีคำเตือน
`encryptionKey`	`string`	—	เข้ารหัสไฟล์ backup (AES-256-GCM) อย่างน้อย 32 ตัวอักษร เช่น `process.env.EASY_CMS_BACKUP_KEY` Backup
`sqlite`	`(options) => DatabaseAdapter`	—	เฉพาะ Postgres: `sqlite` จาก `@easy-cms/db-sqlite` ใช้เขียนไฟล์ backup Backup

audit

ตัวเลือก	Type	ค่าเริ่มต้น
`keepDays`	`number`	`365`	เก็บกี่วัน ที่เก่ากว่าจะถูกลบ `0`: เก็บไว้ทั้งหมด
`values`	`boolean`	`true`	เก็บค่าก่อนและหลังการแก้ `false`: เก็บแค่ชื่อ field ที่เปลี่ยน
`failedLogins`	`number`	`20`	จำนวน login ไม่สำเร็จในหนึ่งชั่วโมงที่แดชบอร์ดจะเตือน Audit log
`scope`	`({ context, user }) => string \| null`	—	ส่วนของเว็บที่ entry เป็นของ เช่น tenant (ปกติ plugin เป็นผู้ตั้ง) admin ของส่วนนั้น (`scoped`) เห็นเฉพาะของส่วนตัวเอง คนอื่นเห็นของส่วนที่เลือกหรือทั้งหมด

httpCache

ตัวเลือก	Type	ค่าเริ่มต้น
`sMaxAge`	`number`	`60`	กี่วินาทีที่ CDN ส่งการอ่านแบบสาธารณะซ้ำได้โดยไม่ต้องถามใหม่ (`s-maxage`)
`staleWhileRevalidate`	`number`	`300`	กี่วินาทีหลังจากนั้นที่ยังส่งของเดิมได้ระหว่างดึงของใหม่
`purge`	`(tags) => void \| Promise<void>`	—	ถูกเรียกหลังเนื้อหาสาธารณะเปลี่ยน พร้อม cache tag ของสิ่งที่เปลี่ยน ไม่รอผล ถ้าล้มจะ log ไว้

logs

ตัวเลือก	Type	ค่าเริ่มต้น
`format`	`'pretty' \| 'json'`	`'pretty'`	`json`: บรรทัดละหนึ่ง object (`time`, `level`, `message`, `requestId`, `error`) ตัวแปร `EASY_CMS_LOG_FORMAT` มีผลเหนือค่านี้ Log
`requests`	`boolean`	`true`	เมื่อเป็น `json` เขียนหนึ่งบรรทัดต่อ API request: method, path, status, เวลาที่ใช้ และผู้ใช้

auth

ตัวเลือก	Type	ค่าเริ่มต้น
`roles`	`string[]`	`['admin', 'editor']`	ต้องมี `admin` เมื่อเปิด `rbac` คือ role ที่มีอยู่เสมอ ผู้ใช้และการยืนยันตัวตน
`rbac`	`boolean`	`false`	กำหนด role และสิทธิ์จากหน้า admin (Settings → Roles) ซ้อนบนกฎ access บทบาทและสิทธิ์
`providers`	`AuthProvider[]`	`[]`	เข้าสู่ระบบหน้า admin ด้วยบัญชีภายนอก เช่น `[google()]` จาก `@easy-cms/auth-oauth` Single sign-on
`providerSignUp`	`{ domains, role? }`	—	เมื่อมี `providers`: คนจากโดเมนอีเมลเหล่านี้ได้บัญชีตอนเข้าสู่ระบบครั้งแรก เป็น `role` (ห้ามเป็น `admin`)
`password`	`boolean \| { breakGlass }`	`true`	`false`: เฉพาะ admin ที่ใช้รหัสผ่านได้ `{ breakGlass: [emails] }`: เฉพาะบัญชีเหล่านั้น (single sign-on สำหรับทุกคน) คนอื่นใช้ `providers`
`setupCode`	`string`	`EASY_CMS_SETUP_CODE`	รหัสที่ admin คนแรกต้องกรอกที่ `/admin` กันคนอื่นแย่งเว็บที่เพิ่ง deploy ถ้าไม่ตั้งจะไม่ถาม และบน production server จะเตือนตราบใดที่ยังไม่มี admin Deploy ด้วยคลิกเดียว
`tokenExpiration`	`number`	`604800` (7 วัน)	อายุของ session เป็นวินาที
`maxLoginAttempts`	`number`	`5`	จำนวนครั้งที่ login ผิดได้ต่อ email (และ IP) ภายใน `lockWindow`
`lockWindow`	`number`	`900` (15 นาที)	เป็นวินาที
`trustedOrigins`	`string[]`	`[]`	origin อื่นที่ส่ง request ด้วย cookie ได้
`resetPasswordExpiration`	`number`	`3600`	ลิงก์ "ลืมรหัสผ่าน" ใช้ได้กี่วินาที ต้องมี `email` และ `serverURL` บน production ลืมรหัสผ่าน
`inviteExpiration`	`number`	`604800`	ลิงก์คำเชิญใช้ได้กี่วินาที
`emails`	`{ resetPassword?, invite?, passwordChanged? }`	—	ฟังก์ชัน `({ user, url, locale, expiresAt }) => { subject, text, html? }` สำหรับข้อความอีเมลของคุณเอง
`members`	`MembersConfig`	—	คนที่ล็อกอินบนหน้าเว็บ ไม่ใช่ระบบจัดการ เช่น ลูกค้า ดู members

members

ตัวเลือก	Type
`roles`	`string[]`	role ของสมาชิก (ต้องอยู่ใน `roles` ด้วย) สมาชิกเข้าระบบจัดการไม่ได้ และ `isStaff` (ค่าเริ่มต้นของทุก collection) ไม่นับพวกเขา สมาชิกของเว็บ
`signUp`	`MembersSignup`	ให้ผู้เยี่ยมชมสมัครบัญชีเองได้: `POST <api>/auth/signup`
`pages`	`{ verifyEmail?, resetPassword? }`	หน้าของเว็บที่เปิดลิงก์ในอีเมลของสมาชิกพร้อม `?token=` เป็น path บน `admin.siteURL` (หรือ `serverURL`) หรือ URL เต็ม ค่าเริ่มต้นคือหน้าของระบบจัดการ
`emails`	`{ verifyEmail? }`	ข้อความอีเมลยืนยันที่อยู่อีเมลของคุณเอง

ตัวเลือก	Type	ค่าเริ่มต้น
`role`	`string`	—	role ของบัญชีใหม่ ต้องเป็นหนึ่งใน `members.roles`
`verifyEmail`	`boolean`	`true`	บัญชีใหม่ต้องยืนยันอีเมลด้วยลิงก์ก่อนล็อกอิน
`turnstile`	`{ siteKey, secretKey }`	—	Cloudflare Turnstile ตรวจทุกครั้งที่สมัคร

upload

ตัวเลือก	Type	ค่าเริ่มต้น
`dir`	`string`	`uploads`	โฟลเดอร์ของที่เก็บไฟล์ในเครื่อง นับจาก root ของโปรเจกต์
`maxFileSize`	`number`	`10485760` (10 MB)	เป็น byte
`mimeTypes`	`string[]`	`['image/*', 'application/pdf']`	ประเภทไฟล์ที่อนุญาต ตรวจจากเนื้อไฟล์: MIME type, `type/*` หรือ `documents`, `office`, `archives` ดูชนิดไฟล์
`storage`	`StorageAdapter`	ดิสก์ในเครื่อง	เช่น `s3Storage()` จาก `@easy-cms/storage-s3` อัปโหลด
`imageSizes`	`ImageSize[]`	`[]`	รูปย่อ (ต้องมี `sharp`) ดู ขนาดรูป
`fromURL`	`UploadFromURLConfig`	ปิด	อัปโหลดจากลิงก์ ดู fromURL
`privateStorage`	`StorageAdapter`	`storage` ที่ไม่มี URL สาธารณะ	ที่เก็บไฟล์ในโฟลเดอร์ส่วนตัว ดูโฟลเดอร์ส่วนตัว
`folders`	`boolean`	`false`	โฟลเดอร์ในคลังสื่อ และเมื่อเปิด `auth.rbac` กำหนดได้ว่าใครใช้แต่ละโฟลเดอร์ ดูโฟลเดอร์

fromURL

ตัวเลือก	Type
`allowedHosts`	`string[]`	จำเป็น `images.example.com`, `.example.com` (subdomain) หรือ `` (ทุก host สาธารณะ)
`allowPrivate`	`boolean`	รวมที่อยู่ในเครือข่ายภายใน (`localhost`, `10.x`…) ด้วย ค่าเริ่มต้น `false` อ่านก่อน

ขนาดรูป

ตัวเลือก	Type	ค่าเริ่มต้น
`name`	`string`	—	key ใน `media.sizes` เช่น `thumbnail`
`width`	`number`	—	ความกว้างเป็น pixel
`height`	`number`	—	ความสูง (ไม่บังคับ)
`fit`	`'cover' \| 'contain' \| 'inside'`	`cover`	วิธีจัดรูปเมื่อกำหนดทั้งกว้างและสูง

localization

ตัวเลือก	Type	ค่าเริ่มต้น
`locales`	`string[]`	—	ภาษาของเนื้อหา เช่น `['th', 'en']` หลายภาษา
`defaultLocale`	`string`	ภาษาแรก	ใช้เมื่อไม่ระบุภาษา และใช้เติมค่าที่ว่าง
`fallback`	`boolean`	`true`	ถ้าค่าว่าง จะอ่านค่าจากภาษาเริ่มต้นแทน

webhooks

ตัวเลือก	Type	ค่าเริ่มต้น
`url`	`string`	—	ปลายทางที่จะ POST event Webhooks
`events`	`string[]`	ทั้งหมด	`create`, `update`, `delete`, `publish`, `unpublish`, `draft`
`collections`	`string[]`	ทั้งหมดยกเว้น `users`	collection ที่ส่ง event ใช้ `[]` เพื่อไม่ส่งเลย ระบุ `users` ถ้าต้องการ event ของบัญชีผู้ใช้
`globals`	`string[]`	ทั้งหมด	global ที่ส่ง event ใช้ `[]` เพื่อไม่ส่งเลย
`secret`	`string`	—	เซ็นการส่งแต่ละครั้ง: `x-easy-cms-timestamp` และ `x-easy-cms-signature-v2` (วิธีตรวจ)
`headers`	`Record<string, string>`	—	header เพิ่มเติม

events รับ events ของ config ด้วย (เช่น order.paid) event เหล่านี้ส่งไปเฉพาะ webhook ที่ระบุไว้

jobs

ตัวเลือก	Type
`name`	`string`	ไม่ซ้ำกัน ตัวพิมพ์เล็ก ใช้ `-` และ `:` ได้ เช่น `shop:carts`
`every`	`number`	รันห่างกันอย่างน้อยกี่วินาที เวลาที่รันล่าสุดเก็บในฐานข้อมูล ถ้ามี `at` ต้องเป็นจำนวนวันเต็ม (ค่าเริ่มต้นหนึ่งวัน) ค่าเริ่มต้น: ทุกรอบ
`at`	`string`	เวลาของวัน `HH:MM` ตาม `timeZone` ถ้าพลาดเวลาไปจะรันหนึ่งครั้งเมื่องานรันครั้งถัดไป
`adminSchedule`	`boolean`	ให้แอดมินเปลี่ยน `every` และ `at` ได้ในหน้า ตั้งค่า → งานเบื้องหลัง ค่าเริ่มต้น `false`
`run`	`({ cms, now }) => unknown`	งานที่ทำ ถ้าล้มเหลวจะบันทึก log และงานอื่นยังรันต่อ

งานเหล่านี้รันพร้อมงานตั้งเวลา: ทุกนาทีบน server หรือทุกครั้งที่ cron เรียก GET <api>/jobs/run แต่ละรอบถูกจองในฐานข้อมูล จึงรันครั้งเดียวแม้มีหลาย instance แอดมินดู รัน และหยุดงานได้ในหน้า ตั้งค่า → งานเบื้องหลัง งานเบื้องหลัง

collections

ตัวเลือก	Type	ค่าเริ่มต้น
`slug`	`string`	—	จำเป็น URL และชื่อตาราง: ตัวพิมพ์เล็ก ตัวเลข `-` และ `_`
`fields`	`Field[]`	—	จำเป็น ดู อ้างอิง field
`labels`	`{ singular?, plural? }`	สร้างจาก slug	แต่ละตัวเป็น string หรือ `{ en, th }`
`useAsTitle`	`string`	—	field ระดับบนสุดที่ใช้เป็นชื่อเอกสาร
`drafts`	`boolean`	`false`	เพิ่ม `status` (`draft` \| `published`) ฉบับร่าง
`versions`	`boolean \| VersionsConfig`	`false`	เก็บเวอร์ชันทุกครั้งที่บันทึก ดู versions
`schedule`	`boolean`	`false`	เผยแพร่และยกเลิกตามเวลา (ต้องมี `drafts`)
`httpCache`	`false \| { sMaxAge?, staleWhileRevalidate? }`	ตาม config	เวลา httpCache ของ collection นี้ หรือ `false` ให้การอ่านเป็น `no-store`
`search`	`{ fields: string[] }`	—	index เอกสารที่ publish แล้วให้ adapter `search` ของ config: field ที่จะ index เรียงจากสำคัญที่สุด ค้นหา
`preview`	`({ doc, locale }) => string \| null`	—	หน้าที่แสดงเอกสาร สำหรับตัวอย่างสด
`access`	`{ read?, create?, update?, delete? }`	ต้อง login	การควบคุมสิทธิ์
`hooks`	`CollectionHooks`	—	ดู hooks
`admin`	`CollectionAdmin`	—	ดู admin components

versions

ตัวเลือก	Type	ค่าเริ่มต้น
`keep`	`number`	`50`	จำนวนเวอร์ชันที่เก็บต่อเอกสาร เวอร์ชันเก่ากว่านั้นจะถูกลบ

hooks

แต่ละตัวเป็น list ของฟังก์ชัน Hooks

Hook	อาร์กิวเมนต์	ค่าที่คืน
`beforeValidate`	`data`, `operation`, `previousDoc?`	data ใหม่ หรือไม่คืน
`beforeChange`	`data`, `operation`, `previousDoc?`	data ใหม่ หรือไม่คืน
`afterChange`	`doc`, `operation`, `previousDoc?`	—
`beforeDelete`	`id`	—
`afterDelete`	`id`, `doc`	—
`afterRead`	`doc`	doc ใหม่ หรือไม่คืน

ทุก hook ได้ user, cms และ slug ด้วย

Admin components

ตัวเลือก	Type
`icon`	`AdminIcon`	ไอคอนในเมนู ค่าเริ่มต้น `file-text` แบรนด์
`order`	`number`	ตำแหน่งในกลุ่มของเมนู ค่าน้อยมาก่อน ที่ไม่ได้ตั้งจะตามมาตามลำดับใน config
`editIn`	`'page' \| 'drawer'`	`drawer` แก้ในแผงที่เลื่อนมาทับรายการ (ใช้ได้เมื่อไม่มี drafts, versions หรือ preview) ค่าเริ่มต้น `page`
`sidebar`	`SidebarPanel[]`	กล่องในแถบข้างของหน้าแก้ไข `{ tag, props, position: 'top' }` วางไว้บนสุด Admin components
`group`	`string \| Label \| false`	กลุ่มในเมนู: id ของกลุ่ม (`admin.nav` เช่น `shop.catalog`), `settings` (ตั้งค่า › เว็บไซต์) หรือ label ซึ่งสร้างกลุ่มชื่อนั้น `false` คือไม่อยู่ในเมนู เข้าถึงผ่านลิงก์ ค่าเริ่มต้น: เนื้อหา ระบบจัดการ
`layout`	`LayoutNode[]`	แท็บ ส่วนที่พับได้ และแถวของหน้าแก้ไข ตามชื่อ field ระบบจัดการ
`badge`	`{ where, tone?, label? }`	ตัวเลขข้างรายการในเมนู: เอกสารที่ตรง `where` ที่ผู้ใช้อ่านได้ เช่น คำสั่งซื้อรอจัดส่ง
`count`	`boolean`	จำนวนเอกสารข้างรายการในเมนู ค่าเริ่มต้น `true`
`empty`	`{ description?, link? }`	ข้อความในหน้ารายการเมื่อยังไม่มีเอกสาร และลิงก์ (`{ label, href }`)
`list`	`{ tree?, sort? }`	หน้ารายการ: `tree` คือชื่อ relationship ไปหา collection เดียวกัน เพื่อแสดงเป็นต้นไม้ (เอกสารระดับบนก่อน เอกสารลูกเปิดอยู่ข้างใต้) ส่วน `sort` คือลำดับเริ่มต้น เช่น `'title'`
`calendar`	`{ start, end?, color? }`	โหมดปฏิทินข้างหน้ารายการ: `start` และ `end` เป็น field วันที่ระดับบนสุด `color` เป็น field select หรือ relationship (ไม่ใช่ hasMany) ที่ใช้แยกสีเอกสาร ระบบจัดการ
`ownerField`	`string`	เมื่อเปิด `auth.rbac`: relationship ไปที่ `users` ที่บอกเจ้าของ เช่น `'author'` สำหรับบทบาทที่ได้ "เฉพาะเอกสารของตัวเอง" ค่าเริ่มต้น: ผู้สร้าง (`createdBy`) บทบาทและสิทธิ์
`confirmDelete`	`{ typeTitle?, impact? }`	ถามมากขึ้นก่อนลบ: `typeTitle` ให้พิมพ์ชื่อ `impact` คือ path ใต้ API ที่เรียกพร้อม `?id=` แล้วคืน `{ message }` บอกสิ่งที่จะหายไปด้วย ลบจากการเลือกหลายรายการไม่ได้

globals

ตัวเลือก	Type	ค่าเริ่มต้น
`slug`	`string`	—	จำเป็น
`fields`	`Field[]`	—	จำเป็น
`label`	`string \| { en, th }`	สร้างจาก slug
`drafts`	`boolean`	`false`
`versions`	`boolean \| VersionsConfig`	`false`
`schedule`	`boolean`	`false`	ต้องมี `drafts`
`httpCache`	`false \| { sMaxAge?, staleWhileRevalidate? }`	ตาม config	เหมือน collection
`preview`	`({ doc, locale }) => string \| null`	—
`access`	`{ read?, update? }`	ต้อง login
`scope`	`({ context, user }) => string \| null \| undefined`	—	เก็บค่าแยกตาม scope เช่นต่อ tenant: string ได้ค่าของตัวเอง `undefined` ใช้ค่ากลาง `null` ไม่มี (อ่านได้ค่าว่าง แก้ไม่ได้)
`hooks`	`GlobalHooks`	—	ดูด้านล่าง
`admin`	`ContainerAdmin`	—	`{ icon, order, group, sidebar, layout }` เหมือน collection ไอคอนเริ่มต้นคือ `settings` และกลุ่มเริ่มต้นคือ ตั้งค่า › เว็บไซต์

Hook ของ global

Hook	อาร์กิวเมนต์	ค่าที่คืน
`beforeValidate`	`data`, `operation`, `previousDoc?`	data ใหม่ หรือไม่คืน
`beforeChange`	`data`, `operation`, `previousDoc?`	data ใหม่ หรือไม่คืน
`afterChange`	`doc`, `operation`, `previousDoc?`	—
`afterRead`	`doc`	doc ใหม่ หรือไม่คืน

endpoints

ตัวเลือก	Type
`path`	`string`	ใต้ `routes.api` เช่น `/seo/generate` หรือ `/stats/:collection` segment แรกห้ามเป็น slug ของ collection หรือชื่อที่ API ในตัวใช้ (path ที่สงวนไว้)
`method`	`'get' \| 'post' \| 'put' \| 'patch' \| 'delete'`
`handler`	`(request: EndpointRequest) => unknown`	คืน `Response` หรือค่าที่ส่งเป็น JSON Endpoints
`root`	`boolean`	เสิร์ฟ path จาก root ของเว็บ (เฉพาะ standalone server) เช่น `/robots.txt` ค่าเริ่มต้น `false`

EndpointRequest

Property	Type
`request`	`Request`	request แบบ Web
`url`	`URL`	URL ของ request
`params`	`Record<string, string>`	ค่าของ segment แบบ `:name`
`user`	`AuthUser \| null`	ผู้ใช้ที่ login อยู่
`context`	`RequestContext`	context ของ request (`onRequest`) ส่งต่อให้ Local API พร้อม `user`
`ip`	`string \| undefined`	IP ของ client ถ้า adapter รู้
`cms`	`EasyCMS`	Local API
`json`	`() => Promise<object>`	body แบบ JSON (ต้องเป็น object ขนาดไม่เกิน 1 MB)
`text`	`() => Promise<string>`	body ตามที่ส่งมาเป็นข้อความ (ไม่เกิน 1 MB) เช่นใช้ตรวจลายเซ็นของ webhook

เริ่มต้น

เนื้อหา

การใช้เนื้อหา

Plugins

การดูแลระบบ

การ Deploy

สูตรสำเร็จ

อ้างอิง

อ้างอิง config

ระดับบนสุด

routes

admin

brand

pages

dashboard

backups

audit

httpCache

logs

auth

members

upload

fromURL

ขนาดรูป

localization

webhooks

jobs

collections

versions

hooks

Admin components

globals

Hook ของ global

endpoints

EndpointRequest

เริ่มต้น

เนื้อหา

การใช้เนื้อหา

Plugins

การดูแลระบบ

การ Deploy

สูตรสำเร็จ

อ้างอิง

อ้างอิง config

ระดับบนสุด

routes

admin

brand

pages

dashboard

backups

audit

httpCache

logs

auth

members

signUp

upload

fromURL

ขนาดรูป

localization

webhooks

jobs

collections

versions

hooks

Admin components

globals

Hook ของ global

endpoints

EndpointRequest