WordPress.org

If your question isn't here, ask your own question at the WordPress.org forums. Please do not email with questions.

How can I move the related posts display?

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" option 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. This method can also be used to display YARPP on pages other than single-post displays, such as on archive pages.

Does YARPP slow down my blog/server?

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

If you find that the YARPP database calls are still too database-intensive, try the following:

• turning off "cross relate posts and pages";
• turning on "show only previous posts";

These options can be found in the "Relatedness" metabox which you can display from the "Screen Options" tab. All of these can improve database performance.

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 in the process of looking for a hosting provider whose databases will not balk under YARPP, I personally have had great success with MediaTemple.

Every page just says "no related posts"! What's up with that?

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

I am currently seeking information from users who cannot get related posts anywhere in order to debug this issue: more information here.

Are there any plugins that are incompatible with YARPP?

• DISQUS: go to the DISQUS plugin advanced settings and turn on the "Check this if you have a problem with comment counts not showing on permalinks".
• SEO_Pager plugin: turn off the automatic display option in SEO Pager and instead add the code manually.
• Pagebar 2;
• WP Contact Form III plugin and Contact Form Plugin;
• Other related posts plugins, obviously, may also be incompatible.

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.

Does YARPP work with full-width characters or languages that don't use spaces between words?

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.

Things are weird after I upgraded.

1. Visit the "Related Posts (YARPP)" settings page to verify your settings.
2. Disactivate YARPP, replace the YARPP files on the server with a fresh copy of the new version, and then reactivate it.
3. Install the official YARPP Experiments plugin to flush the cache.

Can I clear my cache? Can I build up the cache manually?

The official YARPP Experiments plugin adds manual cache controls, letting you flush the cache and build it up manually.