云策 WordPress 开发者社区

函数文档

get_the_tags()

查看官方原文 ↗
💡 云策文档标注

概述

get_the_tags() 函数用于检索文章关联的标签，返回一个 WP_Term 对象数组。该函数不直接输出内容，开发者需手动处理返回的数据以显示或使用标签信息。

关键要点

  • 参数 $post 为可选，可传入文章 ID 或 WP_Post 对象；在 The Loop 中可省略参数。
  • 返回值类型为 WP_Term[]|false|WP_Error：成功时返回 WP_Term 对象数组，无标签或文章不存在时返回 false，失败时返回 WP_Error。
  • 函数内部调用 get_the_terms() 并应用 'get_the_tags' 过滤器，允许自定义标签数组。
  • 适用于多种场景，如显示标签名称、链接到标签页面、创建下拉菜单或基于标签值执行条件代码。

代码示例

// 示例：显示当前文章的所有标签名称（用逗号分隔）
$post_tags = get_the_tags();
if ( $post_tags ) {
    foreach( $post_tags as $tag ) {
        echo $tag->name . ', ';
    }
}

注意事项

  • 函数本身不输出任何内容，需通过 echo 或循环访问对象属性来显示标签。
  • 在 The Loop 外使用时，建议显式传递文章 ID，如 get_the_tags( get_the_ID() )。
  • 返回的数组可能为空，使用前应检查 $post_tags 是否为真以避免错误。
📄 原文内容

Retrieves the tags for a post.

Parameters

$postint|WP_Postrequired
Post ID or object.

Return

WP_Term[]|false|WP_Error Array of WP_Term objects on success, false if there are no terms or the post does not exist, WP_Error on failure.

More Information

This function returns an array of objects, one object for each tag assigned to the post. If this function is used in The Loop, then no ID need be passed.

This function does not display anything; you should access the objects and then echo or otherwise use the desired member variables.

The following example displays the tag name of each tag assigned to the post (this is like using the_tags(), but without linking each tag to the tag view, and using spaces instead of commas):

name . ' '; 
  }
}
?>

Source

function get_the_tags( $post = 0 ) {
	$terms = get_the_terms( $post, 'post_tag' );

	/**
	 * Filters the array of tags for the given post.
	 *
	 * @since 2.3.0
	 *
	 * @see get_the_terms()
	 *
	 * @param WP_Term[]|false|WP_Error $terms Array of WP_Term objects on success, false if there are no terms
	 *                                        or the post does not exist, WP_Error on failure.
	 */
	return apply_filters( 'get_the_tags', $terms );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘get_the_tags’, WP_Term[]|false|WP_Error $terms )

Filters the array of tags for the given post.

Uses Description
get_the_terms()wp-includes/category-template.php

Retrieves the terms of the taxonomy that are attached to the post.
apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.
Used by Description
get_the_category_rss()wp-includes/feed.php

Retrieves all of the post categories, formatted for use in feeds.

Changelog

Version Description
2.3.0 Introduced.

User Contributed Notes

  2. Skip to note 10 content


    hearvox


    You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

    This example prints the tags of current post:
    Code must be used in The Loop.

    $post_tags = get_the_tags();

if ( $post_tags ) {
	foreach( $post_tags as $tag ) {
    echo $tag->name . ', '; 
	}
}

  3. Skip to note 11 content


    marzian


    You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

    // Show post tags with link and a custom separator

    function wpdocs_show_tags() {
    $post_tags = get_the_tags();
    $separator = ' | ';
    $output = '';

    if ( ! empty( $post_tags ) ) {
        foreach ( $post_tags as $tag ) {
            $output .= '<a href="' . esc_attr( get_tag_link( $tag->term_id ) ) . '">' . __( $tag->name ) . '</a>' . $separator;
        }
    }

    return trim( $output, $separator );
}

  4. Skip to note 12 content


    hearvox


    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    Example using post ID to get tags:
    This doesn’t need to be in The Loop.

    $post_tags = get_the_tags( 24 );

print_r( $post_tags );

/*
This above prints the tag objects for post ID #24 (if post has any tags):
Array
(
    [0] => WP_Term Object
        (
            [term_id] => 108
            [name] => tag-1
            [slug] => tag-1
            [term_group] => 0
            [term_taxonomy_id] => 109
            [taxonomy] => post_tag
            [description] => 
            [parent] => 0
            [count] => 1
            [filter] => raw
            [object_id] => 24
        )

    [1] => WP_Term Object
        (
            [term_id] => 109
            [name] => tag-2
            [slug] => tag-2
            [term_group] => 0
            [term_taxonomy_id] => 110
            [taxonomy] => post_tag
            [description] => 
            [parent] => 0
            [count] => 1
            [filter] => raw
            [object_id] => 24
        )

)
*/

  7. Skip to note 15 content


    hearvox


    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Function to show tags in a dropdown:

    ';
    foreach ( get_the_tags() as $tag ) {
        echo '<option value="' . $tag->name . '">' . $tag->name . "</option>n";
    }
    echo '</select>';
}
?>
<h2></h2>
<form id="tags-select" class="tags-select" action="<?php echo esc_url( home_url( '/' ) ); ?>" method="get">
    
    <input type="submit" name="submit" value="view" />
</form>