wp_get_post_tags()
Отримує список позначок зазначеного посту у вигляді масиву.
Це обгортка для функції wp_get_post_terms() .
Працює на основі:
wp_get_post_terms()
wp_get_post_terms()
1 раз – 0.016552 сек
(гальмо) | 50000 разів – 16.89 сек
(повільно) |
PHP 7.2.5, WP 4.9.8
(гальмо) | 50000 разів – 16.89 сек
(повільно) |
PHP 7.2.5, WP 4.9.8
Хуків немає.
Повертає
Массив|WP_Error.
array( WP_Term, WP_Term )– масив об’єктів WP_Termarray()– Порожній масив якщо міток не знайдено.WP_Error— object WP_Error, якщо таксономія post_tag не існує.
Використання
wp_get_post_tags($post_id, $args);
-
$post_id
(число) - ID посту.
-
$args
(масив) Переписує аргументи за промовчанням. Увесь список аргументів дивіться в описі функції wp_get_object_terms() .
За замовчуванням $args встановлюється параметр
fields=all(отримати всі поля терміну). Інші значення цього аргументу:names(отримувати тільки назви термінів) таids(тільки ID термінів).За замовчуванням: array()
Приклади
#1 Отримаємо мітки поточного посту
Допустимо пост має такі мітки: tag2, tag5 и tag6:
$tags = wp_get_post_tags( $post->ID ); print_r ($ tags); /* В результаті отримаємо на екрані наступний код: Array( [0] => stdClass Object ( [term_id] => 4 [name] => tag2 [slug] => tag2 [term_group] => 0 [term_taxonomy_id] => 4 [taxonomy] => post_tag [description] => [parent] => 0 [count] => 7 ) [1] => stdClass Object ( [term_id] => 7 [name] => tag5 [slug] => tag5 [term_group] => 0 [term_taxonomy_id] => 7 [taxonomy] => post_tag [description] => [parent] => 0 [count] => 6 ) [2] => stdClass Object ( [term_id] => 16 [name] => tag6 [slug] => tag6 [term_group] => 0 [term_taxonomy_id] => 16 [taxonomy] => post_tag [description] => [parent] => 0 [count] => 2 ) ) */
#2 Отримаємо список ID позначок поточного посту
У списку будуть лише ID позначок (поле ids):
global $post; $tag_ids = wp_get_post_tags( $post->ID, array( 'fields' => 'ids' ) ); // $tag_ids = [ 4, 7, 16 ]
список змін
| З версії 2.3.0 | Введено. |
Код wp_get_post_tags() wp get post tags WP 6.0.2
function wp_get_post_tags( $post_id = 0, $args = array() ) {
return wp_get_post_terms( $post_id, 'post_tag', $args );
}