Categorie

WordPress.com Popular Posts

IMPORTANT: due to my job, I’m now too busy to maintain my plugins.

This plugin has been abandoned!

If you are a developer and would like to fork, feel free to do so (under the GPLv3 license). No need to contact me.

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!

541 risposte su “WordPress.com Popular Posts”

I upgraded to wordpress 2.5 yesterday (and installed the WP stats plugin), and installed this plugin today. I followed all these steps, and added the widget to my sidebar. Yet it doesn’t show up! Could this be because there isn’t enough wordpress stats data for the widget to cull (less than 24 hours since upgrading the wordpress software), or is it just not compatible with wordpress 2.5?

Hi πŸ™‚
If you open your dashboard, under Blog Stats, then click on “Top Posts & Pages”, and summarize by “All time”, is your list empty? In this case, you should wait for wp-stats to update its logs.
This blog is powered by WordPress 2.5, so that shouldn’t be the cause of your issue.
What version of WordPress.com Stats are you running? I have v1.2, and seems to work fine.

Also check in the widget options that the number of posts is set to a value (for me it’s 5).

Thanks for the quick reply! It looks like the problem was that I was using v1.1.1 of WordPress Stats. I switched to v1.2 and it started working immediately. Thanks again!

What plugin do you use for allowing users to edit their comments? I love it!

Great! I’ll add the requirement of wordpress.com stats v1.2 to the FAQ. Thank you for reporting.
The plugin to edit comments is WP AJAX Edit Comments, really useful.
See you soon! πŸ™‚

Please ignore my previous comment.
Grab version 0.2.2 of WordPress.com Popular Posts, then add this code where you need:

My apologizes.

Yes, add this code where you need:

<?php if (class_exists('WPPP')) WPPP::init(); ?>

.
I’ll add it to the docs.

Hiya – loving your work on this plugin – really handy way of helping people navigate the site.

Is there any way I can restrict the popular posts to, say, the past week or month for example?

Also, is there any way of excluding pages and just counting posts?

Reckon these would make really useful additions to a great plugin.

Chris

quote
“Also check in the widget options that the number of posts is set to a value (for me it’s 5).”
unquote

How can I set the number of post if I got a themes that disable widget? any code for that? πŸ˜‰ and what plugins did you used for this comment smilies… love it… πŸ˜€

Hmmm, yeah I forgot about that.
I’ll add new arguments in the function “WPPP_show_popular_posts”, in next version.

The plugin for the smilies is Smilies Themer Toolbar, developed by me πŸ™‚ you can find it here!

@JunkieYard Dot Com: now in version 0.4.0 you can add arguments to the function WPPP_show_popular_posts(), download the new version and read the docs above.
I’ll look into your error with IE.