apply_filters( 'wpml_unfiltered_admin_string', mixed $default_value, string $option_name )
- Type
- filter
- Catégorie
- Récupération du contenu localisé
- Version de WPML
- 3.2.3-dev
Description
WPML Traduction de chaînes filtre les options de paramétrage du thème ou de l’extension afin de renvoyer les traductions de leurs valeurs dans la langue actuelle.
Cela signifie que sur une installation WordPress où les langues de WPML sont configurées, par exemple, avec l’anglais comme langue principale et l’allemand comme langue secondaire, vous pouvez vous attendre à ce que les traductions allemandes soient les valeurs récupérées lors de l’appel de :get_option('{theme_name}_settings'); lorsque la langue actuelle est l’allemand. Ensuite, lorsque la langue actuelle est l’anglais, les valeurs anglaises seront affichées.
Cependant, cela signifie également que lorsqu’une valeur d’option est mise à jour avec : update_option('{theme_name}_settings', $new_value);la valeur de l’option sera mise à jour dans les deux langues. Cela n’est peut-être pas toujours souhaitable.
C’est là que le filtre ci-dessus est utile. Le filtre permet de récupérer une valeur d’option en contournant les filtres de WPML Traduction de chaînes. La valeur renvoyée est celle de la langue dans laquelle elle est récupérée, de sorte que les opérations ultérieures, telles que la mise à jour de la valeur dans la base de données, n’affectent pas d’autres langues que celle sur laquelle vous travaillez.
Arguments
- $default_value
- (mixed) (Requis) La valeur à renvoyer au cas où la chaîne de texte n’existe pas
- $option_name
- (string) (Facultatif) Le nom de l’option à récupérer. Un nom sans échappement SQL est attendu.
Exemple d’utilisation
Pour l’exemple ci-dessous, imaginez que vous affichez une langue autre que la langue par défaut.
La valeur de l’option que vous récupérez est enregistrée sous forme de tableau sérialisé. Vous souhaitez mettre à jour une seule paire clé-valeur dans le tableau et l’enregistrer dans la base de données. Vous vous attendez à ce que seule la langue actuelle soit affectée.
Exemple
// 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 associés
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
Les 12 hooks de la catégorie Récupération du contenu localisé →