Question

get_tags( string|array $args = '' )

Retrieves all post tags.

---

description

---

参数

$args

(string|array) (Optional) Tag arguments to use when retrieving tags.

Default value: ''

---

返回值

(array) List of tags.

---

源代码

File: wp-includes/category.php

function get_tags( $args = '' ) {
	$tags = get_terms( 'post_tag', $args );

	if ( empty( $tags ) ) {
		$return = array();
		return $return;
	}

	/**
	 * Filters the array of term objects returned for the 'post_tag' taxonomy.
	 *
	 * @since 2.3.0
	 *
	 * @param array $tags Array of 'post_tag' term objects.
	 * @param array $args An array of arguments. @see get_terms()
	 */
	$tags = apply_filters( 'get_tags', $tags, $args );
	return $tags;
}

---

更新日志

Version	description
2.3.0	Introduced.

---

相关函数

Uses

• wp-includes/category.php: get_tags
• wp-includes/taxonomy.php: get_terms()
• wp-includes/plugin.php: apply_filters()

---

Used By

• wp-admin/includes/export.php: export_wp()
• wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_getTags()

---

User Contributed Notes

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

   Displays a list of tags with links to each one and a specific class for each tag:

   
   $tags = get_tags();
   $html = '<div class="post_tags">';
   foreach ( $tags as $tag ) {
   	$tag_link = get_tag_link( $tag->term_id );
   			
   	$html .= "<a href='{$tag_link}' title='{$tag->name} Tag' class='{$tag->slug}'>";
   	$html .= "{$tag->name}</a>";
   }
   $html .= '</div>';
   echo $html;
   

Display all tags in list format with links.

$tags = get_tags(array('get'=>'all'));
	$output .= '<ul class="tag-cloud-list">';
		if($tags) {
		foreach ($tags as $tag):
		$output .= '<li><a href="'. get_term_link($tag).'">'. $tag->name .'</a></li>';
		endforeach;
		} else {
		_e('No tags created.', 'text-domain');
		}
	$output .= '</ul>';
return $output;