Функция get_tag_link() в WordPress используется для получения ссылки (URL) на страницу архива записей, связанных с определенной меткой (тегом). Она принимает ID метки или объект и возвращает URL, который ведет на архивную страницу метки.
get_tag_link( int|object $tag ): string
Параметры
- $tag (обязательный) — ID метки (число) или объект метки (WP_Term).
Возвращаемые значения
- Строка — URL страницы метки. Если метка не существует, возвращается пустая строка.
Пример 1: Получение ссылки на метку по её ID
Простой пример получения ссылки на метку с ID 123. Этот код выведет URL метки:
echo get_tag_link(123);
Результатом будет что-то вроде:
http://example.com/tag/tagnameПример 2: Создание ссылки в HTML
Можно использовать get_tag_link() для создания ссылки на метку внутри HTML-тега <a>:
<a href="<?php echo get_tag_link(123); ?>">Название метки</a>
Пример 3: Использование с объектом метки
Функция может принимать объект метки, полученный, например, через get_tags() или get_term_by(). В этом примере мы получим метку по её слагу и выведем ссылку:
$tag = get_term_by( 'slug', 'my-tag-slug', 'post_tag' );
if ( $tag ) {
echo get_tag_link( $tag );
}Пример 4: Фильтрация ссылки через хук tag_link
WordPress предоставляет фильтр tag_link, который позволяет изменять результат, возвращаемый функцией get_tag_link(). Например, заменим протокол http:// на https:// в URL меток:
add_filter( 'tag_link', 'add_https_to_tag_link', 10, 2 );
function add_https_to_tag_link( $taglink, $tag_id ) {
$taglink = str_replace( 'http://', 'https://', $taglink );
return $taglink;
}
тот фильтр будет автоматически изменять ссылки на метки, чтобы они начинались с https://.
Работа с get_term_link()
Функция get_tag_link() работает на основе более универсальной функции get_term_link(), которая используется для получения ссылок на термины таксономий в WordPress. get_tag_link() — это специфическая реализация для таксономии меток (post_tag).
Заключение
Функция get_tag_link() упрощает получение ссылки на архивную страницу метки в WordPress. Это удобно для динамического создания ссылок на метки в шаблонах, циклах записей и других местах.