Read/Listen/Watch WordPress Plugin

A customizable sidebar plugin/widget to display what you're reading, listening to, and watching; with links to Amazon.

Contributors: sahearn
Tags: Amazon, reading, read, listening, listen, listening to, watching, watch
Requires at least: 2.8
Tested up to: 3.0
Stable tag: 2.1.2

Questions/Comments: sahearn at gmail dot com


This plugin will provide a customizable display along your sidebar for items which you are reading, listening to, and watching. There is a minimum of one item displayed required, but you are not limited to only one of each "type" (i.e. you can list two items reading, one listening, and none watching - or any combination!). In addition, this plugin was initially developed for me and my family to use concurrently, so different "owners" can be specified ("Joe is reading...", "Mary is reading...", etc). Content is created and maintained via the Settings panel.

Other features include:


Latest: v2.1.2 (Apr 2011) -

Older: v2.1.1 (Apr 2010) -



Download the zip file, unzip it, and copy the "read-listen-watch" folder to your plugins directory. Then activate it from your plugin panel (if you are upgrading, deactivate and then reactivate). After successful activation, "Read/Listen/Watch" will appear in your "Settings" menu and "Widgets" control panel.

Go to the "Widgets" control panel first and take a look at the default options, which for many people will not require any changes.

Now go to the "Settings" menu to add your content. Add or delete items one at a time; updates can be performed to multiple items at once. The date field for each item is used for the optional RSS feed. It is important that the format of this field is not changed - as is, it conforms to the RSS 2.0 specification for GMT dates.

This plugin stores its data in the WordPress "options" database table. Two rows will be created: one for each serialized object corresponding to item content and widget configuration.


There is moderate use of the "htmlspecialchars" function throughout this plugin, including the "double_encode" parameter which wasn't introduced until PHP 5.2.3. I've done my best to run PHP version checks, but if you're running below PHP 5.2.3, be wary of HTML entity usage in any user, title, or author fields. You might experience some unusual [double] encoding behavior. If so, do not explicity type out entities - count on plugin code to encode entities for you (e.g. just type "&" - the plugin will convert it appropriately).


Widget Control:
Sidebar Display:



Updated donate/home URL. Cleaned up some RSS formatting.


Cleaner display/formatting on admin settings. FIRST PUBLIC RELEASE.


Handle multiple deletes.


Better indicators and catches for required and optional fields.


Minor formatting changes, code cleanup. Lowered content admin permissions from "manage_options" to level 6 (Editor role).


Complete rewrite to conform with plugin development standards in preparation for first public release.


Added ratings.


Various bugfixes.


First private-use/unreleased version.

Upgrade Notice

No updates at this time.

Updated: 19 Apr 2011