{"active_installs":100000,"added":{"timestamp":1199232000,"timezone":"UTC"},"author":"YARPP","author_profile":{"url":"https://profiles.wordpress.org/jeffparker/","alt":"YARPP"},"banners":[{"type":"high","url":"https://ps.w.org/yet-another-related-posts-plugin/assets/banner-1544x500.png?rev=2549977"},{"type":"low","url":"https://ps.w.org/yet-another-related-posts-plugin/assets/banner-772x250.png?rev=2549977"}],"changelog":"

5.30.11 (11-November-2024)

Bugfix: Resolves minor Unauthenticated Broken Access Control bug
Tested on WordPress 6.7

5.30.10 (17-February-2024)

Bugfix: Resolves stored Cross-Site Scripting bug

5.30.9 (22-November-2023)

Enhancement: Better input sanitization for a more predictable output
Enhancement: Misc performance improvements

5.30.8 (21-November-2023)

Enhancement: Adds ability to set sort order to Random from the YARPP Admin UI

5.30.7 (20-November-2023)

Tested on WordPress 6.4
Bugfix: Fixes PHP 8.2 warnings that were filling up server logs

5.30.6 (09-August-2023)

Tested on WordPress 6.3

5.30.5 (18-July-2023)

Bugfix: Fixes extra space at tail end of title anchor tag that was appearing for admins in the default template
[Bugfix] Template preview will now work even if server configuration does not have allow_url_fopen on (Thank you Ken @ krdev)
Bugfix: Improves how YARPP function attributes are sanitized to avoid possible security issues

5.30.4 (17-July-2023)

Bugfix: Improves how YARPP function attributes are sanitized to avoid possible security issues
Bugfix: Fixes translation bug in fr_FR locale
Bugfix: Fixes YARPP settings page compatibility with WordPress versions 4.8 and below

5.30.3 (28-APRIL-2023)

Bugfix: Improves how function attributes are sanitized to avoid possible security issues

5.30.2 (29-January-2023)

Bugfix: Improves how function attributes are sanitized to avoid possible security issues

5.30.1 (08-November-2022)

Bugfix: Fixes issue caused by stricter type checks for arithmetic operators in PHP8

5.27.8 (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 (29-October-2021)

Enhancement: CSS improvements for better cross-theme compatibility
Documentation: Available YARPP filters

5.27.6 (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 (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\n
- For example, to limit results to those published in the past 12 months: [yarpp recent=\"12 month\"]
\n
Enhancement: For Automatic Display Options use dropdown select for thumbnail sizes instead of radio buttons

5.27.4 (25-August-2021)

Bugfix: PHP 8 compatibility by making $args optional on YARPP::get_template_content()

5.27.3 (16-August-2021)

Bugfix: Make $related_query available to custom templates

5.27.2 (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 (03-August-2021)

Bugfix: i18n / localization for new text strings was not working.\n
- P.s. YARPP is available for translation directly on WordPress.org. Please check out the official Translator Handbook.
\n
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 (20-July-2021)

WordPress v5.8 compatibility
Bugfix: Fixes PHP debug notice “Trying to get property ‘ID’ of non-object”

5.26.0 (14-July-2021)

New: Adds a yarpp_add_image_size filter to avoid creating YARPP thumbnail sizes\n
- add_filter( 'yarpp_add_image_size', '__return_false' );
\n
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 (23-June-2021)

Enhancement: Cleaned up old unused code (adkengage)

5.24.0 (17-June-2021)

Enhancement: Option to automatically generate missing thumbnail sizes on the fly when using Custom YARPP Templates
New: Adds a noyarpp filter to control YARPP Automatic Display programatically.\n
- For example: add_filter( 'noyarpp', 'custom_function' );
\n
Enhancement: Use the faster and less memory intensive function strpos() instead of stristr()

5.23.0 (02-June-2021)

New: Ability to specify maximum number of posts to show in the YARPP shortcode.\n
- For example, to set maximum post limit to 3: [yarpp template=\"list\" limit=3]
\n
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 (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 template specified. For example:\n
- [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
\n
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 (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 (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 (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 (19-April-2021)

Bugfix: Allow default WP image sizes to be picked for the YARPP Thumbnail theme

5.18.1 (19-April-2021)

New: Choose image size for YARPP Thumbnail theme
Bugfix: Resolves join warning (Part 2/2)

5.17.0 (06-April-2021)

New: Adds yarpp_enqueue_related_style filter to be able to dequeue related.css\n
- add_filter( 'yarpp_enqueue_related_style', '__return_false' );
\n
New: Adds friendly per-post meta box options to disable YARPP automatic display on a specific post

5.16.1 (29-March-2021)

Bugfix: include new minified JS files

5.16.0 (29-March-2021)

Enhancement: Switches to minified JavaScript in YARPP Admin for a speed boost
Bugfix: Resolves conflict with Easy Forms for MailChimp which was preventing YARPP settings from being saved
Bugfix: Resolves join warning (Part 1/2)

5.15.3 (15-March-2021)

Enhancement: Improves readability of the database indexes prompt

5.15.2 (12-March-2021)

Tested up to WordPress 5.7

5.15.1 (11-March-2021)

Bugfix: Fixes issue pushing 5.15.0

5.15.0 (11-March-2021)

Enhancement: Default to not comparing using titles and bodies and only add database indexes when they are enabled to improve performance
Enhancement: Default algorithm threshold changed from 4 to 1 to more reliably find related content on new installs
Enhancement: Clear cache button uses modal dialogs instead of native browser alerts
Bugfix: apparent Oxygen Builder conflict

5.14.0 (9-March-2021)

Enhancement: Improve pageload speed by avoiding checking YARPP database requirements on frontend requests

5.13.1 (1-March-2021)

Add some of 5.13.0’s changes that somehow weren’t included

5.13.0 (1-March-2021)

New: Clear YARPP cache button on settings page
Bugfix Undefined variable “$post_types`

5.12.0 (22-February-2021)

New shortcode template attribute. Eg [yarpp template=\"yarpp-template-photoblog\"]
PHP 8.0 compatibility
Deprecated: functions related_posts(), related_pages() and related_entries() [useyarpp_related() instead`]
Deprecated: functions 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 (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 (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 (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 (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: Part 1 of 2 – Resolves jQuery Migrate Helper warnings

5.9.0 (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 (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

5.7.0 (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 (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 (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 (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 (29-July-2020)

New: REST API support! (documentation)
Enhancement: WP Rest Cache Plugin support
Enhancement: Adds filters to change the priority for YARPP’s filters on the_content, the_content_feed and the_excerpt_rss\n
- For example: add_filter( 'yarpp_content_priority', 1 );
\n
Bugfix: Fixes deactivation survey when Google Translate in Chrome auto translates the admin page

5.2.2 (21-July-2020)

Critical Bugfix: Fixes plugin upgrade process. This in turn fixes a page slow down issue introduced for some sites with v5.2.0.

5.2.1 (20-July-2020)

Enhancement: Don’t recommend switching database engine unless necessary for fulltext indexes.

5.2.0 (20-July-2020)

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.9 (25-June-2020)

Bugfix Fixes deactivation survey plugin conflict

5.1.8 (17-June-2020)

Bugfix Add missing file to previous release!

5.1.7 (17-June-2020)

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 (15-May-2020)

Bugfix: 403 error when saving changes resolved
Enhancement: Feedback form enhancements

5.1.5 (11-May-2020)

Bugfix: Use correct deactivation reason code

5.1.4 (11-May-2020)

Require PHP 5.3 as a bare minimum for compatibility features
New: Display optional feedback form on plugin deactivation

5.1.3 (07-April-2020)

Support for WordPress 5.4+
Enhancement: Switch over to secure (https) endpoints

5.1.2 (06-November-2019)

Support for WordPress 5.3+

5.1.1 (23-September-2019)

Enhancement: Review Notice updates + instructions on how to disable it programmatically

5.1.0 (10-July-2019)

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 (08-July-2019)

Bugfix: Fixed invalid CSS rule
Enhancement: Set Cache headers for CSS file

5.0.0 (01-July-2019)

Bugfix: Fixed warning from using get_currentuserinfo()

4.6 (01-July-2019)

Bugfix: Removed links from Plugin Readme to resolve WordFence false positive.

4.5 (18-May-2019)

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.4

Discontinuing the YARPP Pro service

4.3.6

Removed new file

4.3.5

Fix ‘unable to update’

4.3.4

Don’t allow new YARPP Pro signups
Discontinuing the YARPP Pro service as of 01/31/2017

4.3.3

Fix ‘Undefined index’ in YARPP_Cache.php (credit to Derrick Hammer/@pcfreak30)

4.3.2

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

Tested on WordPress 4.4.
Fix $lang missing error in YARPP_Cache.php
Fix WP_Widget deprecation PHP error

4.2.5

Tested on WordPress 4.2.2.
Styling fix: User can now override all YARPP CSS styling

4.2.4

Bugfix: Missing internal version number update

4.2.3

Tested on WordPress 4.0.
Bugfix: Made logo image url in css scheme-less (fix http/https)

4.2.2

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

Bugfix: Resolved the issue related to “Warning: in_array() expects parameter 2 to be array, null given”.

4.2

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

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

Bugfix: Incompatibility with PHP < 5.3.x

4.1

Added optional YARPP Pro enhancements:\n
- 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
\n
Based on user feedback, the “Screen Options” section displays all YARPP options panels by default.

4.0.8

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

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

YARPP’s automatic display will not run on posts which include the HTML comment  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 (120×120) when YARPP thumbnails are not used.\n
- 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.
\n
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\n
- Added Estonian (est_EST) by journal24.info
- Added Gujrati (gu_IN) by Vikas Arora of wiznicworld.com
\n

4.0.5

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.4

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:\n
- Updated French localization and stopword list
- Added Slovenian (sl_SI) localization by Silvo Katalenić
\n
Bugfix: forces the DB Cache Reloaded (Fix) plugins to flush when necessary

4.0.3

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.2

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\n
- Updated Polish, Japanese, Hebrew localizations
- Better right-to-left layout support
\n

4.0.1

Improvements to thumbnail handling\n
- 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)
\n
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

New thumbnail template option!\n
- No PHP required—just visit the settings page
- Edit your theme’s CSS file to modify the styling
\n
Auto display settings changes:\n
- Easily choose which post types you want related posts to display on
- Added an “also display in archives” option
\n
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:\n
- 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.
\n
Refinements to settings UI:\n
- 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 YARPP Template, Description, Author, Author URI, in the same format as plugin and theme file headers. See bundled templates for examples.
\n
Code cleanup:\n
- 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.
\n
Default option changes:\n
- Default result count is now 4
- Default match threshold is now 4
- Default for “before related entries” heading uses h3 instead of p
\n
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.

3.5.6

Typo fix for postmeta cache
Added Traditional Chinese (Taiwan, zh_TW) localization by Pseric

3.5.5

Quick bugfix for how admin screen code was loaded in in WordPress < 3.3.

3.5.4

New Help tab, which displays help text from the readme.
Retina icons! Now served faster, in sprite form.
Added Croatian (hr) localization by gocroatia.com
Cleanup:\n
- 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.
\n

3.5.3

Bugfix: Fixed a common cause of “no related posts”!
Better post revision handling
Bugfix: setup wasn’t automatic for network activations.
Code cleanup:\n
- 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.)
\n

3.5.2

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:\n
- Added Czech (cs_CZ) localization by Zdenek Hejl
- Added Serbian (sr_RS) by Zarko Zivkovic
- Fixed bug in Dutch localization
\n
Clarified readme to require WordPress 3.1
Code cleanup:\n
- 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.
\n

3.5.1

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

New public YARPP query API, which supports custom post types\n
- Documentation in the “other notes” section of the readme
- Changed format of weight, template, recent parameters in options and in optional args
\n
Further main query optimization:\n
- What’s cooler than joining four tables? Joining two.
- Exclude now simply uses term_taxonomy_ids instead of term_ids
\n
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:\n
- 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.
\n
Localizations:\n
- 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
\n

3.4.3

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.2

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.1

Bugfix: restore global $post access to custom templates
Bugfix for missing join_filter on bypass cache
Bugfixes to query changes:\n
- Bugfix: Shared taxonomy terms were not counted correctly
- Bugfix: exclusion was not …
\n

\n","contributors":[{"slug":"shareaholic","name":"Shareaholic","count":2,"is_owner":true,"links":{"profile":{"url":"https://profiles.wordpress.org/shareaholic/","alt":"Shareaholic's profile"},"plugins":{"url":"https://profiles.wordpress.org/shareaholic/#content-plugins","alt":"Shareaholic's plugins"},"activity":{"url":"https://profiles.wordpress.org/shareaholic/#content-activity","alt":"Shareaholic's activity"},"translations":{"url":"https://profiles.wordpress.org/shareaholic/#content-translations","alt":"Shareaholic's translations"}}},{"slug":"shareaholic","name":"Shareaholic","count":1,"is_owner":false,"links":{"profile":{"url":"https://profiles.wordpress.org/shareaholic/","alt":"Shareaholic's profile"},"plugins":{"url":"https://profiles.wordpress.org/shareaholic/#content-plugins","alt":"Shareaholic's plugins"},"activity":{"url":"https://profiles.wordpress.org/shareaholic/#content-activity","alt":"Shareaholic's activity"},"translations":{"url":"https://profiles.wordpress.org/shareaholic/#content-translations","alt":"Shareaholic's translations"}}},{"slug":"jeffparker","name":"YARPP","count":1,"is_owner":true,"links":{"profile":{"url":"https://profiles.wordpress.org/jeffparker/","alt":"YARPP's profile"},"plugins":{"url":"https://profiles.wordpress.org/jeffparker/#content-plugins","alt":"YARPP's plugins"},"activity":{"url":"https://profiles.wordpress.org/jeffparker/#content-activity","alt":"YARPP's activity"},"translations":{"url":"https://profiles.wordpress.org/jeffparker/#content-translations","alt":"YARPP's translations"}}}],"description":"

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:\n
- 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
\n
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 WordPress.org. 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
\n✔ Over 6 million downloads
\n✔ Translated into more than a dozen languages
\n✔ Professionally maintained and actively supported with regular updates
\n✔ 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.

\n","downloaded":7957106,"faq":"

If your question isn’t here, ask your own question at the WordPress.org forums.

\n\n

\nMany pages list “no related posts.”\n\n

Most likely you have “no related posts” right now because the default “match threshold” is too high. Here’s what we recommend to find an appropriate match threshold: lower your match threshold in the YARPP “Algorithm” options to something very low, like 1. (If you don’t see the match threshold, you may need to display the “Algorithm” options via the “Screen Options” tab at the top.) Most likely the really low threshold will pull up many posts that aren’t actually related (false positives), so look at some of your posts’ related posts and their match scores. This will help you find an appropriate threshold. You want it lower than what you have now, but high enough so it doesn’t have many false positives.

\nHow can I limit related posts to a certain time frame? For instance, I don’t want to show posts from two years ago.\n\n

In WordPress, go to “Settings” and “Related Posts (YARPP)” and make sure “The Pool” is checked in the “Screen Options” section at the top of the page. In “The Pool” section, check the box next to “Show only posts from the past X months.”

\nWhere do I tell YARPP to display related posts only by tags?\n\n

In WordPress, go to “Settings” and “YARPP” and make sure “Algorithm” is checked in the “Screen Options” section at the top of the page. In the “Algorithm” section, configure the dropdown boxes next to “Titles,” “Bodies,” “Categories,” and “Tags.”

\nCan I manually specify related posts?\n\n

Sorry, but specifying related posts, displaying related posts from external WordPress sites, and pulling content from the Comments section are all outside the scope of YARPP at this time.

\nI’m seeing related posts displayed on the home page. How do I prevent that?\n\n

Some WordPress themes treat the home page as an archive or a “page.” Go to “Settings” then “Related Posts (YARPP)” and view the “Automatic Display Options” section. Make sure “Pages” and “Also display in archives” are not checked.

\nHow can I prevent the “related posts” list from displaying on specific posts?\n\n

Option 1:

On the edit post page, uncheck “Display Related Posts” in the YARPP box. Be sure to update or publish to save your changes.

Option 2:

Add  to the HTML code of any post to prevent related posts from displaying.

Option 3:

Use the noyarpp filter. For example:

// Disable YARPP Automatic Display in specific categories\nfunction yarpp_disable_categories() {\n  // Examples of in_category usage: https://codex.wordpress.org/Function_Reference/in_category\n  if ( in_category( array( 'my_category_1_slug', 'my_category_2_slug' ) ) ) {\n    return true;\n  }\n}\nadd_filter( 'noyarpp', 'yarpp_disable_categories' );\n

These solutions only work if you are using “Automatic Display” in the “Display Options” section. If you are programatically calling yarpp_related(), the shortcode [yarpp] from PHP code or the YARPP Block, you will need to do your own conditional checks.

\nI’m using the Thumbnails display in YARPP 4+. How do I override the style of the text that displays? The title only shows two lines, the font is larger than I’d like, I’d like to center the thumbnails, etc.\n\n

If you’re familiar with CSS, you can override any YARPP styles by editing your theme’s style.css file, or any other CSS file you may have created that loads after the YARPP one. To edit your theme’s CSS file, go to “Appearance” then “Editor” and then click style.css in the right sidebar. Add changes at the bottom of the file and click “Save.” If you do edit this file, just make sure you add !important after each style declaration, to make sure they’ll override the YARPP rules.

Some common overrides that YARPP users have added are:

/* Reduces the title font size and displays more than two title lines */\n.yarpp-thumbnail {height: 200px !important;}\n.yarpp-thumbnail-title {font-size:0.8em !important; max-height: 4em !important}\n\n/* Centers the thumbnail section */\n.yarpp-related-widget {text-align:center !important;}\n

Once you save any CSS changes, empty your browser’s cache and reload your page to see the effect.

\nHow do I remove sold out WooCommerce products from recommendations (and otherwise filter by postmeta)?\n\n

If you use YARPP to show related products and want to exclude products that are sold out, use the following code snippet:

function yarpp_custom_wp_query($query) {\n    if(isset($query->yarpp_cache_type)){\n        $query->set('post_type', 'product');\n        $meta_query = [\n            'relation' => 'AND',\n            [\n                'key' => '_stock_status',\n                'value' => ['instock','onbackorder'],\n                'compare' => 'IN',\n            ]\n        ];\n        $query->set('meta_query', $meta_query);\n    }\n\n    return $query;\n}\nadd_filter('pre_get_posts', 'yarpp_custom_wp_query', 100);\n

Note: this filter applies after the related items were already calculated, so when it filters out an item you will see fewer related items than you requested.

You can similarly filter WordPress’ meta queries to include/excluded posts from YARPP’s related results.

\nI’m using the Thumbnails display. How can I change the thumbnail size?\n\n

As of YARPP v5.19.0, YARPP usually defaults to using WordPress’ default thumbnail size. This can be changed to another thumbnail size using the YARPP setting “Thumbnail Size”.

However, if you used YARPP before v5.19.0, or your theme defines a “yarpp-thumbnail” size, the default is the “yarpp-thumbnail”. To change “yarpp-thumbnail” size, add the following to your theme’s functions.php file with appropriate width and height variables:

add_image_size( 'yarpp-thumbnail', $width, $height, true ); \n

When you do this, make sure you also set the YARPP setting “Thumbnail Size” to “yarpp-thumbnail”.

Each time you change YARPP’s thumbnail dimensions like this, you will probably want to have WordPress regenerate appropriate sized thumbnails for all of your images. We highly recommend the Regenerate Thumbnails plugin for this purpose.

Note: if you don’t use YARPP’s thumbnail size, you might want to avoid generating it for newly uploaded images to save space. To do that add the following code snippet to your theme’s functions.php file:

add_filter( 'yarpp_add_image_size', \"__return_false\" );\n

\nI’m using the Thumbnails display. Why aren’t the right size thumbnails being served?\n\n

By default, if an appropriately sized thumbnail is not available in WordPress, a larger image will be served and will be made to fit in the thumbnail space via CSS. Sometimes this means images will be scaled down in a weird way, so it is not ideal. What you really want is for YARPP to serve appropriately-sized thumbnails.

There are two options for doing so:

\n
First, you can use the Regenerate Thumbnails plugin to generate all these thumbnail-sized images in a batch process. This puts you in control of when this resizing process happens on your server (which is good because it can be processor-intensive). New images which are uploaded to WordPress should automatically get the appropriate thumbnail generated when the image is uploaded.
\n
\n
Second, you can turn on a feature in YARPP to auto-generate appropriate size thumbnails on the fly, if they have not yet been created. Doing this type of processing on the fly does not scale well, so this feature is turned off by default. But if you run a smaller site with less traffic, it may work for you. Simply add define('YARPP_GENERATE_THUMBNAILS', true); to your theme’s functions.php file.
\n

\nI’m using the Thumbnails display. Why are some of my posts missing appropriate images?\n\n

YARPP’s thumbnail view requires that a WordPress “featured image” be set for each post. If you have many posts that never had a featured image set, we recommend the plugin Auto Post Thumbnail, which will generate post thumbnails for you.

\nIs YARPP compatible with WordPress Multisite?\n\n

YARPP should work fine in a multisite environment, and many users are running it without any issues using WordPress Multisite. It will, however, only get results within each blog. It will not display related posts results from across your network.

\nI want to use YARPP on a site with content in multiple languages.\n\n

The recommended solution in such cases is to use the Polylang plugin. Polylang has posted a tutorial for using YARPP with Polylang.

\nDoes YARPP work with full-width characters or languages that don’t use spaces between words?\n\n

YARPP works fine with full-width (double-byte) characters, assuming your WordPress database is set up with Unicode support. 99% of the time, if you’re able to write blog posts with full-width characters and they’re displayed correctly, YARPP will work on your blog.

However, YARPP does have difficulty with languages that don’t place spaces between words (Chinese, Japanese, etc.). For these languages, the “consider body” and “consider titles” options in the “Algorithm options” may not be very helpful. Using only tags and categories may work better for these languages.

\nDoes YARPP slow down my blog/server?\n\n

YARPP is a highly optimized plugin with an inbuilt cache that makes subsequent queries super efficient. This means that YARPP will not slow your site down.

If you are running a large site and need to throttle YARPP’s computation, try the official YARPP Experiments plugin which adds this throttling functionality.

\nAre there any plugins that are incompatible with YARPP?\n\n

SEO_Pager plugin: turn off the automatic display option in SEO Pager and instead add the code manually.
Other related posts plugins, obviously, may also be incompatible.

Please submit similar bugs by starting a new thread on the WordPress.org forums. We check the forums regularly and will try to release a quick bugfix.

\nYARPP seems to be broken since I upgraded to WordPress X.X.\n\n

Before upgrading to a new WordPress version, you should first deactivate all plugins, then upgrade your WordPress, and then reactivate your plugins. Even then, you may still find that something went wrong with your YARPP functionality. If so, try these steps:

Visit the “YARPP” settings page to verify your settings.
Deactivate YARPP, replace the YARPP files on the server with a fresh copy of the new version, and then reactivate it.
From the “YARPP” settings page, flush the YARPP cache

\nCan I clear my cache? Can I build up the cache manually?\n\n

Yes, there is a button to clear YARPP’s cache table in YARPP’s WP Admin options.

\nHow to add support for a Custom Post Type (CPT)?\n\n

To make YARPP support your Custom Post Type (CPT), the attribute yarpp_support must be set to true when the CPT is registered. The CPT will then be available in the YARPP settings page.

'yarpp_support' => true\n

For example:

function register_my_cpt() {\n  $args = array(\n    'public' => true,\n    'label'  => 'Books',\n    'yarpp_support' => true,\n  );\n  register_post_type( 'book', $args );\n}\nadd_action( 'init', 'register_my_cpt' );\n

If you do not have access to the code which is registering the CPT, maybe because it is a third-party plugin that is creating it, you can still add the yarpp_support argument:

/**\n * Filter the CPT to register more options\n *\n * @param $args       array    The original CPT args.\n * @param $post_type  string   The CPT slug.\n *\n * @return array\n */\nfunction add_yarpp_support_to_post_types( $args, $post_type ) {\n\n  // If not our target CPT, exit.\n  if ( 'my_custom_post_type' !== $post_type ) {\n    return $args;\n  }\n\n  // Add additional YARPP support option.\n  $cpt_args = array(\n    'yarpp_support' => true\n  );\n\n  // Merge args together.\n  return array_merge( $args, $cpt_args );\n}\nadd_filter( 'register_post_type_args', 'add_yarpp_support_to_post_types', 10, 2 );\n

You should replace my_custom_post_type with the CPT that you need to add YARPP support to and add this code to the functions.php of your theme.

If you would like to programmatically control which post types are considered in an automatically-displayed related posts display, use the yarpp_map_post_types filter.

\nDoes YARPP support custom taxonomies?\n\n

Yes. Any taxonomy, including custom taxonomies, may be specified in the weight or require_tax arguments in a custom display as above. term_taxonomy_id specified in the exclude argument may be of any taxonomy.

If you would like to choose custom taxonomies to choose in the YARPP settings UI, either to exclude certain terms or to consider them in the relatedness formula via the UI, the taxonomy must (a) have either the show_ui or yarpp_support attribute set to true and (b) must apply to either the post types post or page or both.

\nCan I disable the Review Notice forever?\n\n

If you want to prevent the Review Notice from appearing you can use the function below:

/**\n * Disable YARPP Review Notice\n *\n */\nfunction yarpp_disable_review_notice() {\n  remove_action('admin_notices', array('YARPP_Admin', 'display_review_notice'));\n}\nadd_action('admin_init', 'yarpp_disable_review_notice', 11);\n

\nCan I disable the request-for-feedback modal when deactivating the plugin?\n\n

Sure. Use the following code:

add_action(\n  'admin_init',\n  function(){\n    remove_all_filters('shareaholic_deactivate_feedback_form_plugins');\n  },\n  11\n);\n

\nI removed the YARPP plugin but I still see YARPP-related database tables. Shouldn’t those be removed, too?\n\n

Beginning with version 4.0.7, YARPP includes clean uninstall functionality. If you no longer wish to use YARPP, first deactivate YARPP using the “Plugins” page in WordPress, then click the “Delete” link found on the same page. This process will automatically remove all YARPP-related files, including temp tables. If you manually try to remove YARPP files instead of going through WordPress, some files or temp tables could remain.

\n\n","homepage":"https://yarpp.com/","icons":[{"type":"1x","url":"https://ps.w.org/yet-another-related-posts-plugin/assets/icon-128x128.png?rev=2549977"},{"type":"2x","url":"https://ps.w.org/yet-another-related-posts-plugin/assets/icon-256x256.png?rev=2549977"}],"installation":"

Install YARPP from within WordPress

Visit the plugins page within your WordPress dashboard and select Add New
Search for YARPP
Press “Install Now” for the YARPP plugin
Activate YARPP from your Plugins page
Go to the “YARPP” settings page to customize YARPP
[optional] copy the sample YARPP Custom Template files inside the yarpp-templates folder into your active theme folder.

Install YARPP Manually

Upload the yet-another-related-posts-plugin folder to the /wp-content/plugins/ directory
Activate YARPP from your Plugins page
Go to the “YARPP” settings page to customize YARPP
[optional] copy the sample YARPP Custom Template files inside the yarpp-templates folder into your active theme folder.

Install YARPP with the WP-CLI

wp plugin install yet-another-related-posts-plugin --activate
Go to the “YARPP” settings page to customize YARPP
[optional] copy the sample YARPP Custom Template files inside the yarpp-templates folder into your active theme folder.

The YARPP custom template feature allows you to easily customize look and feel using the same coding conventions and Template Tags as in WordPress themes.

Your YARPP Custom Template file must be in the active theme’s main directory in order to be recognized by YARPP. If your theme did not ship with a YARPP templates, move the files in the yarpp-templates directory which ships with YARPP into your active theme’s main directory. Be sure to move the files (which must be named yarpp-template-….php) to your theme, not the entire directory. There is no limit restriction on custom templates.

After Activation

You should customize your Pool, Algorithm and Automatic Display Options settings from the YARPP settings page. YARPP supports a full range of placement options, including Automatic Display Options (pick where to show YARPP from the YARPP settings page), Block, Shortcode, Widget, YARPP functions() and REST API support. Details below.

Automatic Display Options

Configurable from the YARPP settings page, the Automatic Display Option automatically displays YARPP right below post content. You can configure which posts types to display YARPP on from the YARPP settings page.

If you do not want to show the Related Posts display in its default position (right below the post content), first go to YARPP options and turn off the “Automatic Display Options”.

If you would like to instead display it in your sidebar and you have a widget-aware theme, YARPP provides a Related Posts widget which you can add under “Appearance” > “Widgets.”

If you would like to add Related Posts elsewhere (such as inline related posts), edit your relevant theme file (most likely something like single.php) and add the shortcode code [yarpp] or PHP function yarpp_related(); within The Loop where you want to display the related posts. Make sure you don’t add echo yarpp_related(); or you may end up with duplicates in your related posts section. The YARPP Block is also an option.

Automatic Display in Feed Options

Make sure the “display related posts in feeds” option is turned on if you would like to show related posts in your RSS and Atom feeds. The “display related posts in feeds” option can be used regardless of whether you auto display them on your website (and vice versa).

Block

YARPP ships with full support for Gutenberg Blocks. You can place YARPP’s Block manually wherever you’d like in post content.

Shortcode

You can place YARPP’s related posts manually wherever you’d like in post content or theme files.

To add to post content, use the shortcode:

[yarpp] to show content related to the current post. You may use more than one YARPP shortcode in a given post or template.\n

All the parameters accepted by yarpp_related() (see below) can also be used in the shortcode. Here are some examples…

If you know the reference Post ID that you want to show content related to, use:

[yarpp reference_id=123] to show content related to post 123\n

To specify which YARPP template to use, use the “template” attribute like so:

[yarpp template=\"yarpp-template-photoblog\"] - where `yarpp-template-photoblog.php` is the file name of the custom template\n[yarpp template=\"list\"] - built-in \"List\" template\n[yarpp template=\"thumbnails\"] - built-in \"Thumbnails\" template\n

To specify maximum number of posts to show, use the “limit” attribute like so:

[yarpp template=\"list\" limit=3]\n

To only show recent posts, use the “recent” attribute (provide it with a number, a space, and then either “day”, “week” or “month”)

[yarpp recent=\"6 month\"]\n

To show another post type, use the “post_type” parameter.

[yarpp post_type=\"page\"]\n

If you need to provide multiple values (eg posts and pages, or a list of categorires of posts to exlude), separate them with a comma but no space.

[yarpp post_type=\"post,page\"] - include both posts and pages in results\n[yarpp exclude=\"1,2,3\"] - exclude posts with categories with IDs 1,2 and 3\n

To adjust the weights and taxonomy requirements, provide the value as JSON (using the same structure as for yarpp_related() below). Eg

[yarpp weight='{\"body\":1}'] - only consider body content\n[yarpp weight='{\"body\":2,\"title\":2,\"tax\":{\"category\":0, \"post_tag\":0}}'] - give extra weight to bodies and titles, but none to categories\n[yarpp require_tax='{\"category\": 2, \"post_tag\": 0}'] - require at least one category in common\n

To order results:

[yarpp order=\"score DESC\"] - high relevance score to low\n[yarpp order=\"rand\"] - random\n

To add YARPP shortcode to your theme files (eg. single.php), use:

<?php echo do_shortcode('[yarpp]'); ?>\n<?php echo do_shortcode('[yarpp reference_id=123]'); ?>\n

If you’re adding the shortcode outside the loop, you must provide the reference_id.

Widget

Related posts can also be displayed as a widget. Go to the Appearance > Widgets options page and add the “Related Posts (YARPP)” widget. Choose to display content from YARPP Basic. The widget will only be displayed on single entry (permalink) pages.

The YARPP widget can be used even if the “auto display” option is turned off.

REST API

Add related posts to your JavaScript driven app!

YARPP adds a REST API endpoint for fetching related posts. The JSON results from the REST API query are the same as you would see if you were visiting a post on your website (the same quantity and order). It is possible to override the quantity at the time of making the REST API request.

[Documentation]

YARPP functions()

Developers can call YARPP’s powerful relatedness algorithm from anywhere in their own code. Some examples and more details are in this WordCamp Birmingham talk.

You may use the functions defined in includes/related_functions.php in your own code, notably:

yarpp_related() – gets the HTML for related posts and displays it
yarpp_related_exist() – checks whether any related posts exists
yarpp_get_related() – returns the list of related posts (WP_Post objects)

Examples:

Show related posts, using all the settings set on the YARPP settings page:

<?php yarpp_related(); ?>\n

Each of these functions will default to using the settings set on the YARPP settings page, but can be customized. For example:

yarpp_related(\n  array(\n    // Pool options: these determine the \"pool\" of entities which are considered\n    'post_type' => array('post', 'page', 'wc_product', ...), //  post types to include in results\n    'show_pass_post' => true, // show password-protected posts\n    'show_sticky_posts' => true, // show sticky posts\n    'past_only' => true, // show only posts which were published before the reference post\n    'exclude' => array(), // a list of term_taxonomy_ids. entities with any of these terms will be excluded from consideration.\n    'recent' => false, // to limit to entries published recently, set to like '15 day', '20 week', or '12 month' (https://www.mysqltutorial.org/mysql-interval/)\n\n    // Relatedness algorithm options: these determine how \"relatedness\" is computed\n    // Weights are used to construct the \"match score\" between candidates and the reference post\n    'weight' => array(\n      'body' => 1,\n      'title' => 2, // larger weights mean this criteria will be weighted more heavily\n      'tax' => array(\n        'post_tag' => 1,\n        ... // put any taxonomies you want to consider here with their weights\n      )\n    ),\n    // Specify taxonomies and a number here to require that a certain number be shared:\n    'require_tax' => array(\n      'post_tag' => 1 // for example, this requires all results to have at least one 'post_tag' in common\n    ),\n    // The threshold which must be met by the \"match score\" to be considered related\n    'threshold' => 5,\n\n    // Display options:\n    'template' => 'thumbnails', // which theme/custom template to use. Built-in ones include \"list\" and \"thumbnails\", or the name of a YARPP template file in your active theme folder starting with \"yarpp-template-\". Example: yarpp-template-videos or yarpp-template-videos.php\n    'limit' => 5, // maximum number of results\n    'order' => 'score DESC', // column on \"wp_posts\" to order by, then a space, and whether to order in ascending (\"ASC\") or descending (\"DESC\") order\n    'promote_yarpp' => true, // boolean indicating whether to add 'Powered by YARPP' below related posts\n    'generate_missing_thumbnails' => true, // automatically generate missing thumbnail sizes on the fly\n    'extra_css_class' => 'class_1 class_2', // add CSS classes to YARPP's parent div\n  ),\n $reference_ID, // second argument: (optional) the post ID. If not included, will use the current post.\n true // third argument: (optional) true to echo the HTML block; false to return it\n);\n

Options which are not specified will default to those specified on the YARPP settings page. Additionally, if you are using a builtin template rather than specifying a custom template file in template, the following arguments can be used to override the various parts of the builtin template: before_title, after_title, before_post, after_post, before_related, after_related, no_results, excerpt_length.

If you need to implement related entries programmatically or to know whether they exist, you can use the functions:

yarpp_get_related( $args, $reference_ID )
\nReturns an array of post objects, just like the WordPress function get_posts.
yarpp_related_exist( $args, $reference_ID )
\nReturns a boolean for whether any such related entries exist.

For each of these functions, $args takes the same arguments as those detailed for yarpp_related() above, except for the various display and template options.

Note that at this time custom YARPP queries using the functions mentioned here are not cached in the built-in YARPP caching system. Thus, if you notice any performance hits, you may need to write your own code to cache the results.

Example of how to use a custom YARPP query and cache the results for a day:

$result = get_transient('yarpp_custom_results_for_' . $post->ID);\nif(! $result){\n  $result = yarpp_related(['post_type' => 'reply'],null,false);\n  set_transient('yarpp_custom_results_for_' . $post->ID, $result, DAY_IN_SECONDS);\n}\necho $result;\n

Show at most 4 related WooCommerce products based on their title and especially on their categories, assuming custom YARPP template
\n yarpp-related-wc-products.php has been added to the active theme folder:

yarpp_related(\n  array(\n    'limit' => 4,\n    'weight' => array(\n      'title' => 1,\n      'tax' => array(\n        'category' => 2\n      )\n    ),\n    'post_type' => 'wc_product',\n    'template' => 'yarpp-related-wc-products.php'\n  )\n);\n

Check for posts related to post with ID 123, and loop through them in order to do some more custom logic:

$related_posts = yarpp_get_related(array(), 123);\nif(! $related_posts){\n  echo 'No related posts';\n} else {\n  foreach($related_posts as $post){\n    // $post is a WP_Post object.\n    echo $post->post_title;\n  }\n}\n

Show results ordered by score (high relevance to low):

yarpp_related(\n  array(\n    'order' => 'score DESC',\n  )\n);\n

Show results ordered by post publish date (new to old):

yarpp_related(\n  array(\n    'order' => 'post_date DESC',\n  )\n);\n

Show results ordered randomly:

yarpp_related(\n  array(\n    'order' => 'rand',\n  )\n);\n

YARPP Filters

Documentation: https://support.shareaholic.com/hc/en-us/articles/4408775687060

\n","internal_ranking":0,"languages":[{"slug":"es_ES","label":"Spanish (Spain)","count":33639},{"slug":"nl_NL","label":"Dutch","count":31535},{"slug":"ru_RU","label":"Russian","count":28509},{"slug":"fr_FR","label":"French (France)","count":21643},{"slug":"de_DE","label":"German","count":20712},{"slug":"es_VE","label":"Spanish (Venezuela)","count":17574},{"slug":"sv_SE","label":"Swedish","count":15463},{"slug":"ja","label":"Japanese","count":14554},{"slug":"es_CO","label":"Spanish (Colombia)","count":13885},{"slug":"nl_NL_formal","label":"Dutch (Formal)","count":12380},{"slug":"es_EC","label":"Spanish (Ecuador)","count":12078},{"slug":"cs_CZ","label":"Czech","count":10803},{"slug":"en_GB","label":"English (UK)","count":10307},{"slug":"zh_CN","label":"Chinese (China)","count":10018},{"slug":"pl_PL","label":"Polish","count":9477},{"slug":"es_CL","label":"Spanish (Chile)","count":8928},{"slug":"en_CA","label":"English (Canada)","count":8645},{"slug":"uk","label":"Ukrainian","count":7431},{"slug":"ko_KR","label":"Korean","count":6183},{"slug":"ca","label":"Catalan","count":4455},{"slug":"hr","label":"Croatian","count":4402},{"slug":"gl_ES","label":"Galician","count":4164},{"slug":"he_IL","label":"Hebrew","count":2804}],"last_seen":{"timestamp":1776427871.531,"timezone":"UTC"},"last_updated":{"timestamp":1731348960,"timezone":"UTC"},"last_wordpress_compatible_version":"6.7.5","latest_num_ratings":10,"latest_rating":5,"latest_ratings":{"1":0,"2":0,"3":0,"4":0,"5":10,"links":{"1":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/?filter=1","alt":"View all 0 one star reviews"},"2":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/?filter=2","alt":"View all 0 two star reviews"},"3":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/?filter=3","alt":"View all 0 three star reviews"},"4":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/?filter=4","alt":"View all 0 four star reviews"},"5":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/?filter=5","alt":"View all 10 five star reviews"},"all":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/","alt":"View all 10 reviews"}}},"minimum_php_version":"5.3","minimum_wordpress_version":"3.7","name":"YARPP – Yet Another Related Posts Plugin","num_ratings":1150,"pluginid":"yet-another-related-posts-plugin","rating":4.8,"ratings":{"1":35,"2":7,"3":15,"4":56,"5":1037,"links":{"1":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/?filter=1","alt":"View all 35 one star reviews"},"2":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/?filter=2","alt":"View all 7 two star reviews"},"3":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/?filter=3","alt":"View all 15 three star reviews"},"4":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/?filter=4","alt":"View all 56 four star reviews"},"5":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/?filter=5","alt":"View all 1037 five star reviews"},"all":{"url":"https://wordpress.org/support/plugin/yet-another-related-posts-plugin/reviews/","alt":"View all 1150 reviews"}}},"reviews":[{"reviewer":"FolioVision","title":"Review demand right in the middle of other plugin interfaces","content":"When will WordPress plugin authors learn some manners? I was attempting to post a video and right in the middle of an unrelated plugin interface, YARPP demanded a plugin review.\n\nIt's bad enough when plugins spam their own admin interfaces but defacing the posting interfaces of other plugins? That's a new low.\n\nYARPP is okay, hence the two stars. YARPP is now spamming hence the two stars. Frustrating as heck to see long time plugin authors turn into spammers. All started with Yoast and the tolerance for his spamming the admin interface, as he sponsored WordCamps.\n\nLive by the sword, die by the sword. More and more people are not enjoying WordPress as this kind of non-FOSS behaviour is tolerated and hence, by tolerance, encouraged by the WordPress Foundation and Automattic.","rating":0.1,"created":{"timestamp":1668384000,"timezone":"UTC"}},{"reviewer":"spherical","title":"Tried a Couple of Others and Returned","content":"\nThe customization of related posts display is what brought me back. Used to be that I got the look I was seeking but after a number of updates, probably in the plugins and/or Wordpress itself, I just couldn't get where I wanted to go with the others. YARPP allows me to get the look I wanted for my chosen themes. Did take a bit of trial and error but got it done.\n","rating":0.25,"created":{"timestamp":1671753600,"timezone":"UTC"}},{"reviewer":"dock3r","title":"Absolute must-have on every blog","content":"\nThe team behind it invested considerable effort to develop this software that is not only lightweight but also highly efficient.\n","rating":0.25,"created":{"timestamp":1682467200,"timezone":"UTC"}},{"reviewer":"Lorna Timbah","title":"Must-have on my blogs","content":"\nI've been using this for years, and it's been one of my go-to plugins for displaying related posts.\n","rating":0.25,"created":{"timestamp":1709164800,"timezone":"UTC"}},{"reviewer":"johnh10","title":"Just what I wanted","content":"\nAn easy to use plugin with excellent Related Posts output.\n","rating":0.25,"created":{"timestamp":1720137600,"timezone":"UTC"}},{"reviewer":"Krisztian Czako","title":"It has a security issue and they're not going to fix it","content":"\nGreat plugin to display related posts wherever I want.\n\n\n\nThe current version has a security issue that the developers dismiss as spam, despite having an official CVE for the problem. There's been no fix for months now (and no intention to fix regarding their responses in the forum).\n","rating":0.1,"created":{"timestamp":1727740800,"timezone":"UTC"}},{"reviewer":"Killian Santos","title":"Très bonne extension !","content":"\nL'extension YARPP est simple et efficace. Je recommande !\n","rating":0.25,"created":{"timestamp":1737504000,"timezone":"UTC"}},{"reviewer":"Davis Simiyu Wanyonyi","title":"Perfect!","content":"\nWorked exactly the way I wanted. Thanks\n","rating":0.25,"created":{"timestamp":1742083200,"timezone":"UTC"}},{"reviewer":"dannyman","title":"It Works!","content":"\nDoes what it says on the tin: shows related posts.\n","rating":0.25,"created":{"timestamp":1762819200,"timezone":"UTC"}},{"reviewer":"ufukart","title":"Still unbeatable, Still free, Still effective","content":"\nStill unbeatable, Still free, Still effective, thank you\n","rating":0.25,"created":{"timestamp":1764547200,"timezone":"UTC"}}],"screenshots":"

$\"YARPP$
YARPP options in WP-Admin: Automatic Display Options
$\"YARPP$
YARPP options in WP-Admin: \"The Pool\" settings
$\"YARPP$
YARPP options in WP-Admin: \"The Algorithm\" settings
$\"Example$
Example - YARPP on starwars.com
$\"Example$
Example - YARPP on CB2.com
$\"Example$
Example - YARPP on chrisguillebeau.com

","short_description":"The best WordPress plugin for displaying related posts. Simple and flexible, with a powerful proven algorithm and inbuilt caching.","support_threads":1,"support_threads_resolved":1,"tags":[{"slug":"seo","label":"seo","count":1992},{"slug":"posts","label":"posts","count":1513},{"slug":"related-posts","label":"related posts","count":149},{"slug":"similar-posts","label":"similar posts","count":37},{"slug":"contextual-related-posts","label":"contextual related posts","count":7}],"tags_count":3698,"languages_count":309589,"age_days":6711.915198774618,"installs_per_rating":86.95652173913044,"downloads_per_rating":6919.2226086956525,"installs_per_day":14.898877151823493,"downloads_per_day":1185.5194477803764,"reviews_per_day":0.1713370872459702,"activation_rate":0.012567383166694021,"version":"5.30.11","marketplace":"wordpress","marketplace_url":"https://wordpress.org/plugins/yet-another-related-posts-plugin","price":null,"wordpress_link":{"alt":"WordPress","url":"https://wordpress.org/plugins/yet-another-related-posts-plugin"}}

Other Posts vs YARPP – Yet Another Related Posts Plugin