get_tag()

2.3.0 wp-includes / category.php / Кодекс WordPress

Возвращает информацию о метке. В виде объекта или в виде ассоциативного или нумерованного массива.

Прежде, чем получать значение из базы данных, функция попробует получить его из кэша.

Возвращает объект класса WP_Error, если в первый параметр функции передано пустое значение, либо null, если метки с указанным ID не существует.

get_tag( $tag, $output = OBJECT, $filter = 'raw' )

Параметры

$tag

(целое|WP_Term ID метки или её объект.

$output

Изменяя значение этого параметра, вы можете изменить формат возвращаемой информации о метке:

OBJECT – данные возвращаются в виде объекта WP_Term.
ARRAY_A – в виде ассоциативного массива.
ARRAY_N – в виде нумерованного массива.

Подробнее во втором примере.

$filter

(строка) Задаёт правила очистки данных о метке функцией sanitize_term_field().

Примеры

1. Основы использования

// получаем метку с ID = 100 и выводим ссылку на неё
$tag = get_tag( 100 );
echo '<a href="' . get_tag_link( $tag ) . '">' . $tag->name . '</a>';

2. Формат возвращаемого результата

Для того, чтобы наглядно показать, что возвращает функция, я воспользуюсь PHP-функцией print_r().

$tag = get_tag( $tag_id );
print_r( $tag );
/* 
WP_Term Object
(
    [term_id] => 100
    [name] => Италия
    [slug] => italy
    [term_group] => 0
    [term_taxonomy_id] => 100
    [taxonomy] => post_tag
    [description] => 
    [parent] => 0
    [count] => 0
    [filter] => raw
    [order] => 0
)
*/
 
$tag = get_tag( $tag_id, 'ARRAY_A' );
print_r( $tag );
/*
Array
(
    [term_id] => 100
    [name] => Италия
    [slug] => italy
    [term_group] => 0
    [term_taxonomy_id] => 100
    [taxonomy] => post_tag
    [description] => 
    [parent] => 0
    [count] => 0
    [filter] => raw
    [order] => 0
)
*/
 
$tag = get_tag( $tag_id, 'ARRAY_N' );
print_r( $tag );
/*
Array
(
    [0] => 100
    [1] => Италия
    [2] => italy
    [3] => 0
    [4] => 100
    [5] => post_tag
    [6] => 
    [7] => 0
    [8] => 0
    [9] => raw
    [10] => 0
)
*/

Кодекс WordPress: Метки: edit_tag_link(), get_edit_tag_link(), get_tag(), get_tag_link(), get_tags(), get_the_tags(), has_tag(), is_tag(), single_tag_title(), tag_description(), the_tags(), wp_get_post_tags(), wp_set_post_tags(), wp_tag_cloud()

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Параметры
Примеры
1. Основы использования
2. Формат возвращаемого результата