- Version: 1.0.0
- Updated: June 28, 2022
- Required: WordPress 5.0+
- What does Polarise Pro do?
- What settings can be applied to polls?
- Default poll settings
- Viewing poll results
- Exporting poll results
- Delete single or all poll votes
- Adding a poll to a page
- How many polls can be on a single page?
- Poll styles
- Poll integrity
- Poll fudging
- How to setup reCAPTCHA
- Where do I enter my license key?
- How many websites can I use Polarise Pro on?
- Is the price of this plugin once only or per year?
Easily create configurable polls for WordPress and add them to any posts or pages.
What does Polarise Pro do?
Polarise Pro for WordPress lets you easily create configurable polls and add them to any posts or pages.
What settings can be applied to polls?
Each poll can have any or all of the following settings applied:
- Start and end dates: the poll will only be available between set dates
- Required form fields before voting is allowed: name or phone
- Send a thank you email: an email is automatically sent to the user after voting
- Display privacy information: shows the user what data is collected when participating in the poll
- Show the vote count: after voting, the user will be shown how may votes have been cast so far
- Show progress: after voting, the user will be shown the progress of the poll results so far
- Members only: only logged in users can vote
- Accent colour: the primary colour used to present the poll (learn about poll styles)
- Poll content: add any additional content to the poll
- Notify text: optional notification checkbox label (and option to pre-tick the checkbox)
- Sender email address: the email address that notifications are sent from
- Sender name: the sender name that notifications are sent from
- Voted message: the message shown to the user after they vote
- Terms and conditions: include any terms and conditions for the poll
- Custom CSS path: if you want to tweak the styles, include your own CSS file
- Disable CSS: completely disable all poll styles
- Notification: send an email to a specified email address every time a vote is cast
To make things easier, you can also specify poll defaults so that all new polls you create will begin with your preferred settings.
Default poll settings
To make things easier, you can specify your preferred poll settings by going to Settings -> Polarise Pro. Any settings you specify here can be automatically be applied to any new poll you create.
To import the settings into a poll, simply create a poll and hit the Import Settings button in the right pane.
Viewing poll results
The poll results can be viewed in WordPress admin at any time.
Only the first 250 results are shown by default (to not tax your database), but you can change that number in Settings -> Polarise Pro -> Maximum votes shown in admin.
You can also export a CSV of all results.
Exporting poll results
Poll results can also be exported to a CSV by hitting the Download Votes CSV button.
Note: The option to export to a CSV is only enabled if the poll has at least one vote. If the button is greyed out, it means nobody has voted in the poll yet.
Delete single or all poll votes
To delete a single vote:
- Edit the poll in WP Admin
- Scroll down to the Votes metabox
- Hover over the vote you want to delete and hit the red delete icon (you will be asked once to confirm this decision)
To delete all votes:
- Edit the poll in WP Admin
- Hit the Delete All Votes button in the right pane (you will be asked once to confirm this decision)
Note: Both these actions are permanent.
Adding a poll to a page
While editing a poll, the sidebar indicates a couple of ways to embed a poll onto any page or post.
Option 1: Paste the supplied shortcode into the editor (both classic and blocks editor are supported).
Option 2: Paste the PHP directly into a theme template file (advanced use, recommended only if you’re comfortable editing code).
How many polls can be on a single page?
While you can run as many polls as you want across as many pages as you want, only one poll can be displayed per page.
Unlike many other poll plugins, Polarise Pro does not offer a myriad of gaudy, tasteless themes that won’t fit the look and feel of your website.
Instead, you are offered the option to specify a single accent colour that will apply to minor parts of the poll interface, leaving the remaining parts to inherit the fonts and styles already being generated by your WordPress theme. This has the desired effect of making it look more like the polls are actually part of your website.
Additionally if you’re so inclined, you can tweak the poll CSS by including your own stylesheet (as a global setting or per poll).
To preserve the integrity of the poll, you can not modify the poll options if at least one vote has been cast.
With this in mind, it is advised that you triple check (or have someone else check) your poll options before publishing.
Pro tip: If you really have to modify a poll option after a vote is cast, your only option is to delete all the votes for the poll in question.
Although it doesn’t happen often, some users may make efforts to fudge the poll results. There are a few deterrents used to limit this:
Set a cookie
Polarise Pro will automatically set a cookie on the user device after they vote, preventing them from voting in that poll again from the same device.
Ignore existing email address
Polarise Pro will not include votes from email addresses that have already been used to vote in the current poll.
Polarise Pro provides the option to use the Google reCAPTCHA API, which will prevent any automated methods someone may employ to automatically cast votes. When reCAPTCHA is enabled the user is presented with a typical challenge which must be solved before they can vote, as shown in the example pictured below.
To set up reCAPTCHA you will need a site key. Learn how.
Log IP address
Polarise Pro logs the IP address of all votes, but it does not use them to assist in preventing poll fudging. The problem that arises when only allowing votes from unique IP addresses is that it prevents legitimate users voting. For example, users who are in the same household, or users working from an office, only one vote from each respective location would be allowed regardless of how many people are there. This unfairly prevents legitimate users from participating in the poll.
So why log the IP addresses? IP addresses may assist in spotting an obvious pattern where someone has made efforts to fudge the poll. You can then make a better informed decision about deleting certain votes.
To cite an example, you may see a few consecutive votes that appear to be from the same person on the same IP address, like this:
While these are possibly real email addresses, common sense dictates that there’s an excellent chance they all belong to the same person, and this person has voted three times with three email addresses that he owns. It’s now up to you if you want to delete all or just two of his votes.
Additional ways to limit poll fudging
Generally speaking there probably won’t be any or perhaps just limited poll fudging. But just in case, some known ways to mitigate include:
- Include language in the terms and conditions specifically stating that any obvious instances of cheating will be deleted and disqualified.
- Export the poll results to a CSV and remove any instances of obvious fudging, and use this as your source of truth.
Viewing the in-progress poll results might give you a good indication about any potential fudging (for example, several votes that are obviously from the same user as demonstrated above), and you can use your better judgement on what to do about it.
How to setup reCAPTCHA
Setting up reCAPTCHA only takes a couple of minutes.
- Login with your Google account here.
- Hit the + icon in the upper right to create a new key.
- Enter a label (it can be anything, but your domain name is ideal).
- Select reCAPTCHA v2 and then select “I’m not a robot” tickbox.
- Below the Domains heading, add your website domain. This will restrict the use of the reCAPTCHA site key to your website only.
- Accept the terms of service.
- Untick the Send alerts to owners option.
- Hit the Submit button.
You will then be presented with a couple of keys, but we are only interested in the site key:
Now login to WordPress admin and go to Settings -> Polarise Pro, scroll down to reCAPTCHA and paste in your site key. Click Save Settings.
With reCAPTCHA enabled, users will be forced to solve a challenge before they can vote.
Important: DO NOT use your secret key by accident. Only use the site key.
Note: At the time of this publication, Google’s free tier allows up to 1 million reCAPTCHA assessments per month. If you somehow exceed that limit, they will ask you to set up a billing account.
When casting a vote, the following information is saved to the database:
- The vote that was cast
- The date the vote was cast
- The IP address of the user who cast the vote
- The email address of the user
- The name of the user (only if you enable the option)
- The phone number of the user (only if you enable the option)
- The option to be notified of poll results (if the user ticks the checkbox)
If you enable the Privacy setting on a poll, information is dynamically generated and shown to the user.
Where do I enter my license key?
In WordPress admin, go to Settings-> Polarise Pro and enter your license key. Once activated, you will be able to begin creating polls.
How many websites can I use Polarise Pro on?
A single site license allows Polarise Pro to be used on a single domain, although you can purchase a multiple site license if desired.
Is the price of this plugin once only or per year?
That’s up to you.
Twelve months after the initial purchase you will have the option to renew your support license, but you don’t have to.
If you decide not to renew your license after 12 months, your product will continue to work as expected without any limitations, but it simply will not be able to receive updates or be entitled to support.
v1.0.0 (28th June 2022)
- Initial release.