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 os
    circa 7 mesi fa
    Rispondi Cita

    I have wp 1.9.1, WPPP Version 1.3.5 and Stats 1.6 with double output:

    # page (1 reader)
    # post (5 reader)
    # post (1 reader)

    (here comes title: Popular Posts =deleted by parameter title=)

    * page
    * page
    * post
    * post

    when I add parameter &format=%post_title% (%post_views% views)

    title shows up again despite deleted by parameter title=

    2. can I exclude certain pages by parameter?

    Thanks! & good plugin!

    Os.

  • #2 scritto da os
    circa 7 mesi fa
    Rispondi Cita

    hint: 2nd part with * wrappes in

    while # is just in .

  • #3 scritto da os
    circa 7 mesi fa
    Rispondi Cita

    os double output problems solved . :-P

  • #4 scritto da Matt
    circa 7 mesi fa
    Rispondi Cita

    @frasten.

    Amazon plugin, the best, but one very small thing is stopping me using it.

    I’m using the PHP code option in my sidebar code. You have the “list_tag (can be: ul, ol, default ul)” options.

    Can you add in a “none” option to the list_tag? This will then allow me to wrap the PHP code inside my own custom code.

    This is because I need to use your code for my tabed sections to work.

    Thanks for the consideration and plugin!

  • #5 scritto da frasten
    circa 7 mesi fa
    Rispondi Cita

    @Matt: the new 2.4.0 version adds that feature! Just upgrade your plugin and test it! :-)

  • #6 scritto da Matt
    circa 7 mesi fa
    Rispondi Cita

    @frasten. Many thanks! I didn’t know the feature was already available!

    I’m using it with the PHP code, works great. Just had to add in the format tag to get the ‘s back. I also activated the cache, hope it’s working!

    Cheers frasten, amazing plugin!

  • #7 scritto da Tim Nicholson
    circa 7 mesi fa
    Rispondi Cita

    Thanks so much for adding in my code for shortcodes! On a completely separate note, what plugin are you using here to display your source code snippets without having the WP editor screw them all up?

  • #8 scritto da frasten
    circa 7 mesi fa
    Rispondi Cita

    @Tim Nicholson: I’m (was) using this plugin; however now I moved to this other one, with a nice syntax highlighting system.

  • #9 scritto da Tiger
    circa 6 mesi fa
    Rispondi Cita

    Fantastic Plugin

    How would I go about adding a post thumbnail to the list?

    ;-(

    • #10 scritto da frasten
      circa 6 mesi fa
      Rispondi Cita

      Hi, this is not possible at this time, but I’ve added your request to the todo-list.

    • #11 scritto da Matt
      circa 2 mesi fa
      Rispondi Cita

      I too would love this feature!

      Another popular posts plugin can do it, but I would rather stick with this plugin as I’m a big fan of it!

      Maybe it can be done though custom template like with the YARPP plugin?

      Thanks!

  • #12 scritto da Tiger
    circa 6 mesi fa
    Rispondi Cita

    By the way I am using the widget

  • #13 scritto da Tiger
    circa 6 mesi fa
    Rispondi Cita

    O fantastic – would be great if we could do this – currently i’ve gone back to wordpress popular posts but once thumbnails are added or at least a way in which i can try and implement thumbnails ill be back ;-) 100%

    keep up the excellent work
    (Y)

    • #14 scritto da frasten
      circa 6 mesi fa
      Rispondi Cita

      @Tiger: could you please test this development version that introduces post thumbnails? I don’t use them, so I can’t test it well.
      Use the new %post_thumbnail% tag in the format.
      At this time they are fixed-sized, but I will allow users to set a size for the images.

      • #15 scritto da Tiger
        circa 6 mesi fa
        Rispondi Cita

        HI there

        before I test this? when u say use the post)thumbnail format is there anything in the widget to enable this or do I need to write in code for this development version?

        Thanks (Y)

        • #16 scritto da frasten
          circa 6 mesi fa
          Rispondi Cita

          @Tiger: Sorry, I forgot to explain :-P
          Go under the widget preferences, and customize the format there. No need to edit code directly.
          Overwrite your old wppp.php with this development one.

  • #17 scritto da Matt
    circa 6 mesi fa
    Rispondi Cita

    frasten , I just noticed my site wouldn’t load. After a bit of investigation I noticed only pages showing popular posts didn’t load, and when I disabled the plugin, it was up again.

    wordpress.com server are currently down, which also means wordpress.com stats aren’t working, which obviously isn’t your fault, but it’s not good if it causes my site to stop loading with your plugin.

    I use the manual code, and the pages with the cache option carried on working, but those without stopped.

    Excellent plugin frasten, one of my favs, I just thought I should let you know :)

    Thanks

  • #18 scritto da Matt
    circa 6 mesi fa
    Rispondi Cita

    Update: WordPress.com is back up, plugin now enabled, and all working again :)

  • #19 scritto da mozzer
    circa 6 mesi fa
    Rispondi Cita

    Same issue than Matt a few hours ago.

    I upgraded to WordPress.com Stats 1.6.2/WordPress.com Popular Posts 2.4.0 and now, even if wordpress.com is back, the issue continues; I had to deactivate the plugin.

    • #20 scritto da frasten
      circa 6 mesi fa
      Rispondi Cita

      @everyone using my plugin and having issues: thank you for reporting: this is a major issue, and I’m investigating right now.

  • #21 scritto da frasten
    circa 6 mesi fa
    Rispondi Cita

    @Everyone: released v2.4.1. It adds some checks against unexpected values returned from wordpress.com servers. This could fix recent issues and hopefully any future ones.
    Important note: who was experiencing these issues should try to disable and then re-enable the cache in the widget. This will clear the cache.
    Who was using WPPP_show_popular_posts() in their theme and was using the cache, should add ONCE this, near WPPP_show_popular_posts():

    update_option( 'wppp_cache', '' );

    Then load a page (this will clear the cache), and then remove the code above.

1 ... 19 20 21 22 23