The plugin implements a simple way of inserting featured posts into WordPress posts or pages by using a shortcode. To retrieve your featured posts when using the shortcode, the plugin uses WordPress’s WP_Query() class and passes your shortcode attributes to it to make the query.

The shortcode implemented by the plugin is [codeflavors_featured_post]. When used without any options, it will select the newest post type post and display it using plugin template Default.

Shortcode options

post_type ( default: post )

The plugin allows you to select any public post type. This includes post types registered by WordPress (post, page and media) and also any other post type registered by third party plugins or WP themes.

The parameter must contain the post type ID ( ie. post, page, attachment etc. )

post_num ( default: 1 )

By default the plugin will select one post and this will be the newest. If you want to display more than one featured post, change this option with the number of posts that you want to retrieve.

offset ( default: 0 )

Same as for post_num option, the plugin will select the newest first post. If you don’t want the results to start with the first post found, change this option with the number of posts that you want to skip starting with the newest one. For example, if you want to retrieve the second newest post, set the offset value to 1.
taxonomy ( default: none )

If you would like to narrow your selection to a given category (ie. choose newest post from category “Fashion”) you will need to specify the taxonomy of the category that you want to select from. For regular posts this parameter can be skipped if you want to choose from regular taxonomies but if you want to choose from any other taxonomy type, you will need to specify it here, especially for custom post types.

category ( default: none )

With the taxonomy specified (for anything other than regular post categories), to choose from a certain category all you have to do is enter in this option the ID or the name of the category that you want to select from.

Unless a taxonomy is specified in option “taxonomy” the plugin will assume by default that you want to select posts from regular post categories.

post_id ( default: none )

If you would like to feature a specific post, enter its ID into this parameter. All other parameters (except template) that might be set will be overridden and the plugin will select your specific post ID and display it.

template ( default: Default template )

The plugin implements two default templates: Default and Fancy that can be used to display your featured posts but also offers you the possibility to implement your own template.