ACFML – Các trường tùy chỉnh ACF và ACF Pro đa ngôn ngữ trong WordPress

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

Nếu bạn xây dựng trang web trên ACF, ACFML sẽ 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ài nguyên được bản địa hóa theo 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ữ.

Các loại nội dung tùy chỉnh, phân loại và Options Page 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 là một phần của nó.

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

Các Field Group của 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 bằng 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á.

ACFML xử lý cả ba trường hợp này trên cơ sở từng Field Group: Same fields across languages, Different fields across languages, và Expert Mode 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 Field Group; ACFML sẽ tự động thiết lập 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 Field Group, mỗi trường sẽ 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 được đồ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.
• 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 giá trị 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 trang Cách dịch các trường tùy chỉnh 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 gặp lỗi trong các công cụ khác: các hàng không đồng bộ, bố cục 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 con có thể dịch được đặt đúng vị trí. Nếu bạn cần các cấu trúc khác biệt cho từng ngôn ngữ (ví dụ: một danh sách sự kiện khác nhau bằng mỗi ngôn ngữ), tùy chọn Sao chép một lần sẽ cho phép làm đ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ị 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 thuật của từng trường bằng khóa wpml_cf_preferences trong định nghĩa field-group, đồ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 chính xác những gì field group khai báo. Các tệp Local JSON của ACF sẽ 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 tại 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 trong 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 các 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 các ví dụ mã nguồn có tại Tài liệu tham khảo về các 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ẽ để đảm bảo khả năng tương thích liên tục – được xác nhận trên trang khả năng tương thích ACF chung. Khi ACF hoặc ACF Pro tung ra một phiên bản phát hành, 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, sự tích hợp sẽ được xây dựng cùng nhau thay vì phải dịch ngược mã.