apply_filters( 'wpml_unfiltered_admin_string', mixed $default_value, string $option_name )
- Tipo
- filter
- Categoría
- Recuperar contenido localizado
- Versión de WPML
- 3.2.3-dev
Descripción
WPML Traducción de cadenas filtra las opciones de configuración del tema/plugin para devolver las traducciones de sus valores en el idioma actual.
Esto significa que en una instalación de WordPress con los idiomas de WPML configurados, por ejemplo, con el inglés como idioma principal y el alemán como idioma secundario, puede esperar que las traducciones al alemán sean los valores recuperados al llamar a:get_option('{theme_name}_settings'); mientras el idioma actual sea el alemán. Luego, mientras el idioma actual sea el inglés, se mostrarán los valores en inglés.
Sin embargo, esto también significa que cuando el valor de una opción se actualiza con: update_option('{theme_name}_settings', $new_value);el valor de la opción se actualizará en ambos idiomas. Es posible que esto no siempre sea deseable.
Aquí es donde resulta útil el filtro anterior. El filtro permite recuperar el valor de una opción omitiendo los filtros de WPML Traducción de cadenas. Lo que se devuelve es el valor en el idioma en el que se recupera, de modo que las operaciones posteriores que se realicen, como actualizar el valor en la base de datos, no afectarán a otros idiomas distintos de aquel con el que esté trabajando.
Argumentos
- $default_value
- (mixto) (Obligatorio) El valor que se devolverá en caso de que la cadena no exista
- $option_name
- (cadena) (Opcional) El nombre de la opción que se va a recuperar. Se espera un nombre no escapado para SQL.
Ejemplo de uso
Para el siguiente ejemplo, imagine que está viendo un idioma distinto al idioma predeterminado.
El valor de la opción que está recuperando se guarda como un array serializado. Desea actualizar un único par clave-valor en el array y guardarlo en la base de datos. Espera que solo se vea afectado el idioma actual.
Ejemplo
// 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); Hooks relacionados
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