ACFML – Trường tùy chỉnh đa ngôn ngữ cho ACF và ACF Pro trong WordPress

Mọi loại trường của ACF đều là đa ngôn ngữ

Nếu bạn xây dựng trang web trên ACF, ACFML bao gồm mọi loại trường trong danh mục của ACF và ACF Pro:

• Các trường Text và Wysiwyg được dịch theo từng ngôn ngữ.
• Các hàng Repeater và Flexible Content luôn đồng bộ giữa các ngôn ngữ.
• Các trường Image, File và Gallery có thể chuyển đổi sang các tệp tin được bản địa hóa cho từng ngôn ngữ.
• Các trường Link, Relationship và Post Object luôn được liên kết chính xác giữa các ngôn ngữ.
• Các trường Date Picker, Color Picker, Map và các trường tương tác khác hoạt động chính xác theo từng ngôn ngữ.

Loại nội dung tùy chỉnh, các phân loại và trang tùy chọn mà bạn đăng ký thông qua ACF cũng được dịch – bao gồm cả nhãn của chúng. Trang web bạn xây dựng bằng ACF chính là trang web trở thành đa ngôn ngữ với ACFML, chứ không phải chỉ một phần của trang.

Chọn những gì giống và khác nhau cho từng ngôn ngữ

Các nhóm trường ACF không có một hành vi dịch thuật chung cho tất cả. Trang Our Team trên trang web của bạn hiển thị cùng các thành viên nhóm trong mọi ngôn ngữ: dịch tên và tiểu sử của họ, giữ nguyên cấu trúc. Trang Events hiển thị các sự kiện khác nhau cho các đối tượng khán giả khác nhau: hiển thị các sự kiện hoàn toàn khác nhau cho từng ngôn ngữ. Trang Product Specs hiển thị sự kết hợp: dịch phần miêu tả, giữ nguyên SKU và giá cả.

ACFML xử lý cả ba trường hợp này trên cơ sở từng nhóm trường: Các trường giống nhau giữa các ngôn ngữ, Các trường khác nhau giữa các ngôn ngữ và Chế độ chuyên gia cho các thiết lập hỗn hợp. Hãy chọn chế độ phù hợp với mục đích của từng nhóm trường; ACFML sẽ tự động kết nối hành vi dịch thuật.

Kiểm soát dịch thuật cho từng trường

Bên trong một nhóm trường, mỗi trường có tùy chọn dịch thuật riêng:

• Dịch. Giá trị của trường được dịch theo từng ngôn ngữ.
• Sao chép. Giá trị của trường luôn đồng bộ giữa các ngôn ngữ; chỉnh sửa một lần và nó sẽ tự động cập nhật cho các ngôn ngữ khác.
• Sao chép một lần. Giá trị của trường tạo cơ sở cho các bản dịch mới, sau đó mỗi phiên bản ngôn ngữ có thể được chỉnh sửa độc lập.
• Không dịch. Trường bị bỏ qua hoàn toàn (ví dụ: trường nội bộ chỉ dành cho trang quản trị).

Các mặc định hợp lý cho từng loại trường được cấu hình sẵn để dùng được ngay: Các trường Text và Wysiwyg mặc định là Dịch, các trường có cấu trúc như Image, Link và Number mặc định là Sao chép. Toàn bộ tài liệu tham khảo về các thiết lập sẵn có tại Cách dịch trường tùy chỉnh của ACF.

Các hàng Repeater và Flexible Content luôn đồng bộ giữa các ngôn ngữ

Các trường Repeater và Flexible Content là nơi các thiết lập ACF đa ngôn ngữ thường bị lỗi trong các công cụ khác: các hàng không đồng bộ, bố cục bị sai lệch và người dịch nhìn thấy nội dung mà họ không nhận ra. ACFML giữ cho cấu trúc hàng đồng bộ giữa các ngôn ngữ theo mặc định. Người dịch sẽ thấy các hàng giống nhau theo cùng một thứ tự, với từng trường phụ có thể dịch ở đúng vị trí. Nếu bạn cần các cấu trúc khác nhau cho từng ngôn ngữ (ví dụ: danh sách sự kiện khác nhau trong mỗi ngôn ngữ), tùy chọn Sao chép một lần sẽ cho phép điều đó.

Các trường cục bộ (được đăng ký bằng PHP) có cùng hành vi dịch thuật

Nhiều trang web chính thức đăng ký các trường ACF bằng PHP thay vì giao diện quản trị của ACF (để dễ dàng di chuyển, kiểm soát phiên bản hoặc cấu hình đi kèm giao diện). ACFML 2.2.0 (tháng 2 năm 2026) mang đến hỗ trợ đầy đủ cho các trường cục bộ (Local Fields). Bạn thiết lập tùy chọn dịch cho từng trường bằng khóa wpml_cf_preferences trong định nghĩa nhóm trường, đồng bộ hóa nó vào WPML từ ACF > Tools, và các màn hình quản trị sẽ phản ánh đúng những gì nhóm trường khai báo. Các tệp Local JSON của ACF mang theo các tùy chọn này khi bạn xuất và nhập giữa các trang web. Quy trình từng bước có trên trang hướng dẫn trong phần Thiết lập tùy chọn cho các trường được đăng ký bằng PHP hoặc JSON.

Các hook dành cho nhà phát triển cho các trường hợp đặc biệt

Đối với các trang web có logic dịch trường tùy chỉnh (loại trừ các trường cụ thể, ghi đè tùy chọn mặc định cho một loại trường trên toàn cục, ẩn chú thích khỏi người dịch), ACFML cung cấp hai bộ lọc (acfml_should_translate_acf_entity, acfml_field_group_mode_field_translation_preference) và bốn hằng số (ACFML_EXCLUDE_FIELD_GROUP_STRINGS_IN_POST_JOBS, ACFML_HIDE_FIELD_ANNOTATIONS, ACFML_REPEATER_SYNC_DEFAULT, ACFML_SCAN_LOCAL_FIELDS). Toàn bộ tài liệu tham khảo kèm ví dụ mã lệnh có tại Tài liệu tham khảo về hook và hằng số của ACFML.

Được xây dựng và duy trì cùng với nhóm ACF

WPML và nhóm ACF hợp tác chặt chẽ về khả năng tương thích liên tục – được xác nhận trên trang tương thích ACF chung. Khi ACF hoặc ACF Pro phát hành phiên bản mới, ACFML sẽ cập nhật theo; khi ACFML cần hỗ trợ từ phía ACF cho một hành vi dịch thuật mới, quá trình tích hợp được xây dựng cùng nhau thay vì thiết kế ngược.