Files
web-alterflixhub/docs/admin-guide.md
T
Bkk1234 319c271d23 feat: บทความ 2 หน้า + แชร์/ลิงก์ย่อ + PWA + แอนิเมชัน + SEO/AI + เอกสาร
- บทความจากหลังบ้าน: /for-film-lovers, /for-cinemas (ArticlePage + ArticleEditor แบบบล็อกย่อหน้า/รูป)
- แชร์: ปุ่มบนการ์ดและท้ายหน้ารายละเอียด · ลิงก์ย่อ /c/<slug> (302) · ธีมแก้วตาม DESIGN.md
- PWA: manifest/sw/offline + ถอดการล็อกซูม (WCAG 1.4.4) + touch target ≥44px
- แอนิเมชัน reveal: IntersectionObserver + gate ด้วย html.fx-motion · เคารพ prefers-reduced-motion
- ค้นหา: normalize/ตัดวรรณยุกต์ + AND หลายคำ + จัดอันดับ · รองรับ /?q= จาก SearchAction
- SEO: pageMeta (canonical/OG/Twitter) + JSON-LD (WebSite/Organization/BreadcrumbList/MovieTheater/Article)
- ไม่ฝังโดเมนในโค้ด: origin มาจาก request (x-forwarded-host/proto) ทั้ง canonical, sitemap, robots, ลิงก์แชร์
- กัน AI: robots.txt (Nitro route, บล็อก AI 21 ตัว) + ai.txt + OG image 1200x630
- เอกสาร: README สรุปโปรเจกต์, DESIGN.md (motion/PWA/SEO/ข้อมูล), architecture.html, admin-guide
- tests: 135 ผ่าน (16 ไฟล์)
2026-11-10 02:31:10 +07:00

16 KiB

คู่มือใช้งานหลังบ้าน AlterFlixHub

คู่มือนี้ตอบคำถาม "แก้ตรงไหน" ทีละงาน — ทุกอย่างอยู่ใน http://localhost:8080/admin (ล็อกอินด้วย ADMIN_USERNAME / ADMIN_PASSWORD ใน .env; ค่าเริ่มต้นคือ it is me / it is me&it is me)

หน้าหลังบ้านมี 7 แท็บ: โรงหนัง · หน้าเกี่ยวกับเรา · สำหรับคนทำโรงหนัง · สำหรับคนรักหนัง · คำศัพท์หลายภาษา · Footer / ไอคอน · สถิติการค้นหา


1. เพิ่ม / แก้ไขโรงหนัง

แท็บ โรงหนัง → เลือกโรงจากรายการซ้าย (หรือกด + เพิ่มโรงหนัง)

ฟอร์มแบ่งเป็น หมวดพับได้ — คลิกหัวหมวดเพื่อกาง ทำทีละหมวดแล้วกด บันทึกทั้งหมด (แถบปุ่มติดล่างจอ):

หมวด มีอะไร
ข้อมูลหลัก ชื่อ EN/TH · slug (URL) · ตัวเลือก "ซ่อนโรงนี้จากหน้าเว็บ"
หมวดหมู่ & สิ่งอำนวยความสะดวก ชิปหมวด (เลือกได้หลายอัน) + ชิปหัวข้อสิ่งอำนวยความสะดวก + ช่องชื่อหัวข้อเฉพาะโรง
การเดินทาง & การติดต่อ วิธีเดินทาง (icon/TH/EN) · หัวข้อ "สอบถามข้อมูลและจองตั๋ว" · ช่องทางติดต่อ (Website/Facebook/Call) · รูปภาพ · การชำระเงิน
ที่ตั้ง & แผนที่ ที่ตั้ง TH/EN · ละติจูด/ลองจิจูด · Google map URL · ที่อยู่ (บรรทัดละรายการ)
คำอธิบายโรงหนัง คำอธิบาย TH/EN ที่แสดงใต้ชื่อโรง

slug (URL)

  • ระบบ ดึงจากชื่ออังกฤษให้อัตโนมัติ จนกว่าคุณจะแก้เอง (แก้แล้วจะไม่ถูกทับ)
  • พิมพ์อะไรก็ได้ระหว่างแก้ แต่ตอนออกจากช่องจะถูกจัดรูป: ตัวเล็ก, ช่องว่าง → -, ตัดอักขระอื่น
  • ถ้า ว่าง / ซ้ำกับโรงอื่น ระบบไม่ยอมบันทึกและบอกเหตุผล
  • ⚠️ เปลี่ยน slug แล้วลิงก์เดิมจะใช้ไม่ได้ (ยังไม่มี redirect)

ซ่อนโรงหนัง

ติ๊ก "ซ่อนโรงนี้จากหน้าเว็บ" → หายจากหน้าแรก/ผลค้นหา/"โรงหนังอิสระอื่นๆ" แต่เปิดดูด้วย URL ตรงได้ (ใช้เตรียมข้อมูลก่อนเปิดตัว) — เอาติ๊กออกแล้วบันทึกเพื่อกลับมาแสดง

สลับลำดับโรงหนัง

รายการซ้ายมี 2 โหมด: ลำดับที่จัดไว้ (ลากวาง หรือกด ↑ ↓) และ ก.ไก่-ฮ.นกฮูก (เรียงชื่อไทยให้ดู) โหมดเรียง ก-ฮ เป็นแค่การดู — กด ใช้ลำดับ ก-ฮ นี้ เพื่อเอาลำดับนั้นมาใช้จริง เมื่อลำดับเปลี่ยนจะมีปุ่ม บันทึกลำดับใหม่ (หรือกด "บันทึกทั้งหมด" ก็ได้)

หน้าแรกสลับการ์ดเองทุกวัน — ลำดับที่จัดไว้จะถูกใช้เป็น "ลำดับฐาน" แล้วระบบหมุน/สลับให้อัตโนมัติ เพื่อไม่ให้โรงใดอยู่ตำแหน่งเดิมสองวันติดกัน (ทุกคนเห็นเหมือนกันในวันเดียวกัน) — รายละเอียดดู DESIGN.md หัวข้อ "ลำดับการ์ดหน้าแรก"


2. รูปภาพโรงหนัง

หมวด การเดินทาง & การติดต่อ → ส่วน รูปภาพโรงหนัง → + เพิ่มรูป

  1. ใส่ URL (https://…) หรือ path ในโปรเจกต์ (/images/ชื่อไฟล์.jpg)
  2. รูปแรก = รูปปกการ์ดหน้าแรก และภาพหลักในแกลเลอรีหน้า detail
  3. มีไม่ครบ 3 รูป ช่องที่เหลือจะแสดงโลโก้ AlterFlixHub แทน
  4. สลับลำดับด้วย ↑ ↓ · ลบด้วยถังขยะ · แล้วกด บันทึกทั้งหมด

ไฟล์ในเครื่อง: วางที่ public/images/… แล้วใส่ /images/…


3. หมวดหมู่ (categories)

หมวด หมวดหมู่ & สิ่งอำนวยความสะดวก → กดชิปที่ต้องการ (เลือกได้หลายอัน) หรือพิมพ์เองในช่องใต้ชิป (คั่นด้วย ,)

หมวดที่ใช้ได้ตอนนี้: ยอดนิยม · อาร์ตเฮาส์ · สารคดี · หนังสั้น · หนังคลาสสิก · หนังนานาชาติ · หนังนอกกระแส · หนังในกระแส · หนังฝรั่งเศส · กลุ่มคนฉายหนัง · หนังไทย

  • แถบกรองหน้าแรกสร้างจากรายการเดียวกับชิปนี้
  • อยากได้คำแปลหมวดอื่น → แท็บ คำศัพท์หลายภาษา → key categories.<ชื่อหมวด>

4. สิ่งอำนวยความสะดวก

  1. ติ๊กชิปหัวข้อที่โรงนั้นมีจริง (โซนนั่งรอ, จุดจำหน่ายตั๋ว, ร้านอาหาร, …)
  2. ใต้ชิปมีช่อง ชื่อหัวข้อ ของแต่ละหัวข้อ (ช่องเดียว ใช้ทั้ง TH/EN) — ว่าง = ใช้ชื่อเริ่มต้น
  3. คำอธิบาย (TH/EN) จะแสดงเฉพาะโรง house-cinema-samyan (ข้อมูลครบแล้ว) — โรงอื่นไม่ต้องกรอก และหน้าเว็บจะไม่แสดงบรรทัดคำอธิบาย
  4. ไม่ติ๊กเลย = หน้าเว็บขึ้น "ไม่มีข้อมูล"

5. การเดินทาง

หมวด การเดินทาง & การติดต่อ → การเดินทาง

  • แต่ละแถว: วิธีเดินทาง (รถยนต์ส่วนตัว / รถไฟฟ้า / รถประจำทาง) + รายละเอียด TH + EN
  • + เพิ่มวิธีเดินทาง / ถังขยะลบ · แถวที่ยังไม่กรอกจะไม่แสดงบนหน้าเว็บ

6. การ์ด "สอบถามข้อมูลและจองตั๋ว" + ช่องทางติดต่อ

หมวด การเดินทาง & การติดต่อ

อยากแก้ ช่อง
หัวข้อการ์ด "หัวข้อ 'สอบถามข้อมูลและจองตั๋ว' (เฉพาะโรงนี้)" — ว่าง = ใช้ค่ากลาง
Website / Facebook / Call แถว ช่องทางติดต่อ → ป้ายชื่อ / ข้อความที่แสดง / ลิงก์
เพิ่มช่องทางใหม่ + เพิ่มช่องทางติดต่อ (ป้ายชื่อมีตัวเลือกแนะนำ)
เบอร์โทรให้กดโทรได้ ลิงก์ใส่ tel:+668…

ค่ากลางของหัวข้อ (มีผลทุกโรงที่ไม่ได้กรอก) → แท็บ คำศัพท์หลายภาษา → detail.contactTitle


7. ที่ตั้งและแผนที่

หมวด ที่ตั้ง & แผนที่

  • แผนที่ในหน้า detail เลือกแหล่งตามลำดับ: Google map URL → พิกัด (ละติจูด/ลองจิจูด) → ถ้าไม่มีทั้งคู่ขึ้น "ไม่มีข้อมูล"
  • ใส่พิกัดเป็นทศนิยม (เช่น 13.7466 / 100.5347) — 0 ถือว่ายังไม่กรอก
  • ที่อยู่ใส่ "บรรทัดละรายการ" (ไม่ใช้ comma เพราะที่อยู่ EN มี comma)

8. การชำระเงิน

ช่อง ชำระเงิน (คั่นด้วย ,) — ค่าเริ่มต้นของโรงใหม่คือ เงินสด และลบได้ พิมพ์ , ได้ตามปกติ (ระบบเก็บข้อความดิบระหว่างพิมพ์แล้วจัดรูปให้ตอนออกจากช่อง)


9. หน้า "เกี่ยวกับเรา"

แท็บ หน้าเกี่ยวกับเรา → เลือกภาษา (TH/EN) → แก้ title, lead, แต่ละหัวข้อ, หัวข้อ/ข้อความติดต่อ มีตัวอย่างหน้าเว็บสด และปุ่ม คืนค่าตั้งต้น ต่อภาษา


10. หน้า "สำหรับคนทำโรงหนัง" และ "สำหรับคนรักหนัง" (บทความ)

สองหน้านี้ใช้ตัวแก้ไขแบบเดียวกัน ต่างกันแค่แท็บ — สำหรับคนทำโรงหนัง → /for-cinemas · สำหรับคนรักหนัง → /for-film-lovers

ในแท็บ เลือกภาษา (TH/EN) แล้วเขียนบทความแบบบล็อก:

  • + เพิ่มย่อหน้า — เพิ่มช่องข้อความทีละย่อหน้า (ขึ้นบรรทัดใหม่ได้ตามที่พิมพ์)
  • + เพิ่มรูปภาพ — ใส่ลิงก์รูป (/images/… หรือ URL เต็ม) + คำอธิบายรูป (alt จำเป็นต่อการเข้าถึง) + คำบรรยายใต้รูป (ไม่ใส่ก็ได้) พร้อมพรีวิวรูปในฟอร์ม
  • ปุ่ม ↑ ↓ สลับลำดับบล็อก · ลบ เอาบล็อกออก
  • แก้ หัวเรื่อง (H1), คำเกริ่นนำ, และ การ์ดติดต่อ (หัวข้อ + ข้อความ) ได้ในแท็บเดียวกัน
  • ตัวนับด้านบนบอกจำนวนย่อหน้า/รูป · ปุ่ม คืนค่าตั้งต้น คืนข้อความเริ่มต้นของภาษานั้น
  • กด บันทึกหน้าสำหรับคนทำโรงหนัง / บันทึกหน้าสำหรับคนรักหนัง → หน้าเว็บอัปเดตทันที (รูปแสดงตามลำดับที่วางไว้)

  • คำศัพท์หลายภาษา: แก้ข้อความทุกจุดในหน้าเว็บด้วย key (เช่น hero.subtitle, detail.contactTitle) — เว้นว่าง = ใช้ค่าเดิมจาก messages.ts
  • Footer / ไอคอน: เพิ่ม/แก้ไอคอนโซเชียล (ชื่อไอคอน Tabler เช่น IconBrandFacebook)

12. สถิติการค้นหา

แท็บ สถิติการค้นหา — เลือกช่วง 1 / 7 / 30 / 90 วัน: คำคันยอดนิยม, คำค้นที่ไม่พบผล, CTR, ผลลัพธ์เฉลี่ย, หมวดที่ถูกใช้, โรงที่ถูกเปิด/คลิก, การค้นหารายวัน

หมวด "ยอดนิยม" ทำงานอย่างไร

  • ยังไม่จัดอันดับจากสถิติจนกว่าข้อมูลจะครบ 6 เดือน (180 วัน) — ระหว่างนี้ใช้ป้าย "ยอดนิยม" ที่ติ๊กเอง
  • หน้าเว็บจะไม่แสดงข้อความแจ้งเรื่องนี้ (ผู้ใช้สั่งลบ) — วันเหลือดูได้จากค่า computePopularity() ในเซิร์ฟเวอร์/บันทึกระบบเท่านั้น
  • เมื่อครบ 6 เดือน ระบบสลับไปจัดอันดับเอง: cinema_view = 1, cinema_select = 1.5, ลดน้ำหนักครึ่งชีวิต 30 วัน, นับเฉพาะ 90 วันล่าสุด, เอา top 8

13. ข้อควรระวัง

  • กด "บันทึกทั้งหมด" ทุกครั้ง — การแก้ในฟอร์มยังไม่ถูกบันทึกจนกว่าจะกดปุ่ม
  • ช่องที่กรอกคั่นด้วย , (หมวด/ชำระเงิน) จะถูกจัดรูปให้เป็น , ตอนออกจากช่อง
  • อย่าแก้ data/content/content.json ด้วยมือระหว่างเซิร์ฟเวอร์รัน — ใช้หลังบ้านหรือ API
  • ถ้าต้องแก้จำนวนมาก ให้ใช้ "แก้ไขดิบเป็น JSON" (ท้ายฟอร์ม) หรือ "วาง JSON เพื่อเพิ่มโรงหนัง"