What I’ve always thought would be a neat plugin would be something that gave users the ability to insert WordPress template tags from within the Write Post/Page screen. I’ve also gotten a few requests for this type of functionality.
Template Tag Shortcodes comes loaded with 40 shortcodes that represent their equivalent template tags.
For example, a commonly used template tag is wp_list_pages(). But, it’s a PHP function and can’t be used within the post editor (without a PHP plugin). With this plugin, you could simply type in [wp_list_pages] and let the plugin do all the work.
The available shortcodes
If you know me, you know I can’t stop at one or two shortcodes. That’s why I made 40.
Several shortcodes have additional parameters, which are listed in the plugin’s readme.html file. Here’s the list of what’s currently available in the plugin.
[wp_list_authors][the_author][the_author_description][the_author_login][the_author_firstname][the_author_lastname][the_author_nickname][the_author_ID][the_author_url][the_author_email][the_author_link][the_author_aim][the_author_yim][the_author_posts][the_author_posts_link][the_modified_author][wp_list_categories][wp_dropdown_categories][the_category][get_category_link][the_date][the_time][the_modified_date][the_modified_time][wp_tag_cloud][the_tags][get_tag_link][wp_list_bookmarks][the_title][the_title_attribute][the_ID][the_permalink][get_permalink][wp_list_pages][wp_dropdown_pages][wp_get_archives][bloginfo][allowed_tags][wp_logout_url][wp_login_url][comments_link][category_description][tag_description][term_description][the_terms][the_author_meta]
I’m sure more will be added over time. If you have a particular template tag you’d like to see as a shortcode, just let me know in the comments.
Some important notes
These shortcodes don’t provide additional XHTML formatting. For example, [wp_list_pages] won’t be wrapped with the <ul> tag. This is because its equivalent template tag wp_list_pages() does not do this. So, you’ll want to add any additional formatting from within the post editor.
I struggled with this decision but thought it was the best route. The goal was to adhere to the same rules as the WordPress template tags.
Download the Template Tag Shortcodes plugin
Get the plugin. Enjoy. Let me know how it works out for you. For full instructions, see the readme.html file included with the plugin download.
- Version: 0.1.1
- Requires: WordPress 2.5+
- Support: Support forums
- Download (WP.org plugin repository)
Please don’t use my contact page or the comments section below to ask support questions. Use my support forums at Theme Hybrid, which is where I handle all support questions for my WordPress projects.
If you run across any bugs or want to share ideas about how to make this plugin better, feel free to post in the comments below.
That is a really awesome idea for a plugin! I’m for sure going to grab this and give it a run!
If only the plugin created a UI element to allow easy insertion while posting so users wont have to remember the format of a template tag
The Frosty — Thanks. I had a few requests and figured it’d be useful. It wasn’t too tough to throw together.
African Boy — Remind me to never, ever add a UI for this plugin.
Sorry, I’m just a firm believer that we should start taking things out of the admin instead of putting more things in.
nice plugin for designers.
Will it parse attributes too? things like [wp_tag_cloud number="10"] to get ten tags? That would be great. And do the shortcodes work in text widgets too (which would effectively make them a sort of meta-widgets)? Love it btw, brilliant idea.
Short codes are way too cool. You made my day
Thanks Justin !
Awesome plugin Justin, and great question Roy, I’m anxious to know the answer.
[...] Tadlock just released a brilliant WordPress plugin that lets you call template tags (the stuff theme developers use to display things) inside posts [...]
topcool — I’m thinking it should be nice for Average Joe, but I suppose even designers can use it.
Roy Tanck — The
readme.htmlfile shows the various parameters you can input for each shortcode. Not all shortcodes have them. But, shortcodes that do have parameters replicate their equivalent template tag.As for shortcodes in widgets, that’s something this plugin shouldn’t control. See this tutorial on making shortcodes work in widgets.
I haven’t tested all of the parameters because that would take forever. I figured I’d let you all do that and let me know what works and what doesn’t.
Many — You’re welcome. I like shortcodes too, at least when I have a bunch of them packaged together.
Adam W. Warner — Thanks. See my answer to Roy.
[...] Read more: Template Tag Shortcodes: WordPress Plugin [...]
This is a super-cool Sauron-style plugin (1 shortcode plugin to rule them all!), Justin. Does
[the_author_email]useantispambot()?[插件推荐] Template Tag Shortcodes…
WordPress 2.5 中加入的 Shortcode 是一个很强大的功能。通过它可以方便的插入代码块，或是实现 PHP 在文章编辑器中的执行等。本文要推荐的 Template Tag Shortcodes 插件就可以在文章编辑器中执行 PHP……
Ian Stewart — It doesn’t currently use
antispambot(), but I’m thinking it might be a good idea to make that change in the next version. There’s really no reason for it not to.Another awesome plugin Justin. I’ve always had trouble turning over a site to a client, where I used php in a post or page with the runPHP plugin, then they go to edit that post with the visual editor and it gets all messed up and stops working. I’ve written a few small plugins for myself and found a few others to replace a couple specific needs I had (wp_list_pages being one, to list child pages on a parent page) but this is really awesome. I am going to see if I can stop using the runPHP plugin altogether and just use this instead.
Thanks very much.
I’ve just installed this plugin, no problems or anything. Really useful. Can’t wait for more shortcodes!
Chris Hajer — I have that same problem, except I’m the one always screwing things up on my own site. I usually just code a quick shortcode in my theme anytime I have some PHP that I’m reusing on multiple pages. It’s the easiest way to steer clear of future headaches.
If I can help you get rid of any more PHP template tags, let me know what they are. I’ll be happy to add more to the plugin.
Danny — Glad to hear everything’s working for you.
Please please please always keep it this way:
> The goal was to adhere to the same rules as the WordPress template tags.
This is exactly how I would expect it to work. If you decide to extend the plugin, please make sure that all the base functionality of the template tags goes unchanged. After years of getting used to passing parameters to template tags, I would hate to have to unlearn that to use this awesome plugin.
Thanks again.
Great idea for a plugin Justin! If you could get this work with the_meta and custom fields, that would be amazingly awesome!!!
Awesome!
Last few days you are furfilling my plugin dreams! First cleaner gallery, widgets reloaded, widget-reset, then get-the-image (way cool), query posts and now this! I am almost exclusively using your plugins, there is no need for any else.
You are making my world better every day, thank you so much!
I am about to join exclusive hybrid theme club (at this moment I am just solving PayPal issue) and so at least a bit help you continue developing those amazing frameworks.
Thank you, man!
Chris Hajer — I plan to keep it that way. I think it is the best route.
Bryan Harley — I thought about incorporating some of the custom field stuff. Several of the custom field functions return arrays instead of strings, which is a problem when we’re dealing with a shortcode.
the_meta()is pretty much out because it prints to the screen rather than returning unless there’s aget_the_meta()equivalent.get_post_meta()would work as a shortcode if you specified to return a single value.It’s something that would come in handy, and I’d definitely love to have the functionality myself.
Mijk — Glad I could be of service. And, we’d be happy for you to join our community at Theme Hybrid.
[...] Template Tag Shortcodes [...]
I’d love to have that functionality too. I think it would totally revolutionize the use of custom fields!!!
Figure it out! You can do it! Heh heh.
Bryan Harley — I’ve been thinking it over a bit. What follows does not concern the
the_meta()function, which I might be able to find a solution for.The problem I see with most custom field functions is that we don’t know what to do with an
arrayof information. For example, how would it be output? The very nature of custom fields makes it impossible to predict what the user wants to do with them. This leads us back to having to use PHP within the post, which kind of goes against the idea of shortcodes.It’s easy to code the shortcodes to grab the information, but since the plugin can’t know what to do with that information, there’s not much we can do. Now, the easy part happens when you do know what to do with the information. You could easily code custom shortcodes to perform specific tasks with your custom fields.
I’m also wondering how useful it would really be. Custom fields are for attaching additional meta information about a specific post. Shortcodes are for adding information inside of a post. Wouldn’t it be easier just to add the information within the post itself? It seems like we’d be adding an additional layer of complexity.
Are there tags for comments that I’m just missing? Specifically, I’m needing comments_number().
R.A. Ray — The shortcode equivalent of
comments_number()is not currently available. All of the available shortcodes are listed above and in thereadme.html. I’ll try to add in some comment stuff in the next version.Thanks man! Love the plugin so far.
[...] pretty ordinary. One not-so-ordinary plugin, however, really caught my eye. It’s called Template Tag Shortcodes by Justin Tadlock. Basically, this lets you use template tags in a “shortcode” form in [...]
[...] 答案就是这个插件了：Template Tag Shoutcuts。 [...]
[...] as instruções de uso dos shortcodes usados nesse plugin. O post oficial do Justin Tadlock que lança o plugin aceita, nos comentários, sugestões de novos shortcodes a serem incluídos no plugin. Um lembrete, [...]
[...] Template Tag Shortcodes，允许在Post或者Page中调入Template Tag。 举例来说，想调用wp_list_categories()这个tag的话，只需在文章或页面的编辑页面中写入[wp_list_categories]。这样就可以在文章中显示你的类别列表了。 [...]
[...] The answer is that the plug-in: Template Tag Shoutcuts. [...]
THANK YOU FOR MAKING THIS. <3 <3 <3
This was exactly what I was looking for. Thanks, a huge super big alot! hehe
thanks, this is very useful plugin for “lazier” like me, hehe…
Love the plugin! For the same reasons as people list above (letting clients edit pages without messing them up). Bravo Justin!
Feature request: The ability to NEST template tags (or use variables). IE: If I want to show the pages that are in the same parent/child relationship in a particular thread, something like
[wp_list pages [the_ID]]
I know this can be done in PHP, but it would be oh so nice to be able to do it in Template Tag Shortcodes
[...] Link: Template Tag Shortcodes: WordPress Plugin [...]
Thanks for this plugin Justin.
Just one question : is there any way to use [the_title] with the ID parameter? As it can be done with [get_permalink id=244] to show the permalink of one post in another one.
Thanks
Glou
This is super!
One question. [wp_list_categories] returns list items, but no enclosing or
Any suggestions of shortcodes my WYSIWYG editors could use to enclose the list.
Like [ul] [/ul] ?
[...] Template Tag Shortcodes, which “turns many of the WordPress template tags into shortcodes that can be used in posts and pages.” And can be used in Section Widget. [...]
Hi mate,
Is there any way to filter [wp_list_categories]?
For example I don’t need all category groups, and their sub categories. Just one group. If I could I would be using something like:
… in my code.
Thanks,
L
is it possible to insert in the future the last posts written with the function of wordpress??
Example
.aaaa
.bbb
.ccc
.ddd
5 posts recently
Ever since OZH Random Words plugin broke with 2.8, I am in desperate need of a random text plugin that works within posts.
There is Random Text by Pants on Head which is compatible with 2.8 but it only displays via widget or template tags.
Can I pay you to add shortcode functionality to Random Text by Pants on Head?http://wordpress.org/extend/plugins/randomtext/
http://www.pantsonhead.com/wordpress/randomtext/
Please email me. I really need it!
Oh, let me add, because it’s not clear in the instructions, the plug in adds random text via this template tag:
Hello!
Thanx for a plugin!!
i’m using – [wp_tag_cloud] in post (publication)
can smbd please tell how to asign a class for that code??
i see the source is:
Gillian Anderson
David Duchovny
Ken Camroux
so, in style.CSS i put
.tag-link {text-decoration:none; color:black;}
.tag-link a {text-decoration:none; color:black;}
but no result.
please help.
[...] a bunch of the “core” functions/tags/etc that are available in WP. one guy even created a plugin that turns template tags into shortcodes. this lets me know that before i go off and try to rewrite history, a little more time on teh googz [...]
Nice one, would definitely come in handy.
I’ve been trying to find the opposite type of thing however, need to learn how to turn a shortcode into a template tag.
[...] installation (2.9.1) I use the plugin Template Tag Shortcodes By Justin Tadlock available here http://justintadlock.com/archives/2009/03/24/template-tag-shortcodes-wordpress-plugin Justin’s plugin rocks! I am also as of Jan 12th working off of a locally served Wordpress [...]