วิธีสร้าง Template Override ใน Joomla ด้วยโค้ด

Template Override คือไฟล์สำเนาที่เทมเพลตใช้แทนไฟล์แสดงผลเดิมของคอมโพเนนต์ โมดูล หรือส่วนเสริม ทำให้ปรับ HTML และ PHP ได้โดยไม่แก้ไฟล์ต้นฉบับ วิธีสร้างด้วยโค้ดคือคัดลอกไฟล์ Layout ที่ต้องการ แล้ววางไว้ในโฟลเดอร์ html ของเทมเพลตตามโครงสร้างที่ Joomla กำหนด

❶ เลือกไฟล์ที่ต้องการ Override

หาไฟล์ Layout ต้นฉบับของส่วนที่ต้องการปรับ เช่น ไฟล์แสดงผลของโมดูลเข้าสู่ระบบ หรือหน้าแสดงบทความ ตรวจสอบชื่อไฟล์และโฟลเดอร์ให้ตรงกับชนิดส่วนเสริมและ Layout

ก่อนเริ่ม ควรสำรองไฟล์ต้นฉบับและเทมเพลตไว้ก่อน การแก้ไฟล์ Layout ต้องเข้าใจตัวแปร PHP และข้อมูลที่ Joomla ส่งให้ไฟล์นั้น หากลบตัวแปรหรือโค้ดสำคัญ อาจทำให้ฟังก์ชันเดิมหยุดทำงาน

❷ สร้างตำแหน่งไฟล์ Override

โครงสร้างทั่วไปของ Override อยู่ใต้โฟลเดอร์ html ในเทมเพลต เช่น

/templates/ชื่อเทมเพลต/html/

ตัวอย่าง Override สำหรับโมดูล mod_login อาจอยู่ที่

/templates/cassiopeia/html/mod_login/default.php

ส่วน Layout ของคอมโพเนนต์อาจมีโฟลเดอร์ย่อยตามชื่อ View เช่น

/templates/cassiopeia/html/com_content/article/default.php

ชื่อไฟล์และโครงสร้างโฟลเดอร์ของ Override ต้องสอดคล้องกับไฟล์และเส้นทางของ Layout ต้นฉบับ

❸ คัดลอกไฟล์และแก้โค้ด

① คัดลอกไฟล์ต้นฉบับ

คัดลอกไฟล์ Layout ที่ต้องการจากโฟลเดอร์ของคอมโพเนนต์หรือโมดูล แล้วนำไปวางในเส้นทาง Override ที่ตรงกันภายใต้โฟลเดอร์เทมเพลต อย่าแก้ไฟล์ต้นฉบับของ Joomla หรือส่วนเสริมโดยตรง เพราะการอัปเดตอาจเขียนทับการแก้ไขนั้น

สามารถใช้เครื่องมือ Create Overrides ในหน้า Templates ของ Joomla เพื่อสร้างโครงสร้างและสำเนาไฟล์ให้ จากนั้นเปิดไฟล์ในโฟลเดอร์ html เพื่อแก้โค้ดได้ หรือสร้างโฟลเดอร์และคัดลอกไฟล์ผ่านเครื่องมือจัดการไฟล์หรือ SFTP ก็ได้

② แก้เฉพาะส่วนที่ต้องการ

ปรับ HTML หรือ PHP ในไฟล์สำเนา โดยคงตัวแปรและโครงสร้างที่จำเป็นต่อการทำงานเดิมไว้ หากนำค่าที่ผู้ใช้กรอกหรือข้อมูลจากฐานข้อมูลมาแสดง ให้ใช้การกรองและ Escape ตามบริบท เพื่อป้องกันการแสดงผลผิดรูปแบบหรือช่องโหว่ด้านความปลอดภัย

❹ ตรวจสอบว่า Joomla เรียกใช้ Override แล้ว

ล้างแคชที่เกี่ยวข้อง แล้วเปิดหน้าเว็บที่แสดงคอมโพเนนต์หรือโมดูลนั้น ตรวจสอบว่าการเปลี่ยนแปลงปรากฏจริง ทดสอบทั้งบนเดสก์ท็อปและมือถือ และลองใช้งานฟังก์ชันที่เกี่ยวข้อง เช่น ลิงก์ แบบฟอร์ม ปุ่ม และการแจ้งเตือน

หากไม่เห็นผล ให้ตรวจตามลำดับนี้

  • ใช้เทมเพลตที่มีไฟล์ Override เป็นเทมเพลตที่แสดงในหน้านั้นหรือไม่
  • ชื่อโฟลเดอร์และไฟล์ตรงกับเส้นทางของ Layout ต้นฉบับหรือไม่
  • มี Alternative Layout หรือ Override อีกชุดที่ถูกเลือกใช้แทนหรือไม่
  • มีแคชของ Joomla หรือแคชจากระบบอื่นค้างอยู่หรือไม่
  • ตรวจสอบ Log หากพบข้อผิดพลาด PHP

❺ ทบทวน Override หลังอัปเดต

การอัปเดต Joomla หรือส่วนเสริมอาจเปลี่ยนไฟล์ Layout ต้นฉบับ แต่ไฟล์ Override จะยังเป็นสำเนาเดิม จึงควรตรวจแท็บ Updated Files ในหน้า Templates เมื่อมีรายการแจ้งเตือน แล้วเปรียบเทียบไฟล์ต้นฉบับรุ่นใหม่กับ Override ของเว็บไซต์

หากต้นฉบับมีการแก้ไขด้านความปลอดภัยหรือเพิ่มตัวแปรที่จำเป็น ให้ปรับ Override ให้สอดคล้องและทดสอบการทำงานอีกครั้ง อย่าคัดลอกไฟล์ต้นฉบับทับ Override ทั้งไฟล์โดยไม่ตรวจความแตกต่าง เพราะอาจทำให้การปรับแต่งเดิมหายไป

❻ ใช้ Override อย่างเป็นระบบ

  • ตั้งชื่อโฟลเดอร์และไฟล์ให้ตรงตามรูปแบบของ Joomla
  • เก็บสำเนาต้นฉบับหรือบันทึกความแตกต่างไว้
  • ใช้ Git ติดตามการเปลี่ยนแปลงของไฟล์ในเทมเพลต
  • ทดสอบหลังอัปเดต Joomla และส่วนเสริมที่เกี่ยวข้อง
  • ลบ Override ที่ไม่ใช้แล้ว หลังตรวจสอบว่าไม่มีหน้าเว็บเรียกใช้งาน

ComSiam แนะนำให้สร้าง Override เฉพาะส่วนที่ต้องปรับจริง และตรวจเทียบกับไฟล์ต้นฉบับทุกครั้งหลังอัปเดต วิธีนี้ช่วยให้การปรับแต่งยังทำงานต่อได้ โดยไม่ต้องแก้ไฟล์ Core ของ Joomla