wpml_element_link

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 )

Тип

filter

Категория

Получение локализованного контента

Версия WPML

3.2

Описание

Возвращает ссылку на тип записи или ссылку на термин таксономии на текущем языке.

* Примечание: существуют альтернативные способы получения ссылки на элемент, предоставляющие разработчикам более полный контроль над выводом HTML.

WordPress предлагает ряд функций для этого, таких как get_permalink(), get_term_link() и т. д.

Если Вы планируете использовать функции, требующие ID типа записи или термина в качестве параметра, обратите внимание на фильтр wpml_object_id.

Аргументы

$element_id

(int) (Обязательно) ID типа записи (запись, страница, вложение, произвольный тип записи) или термина таксономии (метка, рубрика, произвольная таксономия) для ссылки

$element_type

(string) (Необязательно) Тип элемента для ссылки. Может быть ‘post’, ‘page’, ‘attachment’, '{custom post}', ‘tag’, ‘category’, '{custom taxonomy}'. По умолчанию — ‘post’

$link_text

(string) (Необязательно) Текст ссылки. По умолчанию — имя элемента

$optional_parameters

(array) (Необязательно) Аргументы для ссылки

$anchor

(string) (Необязательно) Якорь для ссылки

$echo

(bool) (Необязательно) 0|false для возврата или 1|true для вывода локализованной ссылки. По умолчанию — true

$return_original_if_missing

(bool) (Необязательно) Если задано значение true, всегда будет возвращаться значение (исходное значение, если перевод отсутствует). По умолчанию — TRUE

Пример использования

//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="/ru/?attachment_id=25">'Attachment image title</a>
apply_filters( 'wpml_element_link', 25, 'attachment', __( 'Attachment image title' ) );

Связанные хуки

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

Все хуки категории «Получение локализованного контента» (12) →