=== Related Posts Thumbnails Plugin for WordPress ===
Contributors: hiddenpearls, WPBrigade
Donate link: https://wpbrigade.com/
Tags: easy related posts, Related Posts thumbnails, Free Related Posts, related posts, similar related posts
Requires at least: 3.6
Tested up to: 6.1
Stable tag: 2.1.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Related Posts by WPBrigade is The Best Customizable plugin, that nicely displays related posts thumbnails under the post.
== Description ==
**[Related Posts by WPBrigade](https://wpbrigade.com/wordpress/plugins/related-posts/?utm_source=related-posts-lite&utm_medium=readme&utm_campaign=pro-upgrade-rp)** will add related posts thumbnails after the post. This Related Posts Plugin allows to customize thumbnail sizes, display settings and type of relation.
By default it uses generated by WordPress thumbnail for the first image appeared in the post, that was uploaded on the server with sizes as set in Media settings. You can select between 'thumbnail' and 'medium' size options. In addition if your theme supports Post Thumbnails feature introduced in WordPress 2.9 you can specify custom thumbnail size. You can also specify post custom field name to be used as thumbnails source.
Thumbnails are arranged in columns under the post with related posts title/excerpt under each post thumbnail. Colors of background, border, text, text sizes, background on mouse over, title and excerpt length can be customized. See screenshot.
You can specify number of related posts to display, start date, categories to show on and to include, top text, style settings, default image URL. You can select type of relation - categories, tags, categories and tags, random or custom taxonomies. You can specify where to display related posts - choose page type (main or single), post type and select categories. You can turn off automatic appending to the end of post and use **<?php get_related_posts_thumbnails(); ?>** php tag in the Loop of your theme. Related Posts thumbnails sidebar widget is also available. You can use [related-posts-thumbnails] shortcode in the post body.
** This Related Posts plugin has Gutenberg block **
Contributions:
* Thanks to Adnan for giving life to this plugin.
Translations:
* This plugin has Russian version
* Thanks to Li-An this plugin has French version
* Thanks to Gidibao this plugin has Italian version
* Thanks to Kuzu this plugin has Turkish version
* Thanks to Mirko this plugin has German version
* Thanks to Bejana for Indonesian translation
Related Links:
* Plugin Homepage - see possible problems and solutions.
* Rebrand your WordPress login page with LoginPress
== Installation ==
1. Extract zip in the /wp-content/plugins/ directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. Customize plugin settings at menu Related Posts. Find it at the left bottom of the side menu in wp-admin.
== Frequently Asked Questions ==
= How does this plugin decide which image to use as post thumbnail? =
If your theme supports WordPress Posts Thumbnail feature and post has a specified Post Thumbnail as seen on Edit Post page, when this image will be used as a post thumbnail in related posts. The size of the image is determined by plugin setting 'Post-thumbnails name'.
If your theme does not support Post Thumbnail feature or post has no assigned thumbnail, when the first image on the post will be used as a thumbnail.
= Does plugin support external images, e.g. uploaded on Flickr? =
There is no direct support of external images in the current version of the plugin. You can use custom field option. Or you can use https://wordpress.org/extend/plugins/generate-post-thumbnails/ or similar plugin to save external images as post thumbnails.
= What is the default image URL? =
If there are no images of the specified size in the post, or file does not exist on the server the default image will be used as a post thumbnail. You can upload your image on server and specify its URL in plugin settings.
== Screenshots ==
1. Related Posts Gutenberg Block
1. Plugin in action
1. Plugin settings page
== Upgrade Notice ==
= 2.1.0 =
* Upgrade immediately.
== Changelog ==
= 2.1.0 - 2023-01-10 =
* BugFix: ACF field with image object, URL or ID field.
* Compatibility : Compatible with WordPress 6.1
= 2.0.3 - 2022-07-06 =
* BugFix: Custom field compatible with images object or URL field.
* Compatibility : Compatible with WordPress 6.0
* Compatibility : Compatible with PHP 8.1
= 2.0.2 - 2022-04-19 =
* BugFix: PHP Warning on Gutenberg block.
= 2.0.1 - 2022-04-18 =
* BugFix: The image wasn't displaying with {custom field name} setting.
* Enhancement: Code refactoring.
= 2.0.0 - 2022-03-22 =
* New Feature: Introducing date feature with 7 type of date format.
* Enhancement: Added a filter `rpt_custom_relationship` to get posts from multiple custom post types with same term slug.
* Compatibility : Compatible with WordPress 5.9.2
= 1.9.2 - 2022-02-18 =
* Bugfix: Border style issue.
* Enhancement: Added a filter `relpost_anchor_attr` to extend the HTML attributes within the related posts thumbnails anchor tag.
* Compatibility : Compatible with WordPress 5.9
= 1.9.1 - 2021-04-08 =
* Bugfix: Mobile view layout.
* New Feature : Introducing Lazy Loading filter. Use `rpt-lazy-loading` filter to enable the lazy loading for thumbnails. By default it's false.
* Compatibility : Compatible with PHP 8.0
= 1.9.0 - 2021-03-22 =
* New Feature : Filter to add custom sizes of thumbnails to choose from.
* New Feature : added 'rpt_exclude_post' filter to exclude posts from showing as Related Posts.
* Enhancement : Shortcode attribute to exclude posts from showing as Related Posts.
* Compatibility : Compatible with WordPress 5.7
= 1.8.3 - 2020-03-21 =
* New Feature : Filter for related posts background image.
* New Feature : Add option to disable related posts on mobile.
= 1.8.2 - 2019-10-16 =
* New Feature : Filter for related post top text.
* New Feature : Filter to prevent image size check on inner post images.
* New Feature : Filter to prevent related posts on builders.
* New Feature : Filter to remove related post with empty custom field.
= 1.8.1 - 2019-06-25 =
* Bug Fix : Thumbnails are not showing when post thumbnail source is selected.
= 1.8.0 - 2019-06-25 =
* New Feature : Added AMP support.
* New Feature : Filter to disable related posts on AMP.
* New Feature : Filter to style list for related posts on AMP.
* Refactor : Remove unused assets for gutenberg block.
* Bug Fix : Fix query for sorting latest posts.
* Bug Fix : Fix empty vairable check on custom field.
= 1.7.2 - 2019-06-10 =
* Bug Fix : Sorting issue when latest posts option selected.
= 1.7.1 - 2019-05-27 =
* Bug Fix : Compatibility issue with php 5.3 in newly Gutenberg block.
= 1.7.0 - 2019-05-24 =
* New Feature : Added Gutenberg block for Related posts.
* Bug Fix : Empty container class name.
* Bug Fix : Unable to show related posts on empty custom field.
* Compatibility : Compatible with WordPress 5.2
= 1.6.6 - 2019-03-18 =
* Enhancement : Add `posts_number` & `posts_sort` attributes in [related-posts-thumbnails] shortcode.
* Compatibility : Compatible with WordPress 5.1
* Enhancement : Compatible with PHP 7.3
= 1.6.5 - 2018-06-14 =
* Bug Fix : Last update broke layout because of direct function usage in templates.
= 1.6.4 - 2018-06-06 =
* Feature : Add sort by option for Related Posts.
* Enhancement : Add class attribute in list styling, if someone wants to style list Related Posts.
* Enhancement : Move thumbnails source option to its own section.
* Enhancement : Minor style changes in settings page.
* Bug Fix : Fonts are unable to change in list output style.
* Bug Fix : Unclosed div making layout break.
* Bug Fix : Left content alignment is breaking layout.
* Bug Fix : Content of alt tag of Related Posts image is breaking layout.
= 1.6.3 - 2018-03-26 =
* Feature : Multilingual Compatible. All text is now translateable.
* Feature : Add filter to left, right or center align Related Posts.
* Feature : Add filter to change priority of Related Posts under posts content.
* Enhancement : Add ALT tag in Related Posts thumbnails.
* Enhancement : Replace input types of some fields form text to number.
* Enhancement : Replace default image URL to gallery image selection.
* Enhancement : Replace some ambiguous field's titles with more clear titles.
* Bug Fix : Fix the undefined index notice on widget title.
* Bug Fix : Fix the image issue in widget.
* Bug Fix : Fix the image issue in thumbnails of Related Posts.
= 1.6.2 - 2018-02-27 =
* Feature : Change inline style to class.
* Feature : Add RTL support.
* Bug Fix : Undefined variable on shortcode.
* Bug Fix : Fix encoding tag on excerpt.
* Enhancement : Add color picker on color settings.
* Enhancement : Add date picker on date settings.
= 1.6.1 =
* BugFix: Center align output and image.
= 1.6.0 =
* Compatible with 4.8
* Multiple bugfixes
= 1.5.4 =
* Fixed Category Settings bug.
= 1.5.3 =
* [BugFix] Improved.
= 1.5.2 =
* [BugFix] Top Text title allows h1 to h6 tags now.
= 1.5.1 =
* [BugFix] Removed deprecated constructors for Related Posts widget. Compatible with PHP 7.0
= 1.5.0 =
* Major UI changes for admin settings and compatibility with WP 4.5
= 1.4.0 =
* compatibility with WP 4.4
= 1.3.1 =
* backwards compatibility with WP 2.9
= 1.3 =
* Added support of custom post types and custom taxonomies
* Added multibyte strings support
* Fixed a bug with double quotes in title
* Fixed a bug with stripping shortcodes
* Added Indonesian translation
= 1.2.9 =
* Fixed bug: when not all categories selected and tags only, wrong behavior
* Optimized performance
* Searching for post thumbnail in post body if no assigned Featured Image was set
* Added possibility to show only posts with thumbnails for themes, that support Post Thumbnails
* Removed filter, responsible for image existence
= 1.2.8 =
* Fixed bug, if category has 1 post and relation is based on categories, than no posts will be shown
* Font-family can have quotes in settings
* Added Turkish and German versions
= 1.2.7 =
* Added clean HTML option without plugin CSS, fixed background color change
= 1.2.6 =
* Fixed relative custom url
= 1.2.5 =
* Fixed selection of categories on plugin settings page
= 1.2.4 =
* French version updated
= 1.2.3 =
* Added option to set theme php resizing script
= 1.2.2 =
* Improved plugin performance with high number of posts
* PHP configuration allow_url_fopen is taken into account
* Added start date to exclude old posts
* Fixed display, only posts now
* Separated categories - which are displayed amoung thumbnails and on which thumbnails are displayed
* Random relation, for random posts display
* PHP 4.3 compatible now according to Wordpress requirements
* tested with Wordpress 3.0
= 1.2.1 =
* Thanks to Li-An it now has French version.
* Excerpts will be generated if no excerpt were defined.
* Developer mode to see debugging info in HTML source.
= 1.2 =
* added php tag for use in theme
* added option to turn off automatic appending
* set title length 0 for no title
* added excerpt
* added sidebar widget
* added shortcode
= 1.1.1 =
* removed PHP warning on settings page somebody may experience
* full HTML support in top text field
= 1.1 =
* removed PHP warnings for getimagesize and file if wrong header was received
* fixed Categories and Tags confusion (when you selected Categories relation was based on Tags and vice versa)
* added Categories option to select specific categories
* added post custom field name option as a source for thumbnails
= 1.0 =
* Released plugin initial version