=== topicPolls Pro for bbPress ===
Contributors: GDragoN, freemius
Donate link: https://plugins.dev4press.com/gd-topic-polls/
Tags: dev4press, forum polls, forum, topic poll, bbpress poll
Stable tag: 4.4.1
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 8.0
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Implement a polls system for topics in bbPress powered forums, with settings to control voting, poll closing, display of results and more.

== Description ==
topicPolls is a plugin for WordPress and bbPress, and it works with bbPress topics. Users can create polls for new topics, or add a poll for existing topics. Each topic can have one poll.

= Overview of plugin features =
topicPolls is easy to use, it doesn't require any coding, but it offers a lot of customization potential to developers.

Here is the list of the most important plugin features:

* Create polls with new topics.
* Add polls to the existing topics.
* Edit poll while editing the topic.
* Control user roles allowed to create new polls.
* Disable polls for selected forums.
* Optional description field in the poll.
* Add two or more answers to the poll.
* Reorder poll answers in the poll edit mode.
* Set poll to allow one answer only for each voter.
* Set poll to allow unlimited answers for each voter.
* Set poll to limit the number of answers for each voter.
* Auto close the poll when a topic is closed.
* Control when the poll results can be displayed.

And on the administration side, the plugin has many more useful features:

* Panel with the list of all polls
* List of polls panel: disable or enable any poll
* List of polls panel: delete any poll
* List of polls panel: remove all votes from the poll
* Panel with the list of votes
* List of votes panel: filter by poll, user or answer
* List of votes panel: delete votes
* Panel with the plugin settings
* Panel with the import, export and removal tools

= Upgrade to topicPolls Pro for bbPress =
The Pro version contains many more great features:

* Widget to show list of polls with forums filtering
* Auto close the poll: when selected date is reached
* Auto close the poll: when number of voters is reached
* Require users to respond to topic before answering poll
* Option to allow users to remove and change their vote
* Display list of voters in the poll results
* Settings to control default values of some poll options
* Settings to control display of voters list in the poll results
* Instant votes Notifications
* Daily Digest votes Notifications
* bbPress Topics View: All topics with polls
* bbPress Topics View: Logged-in user topics with polls
* Integration with BuddyPress activity stream

= Get more information about the plugin =
* More information about [topicPolls Pro](https://www.dev4press.com/plugins/gd-topic-polls/)
* Compare [Free vs. Pro Plugin](https://www.dev4press.com/plugins/pricing/)
* More premium [bbPress Plugins](https://www.dev4press.com/bbpress-club/)

= More free dev4Press.com plugins for bbPress =
* [powerSearch for bbPress](https://wordpress.org/plugins/gd-power-search-for-bbpress/) - add advanced search to the bbPress topics
* [GD Forum Manager](https://wordpress.org/plugins/gd-forum-manager-for-bbpress/) - quick and bulk forums and topics edit
* [GD Members Directory](https://wordpress.org/plugins/gd-members-directory-for-bbpress/) - add new page with list of all forum members
* [GD bbPress Attachments](https://wordpress.org/plugins/gd-bbpress-attachments/) - attachments for topics and replies
* [GD bbPress Tools](https://wordpress.org/plugins/gd-bbpress-tools/) - various expansion tools for forums

= Documentation and Support =
You need to register for a free account on [Dev4Press](https://www.dev4press.com/):

* [Frequently Asked Questions](https://www.dev4press.com/kb/product/gd-topic-polls/faqs/)
* [Knowledge Base Articles](https://www.dev4press.com/kb/product/gd-topic-polls/articles/)
* Support Forum: [Free](https://support.dev4press.com/forums/forum/plugins-lite/gd-topic-polls/) & [Pro](https://support.dev4press.com/forums/forum/plugins/gd-topic-polls/)

== Installation ==
= General Requirements =
* PHP: 8.0 or newer
* bbPress 2.6.2 or newer
* WordPress: 6.2 or newer

= PHP Notice =
* The plugin doesn't work with PHP 7.4 or older versions.

= Basic Installation =
* Plugin folder in the WordPress plugins folder should be `gd-topic-polls`.
* Upload `gd-topic-polls` folder to the `/wp-content/plugins/` directory
* Activate the plugin through the 'Plugins' menu in WordPress
* Check all the plugin and plugin widgets settings before using the plugin.

== Frequently Asked Questions ==
= Does plugin work with WordPress Multisite installations? =
Yes. Each website in the network can activate and use plugin on its on.

== Translations ==
* English

== Upgrade Notice ==
= 4.4 =
Various updates and improvements. Bug fixes.

= 4.3 =
Various updates and improvements.

== Changelog ==
= 4.4.1 - 2026.05.01. =
* Fix: the issue with the Poll icon displayed for the list of topics

= 4.4 - 2026.04.14. =
* New: tested with WordPress 7.0
* New: tested with bbPress up to 2.6.14
* Edit: Dev4Press Library 5.5.2
* Edit: Freemius SDK 2.13.1
* Fix: many escaping issues for admin interface
* Fix: many escaping issues on the frontend

= 4.3.2 - 2025.11.15. =
* Edit: Freemius SDK 2.13.0

= 4.3.1 - 2025.05.31. =
* New: tested with bbPress up to 2.6.13
* Edit: Dev4Press Library 5.4
* Edit: Freemius SDK 2.12.0

= 4.3 - 2025.01.29. =
* Edit: few small updates to the plugin loading process
* Edit: various small improvements and tweaks
* Edit: Dev4Press Library 5.3

= 4.1 - 2024.11.12. =
* New: tested with WordPress 6.7
* New: tested and compatible with `PHP` 8.4 RC 3
* New: integration with `Freemius`
* New: plugin name changed to `topicPolls for bbPress`
* New: loading of `Dev4Press Library` via Composer
* New: refactoring namespaces and plugin structure
* New: added License code activation requirements
* Edit: Dev4Press Library 5.2.2

= 2.3 - 2023.11.01. =
* New: updated plugin system requirements
* New: tested with WordPress 6.3
* Edit: many small tweaks and improvements to the plugin core
* Edit: changes to the interface for new library
* Edit: d4pLib 4.3.4

Full changelog: [topicPolls for bbPress Changelog](https://www.dev4press.com/plugins/gd-topic-polls/changelog/)

== Screenshots ==
1. Example poll results
2. Example poll open for voting
3. Create topic poll form
4. Admin side list of polls
5. Admin side list of poll votes
6. Example poll results
