Description
Quickly increase your readers’ engagement by adding related posts in the sidebar or after post content with a widget or shortcode.
Posts with the most terms in common will display at the top!
This plugin is capable of finding related posts in multiple taxonomies and post types. Include or exclude terms from the search for related posts. Change the look and feel by using your own templates in your (child) theme.
Plugin features:
- Widget and Shortcode.
- Display related posts as post thumbnails, links, excerpts or full posts.
- Small Footprint. Doesn’t slow down your site!
- Automatic display of related posts after the post content.
- Search for related posts in single or multiple taxonomies and post types.
- Exclude or include terms and posts.
- Limit the search of related posts by date or number.
- Use your own HTML templates for display of the related posts.
- Use the WordPress REST API to get related posts. (opt-in feature)
- Use a persistent cache layer for the related posts. (opt-in feature)
- Use plugin functions in your theme templates to display related posts yourself.
- Use Filters to change the default behavior of the plugin.
- Extensive plugin documentation.
- Highly Adjustable!
- Follows WordPress coding standards and plugin best practices.
Follow this plugin on GitHub.
See the FAQ to have related posts automatically display after the post content without using the shortcode or widget.
Default usage for the shortcode is:
[related_posts_by_tax]
Attributes for the shortcode are:
post_id
taxonomies
post_types
posts_per_page
order
orderby
before_shortcode
after_shortcode
title
before_title
after_title
exclude_terms
include_terms
exclude_posts
format
image_size
columns
caption
link_caption
limit_posts
limit_year
limit_month
related
public_only
include_self
post_class
Example to show 10 related posts instead of the default 5.
[related_posts_by_tax posts_per_page="10"]
See the documentation for more information about these attributes.
Translations
- Dutch
- French (by Annie Stasse)
- Spanish (by Ludobooks – Cuentos personalizados)
- Catalan (by Ludobooks – Cuentos personalizados)
- Polish (by koda0601)
Screenshots
Installation
- Unzip the
related-posts-by-taxonomy.zip
folder. - Upload the
related-posts-by-taxonomy
folder to your/wp-content/plugins
directory. - Activate Related Posts by Taxonomy.
- That’s it, now you are ready to use the widget and shortcode
FAQ
For more information about the plugin see the plugin documentation.
To customize this plugin see the plugin recipes page.
- Installation Instructions
-
- Unzip the
related-posts-by-taxonomy.zip
folder. - Upload the
related-posts-by-taxonomy
folder to your/wp-content/plugins
directory. - Activate Related Posts by Taxonomy.
- That’s it, now you are ready to use the widget and shortcode
- Unzip the
- Can I change the layout for the related posts?
-
Yes. Review this section of the documentation to style the related posts yourself.
- How can I automatically add related posts after the post content?
- Can I include or exclude posts or terms with the widget or shortcode
-
Yes. For the widget see this filter and for the shortcode see the attributes exclude-terms, include_terms and exclude_posts.
- Can I set my own defaults for the shortcode?
-
Yes. Review Setting your own defaults for the shortcode
- The widget only lets you choose “all taxonomies” or a single taxonomy. Can I make it only use the taxonomies I want?
-
Yes. See this filter on how to do that.
Reviews
Excellent related post plugin! Developer friendly.
Excellent related post plugin! Spend a couple of days finding a good one, and many are either missing relevant features, no longer updated or way to bloated. Related Posts by Taxonomy simply nailed it, working fantastic out of the box, outputs perfect valid code and with its well documented selectors its a breeze to style to your likening. Took me 10 minutes and 4 lines of CSS and I had related and relevant posts in my blog post footer exactly like I wanted it.
THANKS
Exactly what I was looking for !
A fantastic plugin if you have custom post types and taxonomies and need to control in detail the implementation of related posts. Great job !
Perfect for what I needed- great documentation
Fantastic plugin… Free, powerful, easy, and well documented to a very advanced degree. Grateful for such a helpful developer.
Concise & flexible
Does exactly what you need, and the default options provide a good selection of related articles, which can easily be customised further.
Great plugin with great support by the creator
The plugin is very simple to use and has cute options, that I have not found in any such plugin. Thanks to creator.
Very good
Works very well and developer provides top-notch support! Helped me troubleshoot a style issue and went ahead in providing a CSS fix specific for my theme. 🙂
Contributors & Developers
“Related Posts by Taxonomy” is open source software. The following people have contributed to this plugin.
Contributors“Related Posts by Taxonomy” has been translated into 4 locales. Thank you to the translators for their contributions.
Translate “Related Posts by Taxonomy” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.4.1
- Enhancement
- Add post classes with filters or as a shortcode or widget argument
- Move included current post to the top of the stack by default
2.3.2
- Enhancement
- Add public_only parameter to not display private related posts from the current author.
- Add include_self parameter to include the current post in the related posts.
- Add filter pre_related_posts to override the related posts query.
- Bug fixes
- Fix duplicate gallery IDs breaking the column layout of WordPress galleries. Props: @sonamel
2.3.1
- Enhancement
- Add support to disable the shortcode or widget for this plugin
- Add support to update all plugin settings with one filter.
2.3.0
- Enhancement
- Add a WordPress REST API layer to get related posts (opt-in feature)
- Add new filter to activate the WordPress REST API layer
For older changelog versions see the changelog.txt file