Bookshelf Documentation

Why

I wrote this bookshelf package for my own web site at pinds.com. For background information, please visit http://www.pinds.com/download.

Download

The latest version lives in the OpenACS CVS repository.

Getting started

Install the package on your system, mount a new instance somewhere on the site map, make sure you have admin permission on the instance, and then visit the URL where you mounted it. Now you can add your first book.

It's meant to support both single-user publish-to-the-world style bookshelf, and a collaboratively maintained bookshelf for members of a community.

Putting it on some other page

If you want to inlcude your bookshelf on, say, your blog page, you can get it in two versions:

• <include src="/packages/bookshelf/www/bookshelf-include"> gives you the full version with reviews and all.
• <include src="/packages/bookshelf/www/bookshelf-titles-include"> gives you the short version which just lists the titles.
• See this forum posting on how to add in random bookshelf entries.

Technical Info

The package fully supports multiple instances, i.e., you can mount several instances in your site map, and they'll stay properly isolated from each other.

Only supports PostgreSQL (please do port to Oracle if you want to).

Road Map

• Adding categories
• Adding notifications
• Adding a calendar widget, perhaps
• Technical detail: Refactoring some of the common features between this package and bug-tracker and lars-blogger into a common, reusable substrate

Version History

• 0.2: First released version.

License