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 begin with the value of ‘name__like’, case-insensitive. Default is empty string.

The argument ‘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.

The ‘get’ argument, if set to ‘all’ instead of its default empty string, returns terms regardless of ancestry or whether the terms are empty.

The ‘child_of’ argument, 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.

The ‘parent’ argument, 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.

Query_posts can be used to control which posts show up in The Loop. It accepts a variety of parameters in the same format as used in your URL (e.g. p=4 to show only post of ID number 4).

Why go through all the trouble of changing the query that was meticulously created from your given URL? You can customize the presentation of your blog entries by combining it with page logic (like the Conditional Tags) — all without changing any of the URLs.

Common uses might be to:

• Display only a single post on your homepage (a single Page can be done via Settings -> Reading).
• Show all posts from a particular time period.
• Show the latest post (only) on the front page.
• Change how posts are ordered.
• Show posts from only one category.
• Exclude one or more categories.

Important note

The query_posts function is intended to be used to modify the main page Loop only. It is not intended as a means to create secondary Loops on the page. If you want to create separate Loops outside of the main one, you should create separate WP_Query objects and use those instead. Use of query_posts on Loops other than the main one can result in your main Loop becoming incorrect and possibly displaying things that you were not expecting.

The query_posts function overrides and replaces the main query for the page. To save your sanity, do not use it for any other purpose.

Usage

<?php

//The Query
query_posts('posts_per_page=5');

//The Loop
if ( have_posts() ) : while ( have_posts() ) : the_post();
 ..
endwhile; else:
 ..
endif;

//Reset Query
wp_reset_query();

?>

Usage Note

Place a call to query_posts() in one of your Template files before The Loop begins. The wp_query object will generate a new SQL query using your parameters. When you do this, WordPress ignores the other parameters it receives via the URL (such as page number or category). If you want to preserve that information, you can use the $query_string global variable in the call to query_posts().

For example, to set the display order of the posts without affecting the rest of the query string, you could place the following before The Loop:

global $query_string;
query_posts($query_string . "&order=ASC");

When using query_posts in this way, the quoted portion of the argument must begin with an ampersand (&).

Returns the numeric ID of the current post. This tag must be within The Loop.

Usage

<?php get_the_ID(); ?>

Parameters

This tag has no parameters.

Examples

Store the ID

The ID can be stored as a variable using <?php $postid = get_the_ID(); ?>

Post Anchor Identifier

get_the_ID() Can be used to provide a unique anchor in a script. For instance, a dynamically-generated drop down menu with actions for each post in an archive could have

<?php
$id = get_the_ID();
$dropdown = "<select name='dropdown-".$id."' >";
$dropdown .= "<option id='option1-". $id ."'>"Option 1</option>";
$dropdown .= "</select>";
?>

This would allow us to use JavaScript to control the element as it has a unique ID, and when submitting it as a form through the POST or GET methods the dropdown box will be sent with a unique ID which allows the script to note which post it is working on. Alternatively a hidden variable could be sent which will allow the script to see which post the submission is referring to

<?php
echo '<input type="hidden" name="activepost" id="activepost" value="'.get_the_ID().'" />';
?>

If the ID is not called within PHP, then we can use the_ID rather than echo get_the_ID();

Returns an array of objects, one object for each tag assigned to the post. This tag must be used within The Loop.

Usage

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):

<?php
$posttags = get_the_tags();
if ($posttags) {
foreach($posttags as $tag) {
echo $tag->name . ' ';
}
}
?>

Examples

Show tag Images

This outputs tag images named after the term_id with the alt attribute set to name. You can also use any of the other member variables instead.

<?php
$posttags = get_the_tags();
if ($posttags) {
foreach($posttags as $tag) {
echo '<img src="http://example.com/images/' . $tag->term_id . '.jpg"
alt="' . $tag->name . '" />';
}
}
?>

Show the First tag Name Only

<?php
$posttags = get_the_tags();
$count=0;
if ($posttags) {
foreach($posttags as $tag) {
$count++;
if (1 == $count) {
echo $tag->name . ' ';
}
}
}
?>

Display code bases on different tag values

This code will display HTML code depending on if this post has a certain tag or tag(s). Just add as many else if statements as you require.

<?php
if ($all_the_tags);
$all_the_tags = get_the_tags();
foreach($all_the_tags as $this_tag) {
	if ($this_tag->name == "sometag" ) {
?>

<p>SOME HTML CODE <img src="someimage.jpg"></p>

<?php 	} else if ($this_tag->name == "someothertag" ) { ?>

<p>SOME OTHER HTML CODE <img src="someotherimage.jpg"></p>

<?php 	} else {
		// it's neither, do nothing
?>
		<!-- not tagged as one or the other -->
<?
	}
}
}
?>

Member Variables

term_id

the tag id

name

the tag name

slug

a slug generated from the tag name

term_group

the group of the tag, if any

taxonomy

should always be ‘post_tag’ for this case

description

the tag description

count

number of uses of this tag, total

Change Log

Since: 2.3.0

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.

There is a particular reality that needs to be acknowledged, and that is that for many of us, our finances are tighter than what we would like them to be. So maybe, for some of us, hiring that miracle-working Personal Trainer to help get back on track is a little out of the price range. But not to worry, there are plenty of creative and cost effective ways to stay in shape, and even break through existing plateaus without breaking the bank. But before I get into the good stuff, it is important to acknowledge the unequivocal maker or breaker of fitness achievements… and that is motivation.

Got Motivation?
Motivation is a very interesting and dynamic concept. For some of us, motivation works extrinsically (from the outside-in): receiving rewards; money, praise – or in some cases, derision – can provide a sense of empowerment (or in the case of derision, a chance to prove yourself). For others, motivation works intrinsically (from the inside-out): personally creating a tangible feeling of appreciation, passion, and/or a heightened sense of value that can really get you excited about something. Respectively, from my professional and personal experiences, I believe that being intrinsically motivated is much more powerful, self-sufficient, and is more likely to be associated with long term results, despite the endeavor.

So then, how does someone that is not easily intrinsically motivated about exercise, get the proper motivation? Million dollar question. And I wish I had a simple answer for you, but the perfect piece of inspiring advice for each individual is just as unique as the individual themselves. And since everybody is different in their own unique way (in this case, tragically), the most appropriate answer would be… find out what inspires you. Not by fear. Not by marketing trickery. Not by false promises. But by pure, innate passion. Tapping into what you are passionate about can be extremely empowering, and that energy can be harnessed for anything. I will explain more later, but first, let me share an interesting story with you.

A great client and friend of mine once told me (and repeatedly reminds me in the most entertaining stories) “I have a small brain that is easily amused…” Now before you jump to any perverted conclusions, let me clarify what this simple belief means. His statements, “…small brain, easily amused…”, always puts a smile on my face because it reminds me of how we tend to complicate simple pleasures in life. What do I mean by that? It took some training and patience, but eventually I learned to enjoy the simple pleasure of exercise; not just the results that it gave me, but the shear pleasure of doing it! And like my friend, I too have developed (or is it un-developed?) a “small brain, easily amused”, and express that by sharing my simple achievements in life with whoever is willing to listen! Now, if you do decide to give this a try more often – possibly as a little habit in life – It’s important to note that it may be beneficial to share your little achievements in life with people that will humor you, and not get jealous or annoyed. That could be bad.

There are many simple pleasures to be acknowledged and shared! Another personal example, I learned to enjoy the simple pleasure of studying and working hard to get good grades in college. Again, let me point out a critical detail and distinction: I have always enjoyed getting good grades, but it took some work, patience, and diligence to learn to appreciate and enjoy the process. See, this is where simple things get complicated. Often times, especially as Americans, we complicate things by focusing on the end results; focusing on the results/rewards (extrinsic thinking), instead of the process/work (intrinsic thinking). And things get even worse when we are result oriented, and we don’t get what we want… For the extrinsic thinker, this particular situation can be more devastating, compared to that of the intrinsic thinker. Staying motivated absolutely may require a mind frame of NOT what happens to you, but rather, what you do about what happens.

Tying this all into to exercise and fitness is simple… well, at least on a conceptual level. Learn to enjoy the process. Learn to enjoy the work. Learn to enjoy the challenge, the struggle, the sweat, and the soreness associated with exercise! And coincidentally, or perhaps as a prerequisite, learn to enjoy sharing your simple achievements with someone else with a “simple brain, easily amused.”