WPML

wpml_unfiltered_admin_string

Получение значения параметра в обход фильтров WPML ST.

apply_filters( 'wpml_unfiltered_admin_string', mixed $default_value, string $option_name )
Тип
filter
Категория
Получение локализованного контента
Версия WPML
3.2.3-dev

Описание

WPML Перевод строк фильтрует параметры настроек тем оформления и плагинов, чтобы возвращать переводы их значений на текущем языке.

Это означает, что в установке WordPress, где в WPML, например, английский язык задан как основной, а немецкий — как дополнительный язык, Вы получите немецкие переводы при вызове:get_option('{theme_name}_settings');, когда текущим языком является немецкий. А когда текущим языком является английский, будут отображаться английские значения.

Однако это также означает, что при обновлении значения параметра с помощью: update_option('{theme_name}_settings', $new_value);значение параметра будет обновлено на обоих языках. Это не всегда желательно.

Именно здесь и будет полезен вышеупомянутый фильтр. Этот фильтр позволяет получать значение параметра в обход фильтров модуля WPML Перевод строк. Возвращается значение на том языке, на котором оно было запрошено, поэтому дальнейшие выполняемые операции, такие как обновление этого значения в базе данных, не повлияют на другие языки, кроме того, с которым Вы работаете.

Аргументы

$default_value
(смешанный тип) (Обязательно) Значение, возвращаемое в случае отсутствия строки
$option_name
(строка) (Необязательно) Имя получаемого параметра. Ожидается имя без экранирования SQL.

Пример использования

Для приведенного ниже примера представьте, что Вы просматриваете язык, отличный от языка по умолчанию.
Получаемое значение параметра сохранено в виде сериализованного массива. Вы хотите обновить одну пару «ключ-значение» в массиве и сохранить ее в базу данных. Вы ожидаете, что это повлияет только на текущий язык.

Пример 
// 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);

Связанные хуки

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

Все хуки категории «Получение локализованного контента» (12) →