TheRandomizer Manual
1.Installation Instructions
2.Initial Settings
3.Adding Content
4.Site News & Statistics

Installation Instructions

Welcome to The Randomizer V3.0 a fast, efficient, scalable turnkey affiliate system written in PHP and using MySQL for database storage. This guide will help you through the installation process and get you on your way to setting up your own The Randomizer. Installation is very straight forward, only taking about 15 minutes from uploading the files to logging into your administration center.


You will need an FTP (File Transfer Protocol) client, if you do not have one you can download Smart FTP for Windows or InterArchy for Macintosh. At the time of writing both websites have freeware or free trial versions available for download. You do not need an in depth knowledge of PHP programming to install The Randomizer V 3.0 but a working knowledge of FTP functions is a plus.

This guide assumes that you have successfully downloaded the latest release and have the Zip file "unzipped" and ready to go. The instructions will term the zip file you downloaded as "the zip archive", the directories created by the unzipping process as "the local folders" and the directories on your website as "website directories" - this is to prevent confusion. 
 


Requirements

The exact requirements will depend on many factors, the traffic to your site etc. These are some of the general requirements to run TheRandomizer.

Server Requirements
You must have a webserver that has PHP 4.3.3 (or better) and mySQL 4.0 (or better) installed. If you are unsure whether your server has these programs installed, please check with your web host now. If you are capable, you can always download PHP and download mySQL and install it yourself. If your web host does not support PHP or mySQL, consider hosting your entire web site with us. For details on hosting, please click here.  The Randomizer works best on an Apache server, and is Apache 1 and Apache 2 savvy.

General Requirements
You will need the mySQL username and mySQL password for a mySQL user that has permission to "CREATE", "DROP" and "ALTER" tables. You will need about 10mb of free web space and roughly 5mb of mySQL database space to allow installation. If you are unsure on any of these points, please ask your webhost before proceeding.
 



Installing: Step 1 - Uploading
If you haven't done so already, create a new directory on your server named appropriately (if you wanted to access the Randomizer via 'http://www.domain.com/randomizer/', create a directory called 'randomizer' in the 'public_html' or 'www' directory on your webserver). If you wish to install randomizer directly on your main site then creation of the randomizer directory is not required.

Using your FTP client, move into the directory you wish to upload to (if you followed the above advice, move into the newly created 'randomizer' directory). If your FTP client supports "Drag n' Drop" which most modern clients do, you can save yourself some time and effort by simply selecting all the files from the "unzipped" zip archive and drag them into your FTP client window, this will then copy all the files, creating the directories as it goes. Once the directories have been created, CHMOD the Randomizer directory to 0777. This will allow the installer to create config.php and dbconnect.php files automatically. Once installation is done, CHMOD the Randomizer directory to 0755.

That's it, the hard work is now done! You can proceed to the next step.
 
Installing: Step 2 - Using the Installer
An installer is provided to assist you in entering the information TheRandomizer needs to connect to your mySQL database and to create your new administrators account.

Run the "install.php" file through your web browser by entering the URL to it into your browser address bar (if you have followed our example, type in http://www.domain.com/randomizer/install.php, naturally substituting 'domain.com' for your web address.)

You will be presented with a short information screen.

Clicking on START will present you with a simple information form. You will need to know your mySQL username and password at this point. If you do not know it, please ask your web host - in most cases it is different from the FTP log in information.

The form is very straightforward, with only the following points needing closer examination. If you do not know what your mySQL "host" is, try "localhost" (without the quotes). if the mySQL server is on the same server as your website (and in most cases it is) this will suffice.

If you have created a new database for The Randomizer, or wish to use an existing database, enter the name of the database in the appropriate field. If you do not have a mySQL password (if you are installing The Randomizer on your local server) this can be left blank. If this step was successful, you will receive notification to that effect.

If the installer is unable to create the dbconnect.php file on your server, you will be accordingly informed and asked to upload the file directly to your server before continuing further.


Installing Step 3 : Activating your license
TheRandomizer comes with a unique license key which can be found in the client area. Please make sure you have it before proceeding further. The first two fields are automatically filled. If you feel this incorrect, change it with the correct value. Paste your license key at the appropriate place and click "Go next".

If the installer is unable to create the config.php file on your server, you will be accordingly informed and asked to upload the file directly to your server before continuing further.

Click "Go next" and your license will be activated at our servers. Once you get a "License key activated" message you can proceed to the next step. Please note, one license key will be valid for only one installation. In case there is any error during the installation you will have to renew your license key before reinstallation. In such case contact TheRandomizer.net or the reseller from whom you purchased the license.


Installing Step 4 : Choosing new installation or upgrade.
Once the license is activated, you will be asked to select the type of installation. In case you are installing a new copy of TheRandomizer please select "New Installation". In case you are upgrading from V2.4, please select "Upgrade".


 


Installing: Step 5 - Admin Account Creation
On the next screen you will be asked to enter the randomizer administrator details. Enter the details, admin username, password and the contact email ID. Please note you cannot change your admin username later, however you can change your password from the admin area.

Once you finish this step, you will need to load the ip2country database. Click on the ip2country database link and a new window will open.

Be patient as there are more than 47500 records to be inserted into the database. Once this step is over, please delete the install.php file from your server. You have now successfully installed the The Randomizer on your website.

You can access your Randomizer from http://www.yourdomain.com/randomizer/index.php, if you followed our example. Your admin area URL will be http://www.yourdomain.com/randomizer/adminarea/index.php, if you followed our example. You can edit the admin and other settings from the admin control panel.



Next Page ->