Quick Polls >> Documentation

 

Quick Polls Documentation

1.1 Requirements to run Quick Polls
1.2 Installation instructions
1.3 Upgrade Instructions
1.4 Using Quick Polls
_____1.3.1 How to create a Poll or Survey
_____1.3.2 How to place a Poll on a web page or Web Site
_____1.3.3 How Quick Polls Stores Votes
_____1.3.4 How to change the look and feel of Polls
_____1.3.5 How to create your own custom skins to apply to Polls
_____1.3.6 How to Edit, Reset Poll Statistics and Reset IP Addresses
_____1.3.7 How to Retire (Archive) Polls

 

1.1 Requirements

What is required to run Quick Polls?

  • Unix/Linux based Web Host
  • PHP 4.3.2 or above
  • FTP Access
 
1.2 Installation Instructions

The installation of Quick Polls should be painless. It is very easy to install and configure Quick Polls. You don't have to edit any files, and only need to supply information via a setup interface.

Follow the steps below exactly as described and you should have Quick Polls serving you in minutes. Do the steps as you read through them.

Step 1. (Extract the .zip archive)

Extract the files with their directories that came in the .zip archive.

Step 2. (Create a directory and transfer Quick Polls Files)

Create a directory called 'quickpolls' or anything else you would like to call it inside your Public HTML Document Folder. After that transfer all the files and directories extracted from the .zip archive to the 'quickpolls' directory.

Step 3. (Set Directory Permissions)

After you transferred all files and directories assign the permission setting of 777 to the 'data' and 'jsfiles' directories. These are the directories you transferred in the previous step. You can set the permission setting of Directories by right clicking on them and choosing 'Chmod' or 'Permissions'. (Your FTP program will normally have an option to set the permissions of Directories or Files when you right click on them.)

Also set the permission setting of config.php to 777

Step 4. (Load setup.php)

Now you should have uploaded all the Quick Polls program files and configured their permissions. Amongst the files you uploaded will be setup.php - Load this file inside your web browser to complete the setup.

 

1.3 Upgrade Instructions

1.3.1 How to upgrade from the free version to the 'Professional' version.

Step 1. Download the .zip installation archive of the 'Professional' version and extract it's contents.

Step 2. Inside the .zip archive you extracted you'll see directories. Transfer the directories (with their contents) called 'images' and 'skins' to the location where you installed the free version. The free version will already have an 'images' directory. Replace any files if your FTP program asks you if you would like to replace older existing files.

Step 3. Now transfer all the .php files (except setup.php) that you extracted from the .zip installation archive to the location where the free version of Quick Polls is installed. Replace the .php files of the free version with the ones from the 'Professional' version. Do not transfer setup.php as this script should not be available as it is only used to change the user name and password of the Control Panel.

Step 4. The upgrade is now complete.

 

1.4 Using Quick Polls

1.4.1 How to create a Poll or Survey

This should mostly be self-exaplantory. After logging into the Control Panel specify a Poll name and click the 'Next' button.

1.4.2 How to place a Poll on a web page or Web Site

After you created a Poll or Survey click on the 'Get JavaScript' link to obtain JavaScript that you can insert into any web page. Note that you can also place multiple polls on the same web page.

Note that the web pages where you place the JavaScript needs to belong to the same domain as where Quick Polls is installed on. The JavaScript code won't work on a different domain because the security settings of browser's will recognize that the JavaScript being executed is done on a different domain and will block the request.

1.4.3 How Quick Polls Stores Votes

Quick Polls will record votes and uses cookies to ensure that only one person can vote once on a Poll. If the person voting doesn't have cookies enabled then no vote will be recorded and only the Poll results will be displayed. If a person tries to vote more than once then when the 'Vote' button is clicked the results will be shown but no vote will be recorded.

Pro Version Only:

The Pro version additionally comes with IP tracking. What this means is that when a vote is done that Quick Polls records the IP address of the user who voted. If he/she tries to vote again Quick Polls will check his cookies and all IP addresses recorded for the specific Poll so that the user cannot vote twice if his/her IP address has already been recorded.

1.4.4 How to change the look and feel of Polls

Free Version:

Inside the 'data' directory of the .zip installation archive there is 5 HTML files. These HTML files are used as the Poll skins. You can edit these HTML files to change the look and feel of the Polls. Note that you have to leave the words enclosed by exclamation marks in-tact inside the HTML files. (skin files) Removing the words enclosed by exclamation marks inside the HTML files will have the effect of the Polls stop functioning or stop working correctly.

Pro Version Only:

The Pro version of Quick Polls comes with a 'Skin Editor'. What this means is that you can change to the look and feel of any Poll that has been created to give any Poll a unique look and feel. To edit the 'Skin' of any Poll click the 'Skin' icon next to any Poll. You will be presented with the HTML code that the Poll is using. You can customize this HTML code by copying and pasting it into your web editor. Note that you have to leave the words enclosed by exclamation marks in-tact inside the HTML code of the skins. Removing the words enclosed by exclamation marks inside the HTML files will have the effect of the Polls stop functioning or stop working correctly.

The Pro version also comes with pre-created skins where you can choose a pre-created skin. To do this click the 'Skins' icon next to any Poll. Then under the 'Apply Custom Skin' section select a skin. You can preview the skins for the selected Poll by clicking the preview link provided.

1.4.5 How to create your own custom skins to apply to Polls

Pro Version Only:

This section explains how to create a 'skin' set that will be available in the 'drop down' box where you can select to apply a custom skin to a Poll.

To create your own custom skins where you can apply the custom skins to any Polls, you need to follow the following steps:

1. FTP into your host and go to the Quick Polls installation Directory. When there, enter the 'skins' directory. You will see directories named 'default', 'blue', 'cyan', 'green', etc. Now enter the 'default' directory and transfer all the files contained in this directory to your computer's hard drive.

2. Now inside the 'skins' directory create a directory that you can name anything. (without spaces) In this example we will call it 'custom'. Now on your computer's hard drive where you transferred the files there is a file called name.txt - Edit this file and place a name for the Skin in this file. Remove the 'Default' name from it. In this example we will use the name 'Custom'.

Now, edit the HTML files that you transferred to change the look and feel of it.

3. Now you should have edited name.txt and edited the look and feel of the HTML files. Now transfer all the files from your computer's hard drive to the 'custom' directory you have just created under the 'skins' directory.

4. Go to the Control Panel and click the 'Skin' icon next to any Poll. Within the drop down menu in the 'Apply a Custom Skin' section you will see an extra option called 'Custom' to apply the skin to the existing poll.

1.4.6 How to Edit, Reset Poll Statistics and Reset IP Addresses

Click the 'Edit' icon/link next to any Poll to edit it's question and answers.

Pro Version Only:

You can check the tickboxes provided when editing a Poll to reset the Poll statistics or reset the IP addresses recorded of users who voted on the Poll. When IP addresses are removed (resetted) all IP addresses recorded of users who did votes on the specific poll is removed.

1.4.7 How to Retire (Archive) Polls

Pro Version Only:

The Pro version of Quick Poll has an 'Archive' function. This function lets you retire Polls so that no Votes are possible on Polls you select to 'Archive' or retire. 'Archived' or 'Retired' Polls are stored in the section when you click the 'Archive' tab. You can click the 'Archive' icon next to any Poll to 'Archive' or 'Retire' it. When a Poll is archived/retired then no votes can be casted on it anymore. It will always just display the Poll results of previous votes when it was not in it's 'Archived' state.

 

 

Site Map | PowerSeek | Turbo Seek | HTML Rotate | Quick Polls | FM SiteSearch Pro | Download Monitor | SiteNet BBS | More...
Products | Support Desk | Affiliate Program | Web Hosting | FocalMedia.Net Featured On | Contact us