Cherry Trending Posts

Description

This plugin will allow you to track and display the most popular posts of your WordPress website based on the number of views, rating and the number of comments; and thus increase its view-per-visitor rate.

The plugin comprises three main components:

  • Post Views Counter – displays the number of page views for each post;
  • Post Rating – displays the number of votes and the average rating using a visual five-star system;
  • Widget – shows the most popular posts.

Documentation

Options

You can place the list of your top posts on any page using the Widgets tab in your WordPress dashboard.
The Cherry Trending Posts widget itself is highly customizable: besides the basic settings such as specifying the widget title and setting the maximum displayed length of a post title you can:

  • Filter the posts by their views, comments or rating;
  • Choose, whether to show the most rated or the highest rated posts;
  • Show post from specific tags and categories;
  • Display or hide certain metadata (post author, publishing date, rating, comments, etc.);
  • Set the excerpt length (if displayed);
  • Change the button text;
  • And more.

Widget

You can add the posts to the pages with the help of widget which offers you the following settings.

  1. Title – Specify the widget title
  2. Title length in characters (0 — hide, -1 — full) – Set title length
  3. Filter by:
    • Views – Filter posts by Views
    • Rating – Filter posts by Rating
    • Comments – Filter posts by Comments
  4. Select rating type:
    • Most Rated – Filter posts by Most Rated type
    • Highest Rated – Filter posts by the highest rate
  5. Show from:
    • Category – Show posts from category
    • Tag – Show posts by tags
  6. Number of post to show (Use -1 to show all posts) – Here you can define the number of posts to display
  7. Offset (ignored when "posts_per_page" => -1 (show all posts) is used) – This property specifies the number of post to displace or pass over
  8. Excerpt length in words (0 — hide, -1 — all) – This property sets the number of words limit for excerpt
  9. Display meta – This feature adds metadata to the post:
    • Date
    • Author
    • View
    • Rating
    • Comments
    • Category
    • Tag
    • Read More
  10. Button text – Add text to the button

Cache

If any of the cache plugins is used on the website, for a proper operation of the post ratings counter, you need to add the following code to the functions.php file:

add_filter( 'cherry_trend_posts_cache_fix', '__return_true' );

Screenshots

  • Widget settings

FAQ

How to use?

It is not enough to install and activate the plugin to make it work properly. You also need to add 2 actions to the template.

  1. do_action( 'cherry_trend_posts_display_rating' ) / do_action( 'cherry_trend_posts_return_rating' ) – display / return HTML for ratings
  2. do_action( 'cherry_trend_posts_display_views' ) / do_action( 'cherry_trend_posts_return_views' ) – display / return HTML for post views counter

For example, in the twentysixteen template you need to add the actions to the template-parts/content-single.php file. In your template the actions can be stored in a different file.

Changelog

1.0.0

  • Initial release

Contributors & Developers

This is open source software. The following people have contributed to this plugin.

Browse the code