Using the Light Blue API plugin for ProPhoto 5 sites

Using the ProPhoto theme for WordPress is one of the most popular ways of setting up a professional photography website, and ProPhoto 5 includes a flexible contact form that can be customised to suit your requirements (e.g. by asking your clients to specify the type of shoot they're interested in, their wedding date, etc). We've written a WordPress plugin that lets you link up your ProPhoto 5 contact form to your Light Blue account without needing to write any special code.

Requirements

To use the Light Blue API plugin for ProPhoto, you need to be hosting your own WordPress site (e.g. websites hosted on WordPress.com cannot use plugins) and have the ProPhoto 5 theme installed and activated.

Installation

You can download the plugin from the WordPress Plugins Directory. You need to un-zip the file and copy the folder called 'prophoto-light-blue' to your WordPress plugins directory. This is usually located at wp-content/plugins/ in your WordPress directory. Alternatively, you can use the 'Add New' section of the Plugins settings page in your WordPress admin console to search the WordPress Plugins Directory for "light blue" and install the plugin from there.

To set up the Light Blue API plugin for ProPhoto, first go to the Plugins section of your WordPress admin page and activate it. Next, click the Settings link for the plugin.

In the plugin settings page, you'll need to fill in your Light Blue API key. You can find your API key by logging into the My Account section of our website.

Linking the fields on your ProPhoto contact form to the Light Blue API

Once you've installed the Light Blue API plugin for ProPhoto, you need to associate the fields in your forms with parameters that the Light Blue API recognises.

To do this, you need to select your contact form fields from the menus in the 'Field Mappings' section in the plugin settings page, and enter the Light Blue API parameter that you want to send it to into the field next to it. The menu will list all of the fields from your contact form apart from 'Headline text' fields, and the field numbers correspond to those that appear in the 'Form Fields' section of the ProPhoto theme's Contact Form customisation page.

You can find a list of the parameters that the Light Blue API recognises in the Supported Parameters section. Any fields in your forms that have not had a Light Blue parameter set up for them, or have a parameter that doesn't match a valid Light Blue API paramater, will be ignored but stored in the ProPhoto contact form database as usual.

The next few sections of this documentation aren't relevant to using the Light Blue API plugin for ProPhoto, so you can skip ahead to the list of data types and parameters supported by the Light Blue API.