Copyright 2006-2011
    Author: Thorben Kröger <thorbenk@gmx.net>
            Laurent Bovet <laurent.bovet@windmaster.ch>

    This file is part of phpdigikam

    phpdigikam is free software; you can redistribute it
    and/or modify it under the terms of the GNU General
    Public License as published by the Free Software Foundation;
    either version 2, or (at your option)
    any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

Overview
========

This PHP application gives web access to your Digikam 1.x photo
collection.

Installation
============

Prerequisites
-------------
You need a working apache webserver with PHP 5 installed.

Make sure PHP's safe_mode is disabled and your webserver has write
permission in the photos/ directory, otherwise PHP won't be able to
write files, and you'll have to do that manually.

PHP 4 will not work, as it cannot open SQLite databases (digikam saves
it's database in SQLite format) and it's Object-Syntax is different.
Feel free to adapt this script to PHP 4 though, should be easy, the
digikam database could be dumped into a mysql database.

Installation
------------
Put the unpacked archive somewhere in your htdocs or public_html folder
so apache can find it

 * Adapt inc/config.inc.php
   . 'restrictedAlbums' is used in an SQL-WHERE clause on the table 'Albums':
     Only those albums are shown where the condition is TRUE.
     Examples:
       $_config['restrictedAlbums'] = "Albums.id NOT IN (1, 3, 5)"; // only show those albums
       $_config['restrictedAlbums'] = "Albums.albumRoot == 4";      // show all albums on that drive
   . 'restrictedTags' is used in an SQL-WHERE clause on the table 'ImageTags':
     All images are hidden where any condition is TRUE.
     Examples:
       $_config['restrictedTags'] = "tagid=154"; // hide all images tagged 154
       $_config['restrictedTags'] = "1 = 0";     // show all images
   . 'thumbHashPath' is used as a prefix to the relative albums path for
     computing the MD5 hash of the thumbnail path. It must end with a trailing
     slash ('/')!
 * Create a symlink under the phpdigikam folder named "images" pointing
   to your image collection (or add a corresponding DocumentRoot to
   Apache configuration).
 * Create a symlink under the phpdigikam folder named "thumbnails"
   pointing to your ~/.thumbnails/large folder
   (or add a corresponding DocumentRoot to Apache configuration).

   WARNING:
   You must make that directory and the thumbnails withing world-accessable.
   This is not the default since thumbnails are also created for your private
   documents and pictures. Chaning the default permissions can leak PRIVATE
   data!
     chmod 0701 ~/.thumbnails/large
     find  ~/.thumbnails/large -type f -exec chmod 0644 {} +

Go to
http://localhost/location-of-phpdigikam/albumview.php


About
=====

From Thorben:
This script was written to let others browse my photos and making use of
digikam's great tagging feature, which the ordinary HTML export didn't
offer.

It's very easy to use wget to get the functionality of the export plugin.

It works for me, but I realize this is neither very elegant nor very fast.
Feel free to improve it :-)

From Laurent:
I adapted it to my own needs and made it work with Digikam 1.x. I hope it
will work for you.