Возвращает информацию о метке. В виде объекта или в виде ассоциативного или нумерованного массива.
Прежде, чем получать значение из базы данных, функция попробует получить его из кэша.
Возвращает объект класса 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 ) */