apply_filters( 'wpml_translate_single_string', string $original_value, string $domain, string $name, string $language_code )
- Тип
- filter
- Категория
- Получение локализованного контента
- Версия WPML
- 3.2
Описание
*Получает перевод отдельной (в отличие от строки, которая является частью пакета**) текстовой строки. Фильтр ищет строку с совпадающими $domain и $name. Если он её находит, то ищет перевод на текущий язык или язык, который Вы укажете. Если перевод существует, он вернёт его. В противном случае он вернёт исходную строку.
*Чтобы зарегистрировать строку для перевода, см.: wpml_register_single_string
**Для получения перевода строки, которая является частью пакета, см.: wpml_translate_string
Примечание: для этого хука требуется модуль WPML Перевод строк
Аргументы
- $original_value
- (строка) (Обязательно) Исходное значение строки
- $domain
- (строка) (Обязательно) Зарегистрированный домен строки
- $name
- (строка) (Обязательно) Зарегистрированное имя строки
- $language_code
- (строка) (Необязательно) Возвращает перевод на этом языке. По умолчанию имеет значение NULL, которое возвращает текущий язык
Пример использования
Мы берём тот же пример виджета, который использовали для хука действия «wpml_register_single_string». Вы можете перейти туда, чтобы освежить память. Мы используем фильтр «wpml_translate_single_string» в функции вывода виджета
Пример
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...
Связанные хуки
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
Все хуки категории «Получение локализованного контента» (12) →