ACFML – ฟิลด์ที่กำหนดเองของ ACF และ ACF Pro แบบหลายภาษาใน WordPress

ฟิลด์ของ ACF ทุกประเภทสามารถทำเป็นหลายภาษาได้

หากคุณสร้างเว็บไซต์ด้วย ACF ปลั๊กอิน ACFML จะครอบคลุมฟิลด์ทุกประเภทในแคตตาล็อกของ ACF และ ACF Pro:

• ฟิลด์ Text และ Wysiwyg สามารถแปลได้ตามแต่ละภาษา
• แถวของ Repeater และ Flexible Content จะจัดเรียงตรงกันในทุกภาษา
• ฟิลด์ Image, File และ Gallery สามารถสลับไปใช้ไฟล์ที่ปรับให้เข้ากับแต่ละภาษาได้
• ฟิลด์ Link, Relationship และ Post Object จะยังคงเชื่อมโยงกันอย่างถูกต้องระหว่างภาษาต่าง ๆ
• ฟิลด์ Date Picker, Color Picker, Map และฟิลด์แบบโต้ตอบอื่น ๆ จะทำงานได้อย่างถูกต้องตามแต่ละภาษา

ประเภทโพสต์แบบกำหนดเอง อนุกรมวิธาน และ Options Page ที่คุณลงทะเบียนผ่าน ACF ก็สามารถแปลได้เช่นกัน รวมถึงป้ายกำกับด้วย เว็บไซต์ที่คุณสร้างด้วย ACF จะกลายเป็นเว็บไซต์หลายภาษาด้วย ACFML อย่างสมบูรณ์ ไม่ใช่แค่เพียงบางส่วน

เลือกสิ่งที่เหมือนกันและสิ่งที่แตกต่างกันในแต่ละภาษา

Field Group ของ ACF ไม่มีพฤติกรรมการแปลแบบสำเร็จรูปที่ใช้ได้กับทุกกรณี หน้า Our Team บนเว็บไซต์ของคุณอาจแสดงสมาชิกทีมคนเดียวกันในทุกภาษา: คุณแปลชื่อและประวัติของพวกเขา โดยคงโครงสร้างเดิมไว้ หน้า Events อาจแสดงกิจกรรมที่แตกต่างกันสำหรับผู้ชมที่ต่างกัน: คุณสามารถแสดงกิจกรรมที่แตกต่างกันโดยสิ้นเชิงในแต่ละภาษา หน้า Product Specs อาจแสดงแบบผสมผสาน: คุณแปลคำอธิบาย แต่คง SKU และราคาให้เหมือนกัน

ACFML จัดการทั้งสามกรณีนี้ในระดับ Field Group ได้แก่ Same fields across languages, Different fields across languages และ Expert Mode สำหรับการตั้งค่าแบบผสม เลือกโหมดที่ตรงกับจุดประสงค์ของแต่ละ Field Group แล้ว ACFML จะเชื่อมโยงพฤติกรรมการแปลให้โดยอัตโนมัติ

การควบคุมการแปลแบบรายฟิลด์

ภายใน Field Group ทุกฟิลด์จะมีการตั้งค่าการแปลของตัวเอง:

• แปล ค่าของฟิลด์จะถูกแปลตามแต่ละภาษา
• คัดลอก ค่าของฟิลด์จะซิงค์กันในทุกภาษา เมื่อแก้ไขครั้งเดียว การเปลี่ยนแปลงจะถูกส่งต่อไปยังภาษาอื่น ๆ
• คัดลอกครั้งเดียว ค่าของฟิลด์จะถูกใช้เป็นจุดเริ่มต้นสำหรับคำแปลใหม่ จากนั้นในแต่ละภาษาจะสามารถแก้ไขได้อย่างอิสระ
• ไม่ต้องแปล ฟิลด์นี้จะถูกละเว้นโดยสิ้นเชิง (เช่น ฟิลด์ภายในสำหรับผู้ดูแลระบบเท่านั้น)

มีการตั้งค่าเริ่มต้นที่เหมาะสมสำหรับฟิลด์แต่ละประเภทมาให้ใช้งานได้ทันที: ฟิลด์ Text และ Wysiwyg จะตั้งค่าเริ่มต้นเป็น แปล ส่วนฟิลด์ที่มีโครงสร้างอย่าง Image, Link และ Number จะตั้งค่าเริ่มต้นเป็น คัดลอก คุณสามารถดูข้อมูลอ้างอิงพรีเซ็ตฉบับเต็มได้ที่ วิธีแปลฟิลด์ที่กำหนดเองของ ACF

แถวของ Repeater และ Flexible Content จัดเรียงตรงกันในทุกภาษา

ฟิลด์ Repeater และ Flexible Content มักเป็นจุดที่การตั้งค่า ACF แบบหลายภาษาเกิดปัญหาเมื่อใช้เครื่องมืออื่น: แถวไม่ซิงค์กัน เลย์เอาต์ผิดเพี้ยน และนักแปลเห็นเนื้อหาที่พวกเขาไม่รู้จัก ACFML จะรักษาโครงสร้างแถวให้ตรงกันในทุกภาษาโดยค่าเริ่มต้น นักแปลจะเห็นแถวเดียวกันในลำดับเดียวกัน พร้อมกับมีฟิลด์ย่อยที่แปลได้อยู่ในตำแหน่งที่ถูกต้อง หากคุณต้องการโครงสร้างที่แตกต่างกันในแต่ละภาษา (เช่น รายการกิจกรรมที่ต่างกันในแต่ละภาษา) การตั้งค่า คัดลอกครั้งเดียว จะช่วยให้คุณทำสิ่งนั้นได้

ฟิลด์แบบโลคัล (ลงทะเบียนด้วย PHP) จะมีพฤติกรรมการแปลเหมือนกัน

เว็บไซต์ที่ใช้งานจริงหลายแห่งเลือกลงทะเบียนฟิลด์ ACF ด้วย PHP แทนที่จะใช้หน้าจอผู้ดูแลระบบของ ACF (เพื่อความสะดวกในการย้าย การควบคุมเวอร์ชัน หรือการตั้งค่าที่มาพร้อมกับธีม) ACFML 2.2.0 (กุมภาพันธ์ 2026) มาพร้อมกับการรองรับฟิลด์แบบโลคัลอย่างเต็มรูปแบบ คุณสามารถกำหนดการตั้งค่าการแปลของแต่ละฟิลด์ได้ด้วยคีย์ wpml_cf_preferences ในคำจำกัดความของ Field Group จากนั้นซิงค์เข้ากับ WPML จาก ACF > Tools แล้วหน้าจอผู้ดูแลระบบจะแสดงผลตามที่ Field Group ได้ประกาศไว้ ไฟล์ Local JSON ของ ACF จะนำการตั้งค่าเหล่านี้ติดไปด้วยเมื่อคุณส่งออกและนำเข้าระหว่างเว็บไซต์ ขั้นตอนโดยละเอียดอยู่ในหน้าวิธีการใช้งานภายใต้หัวข้อ การตั้งค่าการแปลสำหรับฟิลด์ที่ลงทะเบียนด้วย PHP หรือ JSON

ฮุกสำหรับนักพัฒนาเพื่อรองรับกรณีเฉพาะ

สำหรับเว็บไซต์ที่มีตรรกะการแปลฟิลด์แบบกำหนดเอง (เช่น การยกเว้นบางฟิลด์ การแทนที่การตั้งค่าเริ่มต้นสำหรับฟิลด์บางประเภทแบบโกลบอล หรือการซ่อนคำอธิบายประกอบจากนักแปล) ACFML มีฟิลเตอร์ให้ใช้งานสองตัว (acfml_should_translate_acf_entity, acfml_field_group_mode_field_translation_preference) และค่าคงที่สี่ตัว (ACFML_EXCLUDE_FIELD_GROUP_STRINGS_IN_POST_JOBS, ACFML_HIDE_FIELD_ANNOTATIONS, ACFML_REPEATER_SYNC_DEFAULT, ACFML_SCAN_LOCAL_FIELDS) คุณสามารถดูข้อมูลอ้างอิงฉบับเต็มพร้อมตัวอย่างโค้ดได้ที่ ข้อมูลอ้างอิงฮุกและค่าคงที่ของ ACFML

สร้างและดูแลรักษาร่วมกับทีมงาน ACF

WPML และทีมงาน ACF ทำงานร่วมกันอย่างใกล้ชิดเพื่อรักษาความเข้ากันได้อย่างต่อเนื่อง ซึ่งได้รับการยืนยันใน หน้าความเข้ากันได้ของ ACF ที่ทำร่วมกัน เมื่อ ACF หรือ ACF Pro ออกเวอร์ชันใหม่ ACFML ก็จะอัปเดตตามให้ทันเสมอ และเมื่อ ACFML ต้องการการรองรับจากฝั่ง ACF สำหรับพฤติกรรมการแปลแบบใหม่ การทำงานร่วมกันนี้จะถูกสร้างขึ้นมาด้วยกันแทนที่จะใช้วิธีวิศวกรรมย้อนกลับ