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.
- Widget and Shortcode.
- Display related posts as post thumbnails, links, excerpts or full posts.
- Small Footprint. Doesn’t slow down your site!
- Object and persistent cache to get the related posts.
- 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 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:
Attributes for the shortcode are:
Example to show 10 related posts instead of the default 5.
See the documentation for more information about these attributes.
- Unzip the
- Upload the
related-posts-by-taxonomyfolder to your
- Activate Related Posts by Taxonomy.
- That’s it, now you are ready to use the widget and shortcode
- 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
- 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.
Flexibility, easy to use. Great!
Great plugin, lightweight, fast. And when I encountered a small layout problem (one that wasn’t even a pure problem caused by the plugin), Keesie immediately answered my questions and solved it. Thanks a lot for that!
I Love this plugin so much!
Nice work! I like it. But i have small problem – how justify excerpt?
The plugin works really well! Super light and effective and comes with great documentation. I have tried different methods and nothing worked but this plugin did. If there is an off chance you need support, like in my case I wanted to customize the related posts two show on different CPT pages in a specific way, the author responded to me daily. I would give this plugin 5 stars, and if there was a way, I would give the author an additional 5 stars as well.
Been struggling with YARPP but couldn’t get rid of
- . Old settings kept coming up.
I use Ninja Pages to append tags & categories to pages. Would be great to see pages supported by this plugin as well. Hence 4 stars.
Works like a charm, made my day!
Contributors & Developers
“Related Posts by Taxonomy” is open source software. The following people have contributed to this plugin.Contributors
- New option to link thumbnail captions (post titles) to posts in the widget and shortcode
- Make the widget UI more intuitive
- Bug fixes
- Fix wrong results for cached custom post type related posts
- Add selective refresh to the widget for the customizer
- Bug fixes
- Fix deprecated notice (by removing PHP4 style constructor) when installing this plugin with PHP7. Props: @dima-stefantsov
- Refactor of the persistant cache for consistent results when using the plugin filters
- Better data sanitation for taxonomies and comma separated values
- New PHPunit tests (GitHub only)
- Add Spanish, Catalan and Polish translation files
- Bug fixes
- Fix minor regression bug with the hide empty filter.
- Fix minor bug where the wrong default post type was being used by the shortcode.
- Optimised related posts query.
- All round better validation of function arguments.
- Persistent cache out of beta. Now fully functioning.
- Cached data will be deleted after deleting the plugin from the wp-admin
- New opt-in cache log in the toolbar.
- New option for the widget to randomise the related posts.
- Refactored the query to get the related posts.
- Organized files in the new ‘includes’ directory.
- Added a new class for debugging (only loaded if needed, with a filter).
- New PHPUnit tests for the widget(GitHub only).
- Updated the widget constructor as it is deprecated with WP 4.3
- Added a new (beta) front end cache layer.
- Bug fixes
- Fixed a minor compatibility bug with the widget customizer. Settings were not saved properly when adding a new widget.
- Using WordPress semantic versioning.
- New shortcode attributes before_shortcode and after_shortcode.
- Default h3 heading for the shortcode ‘Related Posts’ title
- Shortcode is wrapped in a div container
- New filter to add classes to gallery items.
- New action after displaying related posts.
- Better logic for the ‘related’ parameter.
- Bug fixes
- Applying ‘the_title’ filters for the shortcode caption.
Updated ‘include_terms’ logic to search for related posts with different taxonomy terms if ‘related’ is set.
Updated unit tests to be more reliable.
- Added a new parameter ‘related’ to get posts with include_terms even if the current post doesn’t have the included terms (unrelated).
- Used attribute aria-describedby in wp_get_attachment_image for accessibility (similar changes as in the WordPress 4.1 gallery).
- Added new filters related_posts_by_taxonomy_post_thumbnail_link and related_posts_by_taxonomy_rss_post_thumbnail_link.
- Removed extract() from all files (WordPress core best practices).
- Added Phpunit tests (in the github repository).
- Fixed a filter recursion bug for the shortcode if it’s used in the WordPress the_content filter and the format is excerpts or posts.
- Deprecated filters related_posts_by_taxonomy_post_thumbnail and related_posts_by_taxonomy_rss_post_thumbnail.
- New filters for the related posts query.
- Fixed minor bug when using spaces in post_types string in the short code.
- Added plugin icons introduced with WordPress 4.0
- New parameters for the shortcode and widget: include_terms and caption.
- New support for html5 tags (set by themes) in the thumbnail gallery (same as in WordPress 3.9 gallery shortcode).
- Allow image columns to be set to zero (same as in WordPress gallery shortcode).
- New options for gallery captions. Use the post title (default), excerpt, attachment caption or attachment alt text for the caption.
- Reformatted code and new inline filter documentation is added to adhere to new WordPress coding standards.
- New filters for overriding images in the thumbnail gallery.
- Fixed bug where duplicate related posts where found for order=”RAND”. Props: Mock.
- Fixed php notices coming from the Related_Posts_By_Taxonomy_Defaults class.
- Removed backward compatibility for WordPress 3.4.
- The template used for display of the post thumbnails is updated. Review the changes made in the updated related-posts-thumbnails.php file if you’re using it to display the thumbnails in your own theme.
- Added image sizes and columns for the widget and shortcode.
- Cleaned up of code base and speed improvements.
- Added a Dutch translation.
- Added a filter for the caption of post thumbnails.
- Added two filters for a future settings page for this plugin. (this will be a separate plugin)
- Added new feature to display related post thumbnails.
- Removed the docs that came with the plugin.
- some minor bug fixing for the shortcode.