++++++++++++++++++++++++++++++++++++++++++++++++
Readme for the "CurrentlyAddictedTo Plugin" 
version 1.0
a plugin for pLog (v1.0)
Developed by Palantir, radar@netpalantir.it

See the plugin in action at my blog:
http://www.netpalantir.it

This plugin is released under the terms of the LGPL

++++++++++++++++++++++++++++++++++++++++++++++++
Warning: This is a pre version. It may work, but
it may also nuke your blog.  BACK   UP   FIRST!!
++++++++++++++++++++++++++++++++++++++++++++++++

WHAT IT IS
This is a plugin for pLog version 1. It will NOT work on any other pLog
previous version, in particular 0.3x series. It will display a new
administration section, called CAT, which will allow you to create lists of
things you like, or music you are currently listening to, or books you are
"addicted to". You will then change your templates, so to make them display
those lists on your blog.

HOW TO INSTALL (from scratch)
1. Unpack the archive
2. Locate the installation directory of your plog
3. Copy the whole "currentlyaddictedto" directory into the plugin directory
4. Change the permissions/ownership of all the files, according to your setup.
   If you transfer files via FTP this could be unneccessary. All the files must 
   be readable by the web server.
5. Point your browser to your blog administration page, log in, click on: 
   Control Center > Plugin center. The shoutbox plugin should be on your 
   list. If it is not, try updating the page a few times, it seems to help ;)
6. The first time you run it, the plugin should autodetect that a database setup
   is neccessary, and create the table.
   
HOW TO UPGRADE FROM 0.x VERSION (pLog 0.3x)
This is currently not supported. However, your previous data are NOT lost, so 
if you need this, let me know, and I will show you how to retrieve your old
data.

HOW TO MAKE IT WORK
First, integrate the plugin into the template.
I am using the grey template, so this example refers to it.

HOW TO USE IT
There are some pre-defined typed lists, including books and music items. You
can create your own lists, refer to lists.txt in the distribution. The user
side of the plugin has no interaction with your visitors. It is just to display
things. In the admin side, you setup your items.
Access the CAT plugin from the Plugin Center in the Admin panel. A list of the
present list is shown. Click on one of them. Your current items are presented.
On the top, you can add a new item.
- To add an item, clic on the Add New Item button. A new yellow item will
appear on the top of the list. Fill in the form, and click on save. The item
will become blue, this means that it has been saved.
- To remove an item, use the expire button. The item will be hidden in the user
area, and will be folded and listed at the bottom of the page. Those items are
NOT deleted.
- To get an expired item back, just click on it, in the list at the bottom of
the page

DOESN'T WORK? BUGS? WISHES? WHO TO CONTACT
Please, use the pLog's bug reporting system. It's located at:
http://bugs.plogworld.net
Otherwise, send me a mail: radar@netpalantir.it
I must admit I don't read plogworld forum regularly, so if you post there,
please let me know by mail as well.

+++++++++++++++++++++++++++++++++++++++++++++++

TODO:
- connection to resources (in particular, book and album covers)
- communication with Amazon, for ISBN quick lookup
- better handling of "banner" and "category has no items" messages (now they are
  hardcoded in the classes!)
- error hadling on the admin side (for now there is no error handling at all)
- permanent deletion of items

+++++++++++++++++++++++++++++++++++++++++++++++

CHANGELOG:
v1.00 For pLog 1.0 Rewritten from scratch. New architecture.

v0.x for pLog 0.3