WP Most Popular

Description

WP Most Popular was born out of frustration in finding a decent plugin which performs one simple task and that is to rank your most popular blog posts.

The plugin keeps a log of your most popular posts based on views and lets you display them in your blog theme with custom styling. You can display popular posts from the last day, 7 days, 30 days or all time.

It also comes with a sidebar widget to let you display your popular posts on your blogs sidebar.

If you are a developer and integrate the plugin in to a theme, you will get a lot more flexibility out of the plugin including the ability to show the most popular custom post types etc.

Usage

There are two ways in which you can use this plugin.

  1. As a sidebar widget
  2. Custom function in your theme files

Using the widget is the easiest way and recommended for most users. If you are a developer and want to integrate the plugin in to your existing theme, then read the information below.

Firstly, the main function which you will need to include in your theme to fetch the popular posts is called wp_most_popular_get_popular().

You can pass that function the following parameters in array form:

  • limit (integer)
    • The number of posts you would like to display i.e. 5
    • Default: 5
  • post_type (string) / (array)
    • The post type you would like to display
    • Example: post
    • Default: All post types
  • range (string)
    • In what date range would you like to display popular posts in
    • Accepted: all_time, monthly, weekly, daily
    • Default: all_time

Those are the current parameters that the plugin supports. Let’s look at an example of how to display the most recent popular posts in a unordered list.

<?php
echo '<ul>';
$posts = wp_most_popular_get_popular( array( 'limit' => 10, 'post_type' => 'post', 'range' => 'all_time' ) );
global $post;
if ( count( $posts ) > 0 ): foreach ( $posts as $post ):
    setup_postdata( $post );
    ?>
    <li><a href="<?php the_permalink() ?>" title="<?php echo esc_attr(get_the_title() ? get_the_title() : get_the_ID()); ?>"><?php if ( get_the_title() ) the_title(); else the_ID(); ?></a></li>
    <?php
endforeach; endif;
echo '</ul>';
?>

Filters

The following filters are available to you:

  • wp_most_popular_list_before – used to filter the
    element of the outputted widget list
    * **wp_most_popular_list_after** – used to filter the

element of the outputted widget list
* wp_most_popular_list_item_single – filters for a the list item generated by the widget

Actions

  • wp_most_popular_list_item – used for modifying the list output

FAQ

Why are no posts displaying when I use the widget or call the function in my theme?

99% of the time this is because no posts have been visited yet to receive a ranking. Simply click on a blog post to read it on your blog and it will receive a ranking and display in the list of most popular posts.

What are the minimum requirements for the plugin?

You will need a web server or shared host that supports PHP version 5 or newer. Javascript is also required to log post views.

Why does the plugin use Javascript to track the post views?

The original version of the plugin that I wrote used PHP to track the post views and the reason why I switched to Javascript was because if a caching plugin is enabled on your blog, the page will be loaded statically to your visitor and the PHP code to log a view on a post will not be run.

Can I request a feature?

Yes, please do so on the WordPress support forum for the plugin. I will consider it and if I feel it is worth adding, I will schedule it for a future release.

Can I contribute code to the plugin?

Yes! The plugin is open source and I host it on Github. Feel free to send me pull requests.

Reviews

504 request

azhar92

Hello Support, I hope you are doing well !!! I have installed this Wp most popular plugin in my website, my website is on wp-engine server. so server person giving max hitting creating under this plugin code. so please check this plugin code. i have some response from wp-engine support so please guide me how to resolve this issue. ack-grep "wmp_update" plugins/ themes/ plugins/wp-most-popular/wp-most-popular.php 52: echo '<!-- WordPress Most Popular --><script type="text/javascript">/* <![CDATA[ */ jQuery.post("' . admin_url('admin-ajax.php') . '", { action: "wmp_update", id: ' . $wp_query->post->ID . ', token: "' . $token . '" }); /* ]]> */</script><!-- /WordPress Most Popular -->'; 65: add_action( 'wp_ajax_wmp_update', 'WMP_system::actions' ); 67: add_action( 'wp_ajax_nopriv_wmp_update', 'WMP_system::actions' ) I am waiting your response!!!

Simple and versatile

RussHorne

Great plugin, can be called with a function to show popular posts anywhere.
I was able to create a category for popular posts and then call the plugin function when that category was viewed.

However, only giving it 4 stars as I've realised that when the plugin is deactivated, all the database info is deleted, the whole table for this plugin is gone!
This should only happen when the plugin is deleted, not deactivated.. Deactivation should be viewed as a temporary thing, possibly while testing another plugin, it shouldn't remove all the data!

If this is fixed it would be worthy of 5 stars.

Thanks.

Read all 9 reviews

Changelog

0.3.1

  • Fixed a bug where the old function wmp_get_popular was no longer working as it should for backwards compatibility

0.3

  • New helper function name for getting the most popular posts wp_most_popular_get_popular. Please note that the old function name is still supported wmp_get_popular
  • New filters and action introduced for use on widget (wp_most_popular_list_before, wp_most_popular_list_after, wp_most_popular_list_item, wp_most_popular_list_item_single) (thanks to sanchothefat and callerc1)
  • Widget now supports thumbnails (thanks to eduardo-marcolino)
  • Added a CSS class name to the widget list (thanks to sinisterstuf)
  • Fixed a bug where the plugin was using a deprecated function (since version 4.3) to setup the widget

0.2

  • Added the ability to query multiple different post types (thanks inc2734)
  • You can now also choose a specific post type from the widget

0.1

  • First version of the plugin released

Contributors & Developers

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

Contributors

Browse the code