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 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.

Sorry for my third post in a row but I thought I would tell you the good news that I got it to work! It turns out it was a browser bug! The Popular Posts widget would not add itself to the Current Widgets in IE7 but worked fine in Firefox. So the plugin is working fine on my site now!

Hello,

I have the most recent version of both this plugin and the stats plugin and everything seems to be setup correctly.

Unfortunately, no matter what nothing populates ๐Ÿ™

When I add the widget it just lists the title but doesn’t list naything else – could it be my theme?

Any ideas? Thanks!

Actually, this just now popped up in the place of popular posts:

WordPress database error: [You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near — it won’t let me post the code error here…

Pretty weird, huh? Any suggestions? Thanks!

@Andy: Thank you for reporting. Actually, the widget configuration under IE7 looks really crappy.
I’ll look into that.

@ComicNerd.com: I’ve PMed you, I need the complete MySQL error.

Hi,

I was getting the same fatal error described by Lealcy B. Junior. The solution you supplied him works for me as well.

But I’d like to suggest you to work on a general fix. My WordPress (2.5.1) and your plugin (1.1.1) should work fine in all cases.

BTW your plugin is a nicely done job. Gongratulations. ๐Ÿ˜‰

@Steker:
Can you please elaborate on the feature you requested?

@Marcelo:
I’ve contacted the WordPress Stats authors, but I haven’t received any answers.
So, like you suggested, I’ve included in v1.1.2 a temporary fix for that error. ๐Ÿ˜Ž

@Marcelo:
Yes. Actually, the fix in v1.1.2 is the same as what you changed in stats.php.
It doesn’t harm, but you can safely remove the fix, because it is already included in WordPress.com Popular Posts.

Hi

I change my server, but the domain and everything is the same,

but for your script, in most popular list, the name of the title of the posts are not shown or some part of them are cut that made me to Erase the code temporary.

but tell me what I should do.

regards

Great plugin, frasten. (Y)

btw, your plugin doesn’t support the_excerpt.

i want to display my popular posts in my home page like this.

format=<a href='%post_permalink%' title='%post_title_attribute%'>%post_title% (%post_views% views)</a>
<br />%the_excerpt%

:o)