Get Post for WordPress

when specifying a tag it’s best to use the slug value rather than the full

name of the tag. To find the slug, see the admin panel -> posts -> post tags.

The slug is listed right on that page.

You may wish to specify an option value with a space in it. This is

accomplished with quotes:

[get-post option="a value with spaces"]

tag:

Specify a tag to search for. The tag’s slug should be specified.

[get-post tag=some-tag]

category:

Specify a category to search for. The category’s slug should be specified.

[get-post category=some-category]

show:

Specify the number of posts to show.

[get-post show=5]

template:

Specify the template to use. This specification overrides the template set in

the options panel of the admin interface. See the template section for more

details on template tags. NOTE: If entering any HTML into this, please be

sure to select the HTML editor rather than the visual editor.

[get-post template="<h1>Title: {title}</h1>"]

random:

Select a random post from the matching criteria

[get-post random]

default:

This isn’t really an option. By default, get-post displays the latest blog

post.

[get-post]

Templates Get-post ships with a default template that should render the usual post

details in a form that fits well with most themes. You can customize this

template to add or remove data from the included post. Additionally, you can

use the template parameter to the [get-post] tag to specify a one-off

template.

Using the show parameter will retrieve multiple posts. In this case, the

template will be repeated one time for each retrieved post.

These tags are replaced with the value from the retrieved post. For instance,

a template containing {title} will actually have the title of the retrieved

post, rather than the word title.

{title}:

The title of the post.

{content}:

The content of the post.

{author}:

The author of the post.

{date}:

The date the post was written.

{time}:

The time the post was written.

{permalink}:

A link to the post itself.

{authorlink}:

A link to all posts by the post’s author.

{id}:

The post’s ID number.

Examples Indicate when your blog was last updated:

Blog last updated [get-post template="{date} at {time}."]

Link to the latest post:

Check out my post: [get-post template="<a href='{permalink}'>{title}</a>"]

How it works This plugin does something a little bit unorthodox: It reenters “The

Loop” while the post content is being rendered. Then, it calls

whatever WordPress internal functions will safely work, using raw data from

$post when these functions are unsafe to call again. People curious about the

internals should examine class-get-post-getter.php. The class is structured

to be reusable by any other GPL2 projects.