WordPress.com Popular Posts

WordPress.com Popular Posts integrates with WordPress.com Stats plugin, providing a widget to show the most viewed posts.

Installation

  • From v2.0.0, WordPress 2.8 is required. If you are using an older version of WordPress, use v1.3.5 of this plugin.
  • Install WordPress.com Stats plugin (required at least v1.2!!!)
  • Download WordPress.com Popular Posts
  • Extract the files in the .zip archive, and upload them (including subfolders) to your /wp-content/plugins/ directory
  • Activate the plugin through the ‘Plugins’ menu in WordPress
  • Place the widget where you like in your sidebars
  • Enjoy!

Themes Integration

If your theme supports widgets, you can place the widget named ‘Popular Posts’ where you want.

If it doesn’t, put this code inside the file sidebar.php, in your theme files:

<?php if (function_exists('WPPP_show_popular_posts')) WPPP_show_popular_posts(); ?>

Optionally you can add some parameters to the function, in this format:

name=value&name=value etc.

Possible names are:

  • title (title of the widget, you can add tags (e.g. <h3>Popular Posts</h3>) default: Popular Posts)
  • number (number of links shown, default: 5)
  • days (length of the time frame of the stats, default 0, i.e. infinite)
  • show (what you want to show; it can be: both, posts, pages; default is both)
  • format (the format of the links shown, default:
    <a href='%post_permalink%' title='%post_title%'>%post_title%</a>

    )

  • excerpt_length (the length of the excerpt, if %post_excerpt% is used in the format)
  • title_length (the length of the title links, default 0, i.e. unlimited)
  • exclude (the list of post/page IDs to exclude, separated by commas. Read the FAQ for instructions)
  • cutoff (don’t show posts/pages with a view count under this number, default 0, i.e. unlimited)
  • list_tag (can be: ul, ol, none, default ul)
  • category (the ID of the category, see the FAQ for info. Default 0, i.e. all categories)
  • cachename (it is used to enable the cache. Please read the FAQ).

You can use these special markers in the format value:

  • %post_permalink% the link to the post
  • %post_title% the title the post
  • %post_title_attribute% the title of the post; use this in attributes, e.g.
    <a title='%post_title_attribute%'...
  • %post_views% number of views
  • %post_excerpt% the first n characters of the content. Set n in the widget options.
  • %post_category% the category of the post
Example

If you want to show the widget without any title, the 3 most viewed articles, in the last week, and in this format: My Article (123 views) you will use this:

<?php WPPP_show_popular_posts( "title=&number=3&days=7&format=<a href='%post_permalink%' title='%post_title_attribute%'>%post_title% (%post_views% views)</a>" );?>
Shortcodes

If you want to include the list in a particular page or post, you can use shortcodes. Please read the FAQ for further info.

FAQ

Please read other updated FAQ here.

Changelog

You can read the whole changelog on the project page.

Download

Download
Download latest version of WordPress.com Popular Posts
for WordPress 2.8+

or v1.3.5 for WordPress < 2.8

License

WordPress.com Popular Posts is released under a GPL v3 license.

This plugin required many hours of development. If you like this plugin, then buy me a coffee!

  • #1 scritto da Lealcy B. Junior
    circa 4 anni fa

    Yes, I think so. Any directions?

  • #2 scritto da Eagle
    circa 4 anni fa

    It works, you are gr8

    thanks alotttttttttttttttttttttttttttttttttt (F)

  • #3 scritto da frasten
    circa 4 anni fa

    @Lealcy B. Junior: let’s try this:
    edit the file stats.php, in the WordPress.com Stats Plugin folder, and change line 543:

    if ( !$stats_cache = get_option( 'stats_cache' ) )
      $stats_cache = array();

    to:

    $stats_cache = get_option( 'stats_cache' );
    if ( !$stats_cache || !is_array( $stats_cache ) )
      $stats_cache = array(); 

    and re-upload your wordpress.com stats plugin.

    This could be a workaround; however if your blog receives many visits this could use some bandwidth (if your cache doesn’t work, it makes a requests to wordpress.com servers, on each visit).

  • #4 scritto da Max Carvalho
    circa 4 anni fa

    I was with this same problem. But now it is ok. Thanks for share this excellent plugin.

  • #5 scritto da Trisha
    circa 4 anni fa

    This is a really great plugin – thanks!

    Any idea when you might update it to be able to exclude pages? I want to show only popular posts without pages being shown also…..for example, my “Home” page always shows up… :)

    Thank you!

  • #6 scritto da frasten
    circa 4 anni fa

    @Trisha, @Chris: Right now! :-D download v1.1 above.
    It’s a little hackish, but it should work fine. (B)

  • #7 scritto da Kes
    circa 4 anni fa

    Nice plugin. It works great.
    This is a great option if you have WP-Cache installed and wanted functionally like WP-PostViews.

    But one thing I’m missing, is to show the views for posts by category. How can I do that ?

  • #8 scritto da Trisha
    circa 4 anni fa

    YAAY! It works! I’m so happy! I’m off to pay you a donation! (L)

  • #9 scritto da Trisha
    circa 4 anni fa

    frasten you should let people donate more than just the price of a cup of coffee – I wanted to send you more but it wouldn’t let me change the amount – I’ll come by in another day or so and buy you another cup!

  • #10 scritto da frasten
    circa 4 anni fa

    Thank you! :-P I really appreciated your donation, I’ll keep on working on these plugins!
    And I edited the link for the donations, thank you for reporting.

  • #11 scritto da Chris
    circa 4 anni fa

    Brilliant, brilliant, brilliant – well done. Exactly what I wanted. I’ll be winging you some cash on Paypal when I get five mins to sort. Top man.

  • #12 scritto da Andy
    circa 4 anni fa

    I tried to get this plugin to work but whenever I go to add it in the widget section it just dissapears after I click “Add”. I have not upgraded to wordpress 2.5.1 yet is that needed to get it to work?

  • #13 scritto da frasten
    circa 4 anni fa

    @Andy: Hi, what version of WordPress are you using? It’s a very strange behavior. :-/

  • #14 scritto da Andy
    circa 4 anni fa

    I am using wordpress 2.5 and I have wordpress.com stats version 1.2

  • #15 scritto da Andy
    circa 4 anni fa

    I just tried it again and what seems to happen is after I click “add” popular posts widget under Available Widgets all the widgets under “Current Widgets” dissapear including the Popular posts one. They do not return unless I refresh the page and this all happens again if I try to add Popular posts every time but does not happen if I try to add other widgets. Its strange.