Denovo Voucher Script User Manual

Denovo Voucher Script

http://www.voucherscript.com

Denovo Voucher Script User Manual Version 2.0



Table of contents

Introduction ........................................................................................................................ 4 Site Setup ............................................................................................................................ 5 Unzipping contents ............................................................................................................. 6

Configuring database settings ........................................................................................ 6 Uploading files ................................................................................................................ 7 Database setup ............................................................................................................... 8

PhpMyAdmin Login page ............................................................................................ 8 Executing database Script form phpMyAdmin ........................................................... 9 Running database Script form phpMyAdmin......................................................... 10

Directory Permissions ................................................................................................... 11 Site Settings....................................................................................................................... 12

Logging into Admin back panel..................................................................................... 12 First time settings.......................................................................................................... 13 Managing Categories .................................................................................................... 15

Merging Categories................................................................................................... 16 Retailer Management ................................................................................................... 18

Adding retailers......................................................................................................... 19 Managing Retailer Imports ....................................................................................... 20 Mapping Retailers Feed columns to internal columns ............................................ 22

Vouchers/Discounts/Offers Management.................................................................... 23 What is iCodes?......................................................................................................... 25 Your Username and Subscription ID from iCodes .................................................... 26 How to configure your merchants over iCodes ........................................................ 27 Affiliate Networks and Merchants selection ............................................................ 30 Adding / Editing Merchants ...................................................................................... 31 How to configure your iCodes detail with voucher script ........................................ 33 Configuring iCodes.co.uk imports............................................................................. 35

Product Management ................................................................................................... 36 Adding new products ................................................................................................ 37 Editing existing product ............................................................................................ 38 Deleting existing products ........................................................................................ 39 Searching for products.............................................................................................. 40

Managing Feeds ............................................................................................................ 41 Adding new feeds ..................................................................................................... 42 Mapping Products Feed columns to internal columns ............................................ 43 Previewing Feed import............................................................................................ 44 Refreshing Feeds....................................................................................................... 45

Managing Banners ........................................................................................................ 46 Subscriber Management Registered Users................................................................ 48 Subscriber Management - Newsletter Subscribers ...................................................... 49 Managing Our Toolbar .................................................................................................. 50



Configuring Site Urls ..................................................................................................... 52 Configuring Site Logo .................................................................................................... 53 Configuring Analytic Settings ........................................................................................ 54 Configuring Change Admin Password........................................................................... 55



Introduction

Denovo Voucher Script is an affiliate marketing solution enabling you to make money by

promoting products, voucher codes, discount, offers etc.

Nearly all aspects of the site can be managed from the administrative back panel which

can be accessed by affixing /admin to the end of your sites URL. The site requires

affiliate feeds and URLs to function. This requires registration with affiliate networks

such as the following or any of your choice:

Affiliate future

Affiliate window

Paid on results



Site Setup

The site can be setup manually or via professional installation from

http://www.voucherscript.com/pricing.html. Setting up the site requires the following

steps:

1. Extracting and uploading files via FTP

2. Setting up database

3. Directory permissions

4. Configuring site settings

5. Configuring CRON

Before we can start setting up the site, we will need the following:

1. FTP server ip address of your hosting

2. FTP credentials (username/password)

3. phpMyAdmin details for your database

For details on how to acquire these credentials please contact your hosting support.



Unzipping contents

Unzip the contents of dvsx.x.zip (or the file you downloaded by clicking on the download

link in the confirmation email) to a temporary location. Once you have unzipped the

folder dvsx.x.zip, you will get four files as follow:

1. Upload contents of this folder to your webroot

2. Denovo Voucher Script User Manual.pdf

3. License Agreement.txt

4. Wordpress-plugin.zip

Now, you have to open the folder, as indicated at number one above. We will refer to

this location as [base]. Looking into [base] directory you should see .htaccess and

index.php files with folders app, cake and vendors.

Configuring database settings

Open database.php in [base]/app/config with any text editor and fill in the following

information

'host' => 'localhost', (local host or your mysql server address)

'login' => your-login name, (username)

'password' => 'your password', (password)

'database' =>'database name', (database name)

Save and close database.php file.



Uploading files

Login with your ftp credentials to your hosting account and upload all files present in the

[base] directory. Once all files have finished uploading, you may disconnect.



Database setup

Setting up your database requires phpMyAdmin. Most web hosting accounts come

bundled with it. This software allows you to manage your databases. If you are unable

to locate it please contact your web hosting provider for assistance.

PhpMyAdmin Login page

Login to your phpMyAdmin site. The screen looks similar to the following:



Executing database Script form phpMyAdmin

Once logged in, select the database you wish to associate with Denovo Voucher Script

from the list on the left column (this database must be the same as set forth in the

database settings section above). Make sure the database is empty otherwise you may

lose data.

Click on the SQL tab on the top of the page



Running database Script form phpMyAdmin

Open the sql file present in following path: [base]/app/config/sql/db-script.sql in any

text editor, copy the contents of this file and paste into phpMyAdmin SQL window, as

shown below. Click the go button.

If you do not see any errors (text written in red with words like Error) your database

has been set up successfully.



Directory Permissions

755 permission needs to be assigned to the following directories

/app/webroot/img/logos

/app/tmp/uploadfiles

/app/tmp/retailerMassImport

It is recommended that you use your cPanel or Plesk or equivalent hosting account

management application to set the permissions for best results.



Site Settings

Logging into Admin back panel

To access the admin panel append /admin to your domain name, for example, your

domain is called acme you would go to www.acme.com/admin

Use the following username and password to access the admin panel

Admin username: admin

Admin password: admin



First time settings

Once logged in, you will have to manage settings for the website. Beginning with giving

your site a friendly name you have to specify a few settings to get your site up and

running.

Second, you have to set your site URL, which will be used in emails and links. Like

http://www.your-url.com or http://www.your-url.co.uk etc. However, please dont

include / or // or \ or \\ at the end of URL.



Admin Dashboard

There are fifteen main tasks for the administrator as follow:

1. Managing Categories

2. Managing Retailers

3. Managing Vouchers

4. Configuring iCodes.co.uk imports

5. Managing Products

6. Managing Feeds

7. Managing Banners

8. Managing Retailer Imports

9. Managing Subscribers

10. Managing Users

11. Configuring Our Toolbar

12. Configuring Site Urls

13. Configuring Site Logo

14. Configuring Analytic Settings

15. Changing Admin Password



Managing Categories

Categories can be managed by clicking on the Categories link on the left side of the

Admin Panel under Content Management tab. There are two levels of categories shown

in parent-child tree:

Parent Categories

Sub Categories

Parent Categories are the top level categories in which all related sub categories are

displayed. To add parent category, click on the link Add Parent Category and to add

sub-category just click on the link Add Sub Category.



Merging Categories

This feature is helpful where Category titles resemble. Click a category being merged

and new screen will show other categories. Select category being merged into and then

hit merge button to merge the retailers of source category into new category. The

source category will no longer have any associated merchants/retailers, this is useful for

deleting categories whereby all retailers are assigned to another and category is marked

as hidden.



On completion, a message will be shown and window will be disappeared.



Retailer Management

This page can be accessed via Content Management in the top menu or Retailers in

the left menu under Content Management.

A retailer can belong to any number of categories. You can add a new retailer by clicking

on the Add Retailer link or manage any existing retailer by choosing the appropriate

action in the row.

Following can be performed on this page

1. Adding new retailers

2. Editing retailers

3. Deleting retailers

4. Searching retailers

5. Viewing and Editing Retailers Vouchers, Discounts, Deals and Offers

6. Upload Logo



Note: when new vouchers are imported from iCodes, there may be retailers not present

locally which are automatically added to the site but require manual update to assign

proper category.

Hint: Click on the Edit or link under Category Column. A new window will appear

containing related information. You can manage Retailer, Vouchers, Deals, Discounts,

and Offers.

Adding retailers



Hint: To select multiple categories for any retailer press CTRL key and then click to

select categories. The fields mark with asterisk is required.

Note: CTRL key is Short for control. CTRL is a key found on computer keyboards. This

term is commonly used to refer to a keyboard shortcut key such as: CTRL + ALT + DEL

Note: While adding a new retailer, you can add regular URL or an affiliate URL in web

field.

Managing Retailer Imports



To import Retailers from CSV feed click on the Import Retailers link at the top of the

page and choose a file to upload and click the upload button. Once the upload

completes you will be redirected to the next step of mapping the feed columns to

system columns. You can also upload zipped files, but the zip file must contain only a

single feed. (The whole process follows the same as feed uploading, mapping, and

previewing)

You can also continue later after uploading a file by using the Refresh Retailers

section. This section displays all the feeds that have been imported into the system or

are available to import.

Select from any of the available feeds (choose only .csv files)



Click on the Refresh button to resume the feed import process

Mapping Retailers Feed columns to internal columns

In order to import data from the Feed, a mapping must be defined. For each field on the

left, select an appropriate equivalent entry from the drop down list on the right. The

drop down list contains columns found in the CSV or zip file uploaded in the earlier step.

Please note that only 120 X 60 size images are supported for logo URL.

Note: The Domain For domain field must be with out http:// in start and / or // or \ or \\

in the last.



Vouchers/Discounts/Offers Management

This page can be accessed via Content Management in the top menu or Vouchers in

the left menu under Content Management.

All vouchers present in the system are displayed on this page.

Vouchers/discounts/offers imported via iCodes are also listed here. Though the ones

imported from iCodes can be removed from the iCodes report page, these can also be

managed like manually added from here.

To search for a specific voucher, enter its title in part or whole and click the search

button.

Clicking the edit button displayed in each row allows for editing of that particular

item.



To delete a voucher, click on the delete link shown next to each voucher. This will

permanently remove the voucher from the system.

To add a new Voucher/Discount/Offer to the system, click on the Add Voucher button

at the top of the page.

Fields marked with an * are required, if image URL is omitted then retailers image is

used. The voucher code field does not apply in case of discounts, offers and deals.

Marking the voucher as featured will cause it to be displayed under the Featured

Vouchers section on the home page.



What is iCodes?

The icodes is a central affiliate database containing

over 2700 merchants, 1100 voucher codes and 2500 offers across 14 affiliate networks,

including categories, merchant keywords, merchant ids, merchant logos, merchant urls

and affiliate urls, which can be accessed, added to and edited via own admin area to

make the service unique to you.

iCodes is an online voucher code and offers database which is fed back to the

users who populate it, making it up to date, accurate and well policed by everyone

involved. (You benefit from the data everyone contributes to)

ICodes technology connects directly to most affiliate network databases to

automatically pull in the voucher codes, the users then collectively do any necessary

editing then submit each voucher code to the shared iCodes database, iCodes then

automatically add affiliate ids ready for one to import directly to ones website

The iCodes first of all asks to register on their website. This registration assigns a

user name and a subscription id. Then it moves to payment process which is using pay

pal. After payment the management verifies the payment is done and then it allows you

to user their database using username and subscription id to import data like

merchants, Offers, Voucher codes.



Your Username and Subscription ID from iCodes

To enable your iCodes feeds you will need to know your iCodes Username and

Subscription IDs. Your username is what you chose when you registered for the

webservices account and the Subscription ID is allocated to you once registered.

If you have registered already, both of the above details are located on

the Home page of your webservices account (After login you will see like)



How to configure your merchants over iCodes

Step 1 Insert your affiliate IDs by using the my affiliate ids tab.



Step 2 Select your Not Joined, Joined and Rejected Merchants by using the my

merchants tab.



Step 3 Select which categories you want to be included in your feed by using the my

categories tab.

You are now ready to import data.



Affiliate Networks and Merchants selection

If you havent already done so, you are required to join the networks and apply to

merchants you wish to promote before importing data.

iCodes currently cater for all the merchants on the following affiliate networks

affiliate future

affilinet

affiliate window

buy.at

commission junction

DGM

linkshare

moreniche

paid on results

profitistic

silvertap

trienta affiliates

tradedoubler

webgains



Adding / Editing Merchants

Adding and Editing merchants in the iCodes database is purely optional, but help from

the users is greatly appreciated and the backbone of how iCodes functions.

Step 1 (Add Merchant) Go to my merchants > add / edit merchant, fill out the

form and press add merchant



Step 2 (Edit Merchant) Using the same page as above, select merchant, do any

necessary editing and press edit merchant



How to configure your iCodes detail with voucher script

After having your iCodes account you would have to add them in your settings.

If you set up first time your site, you will provide detail there. How ever, you can edit

them later.

We suppose here that you have setup the site before and you are integrating icodes

later. Follow the following steps.

Click on Configure > Manage iCodes.co.uk automatic imports. Enter your user iCodes

username and subscription id.

After setting this, now you have to run first time imports, because it is necessary to

enable the scheduler. Click on iCodes menu from left site others tab. You will see a page

with some instructions and note, following the click here link. You will see it only once

until you have not run the first time imports.

When you click first time this link, you will see the log entry in the table on the

same page after some moments. Then you have to set the cron job option from your

cpanel. The URL for cron job will be http://www.your-site-

name.com/feeds/icodes_schedular_import.



Now the scheduler will be run after some time which you have set and the new

imports will be automatically imported to your database.



Configuring iCodes.co.uk imports

To update your icodes account credentials just Click iCodes.co.uk imports under Site

Configuration.



Product Management

Product management allows you to mange all products that have been imported into

the system using product feed imports or by manual addition. From this page you can

do the following

1. Add new products

2. Edit existing products

3. Delete existing products

4. Search for products



Adding new products

To add a new product, click on the Add product button. This will redirect your browser

to the add product form. Choose a retailer this product belongs to and fill in other

details. If you mark this product as Featured it will shown under the featured products

section on the home page.



Editing existing product

You can edit products that exist in the system by clicking the edit link shown next to

each product. Once done, clicking the update button will save the changes.



Deleting existing products

To delete a product, click on the delete link shown next to each product. This will

permanently remove the product from the system.



Searching for products

If you want to search for a particular product, enter its title and click the Search button.

The title can be exact or part of the product title. Search results are shown below the

form.



Managing Feeds

Clicking on the Feeds button will bring up the screen with all the feeds imported into the

system to date. Feeds import is a smart way of adding thousands of products to your

site automatically, instead of adding one by one manually. This feature enables you to

have a site loaded with thousands of products in no time.

Note: Only comma separated (CSV) files are supported.

Use the Roll back feature to remove everything imported into the system via a

particular feed. If you want to remove individual products you should remove them by

using Product Management from Content Management.



Adding new feeds

To import a new feed click on the Add Feed link at the top of the page and choose a

file to upload. Every feed file imported must be associated with a retailer therefore after

choosing the file choose the corresponding retailer from the Select retailer list and

click the upload button. Once the upload completes you will be redirected to the next

step of mapping the feed columns to system columns. You can also upload zipped files,

but the zip file must only contain only a single feed.

You can also continue later after uploading a file by using the Map Feed File section.

This section displays all the feeds that have been imported into the system or are

available to import.

Select from any of the available feeds (choose only .csv files) and also the retailer this

feed should be associated with.

Click on the Next button to resume the feed import process



Mapping Products Feed columns to internal columns

In order to import data from the Feed, a mapping must be defined. For each field on the

left, select an appropriate equivalent entry from the drop down list on the right. The

drop down list contains columns found in the CSV or zip file uploaded in the earlier step.

Please note that only 160 X 175 size images are supported.



Previewing Feed import

Clicking on the next button will cause the system to show a preview of how the data will

be imported from the feed. If you feel that there are no errors, press next to confirm

feed import or back to go back and alter the mapping.

Note: if you see no or incorrect data, try selecting file type and click Reload Preview

button to try other import possibilities.

If you click on the next, you will get the results as shown below (these results may

vary depending on the file you have used)



Refreshing Feeds

If you want to update the products for a particular retailer you simply repeat the add

feed process and it will update the records instead of adding them again.



Managing Banners

This page can be accessed via Configure->Site Settings->Banners in the top menu or

Banner Settings in the left menu under Site Configuration.



There is room for three banners on the site and these are shown on all pages. A top

banner and two left banners. The banners are as follows

Banner Size Displayed at

Top Banner 474x68 Top right

Mid 1 125x125 Middle left

Mid 2 125x125 Middle left

Each banner has an Image path and a corresponding URL which is used when a visitor

clicks on the banner image.

The active box controls whether this banner is shown on the site.

Hint: image and affiliate urls can be acquired by logging into your affiliate network and

browsing through creative for retailers/merchants.



Subscriber Management Registered Users

Registered users allow a visitor to register on the site and bookmark a product, voucher,

retailer, etc. Site administrator can later view these bookmarked items by clicking on

user names.



Subscriber Management - Newsletter Subscribers

Visitors who have subscribed to newsletters can be found here. The list can be exported

to CSV format by clicking on the Download subscribers link.



Managing Our Toolbar

Clicking on the Our Toolbar link will bring up the Our Toolbar settings window.

To create a free toolbar for your site, please visit conduit (www.conduit.com). Once

completed, enter the URL for the toolbar into the Our toolbar URL configuration field

(see Fig. Toolbar-1-a) and a button will appear automatically on your homepage to let

your visitors download the toolbar.

Fig. Toolbar-1-a



To display Latest Vouchers and Latest Products on your toolbar, please add an RSS feeds

into your toolbar on conduit account and just copy and paste the feeds URL of Vouchers

and Products from your Toolbar settings page. You can set the titles, as well, for your

Vouchers and Products which will be displayed when the visitor clicks on your toolbar

feeds. See Fig. Toolbar-1-b

Fig. Toolbar-1-b



Configuring Site Urls

For changing the Site URL, Site name or Click to Reveal Setting just Click Site Urls under

Site Configuration, you can edit them any time.



Configuring Site Logo

You can upload a new site logo for your site.

Note: The previous logo will be deleted automatically.

Hint: For best result logo size is (309 X 106) and logo file type is jpg.



Configuring Analytic Settings

To update your analytic code settings just Click Analytic Settings under Site

Configuration.



Configuring Change Admin Password

You can change your admin password from Configure > Change Admin Password.

Documents

Denovo Voucher Script User Manual