Функция GET_TAG_LINK() для возвращения ссылки на тег

# Функция GET_TAG_LINK() │ WP 2.3.0

Функция get_tag_link() возвращает ссылку на тег по заданному идентификатору тега (Tag ID).

## Использует
- get_term_link()
- get_category_link()

**Время выполнения**:
- 1 раз — 0.0039971 сек (очень медленно)
- 50000 раз — 2.05 сек (быстро)
- PHP 7.4.25, WP 5.9.2

**Хуки**: Нет.

## Возвращаемое значение

Возвращает строку. На успешной операции — ссылку, если тег существует, или пустую строку, если тег не найден.

## Использование

Вызывается с помощью:
```php
get_tag_link( $tag );

Параметры

• $tag (int|object) (обязательный) — идентификатор тега или объект тега.

Примеры

Пример 1 — Основной случай использования

Выведем ссылку на тег с ID 46:

echo get_tag_link( 46 ); //> http://example.com/tag/tagname

Также можно использовать в HTML:

имя тега

Пример 2 — Фильтр: изменение ссылки

Результат работы этой функции можно изменить с помощью хука tag_link, который передает два параметра в функцию:

• $taglink — URL, который функция возвращает по умолчанию.
• $tag_id — ID тега, для которого возвращается ссылка.

Пример, где мы заменяем http:// на https://:

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;
}

Заметки

• Для получения дополнительной информации смотрите: get_term_link().

Изменения

• Версия 2.3.0 — добавлена в WordPress.

Код функции get_tag_link()

Функция находится в файле wp-includes/category-template.php:

function get_tag_link( $tag ) {
    return get_category_link( $tag );
}

Связанные функции

• Постоянные ссылки (чистые удобные URL):

  • edit_bookmark_link()
  • edit_comment_link()
  • get_attachment_link()
  • get_pagenum_link()
  • get_permalink()
  • get_sample_permalink()
  • get_term_link()
  • get_the_permalink()
  • the_permalink()
  • wp_get_shortlink()

• Теги:

  • edit_tag_link()
  • get_tags()
  • single_tag_title()
  • tag_description()
  • tag_exists()
  • wp_generate_tag_cloud()
  • wp_tag_cloud()