apply_filters( 'wpml_translate_single_string', string $original_value, string $domain, string $name, string $language_code )
- Loại
- filter
- Danh mục
- Truy xuất nội dung đã bản địa hóa
- Phiên bản WPML
- 3.2
Miêu tả
*Truy xuất bản dịch của một chuỗi văn bản riêng lẻ (trái ngược với chuỗi văn bản thuộc về một gói**). Bộ lọc sẽ tìm kiếm một chuỗi văn bản có $domain và $name trùng khớp. Nếu tìm thấy, nó sẽ tìm kiếm bản dịch bằng ngôn ngữ hiện tại hoặc ngôn ngữ bạn chỉ định. Nếu có bản dịch, nó sẽ trả về bản dịch đó. Nếu không, nó sẽ trả về chuỗi văn bản gốc.
*Để đăng ký một chuỗi văn bản để dịch, vui lòng xem: wpml_register_single_string
**Để truy xuất bản dịch chuỗi văn bản thuộc về một gói, vui lòng xem: wpml_translate_string
Lưu ý: hook này yêu cầu module WPML Dịch Chuỗi
Đối số
- $original_value
- (string) (Bắt buộc) Giá trị gốc của chuỗi
- $domain
- (string) (Bắt buộc) Domain đã đăng ký của chuỗi
- $name
- (string) (Bắt buộc) Tên đã đăng ký của chuỗi
- $language_code
- (string) (Tùy chọn) Trả về bản dịch bằng ngôn ngữ này. Mặc định là NULL, sẽ trả về ngôn ngữ hiện tại
Ví dụ sử dụng
Chúng ta sử dụng lại cùng một ví dụ về widget mà chúng ta đã dùng cho action hook “wpml_register_single_string”. Bạn có thể xem lại phần đó để nhớ lại. Chúng ta sử dụng bộ lọc “wpml_translate_single_string” trong hàm đầu ra của widget
Ví dụ
function widget($args, $instance){
extract($args);
$title = apply_filters('widget_title', $instance['title'] );
$custom_input = apply_filters('wpml_translate_single_string', $instance['custom_input'], 'Widgets', 'Custom Widget - input field' );
$custom_textarea = apply_filters('wpml_translate_single_string', $instance['custom_textarea'], 'Widgets', 'Custom Widget - textarea field' );
# Before the widget
echo $before_widget;
# The title
if ( $title )
echo $before_title . $title . $after_title;
# Output...
Các hook liên quan
wpml_media_url, wpml_media_id, force_suppress_filters, wpml_get_translated_slug, wpml_home_url, wpml_translate_string, wpml_elements_without_translations, wpml_permalink, wpml_unfiltered_admin_string, wpml_element_link