Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
PHP JavaScript CSS

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
readme.txt
wordpress-popular-posts.php

readme.txt

=== Wordpress Popular Posts ===
Contributors: Ikki24
Donate link: http://rauru.com/
Tags: popular, posts, widget, seo, wordpress
Requires at least: 2.0.2
Tested up to: 2.6.2
Stable tag: 1.2

Adds a widget to show the most popular posts in your Wordpress blog.

== Description ==

Wordpress Popular Posts is a sidebar widget to show the most popular posts in your blog. Many options has been included in it so you can customize it to your likings.

Features:

* Widget's title is by default **Popular Posts**. However, you can change it to whatever you want.

* Wordpress Popular posts will display up to 10 entries by default. This setting can be changed as well.

* It can also display comment count for each entry. Enabled by default.

* If you want to, you can limit the amount of characters displayed for each entry listed. If activated, you can also limit the excerpt to display a certain number of characters (25 by default). Disabled by default.

== Installation ==

1. Download the plugin and extract its contents.
2. Upload the `wordpress-popular-posts` folder to the `/wp-content/plugins/` directory.
3. Activate **Wordpress Popular Posts** plugin through the 'Plugins' menu in WordPress.
4. In your admin console, go to Design > Widgets (or Presentation > Widgets for Wordpress 2.3 and lower), and drag the Wordpress Popular Posts widget to wherever you want it to be, and click Save Changes.
5. *optional* In your admin console, go to Design > Widgets (or Presentation > Widgets for Wordpress 2.3 and lower), click Edit on **Popular Posts** and customize it to your likings. Once you're done with it, click on Change and then on Save Changes.

= Placing Wordpress Popular Posts in your templates =


If you want to use **Wordpress Popular Posts** in your templates and not as a widget, simply place `<?php get_mostpopular(); ?>` where you want your listing to be shown. Easy, huh?.


**v.1.2** I've added a few parameters to the function so you can tweak **Wordpress Popular Posts** to your liking.

**USAGE:**

`<?php get_mostpopular(TITLE, NUMBER-OF-POSTS, SHOW-EXCERPT, SHOW-COMMENTS, CHARACTERS); ?>`


**Example:** `<?php get_mostpopular('Popular Posts', 15); ?>`


**PARAMETERS:**

* **TITLE** (*string*): refers to the title of the widget. Default is `Popular Posts`.
* **NUMBER-OF-POSTS** (*integer*): refers to the amount of entries to be retrieved. Default is 25.
* **SHOW-EXCERPT** (*boolean*): if set to TRUE, it'll limit the number of characters shown for each entry listed. Default is FALSE.
* **SHOW-COMMENTS** (*boolean*): if set to TRUE, comments count will be displayed next to each entry listed. Default is TRUE.
* **CHARACTERS** (*integer*): refers to the number of characters to show per entry. Default is 25.


== Frequently Asked Questions ==

No FAQs so far.

== Screenshots ==

No screenshots available at the moment.
Something went wrong with that request. Please try again.