WordPress Plugin MintPopularPostsWP
Installation Notes
1) Upload MintPopularPostsWP.php to your WordPress plugin directory on the
server (e. g. wp-content/plugins/)
2) Open the plugin administration panel and activate the plugin “MintPopularPostsWP”
3) You will find a new panel in Your WP Admin GUI (Options –> Mint Posts).
Set all required options here as you like and need it.
4) The options $text_to_remove, $ignore_list, $ignore_extensions are overridden
by the parameters in the function call provided you specify something else than the default.
5) If you want to show a list of your popular posts in your sidebar, edit sidebar.php
and add a code snippet like this wherever you like:
30 Most Popluar Posts
30 Mint Watchlist
6) If you want to display the Visits/Visitors Overview:
Mint Statistics
Full synopsis of mpp_popular_posts
Parameter Default Description
$num_posts 10 The number of posts to display
$prev_days 0 How many days would you like the list to run for? For all posts,
enter 0 (default). Any other number (X) will retrieve the top posts
in the last X days
$text_to_remove ? The text to remove from each post title that is displayed. For example,
if every title begins with ?? Turmsegler? it would be redundant to enter
this as part of the link text for every post listed.
$ignore_list ? comma-seperated list of URLs (including http://) that should not be counted
in the popular posts list (wildcard = * or %)
$ignore_extensions ? comma-seperated list of file extensions to ignore (wildcard = * or %)
$include_count true Should the count for each post be displayed?
$include_www false Should a ?www? be appended to the beginning of every url (changing
http://turmsegler.net into http://www.turmsegler.net)?
$pre
the html that should be included before every post listing
$post
the html that should be included after every post listing
Full synopsis of mpp_watched_posts
Parameter Default Description
$num_posts 10 The number of posts to display
$text_to_remove ? The text to remove from each post title that is displayed. For example,
if every title begins with ?? Turmsegler? it would be redundant to enter
this as part of the link text for every post listed.
$include_count true Should the count for each post be displayed?
$include_www false Should a ?www? be appended to the beginning of every url (changing
http://turmsegler.net into http://www.turmsegler.net)?
$pre
the html that should be included before every post listing
$post
the html that should be included after every post listing
Full synopsis of mpp_most_commented
Parameter Default Description
$num_posts 10 The number of posts to display
$pre
the html that should be included before every post listing
$post
the html that should be included after every post listing
Some words about caching
WordPress > 2.0 is equipped with a powerful caching module that helps to significantly
reduce the load on your database. This plugin is caching the results of its queries in
case the following conditions are met
1) WordPress caching is enabled in your wp_config.php:
define (‘ENABLE_CACHE’, true);
define (‘CACHE_EXPIRATION_TIME’, 1800);
2) The folder your_wordpress_dir/wp_content/cache is writable by the Webserver
3) Your site runs with PHP Safe Mode Off
Credits
- function for retrieving popular posts from MINT
- original function by Philip Lindsay (http://www.xlab.co.uk/weblog/632)
- extended by Cody Williams (http://www.projectarcanum.com/archive/2006/02/16/popular-posts-with-mint/) to include caching inspired by Dave Child (http://www.ilovejackdaniels.com/php/caching-output-in-php/)
- extended by Yaakov Ellis to fit into WordPress plugin format with added display options accessible from the function call
- extended by Benjamin Stein to avoid the need of configurations and use the WordPress caching system instead of prorietary caching
- extended by Benjamin Stein (configration panel, support for referrer numbers and the Mint Watchlist)
regards
Benjamin Stein
http://turmsegler.net
