calibre2php
===========

Calibre, by Kovid Goyal (http://calibre.kovidgoyal.net), is an
excellent ebook library management application that also interfaces
to a variety of ebook readers. Calibre does have a web interface
but I decided to write this as there were quite a few requests
for a PHP interface to Calibre.

calibre2php reads (never writes) the Calibre databse directly
so can only work directly with Calibre.

Installation
============
Requires Apache & PHP 5. only tested on CentOS (Red Hat based system).

Copy your Calibre ebook folder to your web server BUT not into
a folder accessible from the Internet. This is to protect your
library from direct access to ensure not just anyone downloads
from your library.

Place all the web files and folders into a folder, on your
web server, accessible from the Internet.

You may need to add a directive into the apache config
to enable the use of the .htaccess file included here. The
directive should be something like the following...
#################################
<Directory /var/www/html/calibre2php>
    Options FollowSymLinks
    AllowOverride all
</Directory>
#################################

Edit the c2psettings.inc.php and set the $ebook_store variable
to the folder containing your ebook library. Set any other
variables you wish to change, especially the $username and
$password, to suite your preferrences up to the line that reads
"// DO NOT CHANGE ANYTHING AFTER THIS LINE!!!!!!!".
The variables are all commented and should be self explanitory.

You may want to remove this README file from your web area...

That should be it for the installation...

Upgrading
=========
If upgrading from v0.10 just copy out your settings from the top
of calibre2php.inc.php and paste them into (overwriting) 
c2psettings.inc.php

Problem reporting
=================
Please be kind, & patient, when reporting issues. This is my
first PHP anything. I just did this for a challange.
Please use the forum to submit issues.
http://www.mobileread.com/forums/showthread.php?t=58826

Known issues
============
There is still much to do...
VERY IMPORTANT: calibre2php only reads the calibre databse
    to get the path & filename of a book you want to download &
    is case sensitive on UX systems. If the physical folder/file is 
    of a different case to what is actually displayed in Calibre
    then calibre2php will not be able to fetch the file for
    download and will display a "file not found" error.
Search box needs to be implemented.
No auth from local LAN still be be done.
Table header "Series" to be made linkable to sort by.
Windows mobile phone sets download file name as "download.php".
Multiple authors "&" separated only shows last.

Changelog
=========
Version 0.12
============
Table headers made linkable to sort by (except "Series").

Version 0.11
-------------
moved settings to seperate file to make upgrade easier
added rating stars
added some css here & there

Version 0.10
-------------
This is the initial release. Testing the response and to first
see if someone else already has a better PHP solution...
