apply_filters( 'wpml_element_link', int $element_id, string $element_type, string $link_text, array $optional_parameters, string $anchor, bool $echo, bool $return_original_if_missing )
- Tipo
- filter
- Categoria
- Recuperar conteúdo localizado
- Versão do WPML
- 3.2
Descrição
Retorna um link de tipo de post ou link de termo de taxonomia no idioma atual.
* Nota: Existem maneiras alternativas de recuperar o link de um elemento que dão aos desenvolvedores um controle mais completo sobre a saída HTML.
O WordPress oferece várias funções para fazer isso, como get_permalink(), get_term_link(), etc.
Se você planeja usar funções que exigem um ID de tipo de post ou de termo como parâmetro, pode ser interessante analisar o filtro wpml_object_id.
Argumentos
- $element_id
- (int) (Obrigatório) O ID do tipo de post (post, página, anexo, post personalizado) ou termo de taxonomia (tag, categoria, taxonomia personalizada) para o qual criar o link
- $element_type
- (string) (Opcional) O tipo de elemento para o qual criar o link. Pode ser ‘post’, ‘page’, ‘attachment’, '{custom post}', ‘tag’, ‘category’ ou '{custom taxonomy}'. O padrão é ‘post’
- $link_text
- (string) (Opcional) O texto do link. O padrão é o nome do elemento
- $optional_parameters
- (array) (Opcional) Argumentos para o link
- $anchor
- (string) (Opcional) Âncora para o link
- $echo
- (bool) (Opcional) 0|false para retornar ou 1|true para exibir (echo) o link localizado. O padrão é true
- $return_original_if_missing
- (bool) (Opcional) Se definido como true, sempre retornará um valor (o valor original, se a tradução estiver ausente). O padrão é TRUE
Exemplo de uso
Exemplos
//produces: <a href="/hello-world/">Hello World!</a> apply_filters( 'wpml_element_link', 1 ); //produces: <a href="/sample-page/">Custom link text for the sample page</a> apply_filters( 'wpml_element_link', 2, 'page', __( 'Custom link text for the sample page' ) ); //produces: <a href="/sample-page/?category=foo&bar=baz">Sample Page</a> apply_filters( 'wpml_element_link', 2, 'page', '', array( 'category'=>'foo', 'bar'=>'baz' ) ); //produces: <a href="/sample-page/#contact">Sample Page</a> apply_filters( 'wpml_element_link', 2, 'page', '', '', 'contact' ); //produces: <a href="/category/uncategorized/">Uncategorized</a> apply_filters( 'wpml_element_link', 1, 'category' ); //produces: <a href="/pt-br/?attachment_id=25">'Attachment image title</a> apply_filters( 'wpml_element_link', 25, 'attachment', __( 'Attachment image title' ) );
Hooks relacionados
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_unfiltered_admin_string