Installation

From Photolibrary

Contents 1 Requirements 2 Installation 3 Security 4 Getting started 4.1 Importing photos 4.2 Publishing photos

Requirements

Make sure you have the following software installed:

• MySQL, version 4.1+ recommended. Should work with 4.0, loss of functionality with 3.23.
• Webserver with PHP. Tested primarily on PHP5, should work on PHP4. You will need to install/enable the following PHP libraries:
  • EXIF library for PHP.
  • GD library for PHP. Version 2+.
  • MySQL library for PHP.
  • File Archive PEAR library. Optional: allows for importing of .zip/.tar etc. and (eventually) exporting multiple images to .zip/.tar etc.

Installation

1. Download and extract photolibrary on your webserver.
2. For UNIX, make sure Apache has write access to the directory.
3. Navigate to the document root, e.g. mysite.com/photolibrary, you should be redirected to dbsetup.php.

   

4. Enter your database username and password as required. This account will need CREATE privs to build the tables. If you want to use a lower access user for day-to-day running of the site, you can edit generated/generated.database.php after installation. You should be redirected to dbinit.php.
5. If you are not loading the page from localhost you will be given an error at this point. Edit dbinit.php to give your current IP in this case:

   $localhost = "your IP";

6. Choose a username and password for your site as prompted.

   

7. If all is successful you should be taken to the settings page. Read through the page, making appropriate changes, and press save at the bottom.

   

8. Navigate to Home and if all has gone well it should look something like this:

   

Security

Images which are not published are not secured. If the path to an unpublished image is leaked, anyone may access that image. Web servers should be configured to deny directory listings on all the image store folders.

If you use the standalone browser (see user guide), make sure to restrict web access to the /bin folder as the XML files will give paths unpublished images. For Apache use:

<Directory "photolibrary_root/bin">
    Order allow,deny
    Deny from all
</Directory>

Getting started

Importing photos

To import photos go the import page. Either copy the files to the /incoming directory, or use on the of the other methods listed. You will be given a list of files ready to import. Press import and wait for the process to complete.

Publishing photos

Go to the categories pages, and check the images you want to publish. Assing the images to the "Access -> Public" category, which should have been created on installation (you can rename it in the settings). Do this by clicking on the assign icon next to "Public" in the category tree on the left.