September 29, 2023

ACF Onyx Poll Plugin

Create polls widgets, blocks and modals based on regular Wordpress and acf (advanced custom fields) functionalities.

This plugin requires ADVANCED CUSTOM FIELD PRO installed.

Plugin for polls based on regular WordPress and acf (advanced custom fields) functionalities using WP REST API and Javascript methods.

The main goal of ACF Onyx Poll is to be totally free, lightweight and simple. No fancy, colorful and polluted options or donate screens.

This plugin is based on Twitter poll cards style.

Features

✔ Gutemberg Block with live preview
✔ Include poll with a shortcode (ommit the ID to get the latest poll) [onyx-poll id=XX class="left|right|full"]
✔ One click to vote
✔ Works with cache plugins
✔ Multiple polls per page
✔ Support for images
✔ Native widget for sidebar
✔ Multiple style options [onyx-poll class="twitter|standard"]
✔ Show poll in a modal
✔ Show poll results on widget after expired
✔ Highlight choosed choice in results area
✔ Limit vote by device or time
✔ Poll activation/expiration schedule
✔ Results in percentage, numbers or both
✔ Show/Hide results
✔ Customize css with css variables
✔ Disable all plugin CSS and use your own
✔ Custom columns on WordPress data table admin area
✔ Translations support

Observations

This plugin does not support Internet Explorer Browser. One of the goals of this plugin is to be js/css lightweight and jQuery free.
ACF Onyx Poll register fields via php to be able to use WordPress translation functions for field labels. So you won’t be able to view/edit the fields inside ACF Custom Fields Settings.
To enable a better/faster CRON you need to manually set your host cronjob to get https://domain.tld/wp-json/onyx/polls/cron endpoint or disable WP-Cron define('DISABLE_WP_CRON', true); inside your wp-config and manually create the cron in your host/server
- Option 1: To run every hour set the cron:
  0 * * * * wget -q -O - https://domain.tld/wp-json/onyx/polls/cron > /dev/null 2>&1
- Option 2: if you disable the default WP-Cron:
  0 * * * * wget -q -O - https://domain.com/wp-cron.php?doing_wp_cron > /dev/null 2>&1

Installation

From your WordPress dashboard

Visit Plugins > Add New
Search for “ACF Onyx Poll”
Activate ACF Onyx Poll from your Plugins page
Click on the new menu item “Polls” and create your first Poll!

Screenshots

Admin List Screen.
Creating a poll.
Example of poll widget/modal

FAQ

Do I need ACF PRO Installed?

Yes, Advanced Custom Fields PRO is mandatory

How to add a poll to a post?

If Gutenberg is active, you can use the ACF Onyx Poll Block with live preview
Or..use the shortcode [onyx-poll] to get the latest poll
To add a specific poll, assign the option ID with the requested poll to the shortcode: [onyx-poll id=XX]
You can align the poll container with the option class in the shortcode: [onyx-poll class=left]. Available options are left, right, full
Is it possible to combine style and aligment. Ex: [onyx-poll class="standard left"]

How to add a poll to a sidebar?

To include a widget, your theme need to support it. Go to Appereance > Widgets and select Poll widget from ACF Onyx Poll

Is it possible to use my own CSS?

Yes, go to the settings poll menu. You can do some customization by overriding some CSS variables inside your css file.

.onyx-poll { --pollWidgetWidth: 400px; --borderColor: #dbe9f5; --boxShadow: 0 4px 12px 6px rgba(31,70,88,0.04); --modalBorderRadius: 4px; --questionColor: #333; --choiceColor: #333; --buttonColor: #333; --choiceHoverBG: #f5f5f5; --choiceBarColor: #e0e0e0; --choiceBorderRadius: 100px; --closeBorderRadius: 100px; --loaderBorderColor: rgb(209, 226, 240); --loaderBG: #a3caec; }

What kind of logs and user data this plugin saves in database?

At the database side, ACF Onyx Poll uses the default ACF/Wordpress structure to store data (the meta fields). Nothing to worry about here.

For privacy, ACF Onyx Poll does not store any user data like ip address, usernames etc…

The only things the plugin saves in the user’s browser is some cookies to check the user choice for specific poll, if the modal was previously showed/closed and a timer. You can check the cookies by looking for onyx_poll_limit_XX, onyx_poll_modal and onyx_poll_choice_XX.

What about browsers support?

All modern browsers will be fine: Chrome, Firefox, Safari and Microsoft Edge (legacy and chromium based).

This plugin will not work with any Internet Explorer version.

Changelog

1.1.6

Release Date – 29 Set 2023

TESTED: WordPress up to 6.3.1

1.1.5

Release Date – 20 Jul 2021

TESTED: WordPress up to 5.8
ADDED: Now is possible to change the poll image size in options menu
FIXED: Label for singular votes, thanks to @Dathix. See more in: https://github.com/andremacola/acf-onyx-poll/pull/13

1.1.4

Release Date – 13 Jan 2021

FIXED: Removed an ACF hook that was causing issues with ACF JSON save location. See more in: https://github.com/andremacola/acf-onyx-poll/issues/12
FIXED: Fatal error on list polls when ‘end date’ field was for some reason saved with an empty value. See more in: https://github.com/andremacola/acf-onyx-poll/issues/11

Thanks to:
– @rampantprint (on github)
– @bwiebeck (on github)

1.1.3

Release Date – 21 Set 2020

IMPROVEMENT: Using ACF PRO as MU Plugin is now possible.

1.1.2

Release Date – 11 Aug 2020

TESTED: WordPress 5.5
FIXED: Rest API method permission_callback typo

1.1.1

Release Date – 30 May 2020

HOTFIX: Some filters were causing fatal errors in some themes and conflicting with certain plugins

1.1.0