What's new in 5.0.3
5.0.3 is a privacy and polish release. It tightens who can see poll results and voters, adds a Delete data on uninstall switch, fixes dark mode and mobile layouts, and makes pages load fewer files. Read the update notes and run the short retest below before you tell your members the update is done.
Update notes
Section titled “Update notes”- Requirements are unchanged. WordPress 6.6 or later (tested up to 7.1) and PHP 8.1 or later. BuddyPress is optional and is needed only for activity polls and group polls.
- No settings or data are migrated. Your polls, surveys, votes and settings stay as they are.
- Deleting the plugin now keeps your data by default. Polls, surveys, votes, survey responses, leads and settings are removed only if Delete data on uninstall is on in Polls Settings > Uninstall before you delete the plugin. It is off by default. Caches and leftover vote locks are always cleared. See Standalone Polls Settings.
- Dark mode now follows the BuddyX or Reign dark mode only. Polls, surveys and widgets no longer switch to dark from the visitor’s device setting. On a theme without that dark mode they stay light.
- The bundled Font Awesome files are gone. Polls use the plugin’s own icons. If your own CSS or templates relied on Font Awesome being loaded by WB Polls, load it from your theme.
- Hide results until the poll ends now appears in the poll form only when the poll has an end date. Polls that never end, or were saved without an end date, no longer hide results.
- Voter lists are for logged-in members. The +N voters list on single polls is now for logged-in members, the same as on activity polls. Visitors still see vote counts and the first voter avatars.
- Polls made through the REST API are stricter. A poll needs a title and at least two different answers. An update that leaves out the answers keeps the poll’s answers. A poll created without a poll type is a text poll.
- Pages without polls load fewer files. The poll composer files no longer load for logged-out visitors on activity pages or on pages without polls, and the Poll Graph and Poll Report widgets load only their own files, only where they are placed.
What changes for you as the site owner
Section titled “What changes for you as the site owner”- Show poll title switch on the WB Poll block, on by default. Turn it off when the block sits in a widget that already shows its own title.
- Delete data on uninstall in Polls Settings (see the update notes).
wp bppolls cleanremoves only the demo polls, activity polls and surveys made bywp bppolls generateand keeps your members’ real content.
Poll results, voters and privacy
Section titled “Poll results, voters and privacy”- An ended poll’s page shows its results to members who did not vote and to guests, the same as the Poll Report widget and the REST API.
- An open poll’s page shows results to administrators and the poll’s author before they vote, the same as the Poll Report widget and the REST API.
- With Hide results until voted on, members who have not voted no longer see a poll’s vote total on the poll page, poll cards, the Poll List block or the poll list API, the same as activity polls.
- The poll list API no longer returns a poll’s rendered results when the poll’s settings hide them from the viewer, whatever
include=resultsorinclude=allasks for. - When a poll shows results without voting inputs (after you vote with changing votes off, or once it has closed), your choice is marked with a check and “Your vote” on activity polls, poll pages, the Poll and Poll List blocks, and the Poll Report and Poll Graph widgets. This works for members and guests; a guest’s own vote is marked while their browser keeps the poll cookie.
- A member who already voted sees their vote, and cannot vote again, from another browser or device.
- The voters list on activity polls loads 20 voters at a time with a Load more button. Single polls show 3 voter avatars per answer, and the +N button loads the rest 20 at a time.
- Activity polls show 3 voter avatars per option, the documented default, when Show N voters was never saved. It was 5 before.
- The voters list opens from the keyboard with Enter or Space, is announced as a dialog, keeps focus inside, closes with Escape or a click outside, and returns focus to where you were. Single polls get a visible close button, and the +N button has a View All tooltip and an accessible name.
- A multiple-choice poll counts each option once per voter, even when the same answer is sent twice.
- The “Hide results” option on the poll form now reads Hide results until the poll ends (see the update notes).
- Show Poll Description now shows the poll’s description instead of the number 1, once on the poll page. Turning it off hides it on the poll page and on cards.
- A paused poll shows a Paused badge on the poll page, poll lists, the Poll Dashboard and the admin poll list instead of Active. The Active and Scheduled list filters no longer include paused polls.
- The poll author can export an activity poll’s votes to CSV again. The export no longer writes a temporary file to the uploads folder, and a poll with no votes downloads a CSV with just the header row instead of an error page.
- Poll authors now see the Export CSV button on the front-end Poll Graph widget, not only in wp-admin.
- BuddyPress Search and BuddyBoss search show and count only the polls that match the search term, and leave out spam, hidden and private polls.
Creating polls and answers
Section titled “Creating polls and answers”- Poll answers made only of spaces are no longer saved, an answer of 0 is kept, and answers that differ only in capitals or spacing count as the same answer.
- Adding a write-in option to a poll skips blank options and options the poll already has, and shows a message instead of saving nothing.
- On activity polls, adding a write-in option no longer counts as a vote, so the member keeps the vote form and votes with Submit. Deleting your own write-in option removes it from the poll card straight away and never leaves you unable to vote.
- Each answer row in the poll editor shows its number and title, and both update as you add, remove or reorder answers.
- Typing past a character limit in the activity post box, the Poll Dashboard or the
[wbpoll_create]form shows a notice that the limit was reached. - The “not allowed to enter more than N options” notice in the activity poll composer closes with Escape as well as Got it, and returns focus to Add option.
- A double click on Submit, Add option or Delete option in an activity poll sends one request, so members no longer see an “already voted” error after voting.
- An activity or group poll posted right after typing its options is always saved as a poll, and a plain group update no longer shows “created a poll in the group”.
- On BuddyPress, a poll posted in a group shows as “created a poll in the group” instead of “posted an update in the group”. Polls posted before the update keep their saved line.
- With several activity polls on one page, or the same poll twice, clicking an option label selects that poll’s option.
- Image, video and audio uploads from the activity post box follow the Activity Polls media settings that show those buttons, and no longer fail when standalone image, video or audio polls are off.
- Saving an image, video or audio link for an activity poll needs a member who may create activity polls, with that media type turned on. Visitors are asked to log in.
- Poll image, video and audio links must be full http or https addresses of at most 2048 characters. Anything else is refused with a message in the post box, including when you press Preview and when you post.
- Image, video and audio polls count as on only when switched on under Poll Types in Polls Settings, the same as the settings page shows. A setting saved without a value no longer turns them on.
- Editing an image, video, audio, HTML, star rating or yes/no poll in the Poll Dashboard after that type is switched off still shows and keeps its options.
- The Who can vote list in the poll editor no longer shows blank group headers. Role names in the poll editor, Polls Settings, Activity Polls settings, Survey Settings and the survey access list follow the site language, and Registered and Anonymous are translatable.
Lists, pages and the Poll Dashboard
Section titled “Lists, pages and the Poll Dashboard”- The Poll List block and
[wbpoll_list]follow their Columns setting, then drop to two columns on tablets and one on phones. The polls archive shows as many columns as fit (three on desktop, two or three on tablets, one on phones). - The Poll List block and
[wbpoll_list]status filter shows full pages of matching polls with the right page count, and the block’s Closed option lists only ended polls. They no longer offer a Category filter, which never matched any poll. - A Poll Dashboard page number past the last page shows the last page instead of an empty list with a range like “Showing 205-201 of 201”. The Activity Polls tab always links its last page.
- Page numbers and previous and next buttons on the Poll Dashboard, poll and survey archives, the Poll List block and the wp-admin vote logs and survey responses are at least 40px tall.
- The Poll Dashboard create and edit panel and its confirm dialogs open above sticky theme headers on phones.
- Pages with more than one
[bp_polls]shortcode no longer repeat the page id “buddypress”. - New poll and survey links work right after activation on sites without BuddyPress, with no Permalinks re-save.
- On sites without BuddyPress, Polls Settings no longer points to an Activity Polls tab that is not there.
- After an uninstall with Delete data on uninstall and a reinstall, activity items that held deleted polls show “This poll is no longer available.” and are no longer counted or listed as activity polls on the Poll Dashboard, the Polls stats widget or the Poll Graph widget. The reinstall keeps the existing Poll Dashboard page assigned and seeds the same default settings as a fresh activation.
Surveys
Section titled “Surveys”- A survey whose saved question list or member type list is not valid JSON no longer stops the survey, its editor or the Surveys list with a fatal error on PHP 8.
Look, dark mode and mobile
Section titled “Look, dark mode and mobile”- Polls, surveys and widgets switch to dark only with the BuddyX or Reign dark mode, and every surface, field and badge has a dark colour. The description editor and answer fields in the Create Poll form follow dark mode.
- Empty result bars are visible in light mode. Badge, Submit and survey button text stays readable on any accent colour, and the Vote button picks a readable label for any custom button colour. Text on accent-coloured buttons, the current page number, selected poll type icons, the Export CSV button and survey buttons switches between white and black to stay readable.
- Poll and survey text, status labels, badges, buttons and empty result bars are readable in light and dark mode on BuddyX, BuddyX Pro, Reign and block themes.
- In dark mode the voters list header stays a dark bar with white text, and selected video and audio options keep their player visible and usable.
- The activity poll checkbox has a visible border in light and dark mode, and stays square on phones.
- Settings switches can be reached with Tab and flipped with Space again when another Wbcom plugin is active, and no longer show overlapping ON/OFF text. Settings tabs fit the screen on tablets and phones.
- On phones, the +N voters button is easier to tap (a 41px target around the same small badge) and shows a focus ring with the keyboard. The Cancel Poll button in the activity post box is a full-size tap target.
- Media button tooltips in the activity post box no longer stay open after a click and overlap the next button’s tooltip.
- On right-to-left sites the voters list shows each member’s handle as @name instead of name@.
- The media uploader, confirm dialogs and messages opened from the activity post box show on top of the BuddyBoss post window instead of behind it, and Esc closes only the uploader, not the post window. The Add image, Add video and Add audio buttons open the uploader again instead of failing with a script error.
- The poll button no longer shows an open, unstyled poll panel in a post box widget on pages that do not load the poll composer. Clicking the poll button no longer logs an error in the browser console.
- Confirm dialogs and media upload titles are translatable.
- The Poll Graph widget, its settings form and the wp-admin Polls stats widget no longer load every poll’s comments, so they cost the same queries for 10 or 50 polls.
- Voter avatars on activity polls, the
[bp_polls]shortcode, vote results and single poll results load every voter name in one batch, and an activity feed loads the voters of all its polls together, on BuddyPress and BuddyBoss. - The poll page checks whether you already voted once, and loads the first voters of every answer with the vote totals, so it costs the same queries for 3 or 10 answers and 12 or 50 voters.
- After an update, the voters list, notices and confirm dialogs load their new styles instead of an older copy cached by the browser.
- The activity post box no longer sends a request to the server each time a poll option is typed or changed.
Licence, notices and logs
Section titled “Licence, notices and logs”- A plugin zip missing its
edd-licensefolder no longer stops the whole site with a fatal error. Polls keep working and administrators see one notice that licence and updates are unavailable until the plugin is re-installed from the original zip. - Updating with demo polls installed no longer logs a “map_meta_cap was called incorrectly” notice.
- Voting, the voters list, poll media, widgets and survey steps no longer log a “wp_send_json was called incorrectly” notice on every request when
WP_DEBUGis on. - The voters list and the “created a poll in the group” activity no longer log BuddyPress deprecation notices on BuddyPress 12 and newer.
- Reinstalling after Delete data on uninstall no longer logs an “Undefined variable $dashboard_page_id” warning.
WP-CLI
Section titled “WP-CLI”wp bppolls listworks as documented and lists private and scheduled polls too. The olderwp bppolls list-pollsandwp bppolls list_pollsnames still work.wp bppolls generatereports the demo poll types it made. Re-running one demo type no longer breaks or duplicates the demo surveys, and deleting an activity poll also clears it from its voters’ vote records.wp bppolls generate --author=<id>sets the owner of the demo polls. The old--useroption never reached the command.- Demo data records votes the same way real votes are recorded, so demo voters see their own vote and cannot vote twice, and demo polls open in the editor with the right settings.
- The WP-CLI help and the reset prompt now say that
wp bppolls resetdeletes every poll, survey, response and vote, not only demo data.
Retest after updating
Section titled “Retest after updating”Use a private browsing window for the logged-out checks.
- Open a poll with Hide results until voted on as a logged-out visitor and as a member who has not voted. No vote total or result bars should show until they vote.
- Vote on a poll, then open it in another browser as the same member. It should show your vote and no vote form.
- Open a poll with an end date and Hide results until the poll ends on. Results should show once the end date passes.
- Open the +N voters list on an activity poll and a single poll. Check it opens with the keyboard, loads more voters and closes with Escape.
- If you use BuddyX or Reign, switch dark mode on and look at a poll, a survey and the Poll Dashboard.
- If you use the Poll List block or
[wbpoll_list], check the columns on a phone and the page count when you filter by status. - In the activity post box, create a poll with images, video or audio and confirm the uploader opens.
- Decide about Delete data on uninstall in Polls Settings before you ever delete the plugin.
- If you use the REST API to create polls, confirm each request sends a title and at least two different answers.
- Open WB Plugins > WB Polls > License and confirm the licence is Active.
For developers
Section titled “For developers”- Changed: the
wbpoll/v1/votersREST route answers 404 for an id that is not a poll the viewer can see, and for an unpublished poll, instead of 403. - Changed:
bpolls/v1/set-poll-typeis a no-op, kept for cached scripts. The poll type comes from the options posted with the update. - Changed: a REST poll create without
poll_typeis saved asdefault(text), and_wbpoll_answer_extrasaves one entry per answer. See REST API. - Changed: the poll list API leaves out rendered results when the viewer may not see them.
- Removed: the bundled Font Awesome stylesheet and fonts. Poll icons are inline SVG.

