Yet Another Related Posts Plugin (YARPP)

Wordpress Plugin
Download latest - 5.30.1

Download Stats

Today 269
Yesterday 370
Last Week 2,468
All Time 4,229,963
Banner 772x250

Related Posts Plugin for WordPress

Yet Another Related Posts Plugin (YARPP) is a professionally maintained, highly customizable, performant and feature rich plugin that displays pages, posts, and custom post types related to the current entry. YARPP introduces your visitors to other relevant content on your site -- boosting visitor engagement, time on site and SEO. Related Posts can increase your pageviews up to 10%. Simply install, activate and watch your sessions and pageviews increase.

Key Features

  • An advanced and versatile algorithm: Using a customizable algorithm considering post titles, content, tags, categories, and custom taxonomies, YARPP finds related content from across your site
  • Caching: Inbuilt cache makes subsequent queries super efficient and fast
  • Custom Templates and Styles: Use a pre-built list or thumbnail template, or use the YARPP custom templating system for 100% control of how results are styles and displayed
  • Flexible with a full range of placement options, including:
    • Automatic Display Options (pick where to show YARPP from the YARPP settings page)
    • RSS/Feed Options
    • Block Editor (Gutenberg)
    • [yarpp] Shortcode
    • Widget
    • YARPP functions()
    • REST API
  • Works with all languages, including those with full-width (double-byte) characters and those that don't use spaces between words
  • Custom post type and taxonomy support
  • WordPress Multisite support
  • bbPress forums support
  • WooCommerce support
  • Professionally maintained and supported with regular updates

YARPP Algorithm Explained

Contribute: Translate YARPP

YARPP is available for translation directly on Please check out the official Translator Handbook.

Wide Support

YARPP is the most popular and the highest rated Related Posts Plugin for WordPress. With your support, this plugin always strives to be the best WordPress plugin for Content Discovery and Related Posts.

Over 10 years of development Over 6 million downloads Translated into more than a dozen languages Professionally maintained and actively supported with regular updates Works with all languages

YARPP works best with PHP 5.3 or greater, MySQL 5.6 or greater OR MariaDB 10.1 or greater, and WordPress 3.7 or greater. See the FAQ for answers to common questions.

Releases (242 )

Version Release Date Change Log
5.30.1 2022-11-08

(08-November-2022) = * Bugfix: Fixes issue caused by stricter type checks for arithmetic operators in PHP8

5.27.8 2022-01-25

(01-December-2021) = * New: [yarpp] shortcode supports all the same parameters as yarpp_related(). See the updated documentation. * Bugfix: Apply the additional CSS class(es) defined in YARPP Advanced Block settings

5.27.7 2021-10-29

(29-October-2021) = * Enhancement: CSS improvements for better cross-theme compatibility * Documentation: Available YARPP filters

5.27.6 2021-10-12

(12-October-2021) = * Bugfix: Support for drop-in caches. Resolves Undefined variable: found warnings. * Bugfix: Add missing string for translations * Bugfix: Workaround for WordPress ca-bundle.crt issue * Bugfix: Properly update the template preview in YARPP's admin console when Thumbnail size selection is updated * Bugfix: Use dummy example thumbnail in previews * Enhancement: For RSS Feed Display Options use dropdown select for thumbnail sizes instead of radio buttons

5.27.5 2021-09-15

(15-September-2021) = * New: Add support for "show_sticky_posts" and "generate_missing_thumbnails" to the yarpp_related() function * New: Add support for "recent" in YARPP shortcode + For example, to limit results to those published in the past 12 months: [yarpp recent="12 month"] * Enhancement: Use dropdown select for thumbnail sizes instead of radio buttons

5.27.4 2021-08-25


5.27.3 2021-08-16

(16-August-2021) = * Bugfix: Make $related_query available to custom templates

5.27.2 2021-08-12

(12-August-2021) = * New: Conversion of legacy widget YARPP block into YARPP Block * Bugfix: New Blocks on widget's sections were showing on homepage * Bugfix: Remove the legacy widget YARPP block on the widgets interface * New: Option to add a custom reference ID on a YARPP Block * Enhancement: Consistency on "Heading" input fields on widgets and blocks * Enhancement: Show demo related post on the Widgets YARPP Blocks

5.27.1 2021-08-03

(03-August-2021) = * Bugfix: i18n / localization for new text strings was not working. + P.s. YARPP is available for translation directly on Please check out the official Translator Handbook. * Bugfix: Remove YARPP's WP_Query filters after the query is done rather than waiting until rendering is done because any queries done in that time will be affected.

5.27.0 2021-07-20

(20-July-2021) = * WordPress v5.8 compatibility * Bugfix: Fixes PHP debug notice "Trying to get property 'ID' of non-object"

5.26.0 2021-07-15

(14-July-2021) = * New: Adds a yarpp_add_image_size filter to avoid creating YARPP thumbnail sizes + add_filter( 'yarpp_add_image_size', '__return_false' ); * New: Preview YARPP Templates on the YARPP settings page under Automatic Display Options * Docs: Added FAQ on how to remove sold out WooCommerce products from recommendations (and otherwise filter by postmeta)

5.25.0 2021-06-23

(23-June-2021) = * Enhancement: Cleaned up old unused code (adkengage)

5.24.0 2021-06-21

(17-June-2021) = * Enhancement: Option to automatically generate missing thumbnail sizes on the fly when using Custom YARPP Templates * New: Control YARPP Automatic Display programatically with filter support for noyarpp. For example: add_filter( 'noyarpp', 'custom_function' ); * Enhancement: Use the faster and less memory intensive function strpos() instead of stristr()

5.23.0 2021-06-02

(02-June-2021) = * New: Ability to specify maximum number of posts to show in the YARPP shortcode. For example: + [yarpp template="list" limit=3] // maximum post limit set to 3 * Bugfix: Check wp_parse_list exists for backwards compatibility to older versions of WordPress * Bugfix: Use query parameters when priming cache using yarpp_related. Resolves bug with yarpp_function not fully accounting for all parameters passed to it.

5.22.0 2021-05-24

(24-May-2021) = * New: Choose the exact post types to include in "The Pool" * New: Ability to specify built-in YARPP templates in the YARPP shortcode. You may use more than one YARPP shortcode in a given post or template and each can have a different templates specified. For example: + [yarpp template="yarpp-template-simple"] // where yarpp-template-simple.php is the file name of the custom YARPP template in your active theme folder + [yarpp template="list"] // built-in "List" template + [yarpp template="thumbnails"] // built-in "Thumbnails" template * Enhancement: YARPP Automatic Placement, YARPP Shortcode, YARPP Block, YARPP Widget and RSS output are all now wrapped in a div with classes yarpp, yarpp-related and yarpp-template-TEMPLATE-NAME to facilitate easier CSS customizations * Enhancement: All admin CSS is now minified

5.21.0 2021-05-14

(14-May-2021) = * Bugfix: Disable "Edit as HTML" for YARPP Block * Bugfix (1|2): Fixes issue with the correct template not being applied

5.20.0 2021-05-06

(06-May-2021) = * New: Option to automatically generate missing thumbnail sizes on the fly * New: Option to include or exclude Sticky Posts * Enhancement: Dynamic CSS for the built-in "Thumbnails" theme is now in-lined for much improved cross compatibility with optimization and caching plugins * Bugfix: Fixes conflict with the Page Optimize plugin

5.19.0 2021-04-29

(28-April-2021) = * New: YARPP Block now available for the WordPress Block Editor (Gutenberg) for drag and drop placement customization * New: Choose image size for YARPP custom theme templates * Bugfix: Indicate yarpp_meta postmeta is protected to prevent themes from displaying it * Bugfix: Check wp_get_additional_image_sizes exists for backwards compatibility to older versions of WordPress

5.18.2 2021-04-19

(19-April-2021) = * Bugfix: Allow default WP image sizes to be picked for the YARPP Thumbnail theme

5.18.1 2021-04-19

(19-April-2021) = * New: Choose image size for YARPP Thumbnail theme * Bugfix: Resolves join warning (Part 2/2)

5.17.0 2021-04-06

(06-April-2021) = * New: Added filter to be able to dequeue related.css add_filter( 'yarpp_enqueue_related_style', '_\_return_false' ); * New: Added friendly per-post meta box options to disable YARPP automatic display on a specific post

5.16.0 2021-03-29

(29-March-2021) = * Enhancement: Switched to minified JavaScript in YARPP Admin for a speed boost * Bugfix: Resolved conflict with Easy Forms for MailChimp which was preventing YARPP settings from being saved * Bugfix: Resolved join warning

5.16.1 2021-03-29

(29-March-2021) = * Bugfix: include new minified JS files

5.15.3 2021-03-15

(15-March-2021) = * Enhancement: Improved readability of the database indexes prompt

5.15.2 2021-03-12

(12-March-2021) = * Tested up to WordPress 5.7

5.15.1 2021-03-11

(11-March-2021) = * Bugfix: fix issue pushing 5.15.0

5.14.0 2021-03-09

(9-March-2021) = * Enhancement: Improve pageload speed by avoiding checking YARPP database requirements on frontend requests

5.13.0 2021-03-01

(1-March-2021) = * New: Clear YARPP cache button on settings page * [Bugfix])( Undefined variable `$post_types

5.12.0 2021-02-22

(22-February-2021) = * New shortcode template attribute. Eg [yarpp template="yarpp-template-photoblog"] * Deprecated: functions related_posts, related_pages, related_entries (use yarpp_related instead), and related_posts_exist, related_pages_exist and related_entries_exist (use yarpp_related_exist instead) * Bugfix: consistently use "post_type" parameter and "cross-relate" from all YARPP functions * Bugfix: Add textdomain to allow translating the readme file

5.11.0 2021-02-08

(08-February-2021) = * New: Adds native support for bbPress! Have you ever wanted a nifty Related Posts section on your bbPress topic pages, like the ones you've seen on forums like StackOverflow? It's now possible with YARPP Related Posts! * Enhancement: Updates to provided custom template examples * Enhancement: YARPP post metabox enhancements - adds "edit" and "view" hover options to each link, mimicking the main posts table * Enhancement: Add missing debug info * Bugfix: Avoid REST API warning by providing the page parameter which WP core expects * Deprecated: functions YARPP::maybe_enqueue_thumbnails() and YARPP::enqueue_thumbnails()

5.10.2 2020-11-23

(23-November-2020) = * Enhancement: Faster queries and a speed boost (Re-introduces database query improvements while avoiding the fatal error identified by some in v5.10.0) * Enhancement: Speed up by not loading widget.css when not necessary * Bugfix: Part 2 of 2 - Resolves jQuery Migrate Helper warnings * Bugfix: Fixes PHP warning on options page * Bugfix: Fixes integration with Algolia search * Bugfix: Respect "Require at least 1 {Taxonomy} in common" when you press "refresh" in the meta box while editing a post

5.10.1 2020-10-23

(23-October-2020) = * Critical Bugfix: Reverts query changes from the v5.10.0 update as it caused 500 fatal errors on some WordPress installations. We sincerely apologies for any issues it may have caused. We did test the release for weeks, but each environment is just a bit different. We are actively testing a bug fix with those affected that volunteered before we release it again.

5.10.0 2020-10-22

(22-October-2020) = * Enhancement: Faster queries and a speed boost * Enhancement: On posts with page breaks, show YARPP only on the last page * Enhancement: Documentation on how to use [yarpp] shortcode from a theme file (like single.php) or post content * Bugfix: If YARPP has already added its content to a post and somehow apply_filters('the_content'...) gets called again, don't try to re-add YARPP's content to the post again. * Bugfix: Fixes showing/hiding excerpt options when checking excerpt checkboxes * Bugfix: Fixes "role" in deactivation survey * Bugfix: Fixes PHP warning on options page * Bugfix: Resolves jQuery Migrate Helper warnings

5.9.0 2020-09-22

(21-September-2020) = * Enhancement: Clarify that "Also display in archives" includes front page and category pages * Enhancement: reference_id parameter support for the YARPP shortcode. For example: [yarpp reference_id=123] to show content related to Post ID 123 (can be used either inside or outside the loop from theme code) * Enhancement: Place warning about comparing using titles and bodies next to the affected inputs, rather than at the top of the page where it could be lost with notices from other plugins * Bugfix: Don't require a category or term, even if set by the admin, on post types that don't use categories or terms (also applies to custom taxonomies)

5.8.0 2020-09-08

(08-September-2020) = * Enhancement: Code hygiene upgrade with usage of WPDB->prepare everywhere possible and related improvements * Bugfix: Since there is no YARPP Pro currently, removed mention of it from the widget form * Bugfix: Fixes "role" in deactivation survey

5.7.0 2020-08-18

(18-August-2020) = * Enhancement: Ensure that when a post is finally published, YARPP cache for peer posts is cleared to ensure the most related posts are always recommended across every post * Bugfix: Fixed warning in Admin UI caused by an unnecessary HTML comment * Bugfix: When priming YARPP's cache, if "Display posts from other post types" is false, we now only include posts of the current post type

5.6.0 2020-08-13

(13-August-2020) = * New: Configurable in-browser caching option for YARPP REST API * Bugfix: Always include unused categories and terms in YARPP Admin options * Bugfix: Fixed issue with loading CSS files from wrong domain on multilingual sites * Various Admin UI fixes

5.5.0 2020-08-06

(06-August-2020) = * New: Support for custom page types and taxonomies, including those added by WooCommerce * Enhancement: Show spinner while full-text indexes are being created * Enhancement: Various YARPP Admin UX/UI improvements * Bugfix: Fixes bug where Review Notice was not getting dismissed for non-admins * Bugfix: Exclude Gutenberg blocks so that they don't appear as related

5.4.0 2020-08-03

(03-August-2020) = * New: Shortcode support! [yarpp] (documentation) * Enhancement: Adds YARPP score to REST API responses (documentation) * Enhancement: Prepare for default jQuery version update in upcoming WordPress Core * Bugfix: Fixed admin panel tooltips * Bugfix: Fixed admin panel "copy template" button

5.3.0 2020-07-29

(2020-07-29) = * New: REST API support (documentation) * Enhancement: WP Rest Cache Plugin support * Enhancement: Filters to change the priority for YARPP's filters on the_content, the_content_feed and the_excerpt_rss, example: add_filter('yarpp_content_priority', 1); * Bugfix: Fixes deactivation survey when Google Translate in Chrome auto translates the admin page

5.2.2 2020-07-21

(2020-07-21) = * Critical Bugfix: Fixes plugin upgrade process. This in turn fixes a page slow down issue introduced for some sites with v5.2.1.

5.2.1 2020-07-20

(2020-07-20) = * Enhancement: Don't recommend switching database engine unless necessary for fulltext indexes.

5.2.0 2020-07-20

(2020-07-20) = * Enhancement: Adds support for InnoDb fulltext search! One of our most requested features. Fulltext indexing is supported in MyISAM or InnoDB with MySQL 5.6.4 and higher. * Enhancement: Optimized database queries, resulting in ~2x speed improvement in some queries.

5.1.8 2020-06-25

(2020-06-17) = * Bugfix Add missing file to previous release!

5.1.9 2020-06-25

(2020-06-25) = * Bugfix Fixes deactivation survey plugin conflict

5.1.7 2020-06-17

(2020-06-17) = * Bugfix Double-check database indexes exist before creating them * Bugfix: Titles were only being considered if body text was also considered for the relatedness algorithm. This update fixes the logic to work where only titles are set to be considered. * Bugfix: Do not dismiss deactivation modal when clicking outside it

5.1.6 2020-05-15

(2020-05-15) = * Bugfix: 403 error when saving changes resolved * Enhancement: Feedback form enhancements

5.1.5 2020-05-11

(2020-05-11) = * Bugfix: Use correct deactivation reason code

5.1.4 2020-05-11

(2020-05-11) = * Require PHP 5.3 as a bare minimum for compatibility features * New: Display optional feedback form on plugin deactivation

5.1.3 2020-04-07

(2020-04-07) = * Support for WordPress 5.4+ * Enhancement: Switch over to secure (https) endpoints

5.1.2 2019-11-06

(2019-11-06) = * Support for WordPress 5.3+

5.1.1 2019-09-23

(2019-09-23) = * Enhancement: Review Notice updates + instructions on how to disable it programmatically

5.1.0 2019-07-09

(2019-07-10) = * Bugfix: Related Posts metabox did not load within Gutenberg Editor * Bugfix: Fixed 'Deactivate YARPP Pro' button, including moving functionality to proper WP AJAX functions * Enhancement: Related Post thumbnails should not be 'pinnable' to Pinterest * Enhancement: Review Notice * Enhancement: Modernized Editor Metabox design * Enhancement: Added 'Refresh' button to Editor Metabox

5.0.1 2019-07-08

(2019-07-08) = * Bugfix: Fixed invalid CSS rule * Enhancement: Set Cache headers for CSS file

5.0.0 2019-07-01

(2019-07-01) = * Bugfix: Fix warning from using get_currentuserinfo()

4.6 2019-07-01
  • Bugfix: Removed links from Plugin Readme to resolve WordFence false positive.
4.5 2019-05-18

After a bit of a hiatus, we're back! The plugin had been delisted due to a minor email address issue. This has been resolved with this release and the plugin has been reinstated. We consider this to be a big step, and yes, after a 6-month hiatus of not being in the plugin directory.

The plugin is also no longer maintained by Adknowledge. A group of us with deep expertise in Content Recommendations and 10+ years experience with maintaining very popular plugins have very recently taken Yarpp over from Adknowlege. More on this will be shared very soon.

After a break of many years, the plugin is 100% supported now that the baton has been passed on. A larger update (hand-in-hand with proper communication) is being carefully worked on with a focus on a host of bug fixes and compatibility updates which will be available once it is properly tested, ready and updates properly communicated. Stay tuned.

4.2.6 2019-04-26
  • After a bit of a hiatus, we're back!
4.4 2017-01-31
  • Discontinuing the YARPP Pro service
4.3.6 2017-01-03
  • Removed new file
4.3.5 2017-01-03
  • Fix 'unable to update'
4.3.4 2017-01-03
  • Don't allow new YARPP Pro signups
  • Discontinuing the YARPP Pro service as of 01/31/2017
4.3.3 2016-12-27
  • Fix 'Undefined index' in YARPP_Cache.php (credit to Derrick Hammer/@pcfreak30)
4.3.2 2016-12-20
  • Fix ksort error in YARPP_Cache.php (credit to Derrick Hammer/@pcfreak30)
  • Discontinuing the YARPP Pro service as of 12/31/2016
4.3.1 2016-01-15
  • Tested on WordPress 4.4.
  • Fix $lang missing error in YARPP_Cache.php
  • Fix WP_Widget deprecation PHP error
4.2.5 2015-05-14
  • Tested on WordPress 4.2.2.
  • Styling fix: User can now override all YARPP CSS styling
4.2.4 2014-09-23
  • Bugfix: Missing internal version number update
4.2.3 2014-09-23
  • Tested on WordPress 4.0.
  • Bugfix: Made logo image url in css scheme-less (fix http/https)
4.2.2 2014-05-09
  • Tested on WordPress 3.9.1.
  • Bugfix: Duplicate related post links removed.
  • Bugfix: Removed extra <br> at the end of post content.
4.2.1 2014-05-08
  • FIXBUG: YARPP Pro options not been updated on plugin upgrade.
4.2 2014-05-08
  • Tested on WordPress 3.9.
  • YARPP Basic and YARPP Pro can now be used simultaneously, rather than being mutually exclusive.
  • Added a YARPP Pro option to the YARPP sidebar widget.
  • Enlarged "Display Options" panel textbox for increased usability.
  • Updated YARPP Pro script to allow for future enhancements.
  • Updated MyISAM check notice message to explain its impact on "Pages."
  • Added descriptive text to explain new enhancements.
4.1.2 2014-03-17
  • Tested on Wordpress 3.8.
  • Added field boxes with API Key information to Domain page.
  • MyISAM check notice message was updated to better express what it does and a feedback message was added in case the fulltext index creation fails.
  • Bugfix: MyISAM check overwrite was broken since 4.1.x release.
  • Bugfix: PHP title not defined warning when creating new cache entry.
  • Bugfix: Uninstall script now deletes options with empty, false or 0 values.
  • Bugfix: Scrollbar functionality on YARPP Pro Domain Settings page.
4.1.1 2013-12-12
  • Bugfix: Incompatibility with PHP < 5.3.x
4.1 2013-12-11
  • Added optional YARPP Pro enhancements:
    • Revenue-generating ad content interspersed with related posts display
    • Detailed reports for Clicks, Click-Through Rate, and Revenue
    • Ability to display related content from multiple domains
    • UI settings for related content display, including thumbnail size and layout
    • Refined "relatedness" algorithm is now independent of MyISAM or InnoDB engines
    • "Relatedness" is calculated and stored externally, minimizing server load
  • Based on user feedback, the "Screen Options" section displays all YARPP options panels by default.
4.0.8 2013-10-18
  • The recent 4.0.7 YARPP update included a settings modification to opt in users to our tracking pixel by default. By doing so, our intent was to use this expanded information to better understand the geographic reach of the popular plugin. We have been made aware that this change infringed upon the WordPress guidelines. We apologize for the issue and have remedied the situation in update 4.0.8. Going forward, we would really appreciate your input to help us continue to improve the product. We are primarily looking for country, domain, and date installed information. Please help us make YARPP better by opting in to this information and by filling out our quick, 5 question survey. Thank you.
4.0.7 2013-10-14
  • Bugfix: Now more robust against certain custom options.
  • Updated plugin de-activate/delete functionality to drop all tables. Prior to fix some legacy tables remained which required manual deletion in wp_options from phpmyadmin.
  • Updated FAQs section.
  • Update to YARPP's data collection terms and conditions.
  • Added Macedonian (mk_MK) localization by WPdiscounts.
4.0.6 2013-09-17
  • YARPP's automatic display will not run on posts which include the HTML comment <!--noyarpp--> by request.
  • More robust activation handling, particularly when network-activated.
  • Improved handling of exceptions, for example when fulltext indexes cannot be created or non-MyISAM tables are used.
  • YARPP no longer triggers the generation of YARPP-thumbnail-sized images (120x120) when YARPP thumbnails are not used.
    • If you are using YARPP programmatically and using the thumbnails view and having troubles with YARPP's thumbnail size being registered, a manual control to force image size registration has been added to the YARPP Experiments plugin.
  • Bugfix: calls to yarpp_related_exist() type functions were causing errors.
  • Bundled yarpp-template-wpml.php is now called yarpp-template-multilingual.php, following discussion with the author of the Polylang plugin.
  • Localizations
    • Added Estonian (est_EST) by JOURNAL
    • Added Gujrati (gu_IN) by Vikas Arora
4.0.7b1 2013-05-11
4.0.6b4 2013-03-31
4.0.6b3 2013-03-29
4.0.6b2 2013-03-29
4.0.6b1 2013-03-11
4.0.5 2013-02-25
  • Bugfix: Some upgrade code would try to access the global $yarpp before it was properly initialized
  • Added experimental graph data method to the YARPP table cache class
4.0.5b1 2013-02-19
4.0.4 2013-02-13
  • Bugfix: 4.0.3 broke some paginated post displays
  • Bugfix: custom post type support was not working properly in widget displays
  • Bugfix: widget control JS was not working right when first adding a widget
  • Added ability to set widget-specific heading for the thumbnails view, by request
  • Added the filter yarpp_results
  • Localizations:
    • Updated French localization and stopword list
    • Added Slovenian (sl_SI) localization by Silvo Kataleni
  • Bugfix: forces the DB Cache Reloaded (Fix) plugins to flush when necessary
4.0.4b5 2013-02-12
4.0.4b4 2013-02-12
4.0.4b3 2013-01-28
4.0.4b2 2013-01-14
4.0.4b1 2013-01-14
4.0.3 2012-12-24
  • Bugfix: on sites where custom templates are not available, the "thumbnails" display option would get reset when visiting the YARPP settings page
  • Bugfix: the CSS for YARPP's thumbnails display would load at the foot of the page, and therefore would cause some style-flashing. This is fixed for automatic includes, but not for widgets or manual calls.
  • Restoration of the $post global after YARPP is now more robust. Fixes the display of incorrect metadata on some complex themes.
  • YARPP template files no longer recognize Template Name fields in their headers, instead using YARPP Template. This is to avoid confusion with regular page templates.
  • Added "Related Posts" meta box to other "auto display" post types
  • Updated Polish localization
4.0.3b4 2012-12-19
4.0.3b2 2012-12-17
4.0.3b1 2012-12-17
4.0.2 2012-12-11
  • Bugfix: cache should be cleared when the "show only previous posts?" option is changed
  • Bugfix: In the thumbnail display, sometimes the default image was not displayed, even though no post thumbnail was available.
  • Localization updates
    • Updated Polish, Japanese, Hebrew localizations
    • Better right-to-left layout support
4.0.2b2 2012-12-10
3.0.2b1 2012-12-10
4.0.1 2012-12-05
  • Improvements to thumbnail handling
    • See new FAQ entry for practical details
    • Thumbnail size can be specified programmatically (see FAQ)
    • YARPP now registers its thumbnail size properly as yarpp-thumbnail
    • Fixed a typo and simplified an item in the dynamic styles-thumbnails.php styles
    • Code to generate thumbnails of appropriate size on the fly has been added, but is turned off by default for performance reasons (see FAQ)
  • Bugfix: a class of yarpp-related- with a stray hyphen was sometimes being produced. Now fixed so it produces yarpp-related.
  • Bugfix: term_relationships table was being joined when unnecessary
  • Bugfix: widget options would not display if custom templates were not available
  • Bugfix: some transients expired too soon if object caching was used
  • The yarpp_map_post_types filter now also applies to feeds and takes an extra argument to know whether the context is website or rss.
4.0.1b3 2012-12-05
4.0.1b2 2012-12-04
4.0.1b1 2012-12-04
4.0 2012-12-03
  • New thumbnail template option!
    • No PHP requiredjust visit the settings page
    • Edit your theme's CSS file to modify the styling
  • Auto display settings changes:
    • Easily choose which post types you want related posts to display on
    • Added an "also display in archives" option
  • Bugfix: uses of related_posts_exist() and get_related() without explicit reference ID parameter would incorrectly return no related posts.
  • Changes to the output HTML:
    • All YARPP output is now wrapped in a div with class yarpp-related, yarpp-related-widget, or yarpp-related-rss as appropriate (by request). If there are no results, a yarpp-related-none class is added.
    • The "related posts brought to you by YARPP" text is only added if there were results.
  • Refinements to settings UI:
    • A new design for the template chooser
    • Example code display is now hidden by default; turn them back on from the "screen options" tab.
    • A new "copy templates" button allows one-button installation of bundled templates into the current theme, if filesystem permissions make it possible.
    • Header information in YARPP custom templates are now displayed to users in the settings UI. Available fields are Template Name, Description, Author, Author URI, in the same format as plugin and theme file headers. See bundled templates for examples.
  • Code cleanup:
    • Settings screen UI have been rewritten to use divs rather than tables!
    • Inline help in settings screen now use WordPress pointers
    • Removed keyword cache table, as it does not ctually improve performance much and the overhead of an additional table is not worth it.
  • Default option changes:
    • Default result count is now 4
    • Default match threshold is now 4
    • Default for "before related entries" heading uses h3 instead of p
  • Added yarpp_map_post_types filter to programmatically specify what post types should be looked at for automatic displays
  • Added option to send YARPP setting and usage information back to YARPP (off by default). This information will be used to make more informed decisions about future YARPP development. More info available in the settings.
4.0b9 2012-12-02
4.0b8 2012-12-02
3.6b6 2012-11-28
3.6b5 2012-11-27
3.6b4 2012-11-26
3.6b3 2012-11-25
3.6b2 2012-11-25
3.6b1 2012-11-24
3.5.6 2012-11-13
  • Typo fix for postmeta cache
  • Added Traditional Chinese (Taiwan, zh_TW) localization by Pseric
3.5.6b1 2012-10-23
3.5.5 2012-10-23
  • Quick bugfix for how admin screen code was loaded in in WordPress < 3.3.
3.5.4 2012-10-01
  • New Help tab, which displays help text from the readme.
  • Retina icons! Now served faster, in sprite form.
  • Added Croatian (hr) localization by
  • Cleanup:
    • Bugfix: stopwords would not be loaded if WPLANG is defined but blank.
    • Added new stats method to YARPP_Cache_* objects.
    • Load meta boxes on screen_option hook. Improves performance on admin pages.
    • Changed default option of "show only previous posts" to false and removed FAQ text, as it no longer improves performance much.
3.5.4b4 2012-09-28
3.5.4b3 2012-09-27
3.5.4b2 2012-09-27
3.5.3 2012-09-17
  • Bugfix: Fixed a common cause of "no related posts"!
  • Better post revision handling
  • Bugfix: setup wasn't automatic for network activations.
  • Code cleanup:
    • Bugfix: tables should be created using WordPress charset settings
    • YARPP_Cache_*::update methods are now protected
    • Simplified some post status transition handling
    • Ensure that delete_post hook receives relevant post ID information
    • Various functions now refer to the enforce method which will activate if it's a new install, or else upgrade if necessary. (Part of the fix for the network activation above.)
3.5.3b4 2012-09-15
3.5.2b3 2012-09-15
3.5.3b2 2012-09-09
3.5.3b1 2012-09-06
3.5.2 2012-08-24
  • Bugfix: fix an unfortunate typo which caused "no related posts" on many environments with non-MyISAM tables
  • Fixed a bug where related posts would not be recomputed on post update, on environments using the table YARPP cache method and a persistent object caching system, like W3 Total Cache or memcached
  • Bugfix: reference to get_post_types() failed in ajax display
  • Fixed a bug where some RSS display options were not being obeyed
  • Fixed a bug where the "automatic display" was being displayed on some custom post types without any control.
  • Localizations:
    • Added Czech (cs_CZ) localization by Zdenek Hejl
    • Added Serbian (sr_RS) by Zarko Zivkovic
    • Fixed bug in Dutch localization
  • Clarified readme to require WordPress 3.1
  • Code cleanup:
    • PHP 5.3+: replaced an instance of ereg_replace
    • Removed warning on settings save
    • Sometimes a warning was printed on upgrade from YARPP < 3.4.4
    • Fixed PHP warning when no taxonomies are considered
    • No longer using clear_pre function which has been deprecated since WordPress 3.4.
3.5.2b2 2012-08-21
3.5.1 2012-08-06
  • Bugfix: change $yarpp->get_post_types() to return array of names by default
  • Ensure that all supported post types are used when "display results from all post types" is set
3.5.2b1 2012-03-05
3.5.1b1 2012-03-03
3.5 2012-03-03
  • New public YARPP query API, which supports custom post types
    • Documentation in the "other notes" section of the readme
    • Changed format of weight, template, recent parameters in options and in optional args
  • Further main query optimization:
    • What's cooler than joining four tables? Joining two.
    • Exclude now simply uses term_taxonomy_ids instead of term_ids
  • Bugfix: "related posts" preview metabox was not always working properly
  • Changes to the related_*() and yarpp_related() function signatures.
  • Added "consider with extra weight" to taxonomy criteria as well
  • Code cleanup:
    • Don't clear the cache when it's already empty
    • protect the sql method as it shouldn't be public
    • Further use of utility functions from 3.1 like wp_list_pluck()
    • New constant, YARPP_EXTRA_WEIGHT to define the "extra weight." By default, it's 3.
  • Localizations:
    • Added Slovak (sk_SK) localization by Forex
    • Added Romanian (ro_RO) localization by Uhren Shop
    • Updated it_IT, ko_KR, fr_FR, sv_SE, ja localizations
3.5b5 2012-02-25
3.5b4 2012-01-15
3.4.4b4 2012-01-14
3.4.2 2012-01-14
  • Bugfix: 3.4 and 3.4.1 assumed existence of wp_posts table.
  • Fix typo in yarpp-template-random.php example template file
  • Improve compatibility with DB Cache Reloaded plugin which doesn't properly implement set_charset method.
3.4.4b3 2012-01-12
3.4.4b2 2012-01-05
3.4.4b1 2011-12-29
3.4.3 2011-12-19
  • Bugfix: keywords were not getting cleared on post update, meaning new posts (which start blank) were not getting useful title + body keyword matches. This often resulted in "no related posts" for new posts.
  • Postmeta cache: make sure to clear keyword cache on flush too
  • Make welcome pointer more robust
  • More custom post type support infrastructure
  • Updated Turkish localization by Bar nver.
3.4.3b3 2011-12-17
3.4.3b2 2011-12-17
3.4.3b1 2011-12-15
3.4.2b1 2011-12-14
3.4.1 2011-12-14
  • Bugfix: restore global $post access to custom templates
  • Bugfix for missing join_filter on bypass cache
  • Bugfixes to query changes:
    • Bugfix: Shared taxonomy terms were not counted correctly
    • Bugfix: exclusion was not working
  • Bugfix: "disallow" terms were not being displayed for custom taxonomies.
  • Add defaults for the post_type arg
  • Strengthen default post ID values for related_* functions
  • Added nonce to cache flushing. If you would like to manually flush the cache now, you must use the YARPP Experiments plugin.
  • Updated sv_SE, ko_KR, fr_FR localizations
3.4.1b5 2011-12-14
3.4.1b4 2011-12-13
3.4.1b3 2011-12-13
3.4.1b2 2011-12-13
3.4.1b1 2011-12-13
3.4 2011-12-13
  • Major optimizations to the main related posts query, in particular with regard to taxonomy lookups
    • Performance improvements on pages with "no related posts"
  • Now can consider custom taxonomies (of posts and pages), in addition to tags and cateogories! Custom taxonomies can also be used to exclude certain content from The Pool.
  • Add welcome message, inviting users to check out the settings page
  • Bug fix: Custom templates could not be used in widget display
  • Significant code cleanup
    • Move many internal functions into a global object $yarpp of class YARPP; references to the global $yarpp_cache should now be to global $yarpp->cache
    • Created the "bypass" cache engine which is used when custom arguments are specified.
      • Switch to bypass cache for demos
    • Now only clears cache on post update, and only computes results for actual posts, not revisions (thanks to Andrei Mikhaylov)
    • Removed the many different options entries, replacing them with a single yarpp option (except yarpp_version)
    • Fixed issues with display options field data escaping and slashing once and for all
    • Streamlined keyword storage in YARPP_Cache_Postmeta
    • Create YARPP_Cache abstract class
    • Updated minor bug for computing how many results should be cached
    • Adding some filters: yarpp_settings_save, yarpp_blacklist, yarpp_blackmethods, yarpp_keywords_overused_words, yarpp_title_keywords, yarpp_body_keywords, yarpp_extract_keywords
    • New systematic use of YARPP_ constants to communicate cache status
    • Use get_terms to load terms
  • Get lazy and embrace asynchronicity:
    • Implement lazy/infinite scrolling for the "disallow tags" and "disallow categories," so the YARPP settings screen doesn't lock up the browser for sites which have a crazy number or tags or categories
    • Don't compute related posts for the metabox on the edit screen; display them via ajax instead
    • Only clear cache on post save, not recompute
  • Added yarpp_get_related() function can be used similar to get_posts()
  • Support for YARPP Experiments.
  • Fix formatting of the Related Posts meta box
  • Localizations
    • Updated it_IT localization
    • Added Portuguese stopwords by Leandro Coelho (Logstica Descomplicada)
3.4RC1 2011-12-12
3.4b10 2011-12-02
3.4b9 2011-11-25
3.4b8 2011-11-21
3.4b7 2011-11-17
3.4b6 2011-11-14
3.4b5 2011-11-13
3.4b4 2011-11-12
3.4b3 2011-11-12
3.4b2 2011-10-23
3.3.3 2011-10-18
  • Bug fix: a fix for keyword computation for pages; should improve results on pages. May require flushing of cache: see FAQ for instructions.
  • Init YARPP on the init action, for compatibility with WPML
  • Updated Polish, Italian, and Japanese localizations; added Dutch stopwords by Paul Kessels
  • Code cleanup:
    • Minor speedup to unnecessarily slow i18n code
    • Fixed fatal error in postmeta keyword caching code
    • Fewer globs
    • Bug fix: ignore empty blog_charsets
3.3.3b2 2011-10-17
3.3.3b1 2011-10-16
3.3.2 2011-08-08
  • Bugfix: removed an unlocalized string
  • Bugfix for users of WordPress 3.0.x.
3.3.1 2011-06-07
  • Quick bugfix to relatedness options panel bug
3.3 2011-06-07
  • Pretty major rewrite to the options page for extensibility and screen options support
    • By default, the options screen now only show the display options. "The Pool" and "Relatedness" options can be shown in the screen options tab in the top right corner of the screen.
    • Removed the "reset options" button, because it wasn't actually doing anything.
  • Rebuilt the new version notice to actually have a link which triggers the WordPress plugin updater, at least for new full versions
  • Changed default "relatedness" settings to not consider categories, to improve performance
  • Added BlogGlue partnership module
  • Localizations
    • Quick fix to Czech word list file name
    • Updated Italian localization (it_IT)
    • Added Hungarian (hu_HU) by daSSad (yarpp-hu at mitcho dot com)
    • Added Kazakh (kk_KZ) by DachaDecor (yarpp-kk at mitcho dot com)
    • Added Irish (gb_IR) by Ray Gren (yarpp-gb at mitcho dot com)
3.2.3b3 2011-05-22
3.2.3b2 2011-05-22
3.2.3b1 2011-05-01
3.2.2 2011-03-28
  • Now ignores soft hyphens in keyword construction
  • Minor fix for "cross-relate posts and pages" option and more accurate related_*() results across post types
  • Localization updates:
    • Updated de_DE German localization files
    • Fixed an encoding issue in the pt_PT Portuguese localization files
    • Added es_ES Spanish localization by Rene (yarpp-es at mitcho dot com) of WordPress Webshop
    • Added ge_KA Georgian by Kasia Ciszewski (yarpp-ge at mitcho dot com) of Find My Hosting
    • Added Czech (cs_CZ) overused words list by berniecz
3.2.2b1 2011-03-23
3.2.1 2011-02-23
  • Bugfix: Duplicate results shown for some users
  • Bugfix: With PHP4, the "related posts" would simply show the current post
    • This was due to an issue with object references in PHP4. What a pain!
    • A big thanks to Brendon Held of inMotion Graphics for being incredibly patient and letting me try out different diagnostics on his server.
  • Better handling of post_status transitions.
  • Bugfix: the widget was not working on pages
  • Added overused words list for French, thanks to saymonz
  • Minor code cleanup:
    • Fixed a bug in yarpp_related_exists()
    • Removed legacy code for gracefully upgrading from YARPP versions < 1.5 and working with WordPress versions < 2.8.
    • Cleanup of yarpp_upgrade_check() calling
    • Cleanup of yarpp_version_json(), including caching and minor security fix
    • Eliminated a couple globals
    • Cleaned up some edge case causes for "unexpected output" on plugin activation
    • Removed WP Help Center badge, as they are closing
3.2.1b4 2011-02-22
3.2.1b3 2011-02-22
3.2.1b2 2011-02-20
3.2.1b1 2011-02-15
3.2 2011-02-01
  • Better caching performance:
    • Previously, the cache would never actually build up properly. This is now fixed. Thanks to Artefact for pointing this out.
    • The appropriate caches are cleared after posts are deleted (#1245).
    • Caching is no longer performed while batch-importing posts.
  • A new object-based abstraction for the caching system. YARPP by default uses custom database tables (same behavior as 3.1.x), but you now have an option to use the postmeta table instead. To use postmeta caching, add define('YARPP_CACHE_TYPE', 'postmeta'); to your wp-config.php file.<!--YARPP no longer uses custom tables! Both custom tables (yarpp_related_cache and yarpp_keywords_cache) are automatically removed if you have them. WordPress Post Meta is used instead for caching.-->
  • Localizations:
    • added Bulgarian (bg_BG) by Flash Gallery;
    • added Farsi/Persian (fa_IR) by Moshen Derakhshan;
    • added Bahasa Indonesia (id_ID) by Hendry Lee of Kelayang
    • added Norwegian (nb_NO) by Tom Arne Sundtjnn;
    • added Portuguese (pt_PT) by Stefan Mueller.
    • updated Lithuanian (lt_LT) by Mantas Malcius
  • Added WordPress HelpCenter widget for quick access to professional support.
  • Some code cleanup (bug #1246)
  • No longer supporting WordPress versions before 3.0, not because I suddenly started using something that requires 3.0, but in order to simplify testing.
3.2b4 2011-01-08
3.2b3 2011-01-02
3.2b2 2010-08-15
3.2b1 2010-08-15
3.1.9 2010-07-15
  • Added Standard Arabic localization (ar) by led
  • The Related Posts Widget now can also use custom templates. (#1143)
  • Fixed a conflict with the Magazine Premium theme
  • Fixes a WordPress warning of "unexpected output" on plugin installation.
  • Fixes a PHP warning message regarding array_key.
  • Fixed a strict WordPress warning about capabilities.
  • Bugfix: widget now obeys cross-relate posts and pages option
  • For WPMU + Multisite users, reverted 3.1.8's get_site_options to get_options, so that individual site options can be maintained.
3.1.8 2010-06-07
  • Added Turkish localization (tr_TR)
  • Bugfix: related pages and "cross-relate posts and pages" functionality is now working again.
  • Some bare minimum changes for Multisite (WPMU) support.
  • Reimplemented the old "show only previous posts" option. May improve performance for sites with frequent new posts, as there is then no longer a need to recompute the previous posts' related posts set, as it cannot include the new post anyway.
  • Minor bugfix to threshold limiting.
  • Minor fix which may help reduce strip_tags() errors.
  • Updated FAQ.
  • Code cleanup.
3.1.7 2010-04-11
  • Added Egyptian Arabic localization (ar_EG)
  • Changed default option for automatic display of related posts in feeds to OFF. May improve performance for new users who use the default settings.
  • "Use template" options are now disabled when templates are not found. Other minor tweaks to options screen.
  • 3.1.7 has been lightly tested with WP 3.0. Multisite (WPMU) compatibility has not been tested yet.
3.1.6 2010-03-12
  • Added Latvian localization (lv_LV)
  • Added a template which displays post thumbnails; requires WordPress 2.9 and a theme which has post thumbnail support
3.1.5 2010-02-27
  • Quick bugfix to new widget template (removed extra quote).
3.1.4 2010-02-26
  • Improved widget code
  • Localization improvements - descriptions can now be localized
  • Compatibility with PageBar - thanks to Latz for the patch!
  • Bugfix: related_posts_exist was giving incorrect values
  • Bugfix: SQL error for setups with blank DB_CHARSET
3.1.4b4 2010-02-24
3.1.4b3 2010-02-24
3.1.4b2 2010-01-05
3.1.3 2009-12-28
  • Performance improvements:
    • Turning off cache expiration, made possible by smarter caching system of 3.1 - should improve caching database performance over time.
    • updated primary key for cache by - improves client-side pageload times.
  • Code cleanup
    • Rewrote include and require paths
  • Bugfix: localizations were not working with WordPress 2.9 (a CodeStyling Localizations bug)
  • Bugfix: redundant entries for "unrelatedness" were being inserted
  • Bugfix: yearpp_clear_cache bug on empty input
  • Version checking code no longer uses Snoopy.
  • New localization: Hindi by Outshine Solutions
3.1.3b3 2009-12-27
3.1.3b2 2009-12-25
3.1.3b1 2009-12-21
3.1.2 2009-12-19
  • Bugfix: saving posts would sometimes timeout
3.1.2b1 2009-12-19
3.1.1 2009-12-19
  • Possible fix for the "no related posts" issue by vkovalcik
  • Bugfix: slight optimization to keyword function by vkovalcik
  • Bugfix: regex issue with br-stripping
3.1 2009-12-19
  • New snazzy options screen
  • Smarter, less confusing caching
    • No more manual caching option"on the fly" caching is always on now.
  • Bugfix: fixed related pages functionality
  • Bugfix: an issue with options saving
  • Bugfix: a slash escaping bug
  • Minor fixes:
    • Fixed yarpp_settings_link dependency when disabled.
    • Breaks (<br />) are now stripped out of titles.
    • Added plugin incompatibility info for Pagebar.
    • Faster post saving.
3.1b1 2009-12-17
3.0.14b1 2009-10-05
3.0.13 2009-09-10
  • Quick immediate bugfix to 3.0.12
3.0.12 2009-09-10
  • Yet another DISQUS note... sigh.
  • Changed default markup to be make the output validate better.
  • Reformatted the version log in readme.txt
  • Added a Settings link to the plugins page
  • Some initial WPML support:
    • Tweaked a SQL query so that it was WPML compatible
    • Added YARPP template to be used with WPML
  • Added Hebrew localization
3.0.11 2009-08-28
3.0.10 2009-08-28
3.0.9 2009-08-13
3.0.8 2009-08-01
3.0.8b4 2009-07-29
3.0.8b3 2009-07-28
3.0.8b2 2009-07-16
3.0.8b1 2009-07-15
3.0.7 2009-07-10
3.0.7b2 2009-06-15
3.0.7b1 2009-06-12
3.0.6 2009-06-11
3.0.5 2009-05-18
3.0.4 2009-05-04
3.0.3 2009-05-04
3.0.2 2009-04-27
3.0.1 2009-04-27
2.1.6 2009-04-15
3.0b7 2009-04-08
3.0b6 2009-03-28
3.0b5 2009-03-22
3.0b4 2009-02-13
3.0b3 2009-02-11
3.0b2 2009-02-04
3.0b1 2009-01-14
2.1.5 2008-12-03
2.1.4 2008-11-20
2.1.3 2008-11-09
2.1.2 2008-11-08
2.1.1 2008-11-08
2.1 2008-10-12
2.0.6 2008-09-25
2.0.5 2008-09-19
2.0.4 2008-07-15
2.0.1 2008-07-14
2.0.2 2008-07-14
2.0.3 2008-07-14
2.0 2008-07-14
1.5.1 2008-02-05
1.5 2008-02-03
1.1 2008-01-10
1.0.1 2008-01-05
1.0 2008-01-02