Installation Instructions

Thank you for purchasing Photography Orders. Please follow these installation instructions carefully. You can also view a video of the installation process.

1. Create a folder on your webserver where you're going to install Photography Orders
2. Create a MySQL Database
   
   Instructions for creating a database in cPanel can be found here: http://twiki.cpanel.net/twiki/bin/view/AllDocumentation/CpanelDocs/DatabaseWizard
   
   Instructions for creating a database in Direct Admin can be found here: http://www.site-helper.com/mysql.html#create
3. Go into /system/application/config/config.php and set the base_url to the base url of your install.
4. Go into /system/application/config/database.php and enter your database details (that you setup in step 2)
5. Go into /system/application/config/dx_auth.php and enter your website name and email address. (line 18 and 19)
6. Upload the contents of porders1_00 to your webserver in the directory you wish to house photography orders.
7. Download the latest version of postlet from http://sourceforge.net/projects/postlet/files/?_test=var1. Credit for Postlet goes to Simon Rycroft and http://postlet.com
8. Open javaUpload.php in a text editor and replace the following text.
   
   ===Find this block of code==============================================
   
   // Configuration --------------------------------------------------------------- // Change the below path to the folder where you would like files uploading. // e.g. "/home/yourname/myuploads/" // Note, this MUST have the trailing slash. $uploaddir = '[PATH TO UPLOAD DIRECTORY]'; // Whether or not to allow the upload of specific files $allow_or_deny = true; // If the above is true, then this states whether the array of files is a list of // extensions to ALLOW, or DENY $allow_or_deny_method = "deny"; // "allow" or "deny" $file_extension_list = array("php","asp","pl"); // -----------------------------------------------------------------------------
   
   ===And replace it with this block of code==================================
   
   // Configuration --------------------------------------------------------------- // Change the below path to the folder where you would like files uploading. // e.g. "/home/yourname/myuploads/" // or "c:\php\uploads\" // Note, this MUST have the trailing slash. $user_id = intval($_GET['user_id']); $gallery_id = intval($_GET['gallery_id']); $base_path = preg_replace("javaUpload.php", "", $_SERVER['SCRIPT_FILENAME']).'uploads/'; mkdir($base_path.$user_id.'/', 0777); mkdir($base_path.$user_id.'/'.$gallery_id.'/', 0777); $uploaddir = $base_path.$user_id.'/'.$gallery_id.'/'; // Whether or not to allow the upload of specific files $allow_or_deny = true; // If the above is true, then this states whether the array of files is a list of // extensions to ALLOW, or DENY $allow_or_deny_method = "allow"; // "allow" or "deny" $file_extension_list = array("jpg","jpeg","JPG","JPEG"); // -----------------------------------------------------------------------------
9. Upload postlet.jar and javaUpload.php to your install directory.
10. Make sure you have the latest version of Java installed: http://www.java.com/en/download/index.jsp
11. Import install.sql into your database. In phpMyAdmin you can do this in the "Import" tab
12. On your webserver, set the permissions for the uploads directory to 777
13. Ensure that the permissions for index.php are 755
14. You're all done, view the app in your browser and login using username 'admin' and password 'admin'. Once everything is working, it's advisable to change the password by going to the "settings" tab.
15. You can create a form to integrate Photography Orders with your website. Visit this link for instructions.

Code documentation

For customising the design

• /system/application/views/layouts - Layouts for the application are found here
• /system/application/views - Views for the application are found here
• /css - Css files
• /js - Javascript files
• /img - Images

Uploads

/uploads - All photos get uploaded to this directory when they are uploaded by the photographer. They are sorted into directories based on user id and galleryid. So when the photographer uploads images for user 5 and gallery 33, the photos get uploaded to /uploads/5/33

Everything else

The app is built on CodeIgniter. Some good videos that will get you started in Code Igniter: http://codeigniter.com/tutorials/

Changing the default emails

You can change the default email text that gets sent to clients in this file:

/system/application/language/english/dx_auth_lang.php

The emails start at about line 23

Troubleshooting

Q. I'm getting an error: Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' in path/to/my/script on line 5. How do I fix it?

A. You need to get your host to upgrade your PHP to version 5. Also make sure that they install the GD2 extension while they're doing it.

Photography Orders does not work with PHP 4.x.x or on IIS.

If they won't upgrade it for you, you'll need to move to a different web host.

Q. There is nowhere to upload photos, or uploading photos doesn't work

A. Try these things

• Make sure permissions are set correctly (step 12)
• Make sure you have the latest version of Java (http://www.java.com/en/download/index.jsp)

Q. The "create gallery" and "create price list" links don't work.

A.Make sure you have Javascript enabled in your browser

Q. Thumbnails aren't working

A. Check that you don't have any non standard characters in your watermark text.

Answers more common questions can be found on our support forum: http://www.getsatisfaction.com/photography_orders

Support

For more information on how to get more support, please visit: http://www.photographyorders.com/policies/