apply_filters( 'wpml_translate_single_string', string $original_value, string $domain, string $name, string $language_code )
- Tipo
- filter
- Categoría
- Recuperar contenido localizado
- Versión de WPML
- 3.2
Descripción
*Recupera la traducción de una cadena de texto individual (a diferencia de una cadena que forma parte de un paquete**). El filtro busca una cadena que coincida con $domain y $name. Si la encuentra, busca una traducción en el idioma actual o en el idioma que usted especifique. Si existe una traducción, la devuelve. De lo contrario, devuelve la cadena original.
*Para registrar una cadena para su traducción, consulte: wpml_register_single_string
**Para recuperar la traducción de una cadena que forma parte de un paquete, consulte: wpml_translate_string
Nota: Este hook requiere el módulo WPML Traducción de cadenas
Argumentos
- $original_value
- (string) (Obligatorio) El valor original de la cadena
- $domain
- (string) (Obligatorio) El dominio registrado de la cadena
- $name
- (string) (Obligatorio) El nombre registrado de la cadena
- $language_code
- (string) (Opcional) Devuelve la traducción en este idioma. El valor predeterminado es NULL, que devuelve el idioma actual
Ejemplo de uso
Retomamos el mismo ejemplo del widget que utilizamos para el hook de acción «wpml_register_single_string». Puede que desee ir allí para refrescar la memoria. Utilizamos el filtro «wpml_translate_single_string» en la función de salida del widget.
Ejemplo
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...
Hooks relacionados
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