WP-Polls 2.13 Readme

» Index

Plugin Information

Author
» Lester 'GaMerZ' Chan

EMail:
»

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

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

Documentation:
» http://dev.wp-plugins.org/wiki/wp-polls

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

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

Credits:
» Localization By Ravan
» Uninstaller By Philippe Corbes

Updated:
» 2nd January 2007

Changelog

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_pollsarchive): ?>
<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 -> Sidebar 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.

The AJAX feature might not work if your blog homepage directory is different from the directory you installed WordPress in. To solve this issue,
1. Open polls.php
2. Find:
  echo "\t".'var polls_ajax_url = \''.$polls_ajax_url.'/wp-content/plugins/polls/polls.php\';'."\n";
3. Replace:
  echo "\t".'var polls_ajax_url = \''.$polls_ajax_url.'/WORDPRESS_DIRECTORY/wp-content/plugins/polls/polls.php\';'."\n";
  
  Where WORDPRESS_DIRECTORY should be the directory name which you installed WordPress in. Note the backslash after your WordPress Directory, you need that.

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; ?>