14 KiB
คู่มือใช้งานหลังบ้าน AlterFlixHub
คู่มือนี้ตอบคำถาม "แก้ตรงไหน" ทีละงาน — ทุกอย่างอยู่ใน http://localhost:8080/admin
(ล็อกอินด้วย ADMIN_USERNAME / ADMIN_PASSWORD ใน .env; ค่าเริ่มต้นคือ it is me / it is me&it is me)
หน้าหลังบ้านมี 5 แท็บ: โรงหนัง · หน้าเกี่ยวกับเรา · คำศัพท์หลายภาษา · 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. รูปภาพโรงหนัง
หมวด การเดินทาง & การติดต่อ → ส่วน รูปภาพโรงหนัง → + เพิ่มรูป
- ใส่ URL (
https://…) หรือ path ในโปรเจกต์ (/images/ชื่อไฟล์.jpg) - รูปแรก = รูปปกการ์ดหน้าแรก และภาพหลักในแกลเลอรีหน้า detail
- มีไม่ครบ 3 รูป ช่องที่เหลือจะแสดงโลโก้ AlterFlixHub แทน
- สลับลำดับด้วย ↑ ↓ · ลบด้วยถังขยะ · แล้วกด บันทึกทั้งหมด
ไฟล์ในเครื่อง: วางที่ public/images/… แล้วใส่ /images/…
3. หมวดหมู่ (categories)
หมวด หมวดหมู่ & สิ่งอำนวยความสะดวก → กดชิปที่ต้องการ (เลือกได้หลายอัน) หรือพิมพ์เองในช่องใต้ชิป (คั่นด้วย ,)
หมวดที่ใช้ได้ตอนนี้: ยอดนิยม · อาร์ตเฮาส์ · สารคดี · หนังสั้น · หนังคลาสสิก · หนังนานาชาติ · หนังนอกกระแส · หนังในกระแส · หนังฝรั่งเศส · กลุ่มคนฉายหนัง · หนังไทย
- แถบกรองหน้าแรกสร้างจากรายการเดียวกับชิปนี้
- อยากได้คำแปลหมวดอื่น → แท็บ คำศัพท์หลายภาษา → key
categories.<ชื่อหมวด>
4. สิ่งอำนวยความสะดวก
- ติ๊กชิปหัวข้อที่โรงนั้นมีจริง (โซนนั่งรอ, จุดจำหน่ายตั๋ว, ร้านอาหาร, …)
- ใต้ชิปมีช่อง ชื่อหัวข้อ ของแต่ละหัวข้อ (ช่องเดียว ใช้ทั้ง TH/EN) — ว่าง = ใช้ชื่อเริ่มต้น
- คำอธิบาย (TH/EN) จะแสดงเฉพาะโรง
house-cinema-samyan(ข้อมูลครบแล้ว) — โรงอื่นไม่ต้องกรอก และหน้าเว็บจะไม่แสดงบรรทัดคำอธิบาย - ไม่ติ๊กเลย = หน้าเว็บขึ้น "ไม่มีข้อมูล"
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. คำศัพท์หลายภาษา / Footer
- คำศัพท์หลายภาษา: แก้ข้อความทุกจุดในหน้าเว็บด้วย key (เช่น
hero.subtitle,detail.contactTitle) — เว้นว่าง = ใช้ค่าเดิมจากmessages.ts - Footer / ไอคอน: เพิ่ม/แก้ไอคอนโซเชียล (ชื่อไอคอน Tabler เช่น
IconBrandFacebook)
11. สถิติการค้นหา
แท็บ สถิติการค้นหา — เลือกช่วง 1 / 7 / 30 / 90 วัน: คำคันยอดนิยม, คำค้นที่ไม่พบผล, CTR, ผลลัพธ์เฉลี่ย, หมวดที่ถูกใช้, โรงที่ถูกเปิด/คลิก, การค้นหารายวัน
หมวด "ยอดนิยม" ทำงานอย่างไร
- ยังไม่จัดอันดับจากสถิติจนกว่าข้อมูลจะครบ 6 เดือน (180 วัน) — ระหว่างนี้ใช้ป้าย "ยอดนิยม" ที่ติ๊กเอง
- หน้าเว็บจะไม่แสดงข้อความแจ้งเรื่องนี้ (ผู้ใช้สั่งลบ) — วันเหลือดูได้จากค่า
computePopularity()ในเซิร์ฟเวอร์/บันทึกระบบเท่านั้น - เมื่อครบ 6 เดือน ระบบสลับไปจัดอันดับเอง:
cinema_view= 1,cinema_select= 1.5, ลดน้ำหนักครึ่งชีวิต 30 วัน, นับเฉพาะ 90 วันล่าสุด, เอา top 8
12. ข้อควรระวัง
- กด "บันทึกทั้งหมด" ทุกครั้ง — การแก้ในฟอร์มยังไม่ถูกบันทึกจนกว่าจะกดปุ่ม
- ช่องที่กรอกคั่นด้วย
,(หมวด/ชำระเงิน) จะถูกจัดรูปให้เป็น,ตอนออกจากช่อง - อย่าแก้
data/content/content.jsonด้วยมือระหว่างเซิร์ฟเวอร์รัน — ใช้หลังบ้านหรือ API - ถ้าต้องแก้จำนวนมาก ให้ใช้ "แก้ไขดิบเป็น JSON" (ท้ายฟอร์ม) หรือ "วาง JSON เพื่อเพิ่มโรงหนัง"