Chuyển đến nội dung Chuyển đến thanh bên
Đã cập nhật
3 Tháng ba, 2026

Tìm hiểu cách thiết lập tùy chọn dịch thuật cho các trường ACF được đăng ký trong PHP và tự động đưa chúng vào các tệp JSON do ACF tạo ra.

Thiết lập Tùy chọn Dịch thuật cho các trường ACF được đăng ký bằng PHP

Để thiết lập tùy chọn dịch thuật cho các trường ACF được đăng ký bằng PHP, bạn cần sử dụng hàm acf_add_local_field_group và thêm wpml_cf_preferences vào định nghĩa của mỗi trường.

Có bốn giá trị số bạn có thể sử dụng cho wpml_cf_preferences:

  • 0Không dịch. WPML sẽ bỏ qua hoàn toàn trường này.
  • 1Sao chép. Giá trị của trường được sao chép sang tất cả các ngôn ngữ và luôn được đồng bộ hóa.
  • 2Dịch. Giá trị của trường sẽ có sẵn để dịch.
  • 3Sao chép một lần. Giá trị của trường được sao chép sang tất cả các ngôn ngữ một lần, sau đó có thể được chỉnh sửa độc lập ở từng ngôn ngữ.

Bạn không chắc chắn nên sử dụng tùy chọn dịch nào? Hãy xem tùy chọn được đề xuất cho từng trường ACF.

Dưới đây bạn có thể thấy một ví dụ về việc thêm khóa wpml_cf_preferences vào một nhóm trường được đăng ký theo lập trình.

acf_add_local_field_group( [
  'key' => 'group_1',
  'title' => 'Nhóm của tôi',
  'fields' => [
  [
  'key' => 'field_1',
  'label' => 'Phụ đề',
  'name' => 'sub_title',
  'type' => 'text',
  'prefix' => '',
  'instructions' => '',
  'required' => 0,
  'conditional_logic' => 0,
  'wrapper' => [
  'width' => '',
  'class' => '',
  'id' => '',
  ],
  'default_value' => '',
  'placeholder' => '',
  'prepend' => '',
  'append' => '',
  'maxlength' => '',
  'readonly' => 0,
  'disabled' => 0,
  'wpml_cf_preferences' => 2, // Trường này ("Phụ đề") sẽ được dịch.
  ],
  ],
  'location' => [
  [
  [
  'param' => 'post_type',
  'operator' => '==',
  'value' => 'post',
  ],
  ],
  ],
  'menu_order' => 0,
  'position' => 'normal',
  'style' => 'default',
  'label_placement' => 'top',
  'instruction_placement' => 'label',
  'hide_on_screen' => '',
] );

Đồng bộ hóa các trường của bạn với WPML

Sau khi xác định các trường của bạn bằng PHP, bạn cần thông báo cho WPML về chúng.

  1. Đi tới trang ACFTools.
  2. Cuộn xuống phần Translate ACF Local JSON and PHP-Registered Fields.
Đồng bộ hóa các trường ACF cục bộ với WPML
  1. Trong phần Đồng bộ hóa tùy chọn dịch cho các trường cục bộ, hãy chọn thời điểm việc đồng bộ hóa sẽ diễn ra. Trong hầu hết các trường hợp, bạn sẽ muốn sử dụng tùy chọn Sync once now và sau đó nhấp vào nút Apply.

WPML sẽ đồng bộ hóa các trường và sau đó đặt lại về tùy chọn không đồng bộ hóa. Bằng cách này, việc đồng bộ hóa chỉ tác động đến cơ sở dữ liệu của bạn một lần và vào thời điểm bạn chọn.

Thiết lập Tùy chọn Dịch thuật cho các trường ACF trong tệp JSON

Nếu bạn đang sử dụng tính năng Local JSON của ACF, ACF Multilingual (ACFML) sẽ tự động thêm các tùy chọn dịch cho mọi trường trong tệp JSON của bạn. Điều này có nghĩa là khi bạn xuất và nhập các tệp JSON giữa các trang web, các tùy chọn dịch sẽ được áp dụng tự động trên trang web đích.

Tất cả những gì bạn cần làm là kích hoạt ACFML trên cả trang web nguồn trang web đích. Sau khi hoàn tất, mỗi khi ACF tạo tệp JSON, nó cũng sẽ bao gồm các tùy chọn dịch thuật của bạn.

Nếu các tệp JSON của bạn ban đầu được tạo khi chưa kích hoạt ACFML, hãy kích hoạt ACFML, nhập các tệp JSON vào giao diện người dùng ACF, thiết lập các tùy chọn dịch thuật và lưu lại các nhóm trường. Việc này sẽ tạo lại các tệp JSON có bao gồm các tùy chọn.