Getting Started

Prerequisites

Before installing the Photo Order Plugin, make sure you have the following software installed on your server:

• Joomla! 1.5
• VirtueMart 1.1.9

Installing The Component

Aurigma Photo Order is a component for Joomla! and its installation process is the same as for any other such component.

1. Login as Joomla! administrator.
2. Go to Extensions → Install/Uninstall.
3. In Upload Package File select the plugin package (Aurigma Photo Order.zip) and click Upload File & Install.
   
   –or–
   
   If it does not work for some reason, the alternative method is as follows:
   1. Unzip Aurigma Photo Order.zip on your local drive.
   2. Upload the folder with component files to a temporary location on your server (through FTP or whatever else method).
   3. In the Install from Directory section specify the full (absolute) path to the component folder.
   4. Click Install.
   5. Remove files from the temporary folder.

If everything is done correctly, you will see the plugin in the list of installed components.

Configuring the Component

Before you use the component, you should configure it. To do this, go to Components → Aurigma Photo Order → Preferences.

License Key

First of all, you need to specify the license key for Image Uploader used in the plugin. You can receive an evaluation license key in My Licenses & Downloads section (License Keys → Evaluation). Upon purchase you will receive a full license key.

A license key is inserted in the License Key field on the preferences page.

Order Folder Settings

To specify where the ordered photos will be uploaded, specify the path to the folder in the Orders Folder field. Make sure that the web server process has enough permission to write to this folder.

You can also specify the order folder structure in the Order Folder Settings field. By default it is {date}/{order_id}/{size}_{paper}/{quantity}_{filename}. You can change it using the following syntax:

• “/” – directory separator,
• {order_id} – order number,
• {date} – order date,
• {filename} – name of the uploaded file,
• {quantity} – quantity,
• {attribute_name} – name of an attribute (e.g. “size” or “paper”), if the product has this attribute the value will be set automatically.

To add attributes to your product go to Components->VirtueMart, select your product, go to the Product Status Tab, find Attribute List, add new attribute and specify some properties and their prices.

Minilab Support

If you have a minilab which supports DPOF, the Photo Order component can streamline the order fulfillment by generating a special description file. This file enables the minilab to print photos in the automatic mode. It is generated for each combination of a paper type and print formats (channel).

To enable DPOF files, set the Export Orders to DPOF option to Yes. After that use the joomla_root/administrator/components/com_aurigmaphotoorder/classes/dpof/channels.xml file to configure channel numbers.

Other Settings

You can also configure the following parameters:

• Width – the width of the Image Uploader control (you can specify it percents or pixels).
• Height – the height of the Image Uploader control (you can specify it percents or pixels).
• File Filter – the file filter for the Image Uploader control (to filter out files you cannot print).