Welcome to PhotoLibrary, a web application for storing, cataloging and retrieving image files.
PhotoLibrary was developed by John Dudeck for SIM International.
This package is released under the terms of the GNU General Public License version 2.
Images are organized into a two-level structure consisting of country and major category, plus any keywords desired. This structure is imposed in the interest of making it easy to find relevant images by browsing and searching.
All use and maintenance is via web browser.
An image can have multiple versions (e.g. different resolutions and file types).
Three user roles:
All users can browse, search, download, and upload (submit) images.
Reviewers can also modify cataloging information about images.
Librarians can also publish (approve) submissions.
Images can be found either by browsing or by searching. Searching will search keywords, descriptions (captions), and user comments.
Images are previewed at 500 x 500 pixels. This is especially useful for hi-res images.
Users may select image files and save selections for later recall in "baskets". Images in baskets may be downloaded.
Users may "vote" on a "user rating" for each image. The user rating determines which images are returned first in a search.
Users may submit comments for each image.
When users upload images for submission, required information must be given by the user for each image. Cataloging rules are enforced by the system for required information: caption, country, and major category. Uploaded images are approved and published to the collection by a librarian.
User screens are available in multiple languages. English and French are included,and others may be added. UTF-8 encoding is supported.
User authentication can be be local to the application, or can be based on Windows passwords, or can be done against Active Directory via LDAP.
PhotoLibrary is written in PHP and uses MySQL. It has been developed under Red Hat Linux and Apache web server. Although it may be portable to other platforms, this has not been tried.
The Linux system requirements are:
MySQL 4.0.18 or greater
Apache 2.0.48 or greater
PHP 4.34 or greater (installed as module in Apache)
ImageMagick (uses only the "convert" command line utility)
+ whatever libs it needs
"zip" command line utility from InfoZip
+ whatever libs it needs
bourne shell commands "umask" & "mkdir"
If Windows password authentication is desired, the follow are also required:
mhash & mcrypt libraries
PHP extensions for mhash & mcrypt
(uses crypt/CHAP.php, Crypt_chap_MSv1(), ntPasswordHash() )
Untar the file. This creates the directory structure for the application:
cd /var/www
';
echo '
Note: A way to download the file directly to the folder is:
';
echo 'cd /var/www
';
echo 'wget http://tech.sim.org/PhotoLibrary/photos-app.'.$version.'.gz
For the rest of the installation instructions see the file:
/var/www/photos/web/app/INSTALL.txt.
John Dudeck <john.dudeck@sim.org>
or
John Dudeck
SIM International
1939 Gold Hill Road
Fort Mill, South Carolina 29708 USA