{"id":24902,"date":"2013-09-21T17:00:36","date_gmt":"2013-09-21T17:00:36","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/super-simple-related-posts\/"},"modified":"2021-06-21T15:01:47","modified_gmt":"2021-06-21T15:01:47","slug":"super-simple-related-posts","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/super-simple-related-posts\/","author":8212610,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.5.4","stable_tag":"1.5.4","tested":"5.7.15","requires":"5.4","requires_php":"","requires_plugins":"","header_name":"Super Simple Related Posts","header_author":"MIGHTYminnow","header_description":"","assets_banners_color":"642b29","last_updated":"2021-06-21 15:01:47","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/mightyminnow.com","header_plugin_uri":"http:\/\/mightyminnow.com","header_author_uri":"http:\/\/mightyminnow.com","rating":4,"author_block_rating":0,"active_installs":50,"downloads":9898,"num_ratings":0,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.1":{"tag":"1.1","author":"McGuive7","date":"2013-11-07 21:04:55"},"1.2":{"tag":"1.2","author":"McGuive7","date":"2013-11-07 21:04:55"},"1.3":{"tag":"1.3","author":"McGuive7","date":"2014-06-25 19:43:48"},"1.4":{"tag":"1.4","author":"McGuive7","date":"2015-07-27 00:19:03"},"1.5":{"tag":"1.5","author":"McGuive7","date":"2016-02-06 06:54:12"},"1.5.1":{"tag":"1.5.1","author":"McGuive7","date":"2016-02-06 22:24:31"},"1.5.2":{"tag":"1.5.2","author":"McGuive7","date":"2016-02-15 19:19:32"},"1.5.3":{"tag":"1.5.3","author":"McGuive7","date":"2016-02-15 20:12:02"},"1.5.4":{"tag":"1.5.4","author":"aaronbmm","date":"2021-06-21 15:01:47"}},"upgrade_notice":{"1.5.3":"<ul>\n<li>Update faulty translation slugs.<\/li>\n<\/ul>","1.5.2":"<ul>\n<li>Remove duplicate plugin file.<\/li>\n<\/ul>","1.5.1":"<ul>\n<li>Remove debugging ID&#039;s appearing after post links.<\/li>\n<\/ul>","1.5":"<ul>\n<li>Add functionality to exclude duplicate posts that would otherwise be included across multiple taxonomy terms.<\/li>\n<li>Add in Grunt build for improved output.<\/li>\n<li>Improve translations.<\/li>\n<\/ul>","1.4":"<ul>\n<li>Add __() translation call for previously untranslated string.<\/li>\n<li>Updated .po\/.mo files.<\/li>\n<\/ul>","1.3":"<ul>\n<li>Added ability to include featured images<\/li>\n<\/ul>","1.2":"<ul>\n<li>Added shortcode functionality!<\/li>\n<li>Add ability to hide the title (hide_title).<\/li>\n<\/ul>","1.1":"<ul>\n<li>Added missing closting bracket } to main PHP file that was causing PHP end of file error and duplicated post type output.<\/li>\n<\/ul>","1.0":"<p>First Release<\/p>"},"ratings":{"1":"2","2":0,"3":"1","4":"2","5":"7"},"assets_icons":[],"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":776439,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":776439,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1","1.2","1.3","1.4","1.5","1.5.1","1.5.2","1.5.3","1.5.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":776438,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":776438,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"The Super Simple Related Posts widget.","2":"Sample output showing posts, pages, and custom post type 'Case Studies' related by Categories."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[89,529,166,2663,90],"plugin_category":[43,57],"plugin_contributors":[78526,78527],"plugin_business_model":[],"class_list":["post-24902","plugin","type-plugin","status-closed","hentry","plugin_tags-category","plugin_tags-content","plugin_tags-posts","plugin_tags-related","plugin_tags-tag","plugin_category-customization","plugin_category-taxonomy","plugin_contributors-mcguive7","plugin_contributors-mightyminnow","plugin_committers-aaronbmm","plugin_committers-mcguive7","plugin_committers-mightyminnow","plugin_support_reps-mightyminnow"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/super-simple-related-posts_642b29.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/super-simple-related-posts\/assets\/screenshot-1.png?rev=776438","caption":"The Super Simple Related Posts widget."},{"src":"https:\/\/ps.w.org\/super-simple-related-posts\/assets\/screenshot-2.png?rev=776438","caption":"Sample output showing posts, pages, and custom post type 'Case Studies' related by Categories."}],"raw_content":"<!--section=description-->\n<p>Super Simple Related Posts gives you both a widget and a shortcode to output lists of posts related to the current post. You get to decide how the posts are related (categories, tags, custom taxonomies), what to show (posts, pages, custom post types), and a whole lot more. The widget is configurable via <strong>Appearance &gt; Settings<\/strong> and more info on shortcode usage is provided below.<\/p>\n\n<p>A <a href=\"http:\/\/mightyminnow.com\"><strong>MIGHTYminnow<\/strong><\/a> plugin.<\/p>\n\n<h4>Features<\/h4>\n\n<p>There are tons of related posts plugins out there - here's why Super Simple Related Posts is special:<\/p>\n\n<ul>\n<li><p><strong>Speed<\/strong>\nUnlike other related posts plugins, Super Simple Related Posts is super fast. It doesn't run resource-intensive algorithms on your database and it doesn't bog down your server. If you're looking for a plugin that'll run through all your content and match related posts word-for-word, there are plenty of good ones out there. If you're looking for a simple, lightning-fast related posts plugin, you're in the right place.<\/p><\/li>\n<li><p><strong>Simplicity<\/strong>\nAs it's name implies, Super Simple Related Posts keeps things as straightforward as possible. This means that you get a simple widget with easily configurable settings to let you do what you gotta' do.<\/p><\/li>\n<\/ul>\n\n<h4>Settings<\/h4>\n\n<p>Whether you use widgets or shortcodes, you can easily configure Super Simple Related Posts with the following settings. These settings are directly configurable in each widget, and can also be controlled with attributes when using shortcodes (for more on shortcode settings, see the \"Shortcode\" section below).<\/p>\n\n<ul>\n<li><p><strong>Title<\/strong>\nThe title of your widget.<\/p><\/li>\n<li><p><strong>Hide Title<\/strong>\nGive you the ability to hide the widget title, particularly useful when using the shortcode.<\/p><\/li>\n<li><p><strong>Post Types<\/strong>\nThe post types you would like to output, and the order in which you want to display them. This works great with all custom post types.Note: you must specify at least one post type, otherwise no content will be output.<\/p><\/li>\n<li><p><strong>Show Posts Related By<\/strong>\nChoose the method by which you want to show related posts. You can choose categories, tags, or any custom taxonomy. This field automatically populates with all available possibilities.<\/p><\/li>\n<li><p><strong>Order By<\/strong>\nThe criteria by which to order the related posts (e.g., title, date created, author, date modified, etc).<\/p><\/li>\n<li><p><strong>Order<\/strong>\nAscending or descending - take your pick.<\/p><\/li>\n<li><p><strong>Number of Posts<\/strong>\nThe total number of posts you would like to show in each section.<\/p><\/li>\n<li><p><strong>What to do if there are no related posts<\/strong>\nChoose how you would like to handle the situations in which no posts are found. Either hide the contents or display a custom message.<\/p><\/li>\n<li><p><strong>Headings<\/strong>\nOptions to link and\/or hide post type and category\/tag\/taxonomy headings.<\/p><\/li>\n<li><p><strong>Before\/After HTML<\/strong>\nA handy feature to let you add custom HTML before and after the widget, in case you want any intro or concluding text.<\/p><\/li>\n<\/ul>\n\n<h4>Shortcode<\/h4>\n\n<p>In addition to using SSRP widgets, you can also use the <code>[ssrp]<\/code> shortcode. Here's an example:<\/p>\n\n<pre><code>[ssrp title=\"My Related Posts\" post_types=\"post, page\" number_of_posts=\"3\"]\n<\/code><\/pre>\n\n<p>Here is a list of the available shortcode attributes, which correlate to the settings listed above. Each attribute is listed along with its potential values in quotations, and any default values are listed in parenthesis.<\/p>\n\n<ul>\n<li><code>title=\"Any Text\"<\/code> (Related Posts)<\/li>\n<li><code>hide_title=\"1\"<\/code><\/li>\n<li><code>post_types=\"Comma-separated list of post type slugs, in order. E.g. post, page\"<\/code><\/li>\n<li><code>taxonomy=\"Taxonomy slug by which to detemine relatedness. E.g. tag\"<\/code> (category)<\/li>\n<li><code>orderby=\"title|name|date|modified|menu_order|author|ID|parent|rand|comment_count\"<\/code> (date)<\/li>\n<li><code>order=\"ASC|DESC\"<\/code> (DESC)<\/li>\n<li><code>number_of_posts=\"Any number\"<\/code> (-1, unlimited)<\/li>\n<li><code>include_featured_image=\"1\"<\/code><\/li>\n<li><code>exclude_duplicates=\"1\"<\/code><\/li>\n<li><code>no_posts_action=\"hide|message\"<\/code> (hide)<\/li>\n<li><code>no_posts_message=\"Any text\"<\/code> (No posts found)<\/li>\n<li><code>post_heading_links=\"1\"<\/code><\/li>\n<li><code>hide_post_type_headings=\"1\"<\/code><\/li>\n<li><code>term_heading_links=\"1\"<\/code><\/li>\n<li><code>hide_term_headings=\"1\"<\/code><\/li>\n<li><code>before_HTML=\"Any HTML\/text\"<\/code><\/li>\n<li><code>after_HTML=\"Any HTML\/text\"<\/code><\/li>\n<\/ul>\n\n<h4>Filters<\/h4>\n\n<p>Super Simple Related Posts also provides you with a handy set of filters you can use for your own development and customization:<\/p>\n\n<ul>\n<li><p><strong><code>ssrp_post_title( $post_title, $post_id )<\/code><\/strong>\nApplied to the title of each related post, within the surrounding <code>&lt;a&gt;&lt;\/a&gt;<\/code> tags.<\/p><\/li>\n<li><p><strong><code>ssrp_post_link( $post_link, $post_id )<\/code><\/strong>\nApplied to the linked title of each related post, outside the surrounding <code>&lt;a&gt;&lt;\/a&gt;<\/code> tags. This is useful for adding a prefix\/font-icon before the linked title.<\/p><\/li>\n<li><p><strong><code>ssrp_posts_list( $post_ul, $post_type_object, $taxonomy_term_object )<\/code><\/strong>\nApplied to the <code>&lt;ul&gt;<\/code> lists of related posts for a given custom post type and category\/tag\/taxonomy.<\/p><\/li>\n<li><p><strong><code>ssrp_taxonomy_term_heading( $taxonomy_term_name, $taxonomy_term_object )<\/code><\/strong>\nApplied to the category\/tag\/taxonomy term headings, within the surrounding <code>&lt;a&gt;&lt;\/a&gt;<\/code> tags if the headings are set to be linked.<\/p><\/li>\n<li><p><strong><code>ssrp_post_type_heading( $post_type_name, $post_type_object )<\/code><\/strong>\nApplied to the post type headings, within the surrounding <code>&lt;a&gt;&lt;\/a&gt;<\/code> tags if the headings are set to be linked.<\/p><\/li>\n<\/ul>\n\n<p>Banner photo by <a href=\"http:\/\/susannahkay.com\">Susannah Kay<\/a>.<\/p>\n\n<!--section=installation-->\n<h4>Manual Installation<\/h4>\n\n<ol>\n<li>Upload the entire <code>\/super-simple-related-posts-widget<\/code> directory to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate Super Simple Related Posts Widget through the 'Plugins' menu in WordPress.<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h3>1.5.4<\/h3>\n\n<ul>\n<li>Fix title sanitization function to prevent 500 error when saving the widget.<\/li>\n<\/ul>\n\n<h4>1.5.3<\/h4>\n\n<ul>\n<li>Update faulty translation slugs.<\/li>\n<\/ul>\n\n<h4>1.5.2<\/h4>\n\n<ul>\n<li>Remove duplicate plugin file.<\/li>\n<\/ul>\n\n<h4>1.5.1<\/h4>\n\n<ul>\n<li>Remove debugging ID's appearing after post links.<\/li>\n<\/ul>\n\n<h4>1.5<\/h4>\n\n<ul>\n<li>Add functionality to exclude duplicate posts that would otherwise be included across multiple taxonomy terms.<\/li>\n<li>Add in Grunt build for improved output.<\/li>\n<li>Improve translations.<\/li>\n<\/ul>\n\n<h4>1.4<\/h4>\n\n<ul>\n<li>Add __() translation call for previously untranslated string.<\/li>\n<li>Updated .po\/.mo files.<\/li>\n<\/ul>\n\n<h4>1.3<\/h4>\n\n<ul>\n<li>Added ability to include featured images<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Added shortcode functionality!<\/li>\n<li>Add ability to hide the title (hide_title).<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Added missing closting bracket } to main PHP file that was causing PHP end of file error and duplicated post type output.<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>First release<\/li>\n<\/ul>","raw_excerpt":"A super simple widget to output related posts based on categories, tags, or custom taxonomies.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/24902","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=24902"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mcguive7"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=24902"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=24902"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=24902"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=24902"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=24902"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=24902"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}