apply_filters( 'wpml_unfiltered_admin_string', mixed $default_value, string $option_name )
- Tipo
- filter
- Categoria
- Recupero dei contenuti localizzati
- Versione di WPML
- 3.2.3-dev
Descrizione
WPML Traduzione stringhe filtra le opzioni di impostazione dei temi/plugin per restituire le traduzioni dei loro valori nella lingua corrente.
Questo significa che su un’installazione WordPress con le lingue di WPML impostate, ad esempio, sull’inglese come lingua principale e sul tedesco come lingua secondaria, i valori recuperati chiamando:get_option('{theme_name}_settings'); mentre la lingua corrente è il tedesco saranno le traduzioni in tedesco. Poi, mentre la lingua corrente è l’inglese, verranno visualizzati i valori in inglese.
Questo significa anche, tuttavia, che quando il valore di un’opzione viene aggiornato con: update_option('{theme_name}_settings', $new_value);il valore dell’opzione verrà aggiornato in entrambe le lingue. Questo potrebbe non essere sempre auspicabile.
È qui che il filtro precedente risulta utile. Il filtro permette di recuperare il valore di un’opzione ignorando i filtri di WPML Traduzione stringhe. Ciò che viene restituito è il valore nella lingua in cui viene recuperato, in modo che le operazioni successive, come l’aggiornamento del valore nel database, non influiscano su lingue diverse da quella con cui stai lavorando.
Argomenti
- $default_value
- (misto) (Obbligatorio) Il valore da restituire nel caso in cui la stringa non esista
- $option_name
- (stringa) (Facoltativo) Il nome dell’opzione da recuperare. È previsto un nome senza escape SQL.
Esempio di utilizzo
Per l’esempio riportato di seguito, immagina di visualizzare una lingua diversa da quella predefinita.
Il valore dell’opzione che stai recuperando è salvato come array serializzato. Vuoi aggiornare una singola coppia chiave-valore nell’array e salvarla nel database. Ti aspetti che venga modificata solo la lingua corrente.
Esempio
// 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); Hook correlati
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
Tutti i 12 hook della categoria Recupero dei contenuti localizzati →