Simple Readbag List

Simple Readbag List is a script that will make it easy to display your list of Readbag items on your blog.

Download

Download Simple Readbag List (v1.0, 12/04/2009)

Installation

1. Upload the entire simple-readbag-list folder to your wp-content/plugins/ directory.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. There is no options screen – configuration is done in your code.

Configuration

You must be signed up to Readbag to use this plugin.

When you sign into readbag there should be an “API” option at the top. Click on this and a window should appear – a few lines down and your API key should be listed. Take a copy of this, as it will be needed for this plugin.

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

<?php simple_readbag_list('apikey','listtype','listlimit'); ?>

Where..

apikey : This is the API key that you got from Readbag

listtype : This is the type of list you require – `U` for unread items or `R` for read items.

listlimit : The number of items to display from 1 to 20 (default is 20)

This will then display your Readbag list in an HTML list (i.e. with `<li>` and `</li>` around each entry).

An example would be…

<?php simple_readbag_list('cgrp5sdaubip6h17t1pn52fozgtmbg3bxdnosdf1qm9o9','u','5'); ?>

This would display a list of 5 unread items for the user with the specified API key.

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_readbag_list')) : ?>
<h2>My Readbag List</h2>
<ul><?php simple_readbag_list('cgrp5sdaubip6h17t1pn52fozgtmbg3bxdnosdf1qm9o9',
'u','5'); ?></ul>
<?php endif; ?>

Problems/Queries

Please report any problems, or suggestions for enhancements, to me either via my contact form or by commenting on the appropriate entries on my blog.

Updates

Updates to this and any other of my WordPress plugins will be published on this blog.

Subscribe to my WordPress category feed.