{"id":25812,"date":"2013-10-22T21:00:13","date_gmt":"2013-10-22T21:00:13","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/magadanski-similar-posts\/"},"modified":"2022-07-07T14:28:03","modified_gmt":"2022-07-07T14:28:03","slug":"magadanski-similar-posts","status":"publish","type":"plugin","link":"https:\/\/kea.wordpress.org\/plugins\/magadanski-similar-posts\/","author":7437790,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.3.4","stable_tag":"1.3.4","tested":"6.0.0","requires":"5.0","requires_php":"","requires_plugins":"","header_name":"M Similar Posts","header_author":"Georgi Popov a.k.a. Magadanski_Uchen","header_description":"","assets_banners_color":"6990dc","last_updated":"2022-07-07 14:28:03","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/buy-me-a-beer.magadanski.com\/project\/magadanski-similar-posts\/","header_plugin_uri":"http:\/\/wordpress.org\/plugins\/magadanski-similar-posts\/","header_author_uri":"http:\/\/magadanski.com\/","rating":5,"author_block_rating":0,"active_installs":10,"downloads":10242,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0":{"tag":"1.0","author":"magadanski_uchen","date":"2013-10-22 21:18:45"},"1.0.1":{"tag":"1.0.1","author":"magadanski_uchen","date":"2013-10-22 21:47:48"},"1.0.2":{"tag":"1.0.2","author":"magadanski_uchen","date":"2013-10-23 20:51:42"},"1.0.3":{"tag":"1.0.3","author":"magadanski_uchen","date":"2013-10-24 19:27:53"},"1.0.4":{"tag":"1.0.4","author":"magadanski_uchen","date":"2013-10-24 19:30:26"},"1.0.5":{"tag":"1.0.5","author":"magadanski_uchen","date":"2013-10-30 09:50:57"},"1.0.6":{"tag":"1.0.6","author":"magadanski_uchen","date":"2013-10-30 16:15:24"},"1.0.7":{"tag":"1.0.7","author":"magadanski_uchen","date":"2013-12-24 12:38:40"},"1.1":{"tag":"1.1","author":"magadanski_uchen","date":"2014-03-29 10:33:49"},"1.1.1":{"tag":"1.1.1","author":"magadanski_uchen","date":"2014-03-29 10:42:35"},"1.1.2":{"tag":"1.1.2","author":"magadanski_uchen","date":"2014-04-23 08:41:23"},"1.1.3":{"tag":"1.1.3","author":"magadanski_uchen","date":"2014-04-23 08:55:29"},"1.1.4":{"tag":"1.1.4","author":"magadanski_uchen","date":"2014-05-24 12:28:39"},"1.1.5":{"tag":"1.1.5","author":"magadanski_uchen","date":"2014-09-07 18:30:33"},"1.1.6":{"tag":"1.1.6","author":"magadanski_uchen","date":"2014-09-24 18:35:45"},"1.2":{"tag":"1.2","author":"magadanski_uchen","date":"2014-12-29 20:19:15"},"1.2.1":{"tag":"1.2.1","author":"magadanski_uchen","date":"2015-04-11 07:45:44"},"1.2.2":{"tag":"1.2.2","author":"magadanski_uchen","date":"2016-04-16 19:58:28"},"1.2.3":{"tag":"1.2.3","author":"magadanski_uchen","date":"2016-08-28 07:41:58"},"1.2.4":{"tag":"1.2.4","author":"magadanski_uchen","date":"2016-09-10 17:59:42"},"1.3.0":{"tag":"1.3.0","author":"magadanski_uchen","date":"2020-03-26 16:28:26"},"1.3.1":{"tag":"1.3.1","author":"magadanski_uchen","date":"2020-03-26 16:28:47"},"1.3.3":{"tag":"1.3.3","author":"magadanski_uchen","date":"2020-04-05 14:23:20"},"1.3.4":{"tag":"1.3.4","author":"magadanski_uchen","date":"2022-07-07 14:28:03"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"2"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":1493834,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":1493834,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":1493834,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":1493834,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"magadanski\/similar-posts":{"name":"magadanski\/similar-posts","title":"Similar Posts"}},"tagged_versions":["1.0","1.0.1","1.0.2","1.0.3","1.0.4","1.0.5","1.0.6","1.0.7","1.1","1.1.1","1.1.2","1.1.3","1.1.4","1.1.5","1.1.6","1.2","1.2.1","1.2.2","1.2.3","1.2.4","1.3.0","1.3.1","1.3.3","1.3.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":792041,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2268416,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2268416,"resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"

The options for the plugin's widget.<\/p>","2":"

The block in the Gutenberg editor.<\/p>","3":"

The Gutenberg Block settings.<\/p>"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[89,166,12268],"plugin_category":[],"plugin_contributors":[84795],"plugin_business_model":[],"class_list":["post-25812","plugin","type-plugin","status-publish","hentry","plugin_tags-category","plugin_tags-posts","plugin_tags-similar","plugin_contributors-magadanski_uchen","plugin_committers-magadanski_uchen"],"banners":{"banner":"https:\/\/ps.w.org\/magadanski-similar-posts\/assets\/banner-772x250.png?rev=1493834","banner_2x":"https:\/\/ps.w.org\/magadanski-similar-posts\/assets\/banner-1544x500.png?rev=1493834","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/magadanski-similar-posts\/assets\/icon-128x128.png?rev=1493834","icon_2x":"https:\/\/ps.w.org\/magadanski-similar-posts\/assets\/icon-256x256.png?rev=1493834","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/magadanski-similar-posts\/assets\/screenshot-1.png?rev=792041","caption":"

The options for the plugin's widget.<\/p>"},{"src":"https:\/\/ps.w.org\/magadanski-similar-posts\/assets\/screenshot-2.png?rev=2268416","caption":"

The block in the Gutenberg editor.<\/p>"},{"src":"https:\/\/ps.w.org\/magadanski-similar-posts\/assets\/screenshot-3.png?rev=2268416","caption":"

The Gutenberg Block settings.<\/p>"}],"raw_content":"\n

This plugin provides a list of similar \/ related entries to an article or a custom post type entry.<\/p>\n\n

This list could be added in the form of a:<\/p>\n\n

    \n
  1. Gutenberg Block<\/li>\n
  2. Shortcode<\/li>\n
  3. Widget<\/li>\n<\/ol>\n\n

    If you add a widget to the sidebar it will only appear when on the details view of an entry, as similarity cannot be calculated when on a list page of multiple entries.<\/p>\n\n

    The syntax for the shortcode is [magadanski-similar-posts id=\"\" post_type=\"\" taxonomy=\"\" limit=\"\"]<\/code><\/p>\n\n

    You can use the attributes as follows:<\/p>\n\n

      \n
    1. ID -- (integer<\/em>) the ID of the post you'd like to get similar posts for. Default value: the current post ID.<\/li>\n
    2. post_type -- (string<\/em>) the post type you'd like to query. Default value: \"post\".<\/li>\n
    3. taxonomy -- (string<\/em>) the taxonomy based on which you'd like to get similar items. Default value: \"category\".<\/li>\n
    4. limit -- (integer<\/em>) a maximum number of results you'd like to receive. Default value: 5.<\/li>\n<\/ol>\n\n

      The similarity is considered based on the number of common categories (or other taxonomy terms) for this post and the rest of the posts in your blog.<\/p>\n\n\n

      Download and activate the plugin. Go to Widgets and add the Similar Posts widget to a sidebar of your choosing.<\/p>\n\n\n

      \n

      How does the plugin determine whether two posts are similar?<\/h3><\/dt>\n

      It checks the categories assigned to this and other posts. The most similar post is considered the one with the most common categories.<\/p><\/dd>\n

      Does this work for tags too?<\/h3><\/dt>\n

      Yes, when inserting the widget you are allowed to chose between categories, tags or any custom taxonomy you have.<\/p><\/dd>\n

      Does this work for custom post types?<\/h3><\/dt>\n

      Yes, this works for pages, posts or any custom post type you have.<\/p><\/dd>\n

      Does this check the post's content too?<\/h3><\/dt>\n

      No, currently similarity is calculated only by shared taxonomy terms (categories, tags, etc).<\/p><\/dd>\n

      Is the plugin offered in my language?<\/h3><\/dt>\n

      The plugin is originally distributed in English and is also translated in Spanish and Bulgarian. In case you need it in some other language you can help with this on https:\/\/translate.wordpress.org\/<\/a><\/p><\/dd>\n\n<\/dl>\n\n\n

      1.3.4<\/h4>\n\n

      Add compatibility with WordPress 6.0.<\/p>\n\n

      1.3.3<\/h4>\n\n

      Remove some meaningless options in the \"Post Type\" dropdown field for the \"Similar Posts\" widget.<\/p>\n\n

      Dev: you can use the new msp_allowed_post_types<\/code> filter to add back any post types that may now be gone, but you consider them needed (for example some private post types for any reason).<\/p>\n\n

      1.3.2<\/h4>\n\n

      i18n enhancements for the Gutenberg block.<\/p>\n\n

      1.3.1<\/h4>\n\n

      Fix the issue where after updating the plugin to 1.3.0 the newly developed features and Gutenberg block were not available.<\/p>\n\n

      Plase update to 1.3.1 to get all these benefits.<\/p>\n\n

      1.3.0<\/h4>\n\n

      Add Gutenberg support. The included options allow you to chose a taxonomy and set a limit (upper boundary set to 10).<\/p>\n\n

      The block will appear as a plain unordered list. Future roadmaps can include the option to show is as a grid, also listing a featured thumbnail for the matching entries and\/or an excerpt.<\/p>\n\n

      1.2.4<\/h4>\n\n

      VisualComposer icon update to match latest branding of http:\/\/magadanski.com\/<\/a><\/p>\n\n

      Tested against WordPress version 4.6.1.<\/p>\n\n

      1.2.3<\/h4>\n\n

      Updates to allow translation via https:\/\/translate.wordpress.org\/<\/a><\/p>\n\n

      1.2.2<\/h4>\n\n

      Tested compatibility with WordPress 4.5 -- no issues registered.<\/p>\n\n

      1.2.1<\/h4>\n\n

      Bugfix: added missing return statement for public functions.<\/p>\n\n

      This is an absolutely safe to install update -- it won't break any of the existing functionality and you are encouraged to do so.<\/p>\n\n

      1.2<\/h4>\n\n

      Dev: The following filters have been added for some control over the generated list markup:<\/p>\n\n

      msp_similar_posts_list_tag -- by default this is `ul` but you can set it to `ol`.\n<\/code><\/pre>\n\n
      There are two more similar filters for this: msp_similar_posts_shortcode_tag<\/code> and msp_similar_posts_widget_tag<\/code>. As you may guess by the name, those allow to set the tag for only either the shortcode markup or the widget markup.<\/p>\n\n
      These secondary filters are executed after the main msp_similar_posts_list_tag<\/code>, so they can overwrite the value.<\/p>\n\n
      msp_similar_posts_list_classes -- this allows you to add\/edit\/remove classes for the list tag. By default only one class is present: \"msp-list\".\n<\/code><\/pre>\n\n
      There are two secondary filters for this as well: msp_similar_posts_shortcode_classes<\/code> and msp_similar_posts_widget_classes<\/code>.<\/p>\n\n
      1.1.6<\/h4>\n\n
      Dev: fix for notice -- missing \"global\" keyword for variable.<\/p>\n\n
      1.1.5<\/h4>\n\n
      Fix for widget bug to allow support for custom post types.<\/p>\n\n
      1.1.4<\/h4>\n\n
      Fix for improper regular expression for request SQL query modification.<\/p>\n\n
      1.1.3<\/h4>\n\n
      Dev: added msp_get_similar_posts()<\/code> shortcut function.<\/p>\n\n
      1.1.2<\/h4>\n\n
      Bugfix for showing the plugin widget on pages if necessary.<\/p>\n\n
      Fix for other potential issues.<\/p>\n\n
      1.1.1<\/h4>\n\n
      Internationalization updates.<\/p>\n\n
      Feel free to submit patches for updating Spanish translation or adding a new one.<\/p>\n\n
      1.1<\/h4>\n\n
      Added WPBakery Visual Composer<\/a> integration.<\/p>\n\n
      Fix: set_similar_id<\/code> uses current post's ID only if $id<\/code> argument is 0 AND similar_id<\/code> property is 0 too.<\/p>\n\n
      Dev: externalized get_post_types<\/code> and get_taxonomies<\/code> methods for Magadanski_Similar_Posts_Widget<\/code> widget as global helper functions prefixed msp_<\/code>:<\/p>\n\n