Voucher Codes

To modify Voucher Codes support, edit the value of the $config_useVoucherCodes variable at line 41 of config.advanced.php as follows:

$config_useVoucherCodes = 0;


Voucher Codes disabled. This will save an unnecessary database query on product pages if not using Voucher Codes. This is the default setting in the distribution.


$config_useVoucherCodes = 1;


Voucher Codes applied in real time on product price comparison pages.


$config_useVoucherCodes = 2;


Voucher Codes applied at import time, and will therefore be reflected in the prices displayed on search result pages. Only use this setting if running automation and importing all feeds daily, or your feeds will be guaranteed to be re-imported within any voucher code expiry period configured.

Adding a new Voucher Code Feed

1. Upload a voucher code feed into the /voucherfeeds/ directory.
2. Go to Content Management > Voucher Codes.
3. Click Register alongside the filename that you have just uploaded.
4. Wait for the feed format autodetection to complete, and then click Next.
5. If autodetection was successful you will be able to see the contents of the first voucher code record displayed at the bottom of the page. If you cannot see the first record, click Back and manually select the correct file format from the drop down menu.
6. Select (or confirm if auto-selected) the fields from the feed that correspond to the Merchant Name, Voucher Code, Valid From (optional), Valid To (optional) and Description, then click Next.
7. Select the merchant names from the feed that correspond to the merchant names on your site, as they may not necessarily be the same. Where there is an exact match the mapping will be auto-selected.
8. Click Register and List to register the voucher code feed and view the codes contained within it. From this page, you can click the links to Add a new voucher code to your site using feed assistance, or alternatively Edit or Delete any existing voucher codes.

Updating A Voucher Code Feed

1. Upload the latest version of a voucher code feed into the /voucherfeeds/ directory, making sure to use the same filename.
2. Go to Content Management > Voucher Codes.
3. Click the link to list the voucher codes in the feed. From this page, you can click the links to Add a new voucher code to your site using feed assistance, or alternatively Edit or Delete any existing voucher codes. There is no need to re-register feeds whenever you update them as long as the format has not changed.

Removing A Voucher Code Feed

1. Delete the voucher code feed from the /voucherfeeds/ directory.
2. Go to Content Management > Voucher Codes
3. Click the link to de-register the missing feed.

Adding a new Voucher Code (Manual)

1. Go to Content Management > Voucher Codes
2. Click New Voucher Code.
3. Enter the Merchant Name and Voucher Code where indicated.
4. If the voucher code applies to a specific or range of products, choose the match type, field name and enter the name or keywords required to identify the product or products for which the voucher code is valid where indicated.
5. If the voucher code is dependant upon a minimum and / or maximum spend, enter the minimum spend and / or maximum spend amounts where indicated.
6. If the voucher code applies to all products for the selected merchant, enter 0.00 as the minimum spend where indicated.
7. Enter the discount value and type. If using type "other", you can enter a description for the discount (e.g. "Free Shipping") where indicated.
8. Enter the validity period for the voucher code where indicated.
9. Click Save to add the voucher code to your site.

Adding a new Voucher Code (Feed Assisted)

When adding a new Voucher Code using feed assistance the Merchant Name and Voucher Code fields will be pre-populated. In addition, the script will attempt to pre-populate the value of other fields based on the data contained in the voucher code record from the feed. The raw feed data is displayed on the right hand side of the page to assist in either selecting the match criteria and discount fields, or confirming that they have been pre-populated correctly.

Voucher Codes Index

The distribution contains an example front end file vouchers.php which you can link to if you wish to emphasise voucher code availability to your visitors.