WP Related Posts Pro

Version: 2.1.0 | Size: 2.4 MB | Required PHP Version: 5.4
Posted In: Premium Product
View Product →
Make sure to have a look at our Getting Started guide if you have not already.

About WP Related Posts Pro

WP Related Posts Pro for WordPress allows site owners to display related posts on your site in a variety of unique layouts using the global setting, widgets, or shortcodes.

Configuration Settings

WP Related Posts Pro’s plugin settings can be found in Settings > Related Posts Pro.


Title [text] – Set a title to display above your related posts.

Default Thumbnail [image] – Select an image to use as the default in case a post has no Featured Image.

Layout [select: Inline Card, Stacked Card, Thumbnail, Grid, Slider, Image Tile, Plain List, Fancy Colors, Colored Tabs, Image Flip] -Select the layout you wish to display the related posts in. This selection will change plugin options.


Number of Posts [select: 1 – 20] – Select the number of posts to showcase.

Theme Style Override [checkbox] – Select this if you wish to style the text on your own or with your theme; otherwise the plugin will style the text.

Display Asynchronously [checkbox] – Select this if you wish to load related posts after the page has loaded. May delay the layout display, but prevents the plugin from affecting page load time.

Where to Display

Location [select: Bottom of Post, Top of Post, Manually Setup] – Select where you prefer the related posts to show. By selecting Manually Setup, you elect to place widgets and shortcodes throughout your site instead of automatically displaying related posts (see Widgets, Shortcodes, and PHP sections below). This selection will change plugin options.

Display on post types [select: Any Post Type, Post, Page, custom post types] – Select which post types to display related posts on.

Do not display in [select] – Select any number of posts to exclude from each post type.

Query Conditions

The Related Posts Pool is a simple calculator for defining the total number of available posts that can be shown. By selecting the options below, you will dynamically change the possible number of related posts.

Related By [select: Contextual, Category, Post_tag, custom taxonomies] – Select the relational mechanism for how the plugin relates posts. Contextual will relate posts with similar titles, while the other options will retrieve posts based on that particular taxonomy.

Exclude Posts in These Post Types [select: page, post, custom post types] – Select the post types you would like to include as part of the Related Posts Pool. Posts in Post Types that are not included here will not be shown. This selection has the greatest impact on the Related Posts Pool.

Exclude [select] – Select individual posts or taxonomies that you would like to exclude from the Related Posts Pool.

Time Range [select: 1 Day, 7 Days, 30 Days, 1 Year, All Time] – Select the range of publish dates the plugin can use to draw related posts.

Add Recent Posts [checkbox] – If the number of related posts are less then the number of posts set to display, then use recent posts for the remaining ones. This is helpful in filling any gaps if there is not enough content to relate to.

Order [select: ascending, descending] – Select the order of posts. Ex. Ascending: A – Z, 1 – 10, Today – Yesterday. Descending: Z – A, 10 – 1, Yesterday – Today.

Order By [select: None, ID, Author, Title, Name, Type, Date, Last Modified Date, Parent ID, Random, Comment Count, Menu ID] – Select how you would like the related posts to be sorted. Use Menu ID to set a custom order Pages using the Order text field in the Page edit screen. The Order option above will change the sort direction.


WP Related Posts Pro can also be used as a Widget and has exactly the same options fields as the above settings except for ID.

ID – Use this ID to easily target an individual widget for custom CSS rules. Save the widget at least once to generate the correct ID.


WP Related Posts Pro has a built-in shortcode builder to place related posts within your posts and pages. Navigate to the Edit screen of any post or page and click Related Post Pro (next to Add Media) to open up the shortcode builder.

Screen Shot 2015-06-23 at 3.07.24 PM

It has the same options as a widget, but will add the shortcode directly to your post upon saving. The shortcode from the builder will look something like this:

[nnr_related_posts id="nnrobots_related_posts_1" layout="thumbnail" related_by="category"]

PHP Template Tags

There are no explicit template tags so you must use the WordPress do_shortcode() function. We advise that you use the shortcode builder to first create the shortcode, then copy and paste the shortcode into the do_shortcode() function. The id field is used to differentiate multiple instances of related posts on one page.

<?php do_shortcode('[nnr_related_posts id="nnrobots_related_posts_0"]'); ?>

Change Log

The changelog is a history of updates and changes to the plugin. It will document the features and fixes we've made to the plugin in the newest release so you can prepare when you update. Please backup your site before updating any plugin, theme, or WordPress.

= 2.1.0 = 2020-05-16
* UPDATED: Callback URL for licensing
* UPDATED: Compatibility with WordPress 5.4.1

= 2.0.6 = 2019-09-13
* FIXED: Cleaned up PHP warnings
* UPDATED: To be compatible with WordPress 5.2.3

= 2.0.5 = 2016-10-12
* FIXED: Cleaned up PHP warnings
* FIXED: When manually selecting Related Posts it wouldn\'t show more than 5

= 2.0.4 = 2015-11-30
* FIXED: Sites with large numbers of posts were sometimes unable to select posts from the dropdown within the settings page

= 2.0.3 = 2015-11-25
* FIXED: Sometimes Related Posts would display on other post types then the one chosen

= 2.0.2 = 2015-10-21
* FIXED: Resolved - error that occurred only when Related Posts were shown before settings were saved for the first time

= 2.0.1 = 2015-8-19
* FIXED: Including stylesheets and scripts on SSL webpages
* FIXED: Popover and modal styling for some admin panels

= 2.0.0 = 2015-7-1
* ADDED: Software Licensing integration. If you previously bought this plugin from Code Canyon, please email us directly at support@99robots.com with your purchase code and we will send you a new license key. You will not receive future updates of this plugin without a valid license key.

= 1.0.8 = 2015-6-18
* UPDATED: Contextual relation has more support for international characters and symbols

= 1.0.7 = 2015-6-15
* UPDATED: Contextual relation is now better at retrieving related posts

= 1.0.6 = 2015-6-5
* FIXED: Post object was not propagation through to display function when displaying related posts in widget

= 1.0.5 = 2015-6-2
* FIXED: Stacked Card layout is displayed as full width when using shortcode and async is set to false
* FIXED: Order By setting description was not showing for setting page and shortcode builder
* FIXED: Background color setting does not show when Image Tiles layout is selected
* FIXED: Six columns are not displayed with the correct width
* FIXED: Title setting was not showing in the shortcode builder
* FIXED: Widget layout Stacked Card was not display correct number of columns

= 1.0.4 = 2015-6-2
* FIXED: Shortcode title is now much easier to target via CSS
* FIXED: Number of posts parameter in shortcode was not working when multiple instances of related posts were displayed on a page
* FIXED: Caching data for each post and related post instance

= 1.0.3 = 2015-6-1
* FIXED: Related posts were not being styled properly if display synchronously
* FIXED: Showing proper settings based off of layout chosen
* FIXED: Stacked Cards responsiveness layout

= 1.0.2 = 2015-5-31
* FIXED: Displaying number of columns for the Stacked Cards layout

= 1.0.1 = 2015-5-26
* UPDATED: The way a user picks a layout on the settings page
* FIXED: Uninstall process

= 1.0.0 = 2015-5-25
* Initial release :)
Doc last modified on July 21, 2015
Product last updated on May 16, 2020