Dịch văn bản mà giao diện và plugin lưu trong wp_options

Tìm hiểu cách làm cho các văn bản được lưu trong bảng wp_options có thể dịch được và tự động chuyển đổi các ID đối tượng.

Các giao diện và plugin đôi khi bao gồm các văn bản như một phần của các tùy chọn mà chúng lưu trong bảng wp_options. WPML cho phép bạn dịch các văn bản như vậy bằng cách thay thế các lệnh gọi get_option bằng các bản dịch bạn chỉ định trong tệp wpml-config.xml.

Tệp wpml-config.xml là một tài liệu cấu hình hướng dẫn WPML những chuỗi nào trong các tùy chọn đã lưu cần được dịch.

Hướng dẫn này dành cho các nhà phát triển tạo giao diện và plugin của riêng họ. Nếu bạn đang cố gắng dịch các chuỗi đến từ các giao diện và plugin của bên thứ ba, hãy đọc trang của chúng tôi về cách tìm các chuỗi không xuất hiện trên trang Dịch chuỗi.

Cần tạo tệp wpml-config.xml? Truy cập hướng dẫn từng bước của chúng tôi về cách tự động tạo tệp cấu hình bằng plugin Multilingual Tools.

Dịch các chuỗi trong bảng wp_options

Khi các giao diện và plugin sử dụng get_option, chúng sẽ đọc các giá trị từ bảng wp_options. WPML có thể lọc các lệnh gọi này và cung cấp bản dịch cho các giá trị của các tùy chọn này.

Điều này hoạt động nếu bản ghi wp_option là một chuỗi đơn giản nhưng cũng hoạt động khi nó là một mảng được tuần tự hóa.

Để dịch một tùy chọn duy nhất, hãy thêm một mục nhập key trong admin-texts. Để dịch một mảng được tuần tự hóa, hãy thêm một vài key dưới một key, như bạn có thể thấy trong my_plugin_options ở ví dụ bên dưới.

Văn bản quản trị trong tệp cấu hình ngôn ngữ

<wpml-config>
  <admin-texts>
    <key name="my_plugins_options">
      <key name="option_name_1" />
      <key name="option_name_2" />
    <key name="options_group_1">
      <key name="sub_option_name_11" />
      <key name="sub_option_name_12" />
    </key>
      <key name="options_group_2">
      <key name="sub_option_name_21" />
    <key name="sub_option_name_22" />
    </key>
    </key>
  <key name="simple_string_option"/>
</admin-texts>
 
</wpml-config>

Có thể sử dụng ký tự đại diện * trong các key phụ như trường hợp sau.

Ví dụ về cách sử dụng ký tự đại diện

<wpml-config>
  <admin-texts>
    <key name="testing_option">
      <key name="*"/>
    </key>
  </admin-texts>
</wpml-config>

Nó tương đương với mã này:

Mã tương đương

<wpml-config>
  <admin-texts>
    <key name="testing_option">
      <key name="sub_key_1"/>
      <key name="sub_key_2">
        <key name="sub_sub_21">
          <key name="sub_sub_211"/> 
        </key> 
        <key name="sub_sub_21"/>
        </key>
      <key name="more_sub_keys"/>
    </key>
  </admin-texts>
</wpml-config>

Vui lòng lưu ý rằng ký tự đại diện * KHÔNG hoạt động trong các key cha:

Ký tự đại diện không hoạt động trong các key cha

<wpml-config>
  <admin-texts>
    <key name="some_option_*" />
    <key name="*"/>
  </admin-texts>
</wpml-config>

Tự động chuyển đổi các ID đối tượng trong văn bản quản trị

Kể từ WPML 4.8, bạn có thể khai báo rằng một số văn bản quản trị nhất định chứa các ID đối tượng như ID bài viết, sản phẩm hoặc phân loại. WPML tự động chuyển đổi các ID đó trên front-end của trang web.

Đây là một phần mở rộng của chức năng hiện có về việc tự động chuyển đổi các ID shortcode và sử dụng cùng một cú pháp.

Trong các mục nhập key dưới admin-texts, hãy sử dụng:

type để nêu rõ đối tượng nào được tham chiếu, ví dụ: post-ids hoặc taxonomy-ids
sub-type (tùy chọn) khi bạn muốn khai báo thực thể cụ thể (ví dụ: product)

Các thuộc tính Type và sub-type có thể được thêm ở bất kỳ cấp độ lồng nhau nào.

WPML có thể phát hiện và chuyển đổi các ID ở những định dạng này:

Một ID duy nhất (ví dụ: 123)
Một mảng (và mảng được mã hóa) các ID (ví dụ: [123,456,789])
Một danh sách các ID được phân tách bằng dấu phẩy (ví dụ: “123,456,789”)

Ví dụ về cách khai báo các ID đối tượng trong văn bản quản trị

<wpml-config>
  <admin-texts>
    <key name="admin_text_option_key" type="post-ids" sub-type="product" />
    <key name="admin_text_with_nested_ids">
      <key name="admin_text_nested_key_with_ids" type="post-ids" sub-type="product" />
      <key name="admin_text_nested_key_with_ids_with_wildcard_*" type="post-ids" sub-type="product" />
      <key name="admin_text_nested_key_with_subkey">
        <key name="admin_text_nested_key_with_subkey_with_ids" type="post-ids" sub-type="product" />
          </key>
      </key>
  </admin-texts>
</wpml-config>

Tài nguyên bổ sung

Để tìm hiểu thêm về tệp wpml-config.xml , hãy truy cập hướng dẫn Tệp cấu hình ngôn ngữ.

Để tùy chỉnh các thành phần khác bằng tệp wpml-config.xml, hãy truy cập các hướng dẫn bổ sung của chúng tôi: