Poll

Description

Poll plug-in allows you to quickly develop and publish user polls to your site as well as to analyze responses obtained from visitors.

This is a voting application that provides a website administrator with the model needed to setup basic polls. You can create the poll in a closed form by defining the question as well as a set of possible answers for the visitors of your site.

It is a standard internet poll with a title, question, and multiple answers (radio box). Visitors can choice one answer, and after press 'vote' button poll result will be displayed. By default, Vivvo Poll allows each visitor to vote only once.

There is 'All polls' link, placed at the bottom of the poll box. It will display the list of all polls: title, question and results of voting for each of the polls. The plug-in keeps a record of the answers, so that the basic statistics of the results and charts can be immediately displayed.

Old polls can be kept on the site so that they can still be viewed by visitors, but they will not be able to vote in them as only the current poll can be used for voting purposes.

Clicking on 'All Polls' will display any polls that are still on the system - this includes all the polls that have not been deleted by the site manager.

How to Install?

You need to access the Plug-ins section. Click on the Plug-ins link which is located in Main menu at the top of your administrator panel.

Admin menu

A list of all plug-ins currently registered to the system is displayed on the right hand side of the screen on Downloaded plug-ins tab.

To install Polls plug-in you need to click on the install icon on the right side of the plug-ins name.

Poll install

This will take you to the page with the installation link: Click here to Install the plug-in

Poll install step 1

After you run the installation, you will be informed that the plug-in was successfully installed.

You may easily go back to the Plug-ins page, by following the link: Click here to go to Plug-in

Poll install step 2

How to Uninstall?

To uninstall Polls plug-in you need to click on the uninstall icon on the right side of the plug-in name.

Poll uninstall

This will take you to the page with the link for uninstall: Click here to uninstall the plug-in

Poll uninstall step 1

You will be informed that the plug-in was successfully uninstalled and you may return to the Plug-ins page by clicking the link: Click here to return to Plug-in home page.

Poll uninstall step 2

Access

The path to the Poll plug-in:

Click on the Plug-ins link (which is located in Main menu at the top of your administrator panel).

Choose Poll plug-in from the list of all installed plug-ins (on the left side of the screen).

User level

This plug-in can be accessed only by users belonging to groups that are allowed to manage Poll plug-in.

Actions

On the left side of the screen you have the list of all polls created. Choose from the list the specific poll you want to see voting statistics for and click on its title.

List of all polls

Detailed statistics of voting are displayed on the right hand side. Therefore you will be able to analyze the results of the polls that you post on your site.

Poll statistic

If the poll is active, you'll notice its generated code just above the statistics. We'll explain what's the purpose of this code and how to use it later in this manual.

Add new poll

Add new poll by clicking on the Add new poll link which is located on the left menu.

Add new poll

In order to add a new poll you have to fill the form displayed on right hand side entering a poll name, then fill the question and answers fields. Finally click Save to submit the data.

For more than one answer click Add new answer link to define additional answers. You are allowed to add as many answers as you need.

Add new answer

You can also delete an answer. Just click on Delete icon Delete answer to remove it from the poll.

Activate/deactivate poll

Once you have created a poll, you should activate it in order for other people to be able to vote in it. This is done by clicking activate button Activate poll. Poll will not be displayed anywhere on your site while being inactive.

Choosing deactivate icon Deactivate poll you will deactivate the poll, making it unavailable to visitors. The poll will not be removed from the system and you'll be able to see its statistics or activate it anytime later.

Edit poll

Click on the Edit icon Edit poll to modify properties of the poll. Doing this brings you to the same form used to create the poll, with all of its values saved. You can also choose edit icon Edit poll on the left menu next to the polls name to edit the poll.

You have the ability to change existing answers, name or question you entered before.

Click the button Save when ready.

Delete poll

Choosing Delete poll will permanently delete selected Poll. All votes and data related to that Poll will be permanently erased. You will receive a confirmation box and if you press “OK” the poll will be deleted. You may also use delete icon on the left menu Delete poll for deleting polls.

Use generated code in templates

This version of Poll plug-in introduces option to have multiple votes activated and working at the same time on your website on different pages or even at the same page. Each Poll has its own generated code. By default only one active poll is being displayed on the front end. But if you activated more than one poll you need to use their generated code to have them display on desired places and sections. You may insert infinite number of polls to show in different pages and areas of your pages. All you have to do is paste generated code in your template file on desired place.

Commonly used templates we recommend for poll placement are: homepage/default.tpl (show a poll on the homepage), article/default.tpl (show on the article pages), category/default.tpl (show on category pages).

Get additional help on template files and explanation of template system in the Developer manual.

 
user_manual/plugin_manual/poll.txt · Last modified: 2008/12/26 06:11 by ksenija
 
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki