Download - Denovo Voucher Script User Manual
-
Denovo Voucher Script
http://www.voucherscript.com
Denovo Voucher Script User Manual Version 2.0
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
Configuring Site Urls ..................................................................................................... 52 Configuring Site Logo .................................................................................................... 53 Configuring Analytic Settings ........................................................................................ 54 Configuring Change Admin Password........................................................................... 55
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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:
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
On completion, a message will be shown and window will be disappeared.
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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)
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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)
-
Denovo Voucher Script
http://www.voucherscript.com
How to configure your merchants over iCodes
Step 1 Insert your affiliate IDs by using the my affiliate ids tab.
-
Denovo Voucher Script
http://www.voucherscript.com
Step 2 Select your Not Joined, Joined and Rejected Merchants by using the my
merchants tab.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
Step 2 (Edit Merchant) Using the same page as above, select merchant, do any
necessary editing and press edit merchant
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
Now the scheduler will be run after some time which you have set and the new
imports will be automatically imported to your database.
-
Denovo Voucher Script
http://www.voucherscript.com
Configuring iCodes.co.uk imports
To update your icodes account credentials just Click iCodes.co.uk imports under Site
Configuration.
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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)
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
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.
-
Denovo Voucher Script
http://www.voucherscript.com
Configuring Analytic Settings
To update your analytic code settings just Click Analytic Settings under Site
Configuration.
-
Denovo Voucher Script
http://www.voucherscript.com
Configuring Change Admin Password
You can change your admin password from Configure > Change Admin Password.