Coppermine Photo Gallery Shop manual.

This page has the instructions for using Coppermine as a shop for photoprints, using Paypal.
For general Coppermine setup, see the manual, click here.


Requirements

There is only one extra requirement to the standard setup, and that is you require a Premier or Business account with Paypal. This is easy to set up, and will make it easy for you to collect your payments.

Installation.

If this is a complete new install, first upload and install version 1.3.2 of Coppermine, and ensure it is working correctly.

The installation of this version is exactly the same as for the standard version, except you should first choose how many print sizes you are going to offer, and if you are going to offer choice of paper type or not.

Within each theme folder, there is a new folder, shop themes, containing a selection of theme.php files.
Each file name starts with a number, and this is the number of sizes available using this file.
After the number, there is either 'with_choice', or 'no_opt'.
The choices given are for paper type, and are glossy, matt, and satin.
So if you want to offer 4 sizes, and a choice of paper, you will need the file '4_with_choice_theme.php'.
If you want 5 sizes, but no choice of paper, then you would need '5_no_opt_theme.php'.

The theme.php already in the theme folder, is the '4_with_choice_theme.php', so if this is the combination you want, there is no need for you to do this next section. If not, this is what you need to do;


Upload all files to the server, and run update. The shop will not work if you miss this update.
Upload the pictures in the images folder into the images folder on the server.



Setting up shop.

Config

Once the coppermine install is up and running, you need to set up the configuration.
Log on in admin mode, and click on the 'config' menu item.
Fill in your site name details. It is important that the 'Gallery administrator email', is the same email address as your Paypal account, otherwise the shop will not work.



You also need to make sure the 'Target address for the 'See more pictures' link in e-cards' is set correctly, with the full url to your gallery, complete with the trailing slash '/'.

Setting prices

You now need to set up the config to show your prices and options.
Still in config, find the 'Shop sizes and prices' section.
Fill in the sizes you are making available, and their prices. Do not use any currency code in these fields.







Setting Currency

Now you have to set the currency symbol and code. The symbol is used to display the correct symbol to the viewer, and the code is used by the paypal button.
It is important that for the code, you use only the correct one as shown for your currency, and use upper case. The symbol is not critical, so you can just use '$' instead of 'US$', if you prefer.





Now set the 'thumbnail view' settings. You are advised to set these as shown here;





Now find the 'Custom fields for image description' section, and in field 1, insert 'Description'.




The remainder of the config settings are unchanged from the standard, set as you want.



Uploading your pics.

Pics are uploaded as normal, but if using the html upload, the info boxes have changed slightly, but are self explanetory.

You can upload up to 10 pics at a time using the html upload method.
Unless you only have only a few to upload, you are advised to upload to the server by ftp. You should ensure they are put into folders you create within the albums folder, but not into the 'userpics' folder.
Now use the 'batch add' function from the admin menu, to place these pics in your albums.

Once placed in the album, the pictures need to have their info added. Click on the 'edit files' button, next to the album thumb.



In the edit files area, you can do most things to each picture.
It is important that you file in the 'picture title', and 'description' fields. (at the time of writing, if the description has no entry, there will be an error shown, when viewing the full pic. It will display, and work as normal though).

Note that you can use BB Code in the description, to add links etc.





Hopefully, when you look at at picture, you should see something like this, which is in the igames theme.





Customising the PayPal buttons


Do not attempt this unless you know what you are doing.

If you have set up re-direct pages etc., you can add these to the paypal button code.
Simply look at the code for your re-direct pages, and add it in to each of the buttons on the theme.php you are using.


You can also change the buttons themselves, again simply replace the existing button url ("https://www.paypal.com/en_GB/i/btn/x-click-but22.gif") with your own one.



Adding languages

The only language included in the package is English, but any language file can be edited to include the shop section.


Open your language file, and find;
// File config.php

Now, after this code, 'array('Character encoding', 'charset', 4),' add the following, and edit it to your language;


'Shop sizes and prices',
array('Size 1', 'size1', 0),
array('Price size 1', 'size1_price', 0),
array('Size 2', 'size2', 0),
array('Price size 2', 'size2_price', 0),
array('Size 3', 'size3', 0),
array('Price size 3', 'size3_price', 0),
array('Size 4', 'size4', 0),
array('Price size 4', 'size4_price', 0),
array('Size 5', 'size5', 0),
array('Price size 5', 'size5_price', 0),
array('Size 6', 'size6', 0),
array('Price size 6', 'size6_price', 0),
array('Currency symbol US$ - Can$ - £ - € - ¥', 'currency_symbol', 0),
array('Currency USD-CAD-GBP-EUR-JPY', 'currency', 0),




Well, that's it, your shop should be up and running now.
Good luck.