Tekserve Single Post Shortcode

Description

There are plenty of plugins to show lists of posts, but if you only want to display a condensed preview of a post on any wp page, this is the plugin for you! The shortcode accepts the numeric id of any post as an attribute, and will display a preview that links to that post. This preview is generated with easily styled html. To show or hide the featured image for your single post preview, pass the attribute showimage with either hide or show. It’s pretty easy!

For fun, I decided to also build a widget that does the same thing; it’s included and can be used like any other widget. Why not?!

Installation

1. Upload the tekservesinglepostshortcode folder to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Use the shortcode anywhere you want a condesed preview of a single post, e.g. [single_post id="1" showimage="show"].
4. To use the widget, go to Appearance->Widgets and drag the Tekserve Single Post Widget into whatever widget area you’d like. Enter the post id, check the box if you want to show the featured image, and hit save.

FAQ

Why would I want to use this?

You want to display a link to a single post with a brief content preview. Plenty of plugins will create this type of object in a list, or as part of popular or related posts, but sometimes you want to manually feature a post somewhere and not mess around with sticky posts or the loop. This simple shortcode does it for you without modifying your theme’s functions.php.

You also get a widget, so there’s that!

How can I style the output?

It’s pretty easy; just add css for the output classes and ids in your style.css for your theme, or enqueue a separate .css file in your theme to handle it.

Here’s a listing of targets to style the output:

Output to Style CSS target

Single Post Container .tekserve-single-post -or- #single-post-$$ ( $$ is numerical post id)

Featured Image .tekserve-single-post a img

Title .tekserve-single-post .tekserve-single-post-title

Date and Author .tekserve-single-post .tekserve-single-post-meta

Post Content .tekserve-single-post .tekserve-single-post-excerpt

Where does the plugin get its output?

From the post, of course! Here are the specifics:

• Image – Post Featured Image / Thumbnail
• Title – Post Title
• Meta – Post Date and Post Author
• Excerpt – Post excerpt, if it exists. If not, first 90 characters of content, sans html tags

Reviews

Contributors & Developers

Changelog

1.3

• filtered excerpt html tags
• added support for excerpt field

1.2

• updated file permissions

1.1

• added widget

1.0

• added shortcode