Question

get_the_tag_list( string $before = '',  string $sep = '',  string $after = '',  int $id )

Retrieve the tags for a post formatted as a string.

---

description

---

参数

$before

(string) (Optional) Before tags.

Default value: ''

$sep

(string) (Optional) Between tags.

Default value: ''

$after

(string) (Optional) After tags.

Default value: ''

$id

(int) (Optional) Post ID. Defaults to the current post.

---

返回值

(string|false|WP_Error) A list of tags on success, false if there are no terms, WP_Error on failure.

---

源代码

File: wp-includes/category-template.php

function get_the_tag_list( $before = '', $sep = '', $after = '', $id = 0 ) {

	/**
	 * Filters the tags list for a given post.
	 *
	 * @since 2.3.0
	 *
	 * @param string $tag_list List of tags.
	 * @param string $before   String to use before tags.
	 * @param string $sep      String to use between the tags.
	 * @param string $after    String to use after tags.
	 * @param int    $id       Post ID.
	 */
	return apply_filters( 'the_tags', get_the_term_list( $id, 'post_tag', $before, $sep, $after ), $before, $sep, $after, $id );
}

---

更新日志

Version	description
2.3.0	Introduced.

---

相关函数

Uses

• wp-includes/category-template.php: get_the_term_list()
• wp-includes/category-template.php: the_tags
• wp-includes/plugin.php: apply_filters()

---

Used By

• wp-includes/category-template.php: the_tags()

---

User Contributed Notes

1. Skip to note content 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 Contributed by Codex

   A Basic Example
   This outputs the list of tags inside a paragraph, with tags separated by commas.

   
   echo get_the_tag_list( sprintf( '<p>%s: ', __( 'Tags', 'textdomain' ) ), ', ', '</p>' );
   

   This would return something like:

   
   <p>Tags: <a href="tag1">Tag 1</a>, <a href="tag2">Tag 2</a>, ...</p>
   

A Slightly More Complex Example

This checks if the post has any tags, and if there are, outputs them to an unordered list.

/** @var string|false|WP_Error $tag_list */
$tag_list = get_the_tag_list( '<ul><li>', '</li><li>', '</li></ul>' );

if ( $tag_list && ! is_wp_error( $tag_list ) ) {
	echo $tag_list;
}

This will return something in the form:

<ul>
	<li><a href="tag1">Tag 1</a></li>
	<li><a href="tag2">Tag 2</a></li>
	...
</ul>

You can add classes and styles with CSS, as necessary.