Files
web-alterflixhub/docs/admin-guide.md
T
Bkk1234 42572020d8 fix(contacts): ช่องทางติดต่อกดใช้ได้จริง (tel:/mailto:/โซเชียล) + ซ่อมข้อมูลเดิม
ปัญหา: href ในข้อมูลดิบไม่สม่ำเสมอ (ว่าง / www. ไม่มี scheme / เบอร์ไม่มี tel: /
facebook ติด fbclid) ทำให้กดแล้วไม่เกิดอะไร และปุ่มโทรใช้ไม่ได้

- app/lib/contact-link.ts: resolveContact() จับคู่ลิงก์ตามชนิด
  · เบอร์ → tel:+66… (แปลง 0 นำหน้า, ตัดขีด/ช่องว่าง/วงเล็บ)
  · อีเมล → mailto: · LINE @id → line.me · เว็บ → https + ตัด fbclid/_rdc/utm_*
- ContactPanel: ไอคอนตามชนิด (phone/mail/fb/ig/line/ticket/globe),
  tel/mailto เปิดแท็บเดิม, เว็บเปิดแท็บใหม่; แถวที่ไม่มีลิงก์แสดงเป็นข้อความ (ไม่หลอกให้กด)
- sanitizeCinemas: คำนวณ href ใหม่ทุกครั้งที่บันทึก → ข้อมูลเก่าไม่กลับมาเพี้ยน
- ContactsEditor: auto-format ตอนออกจากช่อง + พรีวิว "✓ กดโทรได้ → tel:+66…"
- scripts/audit-contacts.mjs [--fix]: ตรวจ/ซ่อมทั้งไฟล์ (แก้ไป 13 จุด, สำรองข้อมูลแล้ว)
- contact-link.spec.ts 13 tests · docs: admin-guide/api/DESIGN
2026-11-15 23:56:46 +07:00

19 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. กด อัปโหลดรูปจากเครื่อง แล้วเลือกไฟล์ (เลือกหลายไฟล์พร้อมกันได้) — หรือ ลากไฟล์มาวาง ในกล่องนั้น หรือ Ctrl+V วางรูปจากคลิปบอร์ด
  2. รองรับ JPG / PNG / WebP / AVIF ขนาดไม่เกิน 8 MB ต่อไฟล์ · ไฟล์จะถูกเก็บที่ data/uploads/cinemas/ และได้ URL รูปแบบ /uploads/cinemas/<ไฟล์> ใช้อ้างในหน้าเว็บได้ทันที
  3. ถ้าอยากใช้รูปที่วางบนเว็บอยู่แล้ว กด เพิ่มช่อง URL แล้ววางลิงก์ (/images/… หรือ URL เต็ม) — ไม่แนะนำลิงก์จาก Google Maps/Facebook เพราะลิงก์หมดอายุและทำให้รูปแตก
  4. รูปแรก = รูปปกการ์ดหน้าแรก และภาพหลักในแกลเลอรีหน้า detail — สลับลำดับด้วยปุ่ม ↑/↓
  5. มีไม่ครบ 3 รูป ช่องที่เหลือจะแสดงโลโก้ AlterFlixHub แทน
  6. อย่าลืมกด บันทึก ท้ายฟอร์ม — รูปจะขึ้นหน้าเว็บทันทีหลังบันทึก

ไฟล์ในเครื่อง (สำหรับรูปที่เตรียมไว้ล่วงหน้า): วางที่ public/images/… แล้วใส่ /images/… · รูปที่อัปโหลดผ่านหลังบ้านจะอยู่ที่ data/uploads/cinemas/ (สำรองข้อมูลแยกจาก repo)


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

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

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

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

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

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

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

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

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

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

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

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

ระบบสร้างลิงก์ให้อัตโนมัติ (เห็นข้อความ ✓ กดโทรได้ → tel:+66… ใต้แถวนั้น)

กรอก ได้ลิงก์
098-869-0997 หรือ 0 9886 90997 tel:+66988690997 (แปลง 0 → +66 ให้)
[email protected] mailto:[email protected]
www.housesamyan.com / lidoconnect.com https://… (เปิดแท็บใหม่)
https://web.facebook.com/x/?_rdc=1&_rdr https://www.facebook.com/x/ (ตัด fbclid, _rdc, utm_* ให้)
@lineid https://line.me/R/ti/p/~lineid
  • ถ้าขึ้น ⚠ ค่านี้ยังใช้เป็นลิงก์ไม่ได้ = ข้อความนั้นไม่ใช่เบอร์/อีเมล/โดเมน → แก้ค่าให้เป็นอย่างใดอย่างหนึ่ง
  • แถวที่ไม่มีลิงก์จะแสดงเป็น ข้อความธรรมดา (ไม่หลอกให้กด)
  • ตรวจ/ซ่อมทั้งไฟล์พร้อมกัน: node scripts/audit-contacts.mjs (ดู) · node scripts/audit-contacts.mjs --fix (เขียนกลับ + สำรองไฟล์)

ค่ากลางของหัวข้อ (มีผลทุกโรงที่ไม่ได้กรอก) → แท็บ คำศัพท์หลายภาษา → 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 เพื่อเพิ่มโรงหนัง"