apply_filters( 'wpml_translate_single_string', string $original_value, string $domain, string $name, string $language_code )
- Tipo
- filter
- Categoria
- Recuperar conteúdo localizado
- Versão do WPML
- 3.2
Descrição
*Recupera a tradução de uma string de texto individual (ao contrário de uma string que faz parte de um pacote**). O filtro procura uma string com $domain e $name correspondentes. Se a encontrar, ele procura uma tradução no idioma atual ou no idioma que você especificar. Se existir uma tradução, ele a retornará. Caso contrário, ele retornará a string original.
*Para registrar uma string para tradução, consulte: wpml_register_single_string
**Para recuperar a tradução de uma string que faz parte de um pacote, consulte: wpml_translate_string
Observação: Este hook requer o módulo WPML Tradução de Strings
Argumentos
- $original_value
- (string) (Obrigatório) O valor original da string
- $domain
- (string) (Obrigatório) O domínio registrado da string
- $name
- (string) (Obrigatório) O nome registrado da string
- $language_code
- (string) (Opcional) Retorna a tradução neste idioma. O padrão é NULL, o que retorna o idioma atual
Exemplo de uso
Retomamos o mesmo exemplo do widget que usamos para o hook de ação “wpml_register_single_string”. Talvez você queira acessá-lo para refrescar a memória. Usamos o filtro “wpml_translate_single_string” na função de saída do widget
Exemplo
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