WP-Polls 2.20 Readme

» Index

Plugin Information

Author:
» Lester 'GaMerZ' Chan

EMail:
»

Website:
» http://www.lesterchan.net/

Features:
» Adds an AJAX poll system to your WordPress blog. You can easily include a poll into your WordPress's blog post/page. WP-Polls is extremely customizable via templates and css styles and there are tons of options for you to choose to ensure that WP-Polls runs the way you wanted. It now supports multiple selection of answers.

Download:
» WP-Polls 2.20 For WordPress 2.1.x And Above
» WP-Polls 2.13 For WordPress 2.0.x
» WP-Polls 2.02a For WordPress 1.5.2

Demo:
» http://www.lesterchan.net/wordpress/

Development:
» http://dev.wp-plugins.org/browser/wp-polls/

Translations:
» http://dev.wp-plugins.org/browser/wp-polls/i18n/

Support Forums:
» http://forums.lesterchan.net/index.php?board=15.0

Credits:
» Localization By Ravan
» Uninstaller By Philippe Corbes

Updated:
» 1st June 2007

Note:
» The Changelog, Installation, Upgrade, Usage Tab at the top of the page.
» I have once again change some of the core code to make it work with the future/expired poll. Please post in the support forums if you encounter any bugs.
» WP-Polls has undergo major changes to support multiple answers and AJAX for the backend. Please post in the support forums if you encounter any bugs.

Donations:
» I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks as my school allowance, I will really appericiate it. If not feel free to use it without any obligations. Thank You. My Paypal account is

» Changelog

Version 2.20 (01-06-2007)
- NEW: Poll Archive Link, Individual Poll Header And Footer In Poll Archive Template
- NEW: Poll Templates Has Now Its Own Page 'WP-Admin -> Polls -> Poll Templates'
- NEW: Poll Widget Can Now Display Multiple Polls
- NEW: Ability To Allow User To Select More Than 1 Poll Answer
- NEW: Added AJAX Style Option: "Show Loading Image With Text"
- NEW: Added AJAX Style Option: "Show Fading In And Fading Out Of Polls"
- NEW: Major Changes To The Administration Panel For WP-Polls
- NEW: AJAX Added To The Administration Panel For WP-Polls
- NEW: Default Poll's Result Template Will Now Show Number Of Votes Beside The Percentage
- NEW: Term "Total Votes" Changed To "Total Voters". Refer To Here
- NEW: Removed Polls From Feed If The Poll Is Embedded Into The Post Using [poll=ID]
- NEW: Filtering Of Individual Poll Logs
- FIXED: Poll Archive Will Now Show Only Polls Results
Version 2.14 (01-02-2007)
- NEW: Works For WordPress 2.1 Only
- NEW: Renamed polls-js.js to polls-js.php To Enable PHP Parsing
- NEW: Ability To Make A Poll Expire
- NEW: Ability To Make A Future Poll
- NEW: Future Poll Will Automatically Open When The Poll's Date Is Reached
- NEW: Expired Poll Will Automatically Closed When The Poll's Date Is Reached
- NEW: Ablity To Choose What To Do When The Poll Is Closed (Display Result, Remove Poll From Sidebar)
- FIXED: Future Dated Polls Will Not Appear In The Post/Sidebar/Polls Archive
Version 2.13 (02-01-2007)
- NEW: polls.php Now Handles The AJAX Processing Instead Of index.php
- NEW: Able To Modify The Style Of Poll Results Bar in 'Polls -> Poll Option'
- NEW: Usage Instructions Is Also Included Within The Plugin Itself
- NEW: Uninstaller Done By Philippe Corbes
- NEW: Localization Done By Ravan
- NEW: Ability To Add HTML Into Poll Question and Answers
- FIXED: AJAX Not Working On Servers Running On PHP CGI
- FIXED: Added Some Default Styles To polls-css.css To Ensure That WP-Polls Does Not Break
- FIXED: Other Languages Not Appearing Properly
- FIXED: Poll IP Logs Of Deleted Poll's Answer Did Not Get Deleted
- FIXED: There Is An Error In Voting If There Is Only 1 Poll's Answer
Version 2.12 (01-10-2006)
- NEW: Polls Archive Is Now Embedded Into A Page, And Hence No More Integrating Of Polls Archive
- NEW: WP-Polls Is Now Using DIV To Display The Poll's Results Instead Of The Image Bar
- NEW: Added Widget Title Option To WP-Polls Widget
- NEW: Ability To Logged By UserName
- NEW: Added CSS Class 'wp-polls-image' To All IMG Tags
- FIXED: If Site URL Doesn't Match WP Option's Site URL, WP-Polls Will Not Work
Version 2.11 (08-06-2006)
- NEW: You Can Now Place The Poll On The Sidebar As A Widget
- NEW: Moved wp-polls.php To wp-content/plugins/polls/ Folder
- FIXED: AJAX Not Working In Opera Browser
- FIXED: Poll Not Working On Physical Pages That Is Integrated Into WordPress
Version 2.1 (01-06-2006)
- NEW: Poll Is Now Using AJAX
- NEW: Ability To Close/Open Poll
- NEW: Added Poll Option For Logging Method
- NEW: Added Poll Option For Who Can Vote
- NEW: Added Poll Results Footer Template Variable (Used When User Click "View Results")
- NEW: Added The Ability To Delete All Poll Logs Or Logs From A Specific Poll
- NEW: Poll Administration Panel And The Code That WP-Polls Generated Is XHTML 1.0 Transitional
Version 2.06b (26-04-2006)
- FIXED: Bug In vote_poll();
Version 2.06a (02-04-2006)
- FIXED: Random Poll Not Working Correctly
Version 2.06 (01-04-2006)
- NEW: Poll Bar Is Slightly Nicer
- NEW: Got Rid Of Tables, Now Using List
- NEW: Added In Most Voted And Least Voted Answer/Votes/Percentage For Individual Poll As Template Variables
- NEW: Display Random Poll Option Under Poll -> Poll Options -> Current Poll
- FIXED: Totally Removed Tables In wp-polls.php
Version 2.05 (01-03-2006)
- NEW: Improved On 'manage_polls' Capabilities
- NEW: Neater Structure
- NEW: No More Install/Upgrade File, It Will Install/Upgrade When You Activate The Plugin
- NEW: Added Poll Stats Function
Version 2.04 (01-02-2006)
- NEW: Added 'manage_polls' Capabilities To Administrator Role
- NEW: [poll=POLL_ID] Tag To Insert Poll Into A Post
- NEW: Ability To Edit Poll's Timestamp
- NEW: Ability To Edit Individual Poll's Answer Votes
- NEW: %POLL_RESULT_URL% To Display Poll's Result URL
- FIXED: Cannot Sent Header Error
Version 2.03 (01-01-2006)
- NEW: Compatible With WordPress 2.0 Only
- NEW: Poll Administration Menu Added Automatically Upon Activating The Plugin
- NEW: Removed Add Poll Link From The Administration Menu
- NEW: GPL License Added
- NEW: Page Title Added To wp-polls.php
Version 2.02a (17-11-2005)
- FIXED: poll-install.php And poll-upgrade.php will Now Be Installed/Upgraded To 2.02 Instead Of 2.01
Version 2.02 (05-11-2005)
- FIXED: Showing 0 Vote On Poll Edit Page
- FIXED: Null Vote Being Counted As A Vote
- FIXED: Auto Loading Of Poll Option: Polls Per Page In Poll Archive Page Is Now "No"
- NEW: Host Column In Poll IP Table To Prevent Network Lagging When Resolving IP
- NEW: New Poll Error Template
Version 2.01 (25-10-2005)
- FIXED: Upgrade Script To Insert Lastest Poll ID Of User's Current Polls, Instead Of Poll ID 1
- FIXED: Replace All <?= With <?php
- FIXED: Added addalshes() To $pollip_user
- FIXED: Better Localization Support (80% Done, Will Leave It In The Mean Time)
Version 2.0 (20-10-2005)
- NEW: IP Logging
- NEW: Poll Options: Sorting Of Answers In Voting Form
- NEW: Poll Options: Sorting Of Answers In Results View
- NEW: Poll Options: Number Of Polls Per Page In Poll Archive
- NEW: Poll Options: Choose Poll To Display On Index Page
- NEW: Poll Options: Able To Disable Poll With Custom Message
- NEW: Poll Options: Poll Templates
- NEW: Display User's Voted Choice
- FIXED: Better Install/Upgrade Script

» Usage Instructions

General Usage (Without Widget)

Open wp-content/themes/<YOUR THEME NAME>/sidebar.php
Add:
<?php if (function_exists('vote_poll') && !in_pollarchive()): ?>
<li>
   <h2>Polls</h2>
   <ul>
      <li><?php get_poll();?></li>
   </ul>
   <?php display_polls_archive_link(); ?>
</li>
<?php endif; ?>

To show specific poll, use <?php get_poll(2);?> where 2 is your poll id.

To embed a specific poll in your post, use [poll=2] where 2 is your poll id.
Scroll down for instructions on how to create a Polls Archive.

General Usage (With Widget)

Activate WP-Polls Widget Plugin
Go to 'WP-Admin -> Presentation -> Widgets'
Drag the Polls Widget to your sidebar
You can configure the Polls Widget by clicking on the configure icon
Click 'Save changes'
Scroll down for instructions on how to create a Polls Archive.

Polls Archive

Go to 'WP-Admin -> Write -> Write Page'
Type any title you like in the post's title area
Type '[page_polls]' in the post's content area (without the quotes)
Type 'pollsarchive' in the post's slug area (without the quotes)
Click 'Publish'
If you ARE NOT using nice permalinks, you need to go to 'WP-Admin -> Polls -> Poll Option' and under 'Poll Archive -> Polls Archive URL', you need to fill in the URL to the Polls Archive Page you created above.

Note

In IE, some of the poll's text may appear jagged (this is normal in IE). To solve this issue,
1. Open poll-css.css
2. Find:
  /* background-color: #ffffff; */
3. Replace:
  background-color: #ffffff;
  
  Where #ffffff should be your background color for the poll.

Polls Stats (Outside WP Loop)

To Display Total Polls
Use:
<?php if (function_exists('get_pollquestions')): ?>
<?php get_pollquestions(); ?>
<?php endif; ?>
To Display Total Poll Answers
Use:
<?php if (function_exists('get_pollanswers')): ?>
<?php get_pollanswers(); ?>
<?php endif; ?>
To Display Total Poll Votes
Use:
<?php if (function_exists('get_pollvotes')): ?>
<?php get_pollvotes(); ?>
<?php endif; ?>
To Display Total Poll Voters
Use:
<?php if (function_exists('get_pollvoters')): ?>
<?php get_pollvoters(); ?>
<?php endif; ?>