WPML
apply_filters( 'wpml_translate_single_string', string $original_value, string $domain, string $name, string $language_code )
Tipo
filter
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...

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

Los 12 hooks de Recuperar contenido localizado →