This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

McNinja Post Styles


Go to the homepage or blog page of a site, chances are, all of the posts look similar: A title, an excerpt and a featured image. Why not display the most important part of your posts to readers and actually give them a reason to click on your post a read it? That’s what this plugin does.

To enable Post Style formatting functionality, go to Settings->Reading and select “Enable Post Style formatting.”

McNinja Post Styles is what we always wanted Post Formats to be: powerful, flexible and extendable. Unleash the creativity of your content.

McNinja Post Styles can display content based on the Post Style of a post. For example, if your post has a video in it and you’ve selected the ‘Video’ style, your blog page, category pages, etc. will display that video rather than an excerpt.

Post Styles can be selected for a Post from the ‘Edit Post’ screen.

For more information or to follow the project, check out the project page.

McNinja Post Styles…

  • Allows authors to choose how to display a Post
  • Supports all of the formats added by Post Formats (aside, gallery, link, image, quote, status, video, audio, chat) so that if your theme made use of Post Formats, the same templates can be used.


  • Example of posts utlizing Post Styles with ‘video’, ‘image’, and ‘standard’ post styles.

  • A post excerpt using the Gallery post style

  • A post excerpt using the Playlist post style

  • A post excerpt using the List post style

  • A post excerpt using the Video post style

  • A post excerpt using the Embed post style

  • A post excerpt using the Quote post style

  • The metabox added to the Post Edit screen

  • Option on Settings -> Reading screen to enable Post Style formatting


Using The WordPress Dashboard

  1. Navigate to the ‘Add New’ Plugin Dashboard
  2. Select from your computer
  3. Upload
  4. Activate the plugin on the WordPress Plugin Dashboard

Using FTP

  1. Extract to your computer
  2. Upload the mcninja-post-styles directory to your wp-content/plugins directory
  3. Activate the plugin on the WordPress Plugins dashboard


How do I make use of Post Styles?

Simply go to Settings->Reading and select “Enable Post Style formatting”, save your changes, and you’re ready to roll!

How do I use Post Styles to display custom theme templates I’ve created?

In your loop or other area in which displaying a content template, change your get_template_part call to the following:

get_template_part( ‘content’, get_post_style() );

get_post_style() will return the slug of the selected post style, for example, if a post is using the ‘image’ Post Style, then get_template_part will be looking to use content-image.php to display the post.

What template will be used if the ‘Standard’ post style (default) is selected?

By default, it will look for content-post.php, if there is no content-post.php, it will use content.php

How do I add CSS to a specific Post Style?

Posts will have a class associated with their style. The class name is in the form of ‘post-style-(slug-name)’, so a post using ‘image’ can be targeted with the ‘.post-style-image’ class.

How do I add a new Post Style?

The ‘post_style_strings’ filter allows you to add new styles. It provides an array of Post Styles and you can add your new post style. The example below adds a new post style named ‘Golden Unicorn’, with a slug ‘golden-unicorn’.

function my_new_custom_post_style( $strings ) {
$strings[‘golden-unicorn’] = _x( ‘Golden Unicorn’, ‘Post style’ );
return $strings;
add_filter( ‘post_style_strings’, ‘my_new_custom_post_style’);

Why aren’t there template files?

This plugin provides the mechanism for allowing custom post formats. It is basically a glorified taxonomy. It is up to themes and developers to utlize this. I’ll be writing some tutorials and examples on my blog shortly though. Feel free to shoot me an email or contact me in the meantime.


There are no reviews for this plugin.

Contributors & Developers

“McNinja Post Styles” is open source software. The following people have contributed to this plugin.


Translate “McNinja Post Styles” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Add content formatting for Image post style
  • Documentation update


  • Add content formatting based on Post Style
  • Add option in Settings -> Reading to enable Post Style formatting
  • Add “Embed” Post Style
  • Add “Chat” Post Style
  • Add “Playlist” Post Style


  • Expose get_post_style_link() function
  • Expose get_post_style_string() function
  • i18n support: add .pot file and make strings translateable
  • Add backwards compatibility with post-format CSS classes for themes already implementing post formats


  • Initial release