apply_filters( 'wpml_unfiltered_admin_string', mixed $default_value, string $option_name )
- Loại
- filter
- Danh mục
- Truy xuất nội dung đã bản địa hóa
- Phiên bản WPML
- 3.2.3-dev
Miêu tả
WPML Dịch Chuỗi lọc các tùy chọn cài đặt của giao diện/plugin để trả về các bản dịch cho giá trị của chúng trong ngôn ngữ hiện tại.
Điều này có nghĩa là trên một bản cài đặt WordPress với các ngôn ngữ WPML được thiết lập, ví dụ như tiếng Anh là ngôn ngữ chính và tiếng Đức là ngôn ngữ phụ, bạn có thể mong đợi các bản dịch tiếng Đức sẽ là những giá trị được truy xuất khi gọi:get_option('{theme_name}_settings'); trong khi ngôn ngữ hiện tại là tiếng Đức. Sau đó, trong khi ngôn ngữ hiện tại là tiếng Anh, các giá trị tiếng Anh sẽ được hiển thị.
Tuy nhiên, điều này cũng có nghĩa là khi một giá trị tùy chọn được cập nhật bằng: update_option('{theme_name}_settings', $new_value);giá trị tùy chọn sẽ được cập nhật trong cả hai ngôn ngữ. Điều này có thể không phải lúc nào cũng là điều mong muốn.
Đây là lúc bộ lọc ở trên trở nên hữu ích. Bộ lọc cho phép truy xuất một giá trị tùy chọn mà bỏ qua các bộ lọc của WPML Dịch Chuỗi. Những gì được trả về là giá trị trong ngôn ngữ mà nó được truy xuất để các thao tác tiếp theo được thực hiện, chẳng hạn như cập nhật giá trị đó trong cơ sở dữ liệu, sẽ không ảnh hưởng đến các ngôn ngữ khác ngoài ngôn ngữ bạn đang làm việc.
Đối số
- $default_value
- (mixed) (Bắt buộc) Giá trị được trả về trong trường hợp chuỗi văn bản không tồn tại
- $option_name
- (string) (Tùy chọn) Tên của tùy chọn cần lấy. Yêu cầu một tên không được escape bằng SQL.
Ví dụ sử dụng
Đối với ví dụ dưới đây, hãy tưởng tượng bạn đang xem một ngôn ngữ khác với ngôn ngữ mặc định.
Giá trị tùy chọn mà bạn đang lấy được lưu dưới dạng một mảng đã được serialize. Bạn muốn cập nhật một cặp key-value duy nhất trong mảng và lưu nó vào cơ sở dữ liệu. Bạn kỳ vọng rằng chỉ ngôn ngữ hiện tại sẽ bị ảnh hưởng.
Ví dụ
// retrieve option value is current language
$a = apply_filters( 'wpml_unfiltered_admin_string', get_option( 'my_option_name' ), 'my_option_name' );
// some operations ...
$a['number']++;
//update the value for the current language only
update_option('my_option_name', $a); Các hook liên quan
wpml_media_url, wpml_media_id, force_suppress_filters, wpml_get_translated_slug, wpml_home_url, wpml_translate_single_string, wpml_translate_string, wpml_elements_without_translations, wpml_permalink, wpml_element_link