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 และฟิลด์แบบโต้ตอบอื่น ๆ จะทำงานได้อย่างถูกต้องตามแต่ละภาษา

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

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

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

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

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

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

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

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

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

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

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

เว็บไซต์ที่ใช้งานจริงหลายแห่งลงทะเบียนฟิลด์ ACF ใน PHP แทนที่จะใช้หน้า UI ของผู้ดูแลระบบ ACF (เพื่อความสะดวกในการพกพา การควบคุมเวอร์ชัน หรือการกำหนดค่าที่มาพร้อมกับธีม) ACFML 2.2.0 (ก.พ. 2026) มาพร้อมกับการรองรับฟิลด์ในเครื่องอย่างเต็มรูปแบบ คุณสามารถตั้งค่าการแปลของแต่ละฟิลด์ได้ด้วยคีย์ wpml_cf_preferences ในการกำหนดกลุ่มฟิลด์ ซิงค์เข้ากับ WPML จาก ACF > Tools และหน้าจอผู้ดูแลระบบจะแสดงผลตามที่กลุ่มฟิลด์ประกาศไว้ ไฟล์ 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 สำหรับพฤติกรรมการแปลแบบใหม่ การทำงานร่วมกันนี้จะถูกสร้างขึ้นมาด้วยกันแทนที่จะใช้วิธีวิศวกรรมย้อนกลับ