Display a list of related entries on your site and feeds based on a unique algorithm. Now with thumbnail support built-in!
If your question isn't here, ask your own question at the WordPress.org forums. Please do not email with questions.
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 "automatically display" options in the "website" section. 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 the Related Posts display elsewhere, edit your relevant theme file (most likely something like
single.php) and add the PHP code
related_posts(); within The Loop where you want to display the related posts.
The thumbnail size can be specified programmatically by adding
add_image_size( 'yarpp-thumbnail', $width, $height, true ); to your theme's
functions.php file with appropriate width and height variables. In the future I may add some UI to the settings to also set this... feedback is requested on whether this is a good idea.
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. I highly recommend the Regenerate Thumbnails plugin for this purpose. See also the next question.
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:
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.
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
YARPP's custom templates feature allows you to uber-customize the related posts display using the same coding conventions and Template Tags as in WordPress themes. Custom templates must be in your active theme's main directory in order to be recognized by YARPP. If your theme did not ship with 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
.php) to your theme, not the entire directory.
The YARPP calculation of related content does make a little impact, yes. However, YARPP caches all of its results, so any post's results need only be calculated once. YARPP's queries have been significantly optimized in version 3.5.
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. If you are looking for a hosting provider whose databases will not balk under YARPP, I personally have had great success with MediaTemple.
Most likely you have "no related posts" right now as the default "match threshold" is too high. Here's what I recommend to find an appropriate match threshold: lower your match threshold in the YARPP options to something very low, like 1. (If you don't see the match threshold, you may need to display the "Relatedness" 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.
Please submit similar bugs by starting a new thread on the WordPress.org forums. I check the forums regularly and will try to release a quick bugfix.
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 "Relatedness options" may not be very helpful. Using only tags and categories may work better for these languages.
The official YARPP Experiments plugin adds manual cache controls, letting you flush the cache and build it up manually.
Requires: 3.3 or higher
Compatible up to: 3.6
Last Updated: 2013-4-15
40 of 69 support threads in the last two months have been resolved.
Got something to say? Need help?