PhotoPost PHP GMS Installation|
We have designed PhotoPost to be easy very easy to install, and we have tested it
on a variety of platforms, including Unix/Apache/FreeBSD and Windows 2000 / IIS 5.0. Please
see our requirements to find out more about what
PhotoPost requires before installation.
Before installing PhotoPost PHP, you need to verify that your server is properly configured
to support it. PhotoPost PHP requires PHP 4.0.2 or greater, MySQL 3.22 or greater, ImageMagick 5.3.8 or greater or the GD Graphics Library
2.0.x. Verify these requirements with your web host if unsure.
2.) Database Configuration|
PhotoPost PHP GMS requires a single MySQL database. Be sure you know your database server address, if it is not localhost, your MySQL
username, password, and the name of the database that you plan to use for PhotoPost.
3.) Downloading PhotoPost, Uploading Files|
Download PhotoPost PHP GMS from our
members area. You will need the username and password that we email to you upon
purchase of a PhotoPost license in order to login to the members area.
Unzip PhotoPost into a directory on your local machine, making sure that you maintain the
directory structure of the zip file. The zip file contains several .php and .sql files as
well as three main directories
called "images", "uploads", and "data". Locate the file called "config-inc.php" and open it
in notepad or another text editor. The file should look something like this:
//**************** External Header Configuration ****************//
// the isset prevents vB headers from being sent during login/logout -
// do not remove this line as it may cause the vB
// headers to interfere with the login/logout process
// To include the file, first edit the header-inc.php file and then
// uncomment out the line below
//**************** MySQL Database Configuration ****************//
// PhotoPost database host address, or leave as localhost
// PhotoPost's database name
// MySQL username and password to access PhotoPost's database
// These two variables are for the userid and password needed to access
// the PhotoPost database named above.
// User database host address, or leave as localhost
//**************** Application Configuration ****************//
//////////////////////// Application Configuration ////////////////////////////////
// These variables set the path to the UNZIP and MOGRIFY commands on your system
// This only needs to be set if you are allowing ZIP uploads. These are full paths,
// including the name of the executable (.exe extensions for windows)
// The -j option for Info-ZIP's UNZIP tells it to ignore paths in ZIP file
$zip_command = "/usr/bin/unzip -j";
// Path to MOGRIFY executable
// There should be no spaces in the directory names, use short names if necessary.
// $mogrify_command = "c:\progra~1\imagemagick\mogrify.exe";
// $mogrify_command = "c:\ImageMagick\mogrify.exe";
$mogrify_command = "/usr/lib/X11/mogrify";
// Debug variable.
// 0 = No debug notifications
// 1 = Program should generate an email and send it to the site administrator
// 2 = Program should terminate with a formatted screen with error message
// When set to 0 or 1, the program will not end on non-fatal errors.
// Cookie variable
// This should be set to match the path for your cookies, / sets the cookie
// to be usable throughout the site. If your BB system has a different setting,
// then you need to put that path here as well.
// ZLIB compression
// Set to "1" if you want to enable Zlib compression
// Date Format
// you can change the format of how dates are displayed
// dow = day of week (Mon, Tue, Wed...)
// month = month (Jan, Feb, Mar...)
// mm = month in numerical format, dd = date, yyyy = year
$ppdateformat = "dow month dd, yyyy";
// If you are running VB and want the server to display the time as an offset
// of GMT (for example, to the timezone where your server is located), enter the
// offset here
$gmtoffset = 0;
// Here is where you can set the fonts used throughout PhotoPost
// Multiple fonts can be specified (just as in HTML code)
$mainfonts="MS Sans Serif,Geneva,Arial";
$fontsmall = "1";
$fontmedium = "2";
$fontlarge = "3";
Edit the values between the quotes on each line of the config-inc.php file to match your
server's settings and your own personal preferences. Use the comments within the file as a guide to each setting. Be careful to
only edit the text between the quotes: don't remove the semicolon from the end of any line or any quotation marks.
You will need to specify the path to your server's "mogrify" ImageMagick binary executable if you plan to use ImageMagick.
If you don't know the location, run the following command from the command prompt to find it:
Then set $mogrify_command in config-inc.php as:
$mogrify_command = "/your/path/to/mogrify";
Alternatively, if you plan to use the GD 2.0.x Graphics Library instead of ImageMagick, you will need to set $usegd = 1;
where indicated, in order to use GD2 instead of ImageMagick's mogrify to handle image resizing.
If you want to be able to upload zip files that contain images, you will also need to find
"unzip" on your server. Follow the above procedure for locating mogrify if you can't find unzip (use "locate unzip").
You'll need to enter the path to unzip in config-inc.php where indicated.
Now create a directory on your web server for PhotoPost. The directory needs to be accessible via the web. Upload PhotoPost's
directories and files from your local machine to your server using FTP. The directory structure on your server should be as follows:
images (chmod 755)
uploads (chmod 777)
help (chmod 755)
data (chmod 777)
Be sure to FTP all .php and .sql files into the photopost directory. All permissions
for .php and .sql files should be set to chmod 644.
4.) Web Installation Script|
Now you are ready to run the web based installation script that will check your
server for PhotoPost's requirements and set up your PhotoPost database. Open
install.php in your web browser and follow the prompts.
Step 1 will test your server - if this step fails, please be sure that your web server
is properly configured with PhotoPost's requirements in mind.
To proceed to the next step, click the link to do a fresh install of PhotoPost PHP.
Step 2 sets up your database. Click on the link to go to Step 3.
Step 3 prompts you for some information, and our script tries to guess as to
your server's settings. Please don't assume that the defaults are correct, double
check them. Hit the button at the bottom of the page to continue.
Step 4 completes the installation process. If you receive an error message at this point, check
your config-inc.php file and be sure that the settings there are correct. Make sure that
your MySQL database for PhotoPost is properly set up and that the username and password
that you're using to access it are correct and that the user has write privledges.
PhotoPost installation is now complete. Be sure you remove your install.php file
(and the various upgradeXX.php files and any .sql files)
from your server's PhotoPost directory to prevent malicious users from altering your PhotoPost settings.
To proceed, open the administrative control panel, adm-index.php, in your browser.