MunkyTopList

MunkyTopList is a WordPress plugin that for the most part is a TopList script that you see on the many Top Sites around the WWW today. The major difference is the fact that site owners do not sign-up or register to have their site listed. Just have link partners start sending your MunkyTopList enabled WordPress blog visitors and the script takes care of the rest. MunkyTopList logs all referers to your blog in the database as well as tracks outgoing clicks made in the MunkyTopList display. You have complete control over what is displayed using our admin center. You are allowed to hide, setup filter keywords and ban IPs so that you can display the links that you want.
 

• Records both Incoming and Outgoing hits.
• Search Engine Friendly links used in the MunkyTopList Widget.
• Lightweight CSS Hint box used to display Hits In / Hits Out
• Sidebar Widget to allow easy implementation into your theme.
• Sticky Referers so they stay on top of the list.
• Automatically grabs Referer Title if specified in settings.
• Add / Edit / Remove Referers
• Edit / Remove Incoming / Outgoing IPs
• Hide Referers from being shown in the TopList manually or by using Filter Keywords
• Ban IPs from having their Hits tracked
• Total control over most important settings.
• Uninstall program to remove MunkyTopList database tables and other data saved
• Control various TopList display features using included CSS.

To use MunkyTopList, you will need:

• An installed and configured copy of WordPress version 2.8.4+.
• MunkyTopList will also work with the equivalent versions of WordPress MU.
• FTP or SFTP access to your web host

= New Installations =

• Download the MunkyTopList archive and extract the files on your computer.
• Create a new directory named `munkytoplist` in the `wp-content/plugins` directory of your WordPress installation.
• Use an FTP or SFTP client to upload the contents of your MunkyTopList archive to the new directory that you just created on your web host.
• Log in to the WordPress Dashboard and activate the MunkyTopList plugin.
• Once the plugin is activated, you will find MunkyTopList in the main Admin navigation
• GoTo Settings -> Miscellaneous and update the global MunkyTopList Settings.

• Add the MunkyTopList Widget to your sidebar and update the settings.
• Make sure your WordPress Theme contains the php function wp_head() (usually in header.php). This enables the tracking code so that it will execute in every page that uses your header.
• If you wish to change the CSS Hint box used in the MunkyTopList Widget that shows Hits In / Hits Out, modify css/mtldisplay.css to your liking in your MunkyTopList plugin folder. (under Hit Box CSS section)
• If you utilize the "shortcode" version below, you may modify css/mtldisplay.css to your liking in your MunkyTopList plugin folder. (under ShortCode CSS section)
• You may also use a WordPress "shortcode" to display a fuller version of the MunkyTopList display by including the following in a WP Post / Page...

  [munkytoplist referer_length="30" referer_shown="50" mtlsort="incomingdesc" show_incoming_hits="true" show_outgoing_hits="true" open_new_window="true"]

• Or... Apply the same WordPress "shortcode" above to your theme pages using the following...
  

  <?php echo do_shortcode('[munkytoplist referer_length="60" referer_shown="20" mtlsort="incomingdesc" show_incoming_hits="true" show_outgoing_hits="true" open_new_window="true"]'); ?>
  

• ShortCode parameters explained below... simplest implementation is accepting MunkyToplist defaults with [munkytoplist]
  • referer_length = truncates referer titles to X characters
  • referer_shown = shows X number of referers in the display
  • mtlsort = how to sort the TopList - valid values: ( "incomingdesc", "incomingasc", "outgoingdesc", "outgoingasc", "titledesc", "titleasc" )
  • show_incoming_hits = show Hits In column - valid values: ( "true", "false" )
  • show_outgoing_hits = show Hits Out column - valid values: ( "true", "false" )
  • open_new_window = open clicked Referer in new window - valid values: ( "true", "false" )