wpml_translate_single_string

apply_filters( 'wpml_translate_single_string', string $original_value, string $domain, string $name, string $language_code )

Type

filter

Catégorie

Récupération du contenu localisé

Version de WPML

3.2

Description

*Récupère la traduction d’une chaîne de texte individuelle (par opposition à une chaîne de texte qui fait partie d’un paquet**). Le filtre recherche une chaîne de texte avec un $domain et un $name correspondants. S’il la trouve, il cherche une traduction dans la langue actuelle ou dans la langue que vous spécifiez. Si une traduction existe, il la renvoie. Sinon, il renvoie la chaîne de texte d’origine.

*Pour enregistrer une chaîne de texte pour la traduction, veuillez consulter : wpml_register_single_string

**Pour récupérer la traduction d’une chaîne de texte qui fait partie d’un paquet, veuillez consulter : wpml_translate_string

Remarque : Ce hook nécessite le module WPML Traduction de chaînes

Arguments

$original_value

(string) (Requis) La valeur d’origine de la chaîne de texte

$domain

(string) (Requis) Le domaine enregistré de la chaîne de texte

$name

(string) (Requis) Le nom enregistré de la chaîne de texte

$language_code

(string) (Facultatif) Renvoie la traduction dans cette langue. La valeur par défaut est NULL, ce qui renvoie la langue actuelle

Exemple d’utilisation

Nous reprenons le même exemple du widget que nous avons utilisé pour le hook d’action « wpml_register_single_string ». Vous pouvez vous y référer pour vous rafraîchir la mémoire. Nous utilisons le filtre « wpml_translate_single_string » dans la fonction de sortie du widget

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 associés

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

Les 12 hooks de la catégorie Récupération du contenu localisé →