Contextual Related Posts

Release post: https://webberzone.com/blog/contextual-related-posts-v3-3-0/

• Features:

  • Related posts block allows you to set a custom header above the related posts. Leave blank to get the one from the main settings page.
  • New option "Related Meta Keys" under the List Tuning tab. You can enter a comma-separted list of meta keys. Posts that match the same value of the meta key are displayed before the other related posts.

• Enhancements/modifications:

  • If the number of "Manual related posts" is greater than the number of related posts, then the database query is bypassed drastically improving perfomance
  • Moved Related Posts Tools page under Tools menu
  • Related Posts block is now wrapped in Disabled tags to prevent accidental clicking of links in the block editor

• Bug fixes:

  • Thumb width and height defaults to 150 in case the settings are missing
  • Setting the style to be text_only didn't enforce no thumbnail

• Developer:

  • New filters: crp_query_date_query, crp_query_meta_query, crp_query_meta_query_relation

Release post: https://webberzone.com/blog/contextual-related-posts-v3-2-0/

• Enhancements:

  • Block shows a placeholder when used in non-Edit screens or when no content is generated

• Bug fix:

  • Missing text-only.min.css file
  • Block settings were not saved

Release post: https://webberzone.com/blog/contextual-related-posts-v3-2-0/

• Bug fix:
  • Widget options were not saved properly
  • Stylesheets and header styles have been fixed to be more specific

Release post: https://webberzone.com/blog/contextual-related-posts-v3-2-0/

• Enhancements/modifications:

  • If thumbnail is set as text only, then the style is also set as text only at runtime

• Bug fix:

  • PHP error thrown when using get_crp_posts_id()

• Deprecated:

  • get_crp_posts_id(). Use get_crp_posts() instead

Release post: https://webberzone.com/blog/contextual-related-posts-v3-2-0/

• New feature:

  • New option to limit posts to the primary category/term. The plugin checks if either Yoast, Rank Math, The SEO Framework or SEOPress are active. If none of these are active, the plugin will pick the first category provided by get_the_terms()
  • New option to show the primary category/term
  • New option in metabox to enter a comma-separated list of post IDs to exclude from the related posts
  • New filter crp_fill_random_posts (default:false) which can be used to fill random posts if the number of related posts is less than the limit set

• Enhancements/modifications:

  • No widget is displayed if get_crp() is empty i.e. no related posts are found
  • post_title and post_content fields are only used if Use content option is set
  • Gutenberg block updated to the latest Blocks API
  • The widget's "Only from categories" autocomplete replaced by ID list
  • Wrapper div now always includes crp_related class name. Stylesheets have been updated to have more specific styles e.g. .crp_related.crp-rounded-thumbs
  • Exclude categories and Exclude on categories renamed to Exclude terms and Exclude on terms as they now support all taxonomies and the accepted format has changed to "Term Name (taxonomy:term_taxonomy_id)"

• Bug fixes:

  • Current post was incorrectly being excluded in the translation functions

Release post: https://webberzone.com/blog/contextual-related-posts-v3-1-0/

• Enhancements:

  • Don't clear cache when saving settings. The cache can be cleared in the Tools page
  • Default thumbnail is now prioritized over the site icon

• Bug fixes:

  • Limiting of characters didn't work properly
  • Fixed link to Tools menu under Settings. Tools button link is better displayed
  • Fixed activation when new blog is created on multisite

Release post: https://webberzone.com/blog/contextual-related-posts-v3-1-0/

• Features:

  • REST API support - you can now fetch the related posts via the REST API. Fetch posts at /contextual-related-posts/v1/posts/<id>
  • New setting in the metabox to exclude specific terms

• Enhancements/modifications:

  • Thumbnail function uses the size instead of exact array of sizes to better select the appropriate thumbnail image size
  • Use site icon if no other thumbnail is found
  • Use both post_title and post_content fields for matching even when match content setting is off
  • Passing post_type and posts_per_page arguments will be respected instead of being overridden

• Bug fixes:

  • Don't enqueue wp-editor on widgets.php
  • WP_Query stopwords are stripped from content that is matched
  • Manual posts are added after the automatic posts are shuffled

Release post: https://webberzone.com/blog/contextual-related-posts-v3-0-0/

• Bug fix:
  • Replicate old style of exclusion checking of option set in meta. Using the shortcode, manual or block will ignore the meta option to "Disable Related Posts display"

Release post: https://webberzone.com/blog/contextual-related-posts-v3-0-0/

• Enhancement:

  • Defining CRP_CACHE_TIME to false will disable expiry
  • Introduced wpml-config.xml file. Title and Custom text for blank output can now be translated with Polylang (and potentially WPML)

• Bug fix:

  • Exclude on categories did not work
  • Posts would trigger a "SHOW FULL COLUMNS FROM" error if they had ' from' in the title
  • Manual posts did not work properly - all post types and all posts are properly fetched now

Release post: https://webberzone.com/blog/contextual-related-posts-v3-0-0/

• Bug fix:
  • Certain posts would trigger a "SHOW TABLES LIKE" error
  • Forced .crp_related figure margin to 0

Release post: https://webberzone.com/blog/contextual-related-posts-v3-0-0/

• Enhancement/Modifications:
  • include_cat_ids and exclude_categories will also accept custom taxonomy term_taxonomy_ids
  • Thumbnail's img tag is wrapped in <figure>
  • Remove extra checking for exclude_categories in get_crp
  • Optimise deleting of cache entries when updating a post - post saving should be significantly faster

Release post: https://webberzone.com/blog/contextual-related-posts-v3-0-0/

• Enhancement/Modifications:

  • Grid style minimum width is now decided by the width of the thumbnail and long words are wrapped

• Bug fixes:

  • Selecting No style created a 404 error
  • Fixed issue with $attachment_id not being declared in some cases

• Bug fixes:
  • Fixed issue where Related Posts newer than was set to 0 caused no posts to display
  • Use the original arguments when setting the cache key for CRP_Query
  • Selecting "Blank Output" didn't work

• Bug fixes:
  • Fixed issue with help tab that broke some sites

Release post: https://webberzone.com/blog/contextual-related-posts-v3-0-0/

• Features:

  • New CRP_Query class for fetching related posts. This replaces get_crp_posts_id() which will be deprecated in a future version
  • CRP Thumbnails now include the loading="lazy" attribute added in WordPress 5.5
  • New parameter more_link_text that can be passed to get_crp() which holds the "read more". Recommended option to customize the more link text using the filter crp_excerpt_more_link_text or the more link element using crp_excerpt_more_link
  • Three new styles: "Masonry" (like Pinterest), "Grid" and "Rounded thumbnails with CSS grid". Might not work with older browsers
  • Imported settings of Related Posts by Categories and Tags. That plugin is now deprecated with this release.

• Enhancement/Modifications:

  • If WPML or PolyLang are active, get_crp_posts_id() and CRP_Query will return the translated set of post IDs and external processing is no longer needed
  • Use wp_img_tag_add_srcset_and_sizes_attr() to generate srcset and sizes attributes. The original code to display the srcset and sizes attributes will continue to be used
  • Improved caching with inbuilt expiry. Use CRP_CACHE_TIME in your wp-config.php to set how long the cache should be set for. Default is one month
  • CRP_MAX_WORDS has been reduced to 100
  • Dropped the need for FULLTEXT index on post_content which should save some database space
  • Deprecated the following filters: get_crp_posts_id, crp_posts_now_date, crp_posts_from_date, crp_posts_fields, crp_posts_join, crp_posts_where, crp_posts_groupby, crp_posts_having, crp_posts_orderby, crp_posts_limits, get_crp_posts_id_short_circuit

• Bug fixes:

  • In the settings page, only built-in taxonomies were being incorrectly displayed
  • If "before list item" is empty, then the output was blanked out
  • Settings help has been fixed
  • crp_get_option would return an incorrect value if $crp_settings global variable was not set

Release post: https://webberzone.com/blog/contextual-related-posts-v2-9-3/

• Bugs:
  • Fixed nonce verification not always done in Import/Export interface. Thanks to Lenon Leite

Release post: https://webberzone.com/blog/contextual-related-posts-v2-9-3/

• Features:

  • New constant CRP_VERSION to hold the current version of the plugin
  • New setting to delete FULLTEXT indices on deactivation

• Enhancements:

  • Added the $args attribute to the filters in main-query.php

Release post: https://webberzone.com/blog/contextual-related-posts-v2-9-0/

Bug fixes: * Password protected posts will no longer show the excerpt

Release post: https://webberzone.com/blog/contextual-related-posts-v2-9-0/

Bug fixes: * Custom CSS box would not save and get cleared out when saving settings

Release post: https://webberzone.com/blog/contextual-related-posts-v2-9-0/

• Features:

  • New section under Settings > Related Posts > Tools to export and import settings. Best option if you'd like the same configuration across multiple WordPress sites
  • New shortcode setting include_cat_ids to limit top posts to selected categories/taxonomies. Use a comma separated list of term_taxonomy_id
  • New setting in widget to only include certain categories. Doesn't work with custom taxonomies

• Enhancements:

  • New function: crp_get_thumb_size() to get the correct size of the thumbnail
  • Only run a get_post query if only the post ID is passed to crp_get_the_post_thumbnail()
  • $match_fields parameter added to crp_posts_match filter
  • Updated WPML functions to use latest filters
  • Admin scripts are no longer loaded into the head - but using a separate JavaScript file
  • Implemented CodeMirror to format custom styles box
  • New filters get_crp_short_circuit and get_crp_posts_id_short_circuit to bypass outputs and queries
  • CRP_MAX_WORDS has been reduced from 500 to 250 to avoid "Too many words" mySQL error
  • The link to the Contextual Related Posts link is no longer a list item but a smaller text paragraph below the items. You can turn this on by enabling Show Credit.

• Bug fixes:

  • Fixed errors created when trying to fetch a featured image or scanned images with remote links
  • Saving categories fields in the settings page uses str_getcsv and a custom function crp_str_putcsv

Release post: https://webberzone.com/blog/contextual-related-posts-v2-8-0/

• Features:

  • New block for Gutenberg aka the block editor. The block is called Related Posts [CRP] and you can find it under the widgets category
  • Two new settings in the widget: Order posts and Randomize order that allows the global setting to be overridden
  • New setting called Keyword in the Meta box where you can enter a word or a phrase to find related posts. If entered, the plugin will continue to search the post_title and post_content fields but will use this keyword instead of the values of the title and content of the source post

• Enhancements:

  • Show author, Show date, Show post excerpt and Post thumbnail settings will show a message that they cannnot be modified in case the Rounded thumbnails or No text styles are selected

• Bug fixes:

  • Selecting date order now orders the related posts by newest first
  • Fixed PHP warning in the widget
  • Stop using current_time( 'timestamp' )
  • Fixes incorrect thumbnail image displayed for attachments in the related posts list

Release post: https://wzn.io/2XUCur8

• Features:

  • Caching improvements: "Enable cache" has been renamed to "Cache HTML output". New option "Cache posts only" has been introduced to cache the output of the database query (array of posts)
  • New option to order posts by relevance, dates or randomly
  • New option to limit posts by the same author
  • Thumbnail HTML markup includes srcset and sizes attributes when available. Read Responsive Images in WordPress 4.4

• Enhancements:

  • No longer use get_the_title. You can use crp_title and/or crp_thumb_title filters to edit the post title and the alt/title attributes of the thumbnail respectively
  • Selecting Rounded thumbnails under Styles tab will allow your thumbnail setting to either be "inline before text" or "only thumbnails, no text"

Release post: https://wzn.io/2VrGdOR

• Enhancements:

  • Optimized versions of default.png and default2.png

• Bug fixes:

  • Fixed PHP error when viewing feed
  • "Exclude categories" setting wouldn't save properly
  • Delete any deprecated settings on save should work properly
  • Clearer messages when saving options and a style is activated

Release post: https://wzn.io/2K2ohWB

• Bug fixes:
  • Fixed PHP fatal error "Cant use function return value in write context"
  • Changed default setting for thumbnail width and height to 150

Release post: https://wzn.io/2K2ohWB

• Features:

  • New options to delete options and/or data on uninstall. This will only work if you visit the Settings page and save the pages.

• Bug fixes:

  • Custom CSS code should now be properly added to the header
  • Upgrading settings when "Automatically add related posts to" had no options checked should work properly

Release post: https://wzn.io/2JZBZJy

• Features:

  • Implemented the Settings API for handling plugin settings
  • New Tools page: Recreate the indices, delete the cache and delete old settings

• Enhancements:

  • widget_title filter includes $instance and id_base variables

• Bug fixes:

  • Checked for non-zero thumbnail width and height in the widget
  • More checks for PHP errors and notices

• Features:

  • New option to disable creation of thumbnails

• Enhancements:

  • Do not delete index on activation
  • crp_thumbnail image size will set the default crop option to true if not already set

• Bug fixes:

  • Missing/Unknown PHP errors/warnings in the widget
  • Minor CSS fixes

• Features:

  • New option to disable related posts on mobile devices
  • New option to disable related posts on AMP pages

• Enhancements:

  • New filters crp_thumb_alt and crp_thumb_title to edit the post thumbnail alt and title tags. Use this to remove/replace the tags
  • New function and filter crp_permalink
  • Saving a post will delete its cache

• Bug fixes:

  • Fixed CSS validation errors
  • Removed conversion of table schema from/to InnoDB. If you are using a version of mySQL above v5.6, you can alter the table engine to use InnoDB with a FULLTEXT index
  • Prevent errors from non-existent post id (virtual post). Contributed by @jnorell

• Bug fixes:
  • Reverted the "Automatically add related posts to" setting introduced in 2.4.0
  • Metaboxes will now save when editting attachments

• Features:

  • New option to randomize the related posts
  • New option to limit related posts to the same post type
  • "Automatically add related posts to" option applies to widgets

• Enhancements:

  • post_types argument now takes a comma-separated list of post types. Default format when resaving options is also comma-separated

• Bug fixes:

  • Trimming titles should now work with multibyte / non-English characters

• Deprecated:

  • crp_max_formatted_content has been deprecated. Use crp_trim_char instead

• Bug fixes:
  • Replaced .crp_title wrapper from div to span. Empty the cache via the settings page and also your browser cache

• Features:

  • Shortcode and the widget now have an added parameter for 'offset'. This is useful if you would like to display different widgets/shortcodes but not always start from the first post
  • New option in metabox: "Exclude this post from the related posts list"
  • New option: Insert after nth paragraph

• Enhancements:

  • The generated HTML code uses a single a href tag rather than two separate ones per item which is usually better for SEO. If you're not using the Rounded Thumbnail style and using your own custom style, then you might need to reconfigure this
  • New constant CRP_MAX_WORDS (default 500) limits the post content to be compared. Add this to your wp-config.php file to overwrite

• Bug fixes:

  • Language files initialisation had the wrong text domain
  • Stop updating the thumb settings if the existing value isn't found. Caused incorrect changes in certain installations
  • Force link text to white when using Rounded Thumb style
  • The plugin will no longer generate any notices if post author is missing

• Deprecated:

  • Removed wick for exclude categories auto-suggest. Plugin now uses jQuery Suggest that is included in WordPress. When you re-save plugin options, the field will convert the slugs to the category name
  • Deprecated $crp_url. Use the new constants CRP_PLUGIN_DIR, CRP_PLUGIN_URL and CRP_PLUGIN_FILE

• Enhancements:

  • Changed text domain to contextual-related-posts in advance of translate.wordpress.org translation system
  • Improved support for WPML. If available, same language posts will be pulled by default. To restrict to the same language add this code to your theme's functions.php file
  • Removed id tag from related posts HTML output to make it W3C compliant. If you're using the id with your custom styles, please change this to classes i.e. change #crp_related to .crp_related and it should work

• Bug fixes:

  • All cache entries were not deleted on uninstall

• Features:

  • Preliminary support for WPML

• Enhancements:

  • Recreate Index and Activation will not try to alter the table engine if not needed

• Bug fixes:

  • All thumbnail classes were not properly applied + new thumbnail class filter
  • Shortcode with "exclude_categories" argument works again

• Bugfixes:
  • "No styles" would not get selected if "Rounded thumbnails' was enabled
  • "Recreate Index" caused a fatal error: Call to undefined function crp_single_activate()
  • Excerpt shortening was not working correctly
  • Exclude categories wasn't working in some cases
  • Additional check to see if default styles are off, then force No style

• Features:

  • Manual posts can now be set in the meta box in the Edit Post screens which will be displayed before the related posts fetched by the plugin
  • Choose between No style, Rounded thumbnails (previously called default style) and Text only style options under the Styles box in the plugin settings page
  • Option to turn off the Contextual Related metabox on Edit Posts screens or limit it to Admins only. Also applies to Pages and Custom Post Types
  • Filter crp_link_attributes that allows a user to add or remove attributes for the a tag
  • Notice is displayed at the top of the Settings page if there are any missing of the FULLTEXT indices missing
  • Option in the Contextual Related Posts meta box to disable the related posts on the selected post
  • Select post type in the Related Posts Widget

• Enhancements:

  • Optimised number of queries for exclude categories option. Those not using this option will see the greatest savings
  • Select a pre-built thumbnail size will automatically update the width, height and crop settings. The default style will no longer enforce the 150x150 thumbnail size.
  • strict_limit argument in get_crp_posts_id is now TRUE by default
  • get_crp takes an additional argument: heading (default is TRUE) that controls the display of the main heading (Related Posts)
  • Output of echo_crp will be cached in a separate meta key

• Bugfixes:

  • First child now gets the correct thumbnail size

• Deprecated:

  • ald_crp() - Use get_crp() instead
  • ald_crp_content() - Use crp_content_filter() instead
  • ald_crp_rss() - Use crp_rss_filter() instead
  • echo_ald_crp() - Use echo_crp() instead

• Separate cache for feeds; Deprecated timthumb; Bug fixes and new features; Check the Changelog for a full list of changes.

=

• Modified: Settings page now clearly highlights what options cannot be changed if the default styles are enabled, i.e. thumbnail settings and no excerpt, author or date

=

• New multisite support; Thumbnails no longer need timthumb; HTTPS support for thumbnails; filters for mySQL query; Check the Changelog for a full list of changes.

=

• New multisite support; Thumbnails no longer need timthumb; HTTPS support for thumbnails; filters for mySQL query; Check the Changelog for a full list of changes.

=

• New Meta box on the Edit screens; Modifed match title algorithm; code cleanup and bug fixes; Check the Changelog for a full list of changes.

=

• Fixed: Add to feeds was broken in v1.9

=

• New default style, new option to prioritise the posts, exclude related posts on Custom Post types and more... Check out the Changelog for more details.

=

• Minor performance improvements + a fix for potential SQL vulnerability

=

• Fixed bugs in 1.8.10: Manual install caused a PHP error; Widget title showed %postname% instead of the Title; Refer the Changelog for more information

= 1.8.9.2 = * New features; Modified widget class to crp_related_widget; Updated timthumb; Modified format of author name that is displayed; Check the Changelog for more information

• New: Select between CSS or HTML attributes for thumbnail width and height; Add author to posts; More options in the widget; More cache control; Check the Changelog for more information

=

• New: Select between CSS or HTML attributes for thumbnail width and height; Add author to posts; More options in the widget; More cache control; Check the Changelog for more information

=

• New: Clear cache button and option to add the date before the post title

=

• IMPORTANT security update: Potential XSS vulnerability fixed. Thanks to Charlie Eriksen via Secunia SVCRP for reporting this

=

• New caching option; new function to return related posts; New shortcode; bug fixes and performance improvements Refer to Changelog for more information

=

• New options to open links in new window and add rel="nofollow"; quality setting for thumbnails when using timthumb; custom text for no related posts; new options for related posts in feeds; thumbnail height and width can be configured for widgets; Refer to Changelog for more information

=

• Exclude related posts on certain posts/pages, include related posts on home page and other archive pages, new timthumb version, miscellaneous fixes. Refer to Changelog for more information

=

• New widget support; performance improvements; use the excerpt; exclude posts / pages by page id.

=

• New widget support; performance improvements; use the excerpt; exclude posts / pages by page id.

=

• New widget support; performance improvements; use the excerpt; exclude posts / pages by page id.

=

• Added support for WordPress Custom Post Types, new Custom Styles tab, timthumb support. Please visit the Settings page to configure soon after upgrade.

=

• Fixed: Clash with YARPP

=

• Fixed: Donation link

=

• Fixed: Title attribute was missing for the thumbnails
• Modified: Reverted the output code to v1.6.5 style with img wrapped in its own a tag

=

• Fixed: Minor bug fix for location of thumbnail

• Added: Better thumbnail support
• Added: Limited support for InnoDB
• Modified: Cleaner Settings page interface

=

• Fixed: Few code tweaks to optimise MySQL performance
• Added: Dutch and Spanish language files

• Fixed: Undefined constants PHP errors

• Fixed: The plugin will now display a list of changes in the WordPress Admin > Plugins area whenever an update is available

• Turned the credit option to false by default. This setting won't effect current users.
• Turned off borders on post thumbnails. You can customise the CSS class "crp_thumb" to style the post thumbnail
• From the next version, the plugin will display update information in your WP-Admin

• Fixed: Custom output was not detecting styles properly
• Fixed: Incorrect XHTML code was being generated when using special characters in the post title

• New: The plugin extracts the first image in the post and displays that if the post thumbnail and the post-image meta field is missing
• New: Display excerpts in the list
• New: Credit link to the CRP page added. You can choose to turn this off, though I would appreciate if you leave it on.
• Updated: All parts of the list are now wrapped in classes for easy CSS customisation

• Fixed: Fixed display of post thumbnails using postmeta field

• Fixed: Numeric options were not being saved correctly

• Added an Option to display post thumbnails
• The output can be completely customised now

• Fixed: Using doublequotes in the title would mess up the screen
• Fixed: Errors when the mySQL index was being regenerated

• Added Italian and Danish languages
• Minor fix for text in the admin page

• Added complete localization support
• Added button to recreate the mySQL FULLTEXT index