Option 1 - Automatic install<\/strong><\/p>\n\nUse the plugin installer built into WordPress to search for the plugin. WordPress will then download and install it for you.<\/p>\n\n
Option 2 - Manual install<\/strong><\/p>\n\n\n- Make sure the files are within a folder.<\/li>\n
- Copy the whole folder inside the wp-content\/plugins\/ folder.<\/li>\n
- In the backend, activate the plugin. You can now select related posts when you create or edit blog posts, pages etc.<\/li>\n<\/ol>\n\n
How to display the related posts on your website<\/strong><\/p>\n\nThe related posts are displayed by adding<\/p>\n\n
<?php global $related; echo $related->show( $post_id ); ?>\n<\/code><\/pre>\n\nto your template. Replace $post_id<\/code> with a post ID. If you call it within the WordPress loop, you can use<\/p>\n\n<?php global $related; echo $related->show( get_the_ID() ); ?>\n<\/code><\/pre>\n\nYou have the option of either outputting a pre-formatted list or returning a PHP array of related posts to customise the\nmarkup yourself.<\/p>\n\n
Examples<\/strong><\/p>\n\nExample 1: Using the default output<\/em><\/p>\n\n<?php global $related; echo $related->show( get_the_ID() ); ?>\n<\/code><\/pre>\n\nThis can be called within the WordPress loop. It will output a <ul><\/code> list with links.<\/p>\n\nExample 2: Returning an array<\/em><\/p>\n\n<?php\n global $related;\n $rel = $related->show( get_the_ID(), true );\n?>\n<\/code><\/pre>\n\nExample 3: Using a simple foreach loop<\/em><\/p>\n\nWith the second argument set to true, it will return an array of post objects. Use it to generate your own custom markup.\nHere is an example:<\/p>\n\n
<?php\n global $related;\n $rel = $related->show( get_the_ID(), true );\n $statuses = related_get_public_statuses();\n\n \/\/ Display the title of each related post\n if( is_array( $rel ) && count( $rel ) > 0 ) {\n foreach ( $rel as $r ) {\n if ( is_object( $r ) ) {\n if ( in_array( $r->post_status, $statuses ) ) {\n echo get_the_title( $r->ID ) . '<br \/>';\n }\n }\n }\n }\n?>\n<\/code><\/pre>\n\nExample 4: Using a WordPress loop<\/em><\/p>\n\nIf you want to run it with a real WordPress loop, then use it as follows. You can then use functions like the_content or the_excerpt.\nBut make sure you don't use the content filter for related posts, because you might get an endless stream of related posts that are related to each other :).<\/p>\n\n
<?php\n global $related;\n $rel = $related->show( get_the_ID(), true );\n $statuses = related_get_public_statuses();\n\n \/\/ Display the title and excerpt of each related post\n if( is_array( $rel ) && count( $rel ) > 0 ) {\n foreach ( $rel as $r ) {\n if ( is_object( $r ) ) {\n if ( in_array( $r->post_status, $statuses ) ) {\n setup_postdata( $r );\n echo get_the_title( $r->ID ) . '<br \/>';\n the_excerpt();\n }\n }\n }\n wp_reset_postdata();\n }\n?>\n<\/code><\/pre>\n\nExample 5: Using Related_du plugin<\/em><\/p>\n\nUsing the default output from the Related (Doubled Up) plugin:<\/p>\n\n
<?php global $related_du; echo $related_du->show( get_the_ID() ); ?>\n<\/code><\/pre>\n\nThis can be called within the WordPress loop. It will output a <ul><\/code> list with links.<\/p>\n\n\n\nWho should use this plugin?<\/h3><\/dt>\nPeople who want to list 'related posts' in their blog posts or pages, and want to choose the related posts manually themselves.<\/p><\/dd>\n
Where does the plugin store its data?<\/h3><\/dt>\nData is stored in the existing postmeta table in the WordPress database. No additional tables are created.<\/p><\/dd>\n
How many related posts can I add?<\/h3><\/dt>\nAs many as you like, there's no limit.<\/p><\/dd>\n
I have many posts, how can I deal with that in the best way?<\/h3><\/dt>\nThere are 2 things that are done or possible.\nThe Javascript Chosen.js is being used so you can easily navigate through the select-box.\nAlso, you can select on the Options page to not list all post types. This will trim down the number of posts that are listed.\nFor each posttype a maximum of 500 posts will be listed.<\/p><\/dd>\n
My admin dashboard gives error about reaching the memory limit.<\/h3><\/dt>\nProbably all post types are shown in the dropdown lists in the metabox.\nYou want to go to Settings > Related > Form-tab and only enable the post types you really want in the dropdown.\nFor me this made a difference from 100MB to 29MB memory usage.<\/p><\/dd>\n
How do I delete all related posts data?<\/h3><\/dt>\nOn the Settings page there is an uninstall tab. If you want post relations and settings removed, use this page to remove them completely.<\/p><\/dd>\n
Are there compatibility issues<\/h3><\/dt>\nThis plugin is not compatible with the Kleo theme.<\/p><\/dd>\n\n<\/dl>\n\n\n
3.5.0<\/h4>\n\n\n- 2025-03-07<\/li>\n
- On the frontend, limit (or extend) the post status that is allowed.<\/li>\n
- Add function 'related_get_public_statuses'.<\/li>\n
- Add filter 'related_get_public_statuses'.<\/li>\n<\/ul>\n\n
3.4.1<\/h4>\n\n\n- 2024-10-07<\/li>\n
- Only load admin pages on dashboard, not frontend.<\/li>\n
- Loading plugin translations should be delayed until init action.<\/li>\n
- Check for direct access of files.<\/li>\n
- Use DIR<\/strong> instead of dirname(FILE<\/strong>).<\/li>\n<\/ul>\n\n
3.4.0<\/h4>\n\n\n- 2023-03-24<\/li>\n
- Set defaults to only show posts on posts by default in metabox.<\/li>\n
- Take some hints from phpcs and wpcs.<\/li>\n<\/ul>\n\n
3.3.0<\/h4>\n\n\n- 2023-01-10<\/li>\n
- Add filter 'related_show_post_tn_size' for thumbnail size.<\/li>\n
- Small improvement for CSS.<\/li>\n<\/ul>\n\n
3.2.0<\/h4>\n\n\n- 2021-12-07<\/li>\n
- Add \"clear:both\" CSS to lists.<\/li>\n
- Take some hints from phpcs and wpcs.<\/li>\n
- Use more 'esc_attr' functions when appropriate.<\/li>\n
- Do not use 'wp_reset_query'.<\/li>\n
- Remove old translation files from plugin, GlotPress should be used.<\/li>\n<\/ul>\n\n
3.1.5<\/h4>\n\n\n- 2021-02-21<\/li>\n
- Fix deprecated jQuery calls with WP 5.6 and jQuery 3.5.<\/li>\n
- Set correct order of metaboxes.<\/li>\n<\/ul>\n\n
3.1.4<\/h4>\n\n\n- 2020-04-13<\/li>\n
- Add uninstall tab on settings page.<\/li>\n
- Update About text on settings page.<\/li>\n<\/ul>\n\n
3.1.3<\/h4>\n\n\n- 2020-03-10<\/li>\n
- Add parameter $post to these 2 filters.<\/li>\n<\/ul>\n\n
3.1.2<\/h4>\n\n\n- 2020-03-10<\/li>\n
- Add filter 'related_show_post'.<\/li>\n
- Add filter 'related_show_post_list'.<\/li>\n<\/ul>\n\n
3.1.1<\/h4>\n\n\n- 2019-04-16<\/li>\n
- Small fix for silly mistake.<\/li>\n<\/ul>\n\n
3.1.0<\/h4>\n\n\n- 2019-01-28<\/li>\n
- Filter heading too in content filters.<\/li>\n
- Set order for content filters.<\/li>\n
- Remove a lot of caching code that should be done by WP Core.<\/li>\n
- No need for cache flush on switch_theme action.<\/li>\n
- Better use of esc_html functions.<\/li>\n
- Add some accessibility fixes.<\/li>\n<\/ul>\n\n
3.0.2<\/h4>\n\n\n- 2018-11-27<\/li>\n
- Add CSS for Gutenberg Editor.<\/li>\n
- Update chosen.js to 1.8.7.<\/li>\n<\/ul>\n\n
3.0.1<\/h4>\n\n\n- 2018-08-31<\/li>\n
- Add compatibility for Dark Mode beta plugin.<\/li>\n<\/ul>\n\n
3.0.0<\/h4>\n\n\n- 2017-09-01<\/li>\n
- Refactor Double Up plugin as just an option.<\/li>\n
- Don't use current post as related post.<\/li>\n<\/ul>\n\n
2.3.2<\/h4>\n\n\n- 2017-08-31<\/li>\n
- Use Nonce for metaboxes too (thanks benoitchantre).<\/li>\n<\/ul>\n\n
2.3.1<\/h4>\n\n\n- 2017-07-31<\/li>\n
- Translate 'any' label as well.<\/li>\n<\/ul>\n\n
2.3.0<\/h4>\n\n\n- 2017-05-08<\/li>\n
- Add option for extended view.<\/li>\n
- Update chosen from 1.4.2 to 1.7.0.<\/li>\n
- Rename styles.css to admin-style.css<\/li>\n
- Add frontend-style.css for extended view.<\/li>\n
- Add actions in construct, not in another action.<\/li>\n
- Limit queries in metabox to 500 posts per posttype.<\/li>\n<\/ul>\n\n
2.2.3<\/h4>\n\n\n- 2017-03-30<\/li>\n
- Use Nonce on admin pages.<\/li>\n
- Show message when options are successfully saved.<\/li>\n
- Always cast related post_ids to an int.<\/li>\n
- Only save custom fields on page edit.<\/li>\n
- Do not concatenate strings, but use sprintf on about page.<\/li>\n<\/ul>\n\n
2.2.2<\/h4>\n\n\n- 2016-11-23<\/li>\n
- Fix compatibility for Qtranslate and Qtranslate-X.<\/li>\n<\/ul>\n\n
2.2.1<\/h4>\n\n\n- 2016-05-23<\/li>\n
- Don't add it to the content twice in the RSS Feed.<\/li>\n<\/ul>\n\n
2.2.0<\/h4>\n\n\n- 2016-05-22<\/li>\n
- Add option for adding related posts to RSS Feed.<\/li>\n<\/ul>\n\n
2.1.3<\/h4>\n\n\n- 2016-04-13<\/li>\n
- Improve styling of headings on admin pages.<\/li>\n
- Update Donate text.<\/li>\n<\/ul>\n\n
2.1.2<\/h4>\n\n\n- 2016-04-05<\/li>\n
- Make it possible to leave title for content filter empty.<\/li>\n
- Add filter for that content title.<\/li>\n
- Move many files into subdirs.<\/li>\n
- Also test if post exists on admin side.<\/li>\n<\/ul>\n\n
2.1.1<\/h4>\n\n\n- 2016-03-20<\/li>\n
- Add option to chosen for better search: search_contains:true.<\/li>\n<\/ul>\n\n
2.1.0<\/h4>\n\n\n- 2015-12-11<\/li>\n
- Make optgroup label more informative.<\/li>\n
- Fix some translations.<\/li>\n
- Drop pot and nl_NL, they are maintained at GlotPress.<\/li>\n<\/ul>\n\n
2.0.9<\/h4>\n\n\n- 2015-10-04<\/li>\n
- Sort only hierarchical post_types on title (ASC), the rest on date (DESC).<\/li>\n<\/ul>\n\n
2.0.8<\/h4>\n\n\n- 2015-10-04<\/li>\n
- Only support WordPress 3.7+, since they really are supported.<\/li>\n
- Use plugins_url() for enqueue.<\/li>\n
- Change title of Widget.<\/li>\n
- Update pot, nl_NL.<\/li>\n<\/ul>\n\n
2.0.7<\/h4>\n\n\n- 2015-09-02<\/li>\n
- Use h1 headings properly, including closing tag.<\/li>\n
- Add fr_FR (thanks Vincent Clarisse).<\/li>\n<\/ul>\n\n
2.0.6<\/h4>\n\n\n- 2015-08-05<\/li>\n
- Use h1 header on admin page.<\/li>\n
- Add option for content filter to show on all views.<\/li>\n
- Update pot, nl_NL.<\/li>\n<\/ul>\n\n
2.0.5<\/h4>\n\n\n- 2015-07-17<\/li>\n
- Much simpler solution for WPML.<\/li>\n<\/ul>\n\n
2.0.4<\/h4>\n\n\n- 2015-07-17<\/li>\n
- Support WPML, only list the right posts in the metabox.<\/li>\n
- Upgrade Chosen.js from 1.2.0 to 1.4.2.<\/li>\n<\/ul>\n\n
2.0.3<\/h4>\n\n\n- 2015-05-31<\/li>\n
- Add about tab on settingspage.<\/li>\n
- Update pot and nl_NL.<\/li>\n<\/ul>\n\n
2.0.2<\/h4>\n\n\n- 2015-05-06<\/li>\n
- Use is_singular, and show the list on pages as well.<\/li>\n<\/ul>\n\n
2.0.1<\/h4>\n\n\n- 2015-04-25<\/li>\n
- Properly escape the title of the content filter.<\/li>\n<\/ul>\n\n
2.0.0<\/h4>\n\n\n- 2015-04-08<\/li>\n
- Add duplicate plugin Related (Doubled Up).<\/li>\n
- Small cleanups in get_posts args.<\/li>\n
- Update pot, nl_NL.<\/li>\n<\/ul>\n\n
1.7.0<\/h4>\n\n\n- 2015-04-05<\/li>\n
- Add indentation for hierarchical posts in dropdown.<\/li>\n
- Add walker for that dropdown.<\/li>\n
- Use get_posts instead of WP_Query.<\/li>\n<\/ul>\n\n
1.6.4<\/h4>\n\n\n- 2015-03-26<\/li>\n
- Use admin_enqueue_scripts function.<\/li>\n
- Load admin scripts in footer.<\/li>\n<\/ul>\n\n
1.6.3<\/h4>\n\n\n- 2015-03-21<\/li>\n
- Add de_DE (Thanks Eckart Schmidt).<\/li>\n<\/ul>\n\n
1.6.2<\/h4>\n\n\n- 2015-03-16<\/li>\n
- Add fa_IR (Thanks Mohsen Pahlevanzadeh).<\/li>\n<\/ul>\n\n
1.6.1<\/h4>\n\n\n- 2015-03-16<\/li>\n
- Use our text-domain everywhere.<\/li>\n
- Update pot and nl_NL<\/li>\n<\/ul>\n\n
1.6.0<\/h4>\n\n\n- 2015-03-01<\/li>\n
- Support Qtranslate-X plugin.<\/li>\n
- Place settingspage in own php-file.<\/li>\n<\/ul>\n\n
1.5.9<\/h4>\n\n\n- 2015-02-28<\/li>\n
- Support attachments by showing posts with post_status 'inherit' as well.<\/li>\n<\/ul>\n\n
1.5.8<\/h4>\n\n\n- 2015-01-07<\/li>\n
- Only show the content filter on single posts, not on blog.<\/li>\n<\/ul>\n\n
1.5.7<\/h4>\n\n\n- 2014-12-05<\/li>\n
- Use chosen.js for easy select-boxes (thanks rembem).<\/li>\n
- Use in_array instead of looping with foreach.<\/li>\n
- Update nl_NL.<\/li>\n<\/ul>\n\n
1.5.6<\/h4>\n\n\n- 2014-10-22<\/li>\n
- Test if the metakey really holds values and avoid PHP Warnings<\/li>\n
- Improved examples in Readme<\/li>\n<\/ul>\n\n
1.5.5<\/h4>\n\n\n- 2014-10-21<\/li>\n
- Add sr_RS Serbian Language (Borisa Djuraskovic)<\/li>\n<\/ul>\n\n
1.5.4<\/h4>\n\n\n- 2014-08-22<\/li>\n
- Compatibility with Qtranslate and MQtranslate<\/li>\n
- Don't show posts with status 'trash'.<\/li>\n<\/ul>\n\n
1.5.3<\/h4>\n\n\n- 2014-08-13<\/li>\n
- Add option for content filter title<\/li>\n
- sanitize values in update_option()<\/li>\n<\/ul>\n\n
1.5.2<\/h4>\n\n\n- 2014-08-08<\/li>\n
- Only show header if there are related posts (content filter)<\/li>\n<\/ul>\n\n
1.5.1<\/h4>\n\n\n- 2014-05-10<\/li>\n
- Show header above the related posts in content filter<\/li>\n<\/ul>\n\n
1.5.0<\/h4>\n\n\n- 2014-05-07<\/li>\n
- Remember tab after submit<\/li>\n<\/ul>\n\n
1.4.9<\/h4>\n\n\n- 2014-05-05<\/li>\n
- Better naming of variables<\/li>\n<\/ul>\n\n
1.4.8<\/h4>\n\n\n- 2014-05-02<\/li>\n
- Add a filter for the content, with an option to use it<\/li>\n
- Option page now uses tabs<\/li>\n
- Update nl_NL<\/li>\n<\/ul>\n\n
1.4.7<\/h4>\n\n\n- 2014-04-18<\/li>\n
- No need to add explicit support<\/li>\n
- Rewrite save function, meta_key gets deleted correctly now<\/li>\n<\/ul>\n\n
1.4.6<\/h4>\n\n\n- 2014-04-15<\/li>\n
- Support Widget Customizer in 3.9<\/li>\n<\/ul>\n\n
1.4.5<\/h4>\n\n\n- 2014-03-23<\/li>\n
- Cleanup duplicate code<\/li>\n<\/ul>\n\n
1.4.4<\/h4>\n\n\n- 2014-03-22<\/li>\n
- Add settings link to main plugin page<\/li>\n<\/ul>\n\n
1.4.3<\/h4>\n\n\n- 2014-03-18<\/li>\n
- Also delete just added post<\/li>\n<\/ul>\n\n
1.4.2<\/h4>\n\n\n- 2014-02-14<\/li>\n
- Fix post update on wp_update_post()<\/li>\n<\/ul>\n\n
1.4.1<\/h4>\n\n\n- 2013-12-17<\/li>\n
- Update nl_NL<\/li>\n<\/ul>\n\n
1.4<\/h4>\n\n\n- 2013-12-13<\/li>\n
- Now includes a widget<\/li>\n<\/ul>\n\n
1.3.2<\/h4>\n\n\n- 2013-12-07<\/li>\n
- Move styling to stylesheet<\/li>\n<\/ul>\n\n
1.3.1<\/h4>\n\n