WordPress.org

Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/get tags

Description

Retrieve an array of objects for each term in post_tag taxonomy.

Usage

 <?php $tags_array get_tags$args ); ?> 

Parameters

Retrieves a list of post tags based on the criteria provided in $args. The list of arguments that $args can contain, which will overwrite the defaults:

orderby 
Default is 'name'. Can be name, count, or nothing (will use term_id).
order 
Default is ASC. Can use DESC.
hide_empty 
Default is true. Will not return empty terms, which means terms whose count is 0 according to the given taxonomy.
exclude 
Default is an empty string. A comma- or space-delimited string of term ids to exclude from the return array. If 'include' is non-empty, 'exclude' is ignored.
include 
Default is an empty string. A comma- or space-delimited string of term ids to include in the return array.
number 
The maximum number of terms to return. Default is empty.
offset 
The number by which to offset the terms query.
fields 
Default is 'all', which returns an array of term objects. If 'fields' is 'ids' or 'names', returns an array of integers or strings, respectively.
slug 
Returns terms whose "slug" matches this value. Default is empty string.
hierarchical 
Whether to include terms that have non-empty descendants (even if 'hide_empty' is set to true).
search 
Returned terms' names will contain the value of 'search', case-insensitive. Default is an empty string.
name__like 
Returned terms' names will contain the value of 'name__like', case-sensitive. Default is empty string.
description__like 
Returned terms' descriptions will contain the value of 'description__like', case-insensitive. Default is empty string.
pad_counts 
If set to true will include the quantity of a term's children in the quantity of each term's "count" object variable.
get 
If set to 'all' instead of its default empty string, returns terms regardless of ancestry or whether the terms are empty.
child_of 
When used, should be set to the integer of a term ID. Its default is 0. If set to a non-zero value, all returned terms will be descendants of that term according to the given taxonomy. Hence 'child_of' is set to 0 if more than one taxonomy is passed in $taxonomies, because multiple taxonomies make term ancestry ambiguous.
parent 
When used, should be set to the integer of a term ID. Its default is the empty string, which has a different meaning from the integer 0. If set to an integer value, all returned terms will have as an immediate ancestor the term whose ID is specified by that integer according to the given taxonomy. The 'parent' argument is different from 'child_of' in that a term X is considered a 'parent' of term Y only if term X is the father of term Y, not its grandfather or great-grandfather, etc.

Returns

Returns either an array of objects or an empty array. Each returned object has the following properties:

term_id 
(string)
name 
(string)
slug 
(string)
term_group 
(string)
term_taxonomy_id 
(string)
taxonomy 
(string)
description 
(string)
parent 
(string)
count 
(string)

Example

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;

Source File

get_tags() is located in wp-includes/category.php.

Resources

Related

Tags: get_tag(), get_tag_link(), get_tags(), get_the_tag_list(), get_the_tags(), is_tag(), the_tags(), single_tag_title(), tag_description(), wp_generate_tag_cloud(), wp_tag_cloud()

See also index of Function Reference and index of Template Tags.
This article is marked as in need of editing. You can help Codex by editing it.