You can choose to download only the Vote Caster Component or the entire One Admin Suite. Before installing, we recommend you to take a look at System Requirements.

Your web host must have PHP installed and configured with the MySQL database support. Also, you should have FTP access to the web server where you wish to install the Vote Caster on.

Step 1: Unzip File

Unzip the votecaster30.zip onto your local computer, making sure to preserve the directory structure contained in the zip. If you do not have a zip utility, you can download one for free, the Winzip program from

Step 2: Uploading Files

Using a FTP program, login to your web server and transfer the 'oneadmin' folder from your local computer into the web root. This is usually public_html or httpdocs folder, the same directory in which your homepage resides. However, the web root location could be different on your server.

Step 3: Set File Permissions

The Vote Caster requires modification of files or create new files in directories. If you are using Unix-based web server, you will need to set file permissions - read, write and execute on these files and directories. Most FTP programs allow you to change file permissions. As for Windows server users, the appropiate file permissions might have been set.

Permissions are specified by 3 digit number, such as 644 or 755. Please CHMOD * these file and directory accordingly:

• /oneadmin/_files : 777 (Owner: Read, Write, Execute; Group: Read, Write, Execute; Others: Read, Write, Execute)
  
  
• /oneadmin/config.php : 777 (Owner: Read, Write, Execute; Group: Read, Write, Execute; Others: Read, Write, Execute)

Unix File Permissions
* CHMOD is a command responsible for changing file permissions.

To set file permissions with your FTP program, right click on a file or directory, and look for command such as 'File Attributes', 'Change File Permissions', or 'chmod'. From here you will be able to set 'read, write, execute' permissions for 'owner, group, others' via checkboxes. Anyway, the easiest way to set permission would be insert the appropiate number.

Windows File Permissions

Normally, PHP scripts is able to run on Windows environment with no need to set any file permissions. However, in some cases, a server might not be setup to allow the PHP scripts to have 'write access' to it's file. As a result, the program will prompts you warning message stating that it is not able to write into it's data file.

Step 4: Creating a MySQL Database

Most web hostings include an integrated control panel to let you manage your MySQL database easily.

Let's login to your MySQL database, and create a new database for your Vote Caster, as well as a new user account with full permissions on that database. You can also use the existing database if you wish. Please jot down the MySQL details, as you will need them in the Installation Wizard.

If you do not have enough permission to create the database, you may need to ask your web hosting provider to create it for you, and grants you access.
 


Step 5: Run Installation Wizard

To run the Installation Wizard, open the /oneadmin with your web browser, for example: http://your-domain-name/oneadmin.

The Installation Wizard will appears, which will guides you through the final installation process. Simply follow 3 simple steps as described below:

(I) Directory Paths and Administrator Password

This section allows you to specify the locations of your /oneadmin directory, and the administrator login password. There are 4 text fields to fill in, from which 3 have been defined by the Vote Caster program.

• Web Address
  
  The complete URL to the /oneadmin folder on your web server, such as http://your-domain-name/oneadmin/. It is also the fully qualified URL to access your administrator panel, and you use it to request for your product activation key.

• Document Path
  
  The complete path from root level to the /oneadmin folder on your web server, for example: '/home/sitename/public_html/oneadmin/', or
  '/var/www/httpdocs/sitename/oneadmin/'. If you unsure of the path, please ask your server administrator for assistance.
  
  By default, this text field should already contains values that the Vote Caster has specified for you. However, in some special instances, you may need to enter the correct path as required:
  
  1. Value of document path consist only a single slash '/' character
  - This is caused when your server might not be setup to publish the relative path.
  - It is advised that you make a request to your server administrator for the complete document path.
  
  
  2. Document path of Windows web server
  - Says the default value is 'E:\home\system\sitename\oneadmin\'.
  - Here's what to do: Replace all backslash '\' with double backslash '\\'. Your correct path should look something like this 'E:\\home\\system\\sitename\\oneadmin\\'

• Administrator Login
  
  By default, the Vote Caster creates 'admin' user for you, and this value is not modifiable. Please enter and confirm the administrator login password for One Admin panel.

(II) MySQL Database Settings

This section allows you to enter the details MySQL database, which you have created ealier. There are 5 fields to complete:

• MySQL Host
  - The host name of the server where MySQL is installed, such as localhost (the most common used name, and is specified by default)
  
  
• MySQL Username
  - The user account of the MySQL database you created ealier.
  
  
• MySQL Password
  - The password for the above user account.
  
  
• MySQL Database
  - The name of the MySQL database you created to store the Vote Caster's tables.

Once you have completed all sections, scroll down to the bottom of the page and click the 'Proceed To Install' button. Your Vote Caster configuration is saved right to the /oneadmin/config.php file, the MySQL database will also be created.

Now, you're ready to login to your One Admin panel, using the username and password of administrator. Proceed to install the Vote Caster, and lets your guests cast their vote for the topic you have set on your website.