Ioncube Omnistar Affiliate Install Guide

To install the Omnistar Affiliate Software, you will need your product zip file and a license file which can be download at http://software.omnistaretools.com. You will also need:

• PHP 4.2 or later
• An EMPTY MySQL 4.1 Database or later
• Your MySQL server information:
      • MySQL hostname
      • MySQL database name
      • MySQL username
      • MySQL password
• FTP software to upload the files
• A web browser (IE or Firefox)

(If you are not sure about the MYSQL information, contact your hosting company)

Important: Please make sure the MYSQL database that you use is an EMPTY Database because all information will be deleted from your database.

Important: Once you install our affiliate software, you are going to add special code to your "Thank You" page if you are going to pay commission based on sales. The "Thank You" page is the final step in the order process and the page users are forwarded when they complete your purchase. If the "Thank You" Page is on a secure server (i.e. the URL is https instead of http) then you should install the affiliate software on a secure server. For more information on accessing your secure server you should contact your hosting company.

STEP 1: UNZIP FILES

Unzip the software files on your local computer.

STEP 2: FIND WEB ROOT FOR SERVER

Log into your server with your FTP program and locate your "Web Root". This is the top-level directory where you can place web pages which will be displayed on your website.
This is the same directory in which your website's homepage are located. Examples on some servers are: /www/, /public_html/, /httpdocs/, /htdocs/, /html/

STEP 3: UPLOAD FILES

Rename ‘affiliate51’ to ‘affiliate’ before you upload the file and then the ‘affiliate’ folder to your web root. If you want to use another folder other then ‘affiliate’ then open a ticket at http://support.omnistaretools.com

When you upload the files, make sure that the files are transferred in the correct format (The choices are "ascii" or "binary"). (Most FTP programs have an auto-detect setting for transferring files in the correct mode and this should be used if your ftp program has this setting.)

Mac Users: If your FTP program has a setting for "Translate ISO characters" (i.e. Fetch), make sure it's disabled before you upload the affiliate program.

STEP 4. SET INITIAL FILE PERMISSIONS

If you are using a Unix-based Server, you will now need to set file permissions for specific files and directories that you uploaded in the previous step. If you are a Windows user, appropriate permissions may already be set. You should use your FTP program to change permission.

Set the following permissions:

[web root]/affiliate/admin/	set permissions on this folder to 777
[web root]/affiliate/img	set permissions on this folder to 777
[web root]/affiliate/lib/etools2.php	set permissions on this file to 666
[web root]/affiliate/lib/etools2_noperm.php	set permissions on this file to 666
[web root]/affiliate/spaw/config/spaw_control.config.php	set permissions on this file to 666

STEP 5: EXCUTE INSTALL FILE

Finally, excute the install program /[affiliate]/install.php with your Web Browser. For example the link should look like this:

http://www.MYSITE.COM/affiliate/install.php

Fill out this page with all the required information.

STEP 6: SET FINAL FILE PERMISSIONS

[web root]/affiliate/admin/	set permissions on this folder to 755
[web root]/affiliate/lib/etools2.php	set permissions on this file to 444
[web root]/affiliate/lib/etools2_noperm.php	set permissions on this file to 444

STEP 7: MOVE UP LICENSE FILE

Unzip the license file that you download from http://software.omnistaretools.com. Once you unzip the license file, it should be called affiliate_license.txt. Move affiliate_license.txt to [web root]/affiliate/admin/ folder

STEP 8: LAUNCH THE SOFTWARE

You can launch the software at http://YOURSITE/affiliate/admin/

Login: admin
P assword: admin

If you pull up this domain and you see an Ioncube error, then visit http://www.ioncube.com and make sure you have the latest Ioncube loader.

That’s it! Enjoy our Affiliate Software. We offer other 10 other web based php software solutions and services at http://www.omnistaretools.com

If you have problems installing our software, please visit our Troubleshooting Guide