lubuntu.me/plugins/wp-polls/readme.txt

# WP-Polls
Contributors: GamerZ  
Donate link: https://lesterchan.net/site/donation/  
Tags: poll, polls, polling, vote, booth, democracy, ajax, survey, post, widget  
Requires at least: 4.0  
Tested up to: 4.9  
Stable tag: 2.73.8  

Adds an AJAX poll system to your WordPress blog. You can also easily add a poll into your WordPress's blog post/page.

## Description
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.

### Build Status
[![Build Status](https://travis-ci.org/lesterchan/wp-polls.svg?branch=master)](https://travis-ci.org/lesterchan/wp-polls)

### Development
[https://github.com/lesterchan/wp-polls](https://github.com/lesterchan/wp-polls "https://github.com/lesterchan/wp-polls")

### Translations
[http://dev.wp-plugins.org/browser/wp-polls/i18n/](http://dev.wp-plugins.org/browser/wp-polls/i18n/ "http://dev.wp-plugins.org/browser/wp-polls/i18n/")

### Credits
* Plugin icon by [Freepik](http://www.freepik.com) from [Flaticon](http://www.flaticon.com)

### 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, I will really appreciate it. If not feel free to use it without any obligations.

## Changelog
### Version 2.73.8
* FIXED: Bug fixes and stricter type checking

### Version 2.73.7
* FIXED: Unable to save input HTML tags for footer templates

### Version 2.73.6
* FIXED: Unable to vote for multiple answers
* FIXED: input HTML tags being removed when saving templates

### Version 2.73.5
* FIXED: Parsed error in SERVER variable.

### Version 2.73.4
* FIXED: sanitize_key on top of intval.

### Version 2.73.3
* NEW: Added sort by votes casted to poll answers.
* NEW: For polls with mutiple answers, we divided by total votes instead of total voters. Props @ljxprime.
* FIXED: Do not display poll option is not respected when poll is closed.
* FIXED: pollip_qid, pollip_aid, pollip_timestamp are now int(10) in pollsip table.
* FIXED: pollq_expiry is now int(10) in pollsq table.

### Version 2.73.2
* NEW: Bump WordPress 4.7
* FIXED: Change cron to hourly instead of twice daily.

### Version 2.73.1
* FIXED: Allow local IP
* FIXED: XSS on Poll bar option. Props [Netsparker Web Application Security Scanner](https://www.netsparker.com/)
* FIXED: Stricter Poll pptions check
 
### Version 2.73
* NEW: Display Poll Questions at the top of the Poll Logs table
* FIXED: Remove slashes

### Version 2.72
* NEW: Use translate.wordpress.org to translate the plugin
* FIXED: SQL Injection fixes. Props [Jay Dansand](https://github.com/jaydansand)
* FIXED: Use $wpdb->insert(), $wpdb->update() and $wpdb->delete() as much as possible
* FIXED Remove poll_archive_show option from UI

### Version 2.71
* FIXED: Use wp_kses_post() to get filter always bad tags

### Version 2.70
* NEW: Add wp_polls_vote_poll_success action hook
* NEW: Add wp_polls_add_poll, wp_polls_update_poll, wp_polls_delete_poll action hooks
* FIXED: PHP Notices
* FIXED: Removed not needed wp_print_scripts
* FIXED: Use esc_attr() and esc_textarea() instead of htmlspecialchars(). Props [Govind Singh](https://in.linkedin.com/pub/govind-singh/21/1a9/bab)

## Screenshots

1. Admin - All Poll
2. Admin - Manage Polls
3. Admin - Poll Options
4. Admin - Poll Templates
5. Admin - Poll Widget
6. Admin - Uninstall Poll
7. Poll - Single Poll Answer
8. Poll - Mutiple Poll Answers
9. Poll - Results
10. Poll - Archive

## Frequently Asked Questions

### General Usage (Without Widget)

~~~
<!--?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 show random poll, use `<!--?php get_poll(-2); ?-->`
* To embed a specific poll in your post, use `[poll id=&#34;2&#34;]` where 2 is your poll id.
* To embed a random poll in your post, use `[poll id=&#34;-2&#34;]`
* To embed a specific poll&#39;s result in your post, use `[poll id=&#34;2&#34; type=&#34;result&#34;]` where 2 is your poll id.

### General Usage (With Widget)
1. Go to `WP-Admin -&gt; Appearance -&gt; Widgets`.
2. You can add the Polls Widget by clicking on the &#39;Add&#39; link besides it.
3. After adding, you can configure the Polls Widget by clicking on the &#39;Edit&#39; link besides it.
4. Click &#39;Save Changes&#39;.
5. Scroll down for instructions on how to create a Polls Archive.

### How To Add A Polls Archive?
1. Go to `WP-Admin -&gt; Pages -&gt; Add New`.
2. Type any title you like in the post&#39;s title area.
3. If you ARE  using nice permalinks,  after typing the title, WordPress will generate the permalink to the page. You will see an &#39;Edit&#39; link just beside the permalink.
4. Click &#39;Edit&#39; and type in `pollsarchive` in the text field and click &#39;Save&#39;.
5. Type `[page_polls]` in the post&#39;s content area.
6. Click &#39;Publish&#39;.

* If you ARE NOT using nice permalinks, you need to go to `WP-Admin -&gt; Polls -&gt; Poll Options` and under `Poll Archive -&gt; Polls Archive URL`, you need to fill in the URL to the Polls Archive Page you created above.

### Why doesn&#39;t my poll&#39;s answers add up to 100%?
* It is because of rounding issues. To make it always round up to 100%, the last poll&#39;s answer will get the remainding percentage added to it. To enable this feature, add this to your theme&#39;s functions.php: `add_filter( &#39;wp_polls_round_percentage&#39;, &#39;__return_true&#39; );`

### How Does WP-Polls Load CSS?
* WP-Polls will load `polls-css.css` from your theme&#39;s directory if it exists.
* If it doesn&#39;t exists, it will just load the default `polls-css.css` that comes with WP-Polls.
* This will allow you to upgrade WP-Polls without worrying about overwriting your polls styles that you have created.

### Why In Internet Explorer (IE) The poll&#39;s Text Appear Jagged?
* To solve this issue, Open poll-css.css
* Find: `/* background-color: #ffffff; */`
* Replace: `background-color: #ffffff;` (where #ffffff should be your background color for the poll.)

### How Do I Have Individual Colors For Each Poll&#39;s Bar?
* Courtesy Of [TreedBox.com](http://treedbox.com &#34;TreedBox.com&#34;)
* Open poll-css.css
* Add to the end of the file:

~~~
.wp-polls-ul li:nth-child(01) .pollbar{ background:#8FA0C5}
.wp-polls-ul li:nth-child(02) .pollbar{ background:#FF8}
.wp-polls-ul li:nth-child(03) .pollbar{ background:#ff8a3b}
.wp-polls-ul li:nth-child(04) .pollbar{ background:#a61e2a}
.wp-polls-ul li:nth-child(05) .pollbar{ background:#4ebbff}
.wp-polls-ul li:nth-child(06) .pollbar{ background:#fbca54}
.wp-polls-ul li:nth-child(07) .pollbar{ background:#aad34f}
.wp-polls-ul li:nth-child(08) .pollbar{ background:#66cc9a}
.wp-polls-ul li:nth-child(09) .pollbar{ background:#98CBCB}
.wp-polls-ul li:nth-child(10) .pollbar{ background:#a67c52}
.wp-polls-ul li .pollbar{ transition: background 0.7s ease-in-out }
.wp-polls-ul li .pollbar:hover{ background:#F00 }
~~~

### To Display Total Polls

~~~
<!--?php if ( function_exists( 'get_pollquestions' ) ): ?-->
	<!--?php get_pollquestions(); ?-->
<!--?php endif; ?--> 
~~~
 
### To Display Total Poll Answers

~~~
<!--?php if ( function_exists( 'get_pollanswers' ) ): ?-->
	<!--?php get_pollanswers(); ?-->
<!--?php endif; ?--> 
~~~
 
### To Display Total Poll Votes

~~~
<!--?php if ( function_exists( 'get_pollvotes' ) ): ?-->
	<!--?php get_pollvotes(); ?-->
<!--?php endif; ?--> 
~~~
 
### To Display Total Poll Voters

~~~
<!--?php if ( function_exists( 'get_pollvoters' ) ): ?-->
	<!--?php get_pollvoters(); ?-->
<!--?php endif; ?--> 
~~~