Program: Free Perl Album
Version: 1.5 Build 2008.07.12
Author: Tri Dung Nguyen
Download & Support: www.vitinh.de
Donation: www.vitinh.de/donation
#######################################################################
System requirement:
-------------------
+ Windows or UNIX with Perl
+ HTTP server (Apache, Xitami...)
Optional (nice to have):
-------------------------------
+ Modul Image::Magick
+ Modul LWP::UserAgent
+ Modul Net::SMTP
+ Modul File::Copy
+ Modul Image::ExifTool
Installation and Configuration:
-------------------------------
1. Upload files and folders
+ Upload all files and folders to the cgi-bin directory
+ Files and folders to upload in ASCII-Mode:
- install.cgi
- fpa.cgi
- fpa_resize_thumb.cgi (new in this version - this script resizes
all existing thumbnails to the dimension defined in the Control Panel)
- fpa_recover.cgi (new in this version - this script finds and
recover orphan files and folders)
- fpa_batch.cgi (new in this version - this script allows unattended
adding multiple pictures via FTP)
- fpa_ascii (and all files inside)
+ Files and folders to upload in BINARY-Mode:
- fpa_binary (and all files inside)
2. Chmod (set access permission - only applicable on Unix hosts)
+ Skip this step if your server is running on a Windows machine
+ All files and folders: chmod 755
+ It means:
Owner: read, write, execute
Group: read, -- , execute
Other: read, -- , execute
3. Installation
+ Open your browser and point it to the file install.cgi
(for example: https://www.you.com/cgi-bin/install.cgi)
+ In the installation window, fill in all fields to continue
+ During the instalation, the installer will:
- make the album working directory (fpa_files) in your cgi-bin
- make sub-directories in the working directory:
+ configs
+ languages
+ skins
+ albums
+ session
+ ftp (you can then upload your pictures via FTP to this folder and run the Batch-Script
from the Control Panel)
+ logs
+ cards
+ users
- make the public directory (fpa_public) in your document root
(for example: https://www.yoursite.com/fpa_public)
- copy the ascii-files (configs and template files) to the sub-directories
- copy the binary files (image files) to the public directory
+ Directory tree after the installation:
+ cgi-bin/
+------ + fpa_files/
+ +------ + configs/
+ +------ + languages/
+ +------ + skins/
+ + + ----- + additional_skins
+ +------ + albums/
+ +------ + session/
+ +------ + ftp/
+ +------ + logs/
+ +------ + cards/
+ +------ + users/
+ + your_existing_files_and_folders
+ fpa_public/
+------ + icons
+ + ----- + additional_skins
+------ + temporary
+------ + albums
+-------+ your_binary_files
+ After the installation is complete, log in as administrator
and configure your new album
4. Configuration
+ Follow the screen guide to configure your album
+ Use the forum if you have a question or want to share your experience
5. Note
+ To change the layout of the album, you may edit all .tpl files in the
directory fpa_files/skins and style.css in the directory fpa_public/icons.
+ Don't forget to DELETE the installer after the installation!
+ And sorry for my terrible English ;-)
Thank you for choosing Free Perl Album!