OwenPoll - Setup Instructions

OwenPoll Setup Instructions

** Parts of this sample readme are hidden with xxxxx for security reasons**

Thank you for purchasing OwenPoll!
You are only a few minutes away from having OwenPoll ready for use.
These are the instructions for setting up OwenPoll to work on your server.
You will need to have PHP and MySQL already set up and working.
You will also need software that can open compressed (zipped) files.
(Well, if you can read this then you have already unzipped the files).

Extracting Files

Extract the files to a folder of your choice.
If necessary, upload them to your web hosting account

Run the Setup Wizard

If you want to use the easy wizard, then open the file xxxxx in your browser, by typing something similar to the following in your browser's Address Bar:
(Replace the path shown with the applicable path in your case)
http://localhost/yourfolder/xxxxx/xxxxx
OR
http://www.yourwebsite/yourfolder/xxxxx/xxxxx

Step 1: Connection Settings

First, you need to specify the database connection settings on your server.
This must be done first if you would like to automatically create your database and tables.
Even if you will create the database yourself, OwenPoll will still need this information to access data.

Manual Setting
You can very easily set the necessary information. Simply do the following:
Open xxxxx/xxxxx using Notepad or any PHP editor.
Edit the following lines:

xxxxx

Click Skip this step to proceed to the next step.

Automatic Setting
You can automatically set the information needed in the file xxxxx IF:
You are installing the software on a local machine and have write permission
or
You are installing the software on a web server and have set write permission on the file xxxxx

If the above applies to you, then simply fill in the information in the appropriate boxes then click Create File.
You will see a page informing you that the connection settings file has been created
Click the link for the next step

Step 2: Creating the database

Using SQL
If you know how to run SQL statements on your database, then you may run the following file that is in the setup folder:
createdb.sql - this creates the database

You may skip this step of the automated installation if you want to create the database yourself or if you want to use an existing database.

Automatic Setting
Note:This Step will only work IF:
- you have correctly set the Connection Settings in xxxxx above.
- the user specified in the file has permission to create a database
If the above is done, then click the link to create the database named in the connection settings.
You will see a message that the database has been created
Click the link for the next step

Step 3: Creating the tables

Using SQL
If you know how to run SQL statements on your database, then you may run the following file that is in the setup folder:
createtables.sql - this creates the tables.

Automatic Setting
Note:This Step will only work IF:
- you have correctly set the Connection Settings in xxxxx above.
- the user specified in the file has permission to create tables in the specified database.
If the above is done, then click the link to create the tables used by the software.
You will see a message that the tables were created
Click the link for the next step

After you run each file, you should see a message telling you that the table or database was created successfully.
If not, you will see an error telling you what problem was encountered.
Depending on which error you get, you may need to contact your web hosting service for help

Step 4: Creating Your Admin Account

Automatic and Manual Setting
After completing the steps above, you may create the file containing the details to be used in accessing the Poll Administration Panel of your your web site.
Enter the username that the administrator will use.
Enter the password that the administrator will use.
Repeat the password that the administrator will use.
Click the Create File button.
The file xxxxx is created in the xxxxx folder with the username you entered and the password in an encrypted format.

If the file is not created, you may open it in your PHP editor and enter the password shown instead of the existing encrypted one:
xxxxx="enter-the-password-here";

You will now be able to log in with the username and password that you specified.

Done!

That's it!
OwenPoll is ready for use!

Please delete xxxxx from your live server.

Feel free to log in and explore how the features are used.