Title: Onyx Poll Author: andremacola Published: 26.5.2020 Last modified: 11.10.2026 --- Hae lisäosia ![](https://ps.w.org/acf-onyx-poll/assets/banner-772x250.png?rev=3740155) ![](https://ps.w.org/acf-onyx-poll/assets/icon-256x256.png?rev=3740155) # Onyx Poll [andremacola](https://profiles.wordpress.org/andremacola/) [Lataa](https://downloads.wordpress.org/plugin/acf-onyx-poll.2.0.2.zip) * [Tiedot](https://fi.wordpress.org/plugins/acf-onyx-poll/#description) * [Arvostelut](https://fi.wordpress.org/plugins/acf-onyx-poll/#reviews) * [Asennus](https://fi.wordpress.org/plugins/acf-onyx-poll/#installation) * [Kehitys](https://fi.wordpress.org/plugins/acf-onyx-poll/#developers) [Tuki](https://wordpress.org/support/plugin/acf-onyx-poll/) ## Kuvaus Onyx Poll creates lightweight polls with the WordPress REST API and JavaScript. ACF and ACF PRO are not required. #### Features * Block editor integration with live preview, standard and Twitter styles. * Shortcode, sidebar widget and automatic modal. * Multiple polls per page, answer images and registered thumbnail sizes. * Editable answer counters; the total is always their sum. * Percentage, number or combined results, with an option to hide results until expiration. * Voting intervals enforced on the server for signed browser sessions. * Automatic expiration and an hourly WP-Cron task. * Native administration with media selection and answer reordering. * Dedicated tables for poll rules, answers and vote counters. * Settings descriptions, help, cron execution status and WordPress Site Health integration. * Optional permanent cleanup on uninstall; data is kept by default. #### Upgrading from the ACF version IMPORTANT: 2.0 is a major update with breaking changes to requirements and internal storage. Back up the full database and plugin files, and test the update on a staging copy before updating a production site. See the breaking changes below and the migration FAQ. Migration starts automatically on activation or on the next WordPress request after upgrading an already active plugin from 1.2.0 or an earlier ACF version. No manual export, import or reactivation is needed. The plugin creates {prefix}onyx_polls and {prefix}onyx_poll_answers and copies existing polls in resumable batches of 50 per request. A requested poll is imported on demand if its batch has not run yet, including the latest-poll shortcode and modal selection. IDs, titles, publication status, answer order and text, image references, individual vote counters, dates, voting limits, result preferences and global settings are preserved. Existing blocks, shortcodes and widgets keep working without editing post content. Each poll is imported in a database transaction; retrying migration does not overwrite already imported polls or votes received in 2.0. Legacy custom fields are kept for recovery and are not deleted by the update. New rules and votes are written only to the plugin tables. ACF is not required to run the plugin or migration; keep it installed if your theme or another plugin still needs it. The database user must be allowed to create the plugin tables. #### Breaking changes in 2.0 * Minimum requirements are now WordPress 6.3 and PHP 7.4. Check the hosting environment before updating. * Poll data moves from WordPress custom fields to the plugin tables. Custom templates, snippets or integrations that read or write ACF fields or onyx_poll_* post metadata must be adapted; those legacy fields stop receiving updates. The plugin’s existing shortcodes, block identifier, widget and public REST routes remain compatible. * Total votes is now read-only and equals the sum of answer counters. A manually entered total that differed from that sum will change during migration; individual answer counters are preserved. * Poll editing and settings use native plugin forms. Customizations that depend on ACF field registration, form markup or ACF-specific hooks must be reviewed. * Downgrading to 1.2.0 does not copy new votes or edits back into legacy fields. Restoring an old backup also loses changes made after that backup. Plan rollback with a current database backup; do not use downgrade as a way to reverse migration. ## Kuvankaappaukset [⌊Poll administration list.⌉⌊Poll administration list.⌉[ Poll administration list. [⌊Poll editing screen.⌉⌊Poll editing screen.⌉[ Poll editing screen. [⌊Poll displayed on the site.⌉⌊Poll displayed on the site.⌉[ Poll displayed on the site. ## Blocks This plugin provides 1 block. * Onyx Poll ## Asennus 1. Install Onyx Poll through the WordPress Plugins screen, or upload the plugin folder to wp-content/plugins. 2. Activate the plugin and create a poll under Polls. 3. Add an Onyx Poll block, shortcode or widget to your site. ## UKK ### Do I need ACF PRO installed? No. Version 2.0 uses its own editor, settings and database tables. Existing ACF poll data migrates automatically. ### Will my 1.2.0 polls and votes migrate automatically? Yes. Updating the active plugin starts migration on the next WordPress request; a fresh activation also starts it. Polls are copied in batches of 50 per request and migration resumes on subsequent requests. A poll needed by a shortcode, block, widget or modal is imported on demand, so a large poll collection does not need to finish migrating before those polls can be displayed. No ACF installation or manual import is required. Poll IDs, answers, images, individual counters and settings are preserved. Migration does not delete the original custom fields and repeated runs do not overwrite new votes. The only intentional result change is that total votes becomes the sum of the answer vote counts. ### Can I update without changing existing posts or losing site content? The built-in blocks, shortcodes and widgets remain compatible, and the update does not rewrite posts or pages or remove media. However, no major update can guarantee compatibility with every hosting environment, theme or custom integration. Back up the database and files, test on staging, verify PHP 7.4 and WordPress 6.3 or newer, and confirm that the database user can create tables. Review the breaking changes if custom code accesses the old ACF fields directly. ### Can I remove ACF or downgrade after updating? Onyx Poll 2.0 and its migration work without ACF. Remove ACF only if your theme and other plugins do not need it. Old ACF fields remain as a pre-migration copy; they are not synchronized with new votes or edits. Downgrading to 1.2.0 therefore does not preserve changes made in 2.0. Keep a current database backup and test any rollback separately. ### How do I add a poll to a post? Insert the Onyx Poll block and select the poll and style, or use a shortcode: ``` [onyx-poll] [onyx-poll id=85] [onyx-poll id=85 class="twitter full"] ``` Replace 85 with your poll ID. Omit the ID to show the latest published poll. Alignment classes: left, right, full. Styles: twitter, standard. The poll list provides a shortcode to copy. ### How do I add a poll to a sidebar? If your theme provides widget areas, add the Poll widget under Appearance > Widgets and select its poll and style. ### Can I use my own CSS? Yes. Keep the default stylesheet enabled to override its CSS variables, or enable Use custom CSS in Poll settings to replace all plugin styles. The help section on that page contains the full variable example. ``` .onyx-poll { --pollWidgetWidth: 400px; --borderColor: #dbe9f5; --boxShadow: 0 4px 12px 6px rgba(31,70,88,.04); --modalBorderRadius: 4px; --questionColor: #333; --choiceColor: #333; --buttonColor: #333; --choiceHoverBG: #f5f5f5; --choiceBarColor: #e0e0e0; --choiceBorderRadius: 100px; --closeBorderRadius: 100px; --loaderBorderColor: rgb(209,226,240); --loaderBG: #a3caec; } ``` ### How can I check the expiration cron? Poll settings shows the last successful check, its source, the next scheduled check, timezone and status. A new installation waits for its first recorded execution; earlier execution history is not available. Checks with no expired polls also count as successful runs. The plugin adds its status to Tools > Site Health. WP-Cron normally depends on site visits. For predictable execution, configure your host to request wp-cron.php every five minutes; the Onyx event itself remains hourly: ``` */5 * * * * curl --fail --silent --show-error 'https://example.com/wp-cron.php?doing_wp_cron' > /dev/null 2>&1 ``` Only after the external scheduler is configured and tested, disable the automatic page trigger in wp-config.php: ``` define('DISABLE_WP_CRON', true); ``` The existing direct expiration endpoint is also supported: ``` 0 * * * * curl --fail --silent --show-error 'https://example.com/wp-json/onyx/polls/cron' > /dev/null 2>&1 ``` This endpoint runs only the Onyx check. It does not run other WordPress scheduled tasks. Endpoint runs are identified separately; an overdue WordPress event still needs investigation. Voting checks deadlines immediately, even when cron is delayed. See the [WordPress server scheduler documentation](https://developer.wordpress.org/plugins/cron/hooking-wp-cron-into-the-system-task-scheduler/). ### Where is the data stored? Poll rules use {prefix}onyx_polls; answers, image references and votes use {prefix} onyx_poll_answers. WordPress stores titles and publication status in the onyxpolls post type. Settings and cron diagnostics use the plugin’s own options. The actual WordPress table prefix is used. No visitor IP addresses or usernames are stored. Cookies remember votes, modal dismissal and voting intervals: onyx_poll_limit_XX, onyx_poll_modal and onyx_poll_choice_XX. ### What happens on uninstall? Data is kept by default. In Poll settings, administrators can choose permanent deletion and must acknowledge that recovery will not be possible without a backup. Permanent cleanup removes only the three plugin tables, the exact list of plugin- owned options, and wp_posts rows with post_type onyxpolls. Other posts and pages are preserved, including those containing poll blocks or shortcodes. Media files, attachment relationships, comments, revisions and legacy custom fields are preserved. Deactivation never deletes poll data. ### What protects anonymous voting? Voting requires POST, a signed browser cookie and a short-lived token bound to the poll and its current answer order. Browser sessions can submit up to 10 valid voting requests per minute. Poll-specific intervals are enforced in the same database transaction as the vote, so simultaneous requests and removal of the old limit cookie cannot duplicate a limited vote. IP addresses and browser fingerprints are not used, and users sharing a VPN or network do not share a voting limit. Someone who deletes all poll cookies, obtains another browser session or automates new sessions can still vote again. These controls reduce request forgery and session- based abuse; anonymous voting does not guarantee one vote per person. Unlimited voting removes the poll-specific interval while keeping the session burst limit. Session limits use {prefix}onyx_poll_guards, which stores keyed hashes, poll IDs, counters and expiry times. Expired records are pruned by cron. WordPress password protection is respected by public poll reads and votes. Poll settings require the manage_options capability; poll editing keeps the existing WordPress permissions. ### Do custom voting integrations need an update in 2.0.2? Yes. Keep the cookie returned by GET /wp-json/onyx/polls/list?id=POLL_ID, read vote_token from the response, then send POST /wp-json/onyx/polls/vote with the same cookie and the X-Onyx-Poll-Token header. The JSON body still contains poll and choice, with one-based choice positions. Refresh the list when the poll changes or the token expires. Requests from unrelated browser origins are rejected. Shared caches must respect Cache-Control: private, no-store on poll REST responses. WordPress supplies the correct REST URLs even when pretty permalinks are disabled. Existing plugin shortcodes, blocks and widgets handle this automatically. Browser cookies are required for voting. Upgrading creates the guards table automatically and preserves existing poll data and votes. The direct cron endpoint remains compatible and is limited to one execution per minute. ### Which browsers are supported? Current Chrome, Firefox, Safari and Edge. Internet Explorer is not supported. The public polling interface does not require jQuery. ## Arvostelut ![](https://secure.gravatar.com/avatar/c5e1695f9aaebd30237b6a7b5963528d74d2a55553b07f34f0709bf3af9ec653? s=60&d=retro&r=g) ### 󠀁[Finally a clean well-designed WordPress poll plugin](https://wordpress.org/support/topic/finally-a-clean-well-designed-poll-plugin/)󠁿 [JanPaul999](https://profiles.wordpress.org/janpaul999/) 21.10.2023 The concept of polls is so simple, yet many WP poll plugins completely fail at this in my opinion, over complicating things, bugs, bad designs, it's all over the place but generally quite bad. This plugin however does polls well. It's simple with a clean design. No bloat or bugginess. It just works and does the job well. ![](https://secure.gravatar.com/avatar/67027ec6d30552d7a5ea38a9119cc6d32e1748d4500dce4001cbd0bd7a7b8995? s=60&d=retro&r=g) ### 󠀁[Works great.](https://wordpress.org/support/topic/works-great-8190/)󠁿 [Stephen Osunwale](https://profiles.wordpress.org/hostephen/) 26.3.2022 Nice and simple. Works great – I just hope it's not abandoned. ![](https://secure.gravatar.com/avatar/0a74e198deb888cc3b658d1c4985c5b745cd8ff7094086868d94d77be19cdfc1? s=60&d=retro&r=g) ### 󠀁[Awesome](https://wordpress.org/support/topic/awesome-8626/)󠁿 [shermangeni](https://profiles.wordpress.org/shermangeni/) 3.3.2021 Works really nice and simple of use !! ![](https://secure.gravatar.com/avatar/a04800f139d7bcf9ed6ad59dd5200c70a519cf35ca9e93e223b0218acd324040? s=60&d=retro&r=g) ### 󠀁[Great plugin](https://wordpress.org/support/topic/great-plugin-26952/)󠁿 [photosjob](https://profiles.wordpress.org/photosjob/) 10.7.2020 Very nice plugin for creating polls (making use of ACF PRO). Adding new polls is a breeze and with widgets and shortcodes they are embedded where ever you want. [ Lue kaikki 4 arvostelua. ](https://wordpress.org/support/plugin/acf-onyx-poll/reviews/) ## Avustajat & Kehittäjät “Onyx Poll” perustuu avoimeen lähdekoodiin. Seuraavat henkilöt ovat osallistuneet tämän lisäosan kehittämiseen. Avustajat * [ andremacola ](https://profiles.wordpress.org/andremacola/) “Onyx Poll” has been translated into 1 locale. Kiitoksia [kääntäjille](https://translate.wordpress.org/projects/wp-plugins/acf-onyx-poll/contributors) heidän työstään. [Käännä “Onyx Poll” omalle kielellesi.](https://translate.wordpress.org/projects/wp-plugins/acf-onyx-poll) ### Oletko kiinnostunut kehitystyöstä? [Browse the code](https://plugins.trac.wordpress.org/browser/acf-onyx-poll/), check out the [SVN repository](https://plugins.svn.wordpress.org/acf-onyx-poll/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/acf-onyx-poll/) by [RSS](https://plugins.trac.wordpress.org/log/acf-onyx-poll/?limit=100&mode=stop_on_copy&format=rss). ## Muutosloki #### 2.0.2 _Release date: 11 Oct 2026_ * Security: restricted voting to POST and added signed browser sessions, poll-bound tokens, and origin checks. * Security: enforced repeat voting limits atomically on the server and limited each session to 10 voting requests per minute, without using IP addresses. * Security: protected password-restricted polls and limited global settings to administrators with manage_options. * Invalidated stale voting tokens when answers change and disabled shared caching of personalized REST responses. * Added a dedicated guards table, cron cleanup, and scoped uninstall handling; existing polls and vote counts are preserved. * Limited repeated public cron calls and prevented expiration from closing a poll that was concurrently reopened. * Improved duplicate-click and network error handling and supported REST URLs with plain permalinks. * Custom voting clients must send the new token and session cookie. See the voting integration FAQ. #### 2.0.1 _Release date: 11 Oct 2026_ * Improved English interface text, error messages, and documentation. * Updated Brazilian Portuguese and German translations and added complete Spanish( Spain) and Dutch translations. * Separated vote action labels from vote count nouns and translated administration status tooltips. * Poll end dates now follow the WordPress site date format. #### 2.0.0 _Release date: 11 Oct 2026_ * Removed the ACF PRO dependency with native administration and a native block editor integration. * Added dedicated tables and automatic, resumable migration of existing polls. * Kept latest-poll shortcodes, listings, and modal selection working while a large migration is still pending. * Calculated total votes from answer counts and preserved concurrent votes during administration saves. * Added settings descriptions, help, cron execution tracking and Site Health integration. * Improved image controls, answer reordering and block previews. * Added an explicit, scoped data cleanup option on uninstall; other content is preserved. * Breaking: requires WordPress 6.3 and PHP 7.4; custom ACF-based integrations must adapt to dedicated storage and native forms. Total votes is derived from answers. See the upgrade notice and migration FAQ. #### 1.2.0 _Release date: 11 Jun 2025_ * Fixed: Sanitized shortcode attributes to prevent stored cross-site scripting ( XSS). #### 1.1.9 _Release date: 20 Apr 2025_ * Fixed: WordPress text domain translation notices. #### 1.1.8 _Release date: 28 Jul 2024_ * Fixed: PHP 8.2 warnings about deprecated dynamic properties. #### 1.1.7 _Release date: 26 Jul 2024_ * Tested with WordPress up to 6.6.1 #### 1.1.6 _Release date: 29 Sep 2023_ * Tested with WordPress up to 6.3.1 #### 1.1.5 _Release date: 20 Jul 2021_ * Tested with WordPress up to 5.8 * Added: Poll image size selection in the settings menu. * Fixed: Singular vote label, thanks to @Dathix. Details: https://github.com/andremacola/ acf-onyx-poll/pull/13 #### 1.1.4 _Release date: 13 Jan 2021_ * Fixed: Removed an ACF hook that caused issues with the ACF JSON save location. Details: https://github.com/andremacola/acf-onyx-poll/issues/12 * Fixed: A fatal error in the poll list when the end date was empty. Details: https:// github.com/andremacola/acf-onyx-poll/issues/11 Thanks to: – @rampantprint (on GitHub) – @bwiebeck (on GitHub) #### 1.1.3 _Release date: 21 Sep 2020_ * Improved: Support for ACF PRO as a must-use plugin. #### 1.1.2 _Release date: 11 Aug 2020_ * Tested with WordPress 5.5. * Fixed: A typo in the REST API permission_callback method. #### 1.1.1 _Release date: 30 May 2020_ * Fixed: Filters that caused fatal errors in some themes and conflicts with other plugins. #### 1.1.0 _Release date: 30 May 2020_ * Added: An Onyx Poll block with live preview. * Added: Copyable shortcodes in the poll list. * Fixed: PHP notices. * Adjusted CSS. * Adjusted JavaScript. * Updated translations. #### 1.0.1 _Release date: 29 May 2020_ * Added native sidebar widget * Added new bar style * Updated the English source translation template. * Fixed: Results display when only vote counts or percentages were selected. * Fixed: PHP notices. * Fixed: CSS flex alignment. * Fixed: Click event handling. #### 1.0 _Release date: 27 May 2020_ * Initial release ## Metatiedot * Version **2.0.2** * Last updated **1 päivä sitten** * Active installations **70+** * WordPress version ** 6.3 or higher ** * Tested up to **7.1.3** * PHP version ** 7.4 or higher ** * Languages * [Dutch](https://nl.wordpress.org/plugins/acf-onyx-poll/) ja [English (US)](https://wordpress.org/plugins/acf-onyx-poll/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/acf-onyx-poll) * Tags * [poll](https://fi.wordpress.org/plugins/tags/poll/)[polls](https://fi.wordpress.org/plugins/tags/polls/) [survey](https://fi.wordpress.org/plugins/tags/survey/)[voting](https://fi.wordpress.org/plugins/tags/voting/) * [Edistynyt näkymä](https://fi.wordpress.org/plugins/acf-onyx-poll/advanced/) ## Arvosanat 5 out of 5 stars. * [ 4 5-star reviews ](https://wordpress.org/support/plugin/acf-onyx-poll/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/acf-onyx-poll/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/acf-onyx-poll/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/acf-onyx-poll/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/acf-onyx-poll/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/acf-onyx-poll/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/acf-onyx-poll/reviews/) ## Avustajat * [ andremacola ](https://profiles.wordpress.org/andremacola/) ## Tuki Onko sinulla jotain sanottavaa? Tarvitsetko apua? [Tukifoorumi](https://wordpress.org/support/plugin/acf-onyx-poll/)