PhotoPost Photo Sharing Photo Gallery    Visualize community tm
Fareness: Discover When & Where for Low Fares
| | |
PhotoPost PHP Pro 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.

Whenever possible, the script will try to self-correct any problems (like permissions or missing directory); but in order for the script to do this the files/directories must be setup by you so that the server has permissions to do these things as per our instructions below.

1.) Server Configuration

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, and ImageMagick 5.3.8 or greater. Verify these requirements with your web host if unsure.

2.) Database Configuration

If you're using PhotoPost with an existing forum, you can either use the MySQL database that you're presently using for your forum for both PhotoPost and your forum, or you can create a separate database for PhotoPost (in either case, your forum user database will still be used by PhotoPost). If you choose to, or if you are using PhotoPost by itself, create a MySQL database for PhotoPost and record the database name and the username and password needed to access it. Be sure to consult and your web host if you have questions about installing MySQL or setting up a MySQL database.

If you plan to use PhotoPost with an existing forum, we recommend that you backup your database before proceeding. PhotoPost is designed to work with the "stock"/unaltered versions of the various supported forums, not hacked versions. Most hacks should not affect PhotoPost's use of your forum user database table and usergroups table(s), but backing up is the safest way to go.

New Installations can specify a table "prefix" if you need to install all your tables into a single database. Entering a unique prefix will allow PhotoPost to exist in the same database as other applications without risk of sharing table names.

3.) Downloading PhotoPost, Uploading Files

Download PhotoPost 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", "help", "languages", "stylesheets" and "data".

You can either edit your config-inc.php in a text editor (like NotePad) or you can wait until you run the install.php program which will let you review your config-inc.php options and set them there.

If you choose to edit the config-inc.php manually: 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. If you plan to use PhotoPost's internal user registration system rather than interfacing with a forum user database, make sure that $database and $database_bb are both set to the same PhotoPost database.

Before you run Install

First determine if your server has ImageMagick or GD installed, by referencing our requirements page (or ask your web host). If your server does not have ImageMagick or GD installed, you can install whichever is easiest yourself, you can ask your host to install one, or you can purchase our affordable install service to have us install PhotoPost with either ImageMagick or GD (as appropriate) together on your website/server for you.

GD / GD2 Graphics Users

Some PHP installations include support for GD/GD2 graphic extensions. You can verify your server's setup by checking your phpinfo. See our requirements page for instructions on how to check your server configuration in the "Testing Your Web Server for Compatibility" section.

If you plan to use the GD Graphics Library instead of ImageMagick, you will need to set $usegd = 1 in config-inc.php for GD 1.x.x or set $usegd = 2 in config-inc.php for GD 2.x.x, or choose GD1 or GD2 from the dropdown during the install process (see below).

ImageMagick Users

You will need to know 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:

locate mogrify

You can edit config-inc.php manually now, or you can configure this in step #4 below. For manual config, set $mogrify_command in config-inc.php as:

$mogrify_command = "/your/path/to/mogrify";

or, for NT users:

$mogrify_command = "c:/path/mogrify.exe";

(Note the use of forward slashes, this prevents PHP from confusing paths).

If you are going to run the install.php to set your configuration (instead of editing config-inc.php by hand), please take note of the path to mogrify for later use during the web based install.

Now create a directory on your web server for PhotoPost. The directory needs to be accessible via the web. FTP PhotoPost's directories and files from your local machine to your server. The directory structure on your server should be as follows:

  data (chmod 777)
     1 (chmod 777 - including subdirectories)
     2 (chmod 777 - including subdirectories)
     500 (chmod 777 - including subdirectories)
  documentation (chmod 755)
  forums (chmod 755)
  help (chmod 755)
  images (chmod 755)
  js (chmod 755)
  languages (chmod 755)
  mobile (chmod 755)
  stylesheets (chmod 777)
  templates (chmod 777)
  uploads (chmod 777)
     1 (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.

During installation the install script will check your permissions and, if set incorrectly will try to correct them. However, for this to work your web server must have permissions to make changes to these files. If you encouter an error while running Install it is probably because the web server does not have the permissions it needs to make changes or create files. Check your user/group ownership permissions to ensure they match your web server.

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 let your review and/or set your options in config-inc.php. Your config-inc.php MUST be writable by install for this step to succeed. If you get an error, it is because the server does not have write access to the file. Change permissions to 777 and run again.

Step 2 will test your server for the graphics selection you chose. If you selected ImageMagick, it will look for mogrify at the path you specified. If you selected GD, it will test to make sure the GD library is installed. If either returns an error, then you need to go back and either find the proper path to mogrify - or your server does not support the GD library you selected.

To proceed to the next step, click on "Click here for a FRESH install".

Step 3 will check your database settings. If the server cannot connect to the databases you specified, you will get an error. To fix this you will need to edit your config-inc.php variable settings and hit REFRESH; or restart install.php and edit your selections. Once verified, the install program will begin populating your tables with our data. Finally, the script will ask whether you want to install PhotoPost using its Internal User registration system, or to instead work with an existing/external Forum user registration system.

Step 4 will prompt you for some server configuration 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. If you are using PhotoPost with a forum, note that the following forum versions correspond with the selections in the drop down box (those using PhotoPost's internal registration system can ignore this):

2.2.0 = All vBulletin versions v2.2.0 and newer
2.0.3 = vBulletin versions between 2.0.3 and v2.2.0 (not including 2.2.0)
phpBB2 = phpBB 2.0+ (RC versions not supported)
UBBThreads v6 = UBB Threads versions 6.x
DCForums = DCForums 1.2
InvisionBoard = IPB 1.1.1

Step 5 will set up your user and usergroups database. If you receive an error message at this point, check your config-inc.php file and be sure that the settings for your $bb_database 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 insert, update, delete, and alter privledges.

PhotoPost installation is now complete. Be sure you remove your install.php file (and the various upgradeXX.php/.sql)files) from your server's PhotoPost directory to prevent malicious users from altering your PhotoPost settings. Leave the .sql files in place as they are used later if you reimport usergroups.

To proceed, open the administrative control panel, adm-index.php, in your browser.

5.) vbPortal/vBulletin header-inc.php Visual Integration

If you use vbPortal or vBulletin, you can integrate your forum's look and feel into PhotoPost. The vbPortal integration displays your vbPortal top/left side, and bottom, around PhotoPost. The vBulletin integration displays your default vB header/footer templates with PhotoPost. To implement this, open header-inc.php and follow the instructions there. vbPortal users should only edit the vbPortal section (not the vBulletin section), and those who use vBulletin only should only modify the vBulletin section.

IMPORTANT - FOR VBULLETIN 4 ONLY. New plugins included in download.

In the install directory set permissions on the file product_pppro.xml, source-vb4.xml and source-vb42.xml files to 777

2. Go to your photopost admin panel ( ) and hit the option to generate vbulletin plugin xml. That file will download to your computer.

3. Go into your vbulletin admin panel and under plugins & products select the option to manage products. You can then use the add/import product option and upload the xml file you downloaded to your computer called product_pppro.xml file. Once that is done your forum will show gallery content.

4. Thats it your done!!


1. Make a copy your vb config.php file from vbulletin install and place that copy into your photopost directory.

2. Copy the pp.php file from the install directory into your vBulletin forums root directory ( This is the root directory not any subdirectories ).

Important Note: Once you have finished installing PhotoPost, be sure to remove the PhotoPost zip file from your webserver and store the zip file on your local PC in a safe place, or burn it to a CDR disc as a backup. Your copy of PhotoPost can be traced back to you and if it is ever stolen and distributed illegally (this has happened!), you can be held liable for that distribution. If you keep the PhotoPost zip file on your PC, make sure you use a firewall product such as ZoneAlarm (free) to protect your PC from hackers, and never give your PhotoPost members area username/password to anyone. Even third party developers that you hire to do an installation or modification could steal your copy of PhotoPost and illegally distribute it.