WordPress.org

Author: David Artiss

From version 2.0, please read the installation notes for ensuring that the new caching facility correctly works

You must be signed up to Wakoopa (http://www.wakoopa.com) to use this plugin.

To display your software list on your WordPress site you will need to insert the following code, where appropriate, into your theme…

<?php simple_wakoopa_list('paras'); ?>

Where paras is a list of parameters, separated by an ampersand..

user= : This is your Wakoopa username and is the only parameter you MUST specify

type= : This is the type of list that you wish to have displayed and should be 0 (most used - the default), 1 (recently used) or 2 (newly used)

limit= : The number of items on the list (default is 10)

link= : The software titles will be linked to and this defines what type of link should be used. 0 (the default) links to the home page of the software, whereas 1 links to the matching Wakoopa page.

height= : If you wish to display the software logo in front of each entry, you must specify the item height here. Leave it blank to exclude images.

cache= : Wakoopa data is cached locally for a number of hours - use this options to specify the number of hours that a cache should be used for. The default is 3. Specify `NO` to switch off caching.

nofollow= : If specified as `YES` this will turn on the `NOFOLLOW` attribute for the links. By default, this is switched off.

target= : Allows you to override the standard `TARGET` of `_BLANK`. 

This will then display the list of software in a list (i.e. with <li> and </li> around each entry).

An example would be...

<?php simple_wakoopa_list('user=test&limit=20&height=12'); ?>

This would display a list of the 20 most used pieces of software for user "test". It would also display an image of height 12 pixels next to each.

The following is an example of how it could be used, with a function_exists check so that it doesn't cause problems if the plugin is not active...

<?php if (function_exists('simple_wakoopa_list')) : ?>
<h2>Top 10 Programs</h2>
<ul><?php simple_wakoopa_list('user=test&limit=20&height=12'); ?></ul>
<?php endif; ?>

You can also, at the same time as displaying the list, retrieve the RSS filename as well. Simply assign a variable to the call to simple_wakoopa_list. For example...

<?php $rss_filename=simple_wakoopa_list('user=test&limit=20&height=12'); ?>

This will place the equivalent RSS file name in $rss_filename, whilst still displaying the Wakoopa list as normal.

If, however, you'd like to get the RSS file name BEFORE displaying the list then you will need to make a call to a new routine. This only requires the first THREE parameters that you used with simple_wakoopa_list. The new routine is named simple_wakoopa_feed and does not display a Wakoopa list.

An example of its use is...

<?php $rss_filename=simple_wakoopa_feed('user=test&limit=20'); ?>