Codex

Codex Resources

Template Tags/get the tag list

Contents

Description

Generates a HTML string of the tags associated with the current post. The name of each tag will be linked to the relevant 'tag' page. You can tell the function to put a string before and after all the tags, and in between each tag. This tag must be used inside 'The Loop'.

Usage

This function does not display anything - if you want to put it straight onto the page, you should use echo (get_the_tag_list()). Alternatively, you can assign it to a variable for further use by using $foo = get_the_tag_list().

The variables are all optional, and should be placed in the order 'before', 'separator', 'after'. You can use HTML inside each of the fields.

Example

A Basic Example

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

<?php
echo get_the_tag_list('<p>Tags: ',', ','</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 a standard unordered list. 

<?php
if(get_the_tag_list()) {
 get_the_tag_list('<ul><li>','</li><li>','</li></ul>');
}
?>

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./


the_tags, get_the_tags, get_the_tag_list, single_tag_title, is_tag, get_tag_link, wp_tag_cloud, wp_generate_tag_cloud,

How to pass parameters to tags with PHP function-style parameters

Go to Template Tag index

This page is marked as incomplete. You can help Codex by expanding it.

Retrieved from "http://codex.wordpress.org/Template_Tags/get_the_tag_list"