Foodle Add-On for Democracy Poll

Descrição

Provides a seamless and flexible, interactive display option for online polls with Democracy Poll with a lot of parameters to be controlled for various display possibilities.
To be used as a shortcode alongside the poll for an interactive results display or separately just for result display purposes.
It provides and will further provide enhancements for Democracy Poll, like e.g. mixed polls (checkboxes plus radiobuttons in one poll). User fields (poll categories) can be defined and maintained in the users’ profiles to provide enhanced result statistics (e.g. showing a choir’s voices representation on proposed concert or rehearsal dates being polled in order to judge the ability to sing) – this was the author’s initial motivation.
Fields can as well be automatized in input based on regular expressions applied on the main user’s field (poll category).
Email reminders to users that didn’t vote, yet. Flexible sorting options and much more. Of course: the main shortcode is made for registered users only. Give it a try!

Inspired by and enhancing: Tkama’s Democracy Poll plugin.

Latest important updates:

  • New from version 2.5.10.0: Individuals can be excluded from being considered as voters – regardless their role(s) – by the tab ‘Special Roles & Users’. From version 2.5.9.0, the bar graph text can be edited in the Foodle settings.
  • New from version 2.5.8.0: The visibility of the bar graph tooltip with users who did not vote yet can now be controlled by roles.
  • New from version 2.5.7.0: Added a dynamic icon (2.5.6.0) in the Democracy poll list and edit pages to visualize the following: a) everyone voted already, b) not everyone voted so far, c) the numer of users to vote is zero or d) an unexpected voter did vote or the participation rate exceeds 100%. In version 2.5.7.0, the following visualization was added: e) NOT all (maybe the brandnew) Foodle poll parameters have been saved so far, so they are still in their programmed default state.
  • New from version 2.5.5.0: A table with a list of users who did not vote so far for a poll is being displayed interactively as a tooltip when hovering with the mouse over the related bar graph (also available on touch screens: just touch the bar graph). Can be limited to administrators for each poll individually (= default). This is also available in the back end poll list an in each poll edit page (icon).
  • New from version 2.5.4.0: Only voters asigned for a poll are able to vote. For each poll, entering new comments can be controlled by roles and administrators’ vote option is controllable as well (since 2.5.3.0).
  • New from version 2.5.1.0: A comments table preview is being displayed interactively as a tooltip when hovering with the mouse over the related green icon, which indicates that comments are available for a poll, or when touching the green icon on touch screens (since 2.5.2.0).
  • New from version 2.5.1.0: A comment’s preview is being displayed interactively as a tooltip when hovering with the mouse over the related green icon (or when touching it on touch screens), which indicates that comments are available for a poll.
  • New from version 2.5.0.0: A new shortcode to display the participation rate of individual polls by means of a bar graph.
  • New from version 2.4.0.0: Visibility Management: In each Democracy Poll edit page, the poll-related visibility of Democracy Poll, Foodle and the poll’s comments can be tailored in detail depending on the users’ roles.
  • New from version 2.3.0.0: A new shortcode was introduced for logged-in users to collect and display user comments related to individual polls. And from version 2.3.7.0 onward, a user template for automated use in the Democracy Poll textarea is available.
  • New from version 2.2.0.0: Selection of roles is now possible for polls in order to easier control reminder emails and statistics.
  • New from version 2.1.0.0: A new back end tab was introduced to display the usage of the Democracy shortcode and the Foodle main shortcode.
  • New from version 2.0.0.0: Major release with a number of improvements and enhancements.

Some General Considerations and more details:

The basic idea for this plugin was developed when the need for polls arrived for the choir I have the pleasure to be part of: Voices Unlimited.
This plugin can be used by any organization, association, union, society, club or group of people when polls shall be executed and results be displayed in a structured way, e.g.:

  • For this or that choir rehearsal or planned public event to be scheduled, would sufficient Sopranos 1 or Tenors 2 be available?
  • Or do the choir members support this or that idea and from which sub-group do they come from?
  • Or what could be winning ideas for the next concert stage dress (Democracy Poll with answers to be brought by the voters and be displayed for everyone easy to understand) and would this spread nicely in color on stage, considering the choir’s stage order?

You will surely translate all this into your own environment and your own needs…

Main feature is the Foodle shortcode, which allows to display poll results in a configurable table format. Alongside the Democracy Poll shortcode, it will display the results interactively by use of AJAX communication.
However, it can as well be used independently to just display poll results.
Together with the WordPress comments function in pages or posts, this can be considered a good tool for online interaction with your registered (!) users.

Warning! Democracy Poll’s logging and IP storing option must be activated in order for Foodle to work. By this, all votes are stored in the database for Foodle to work with. You may select to avoid IP storage in each individual poll in order to avoid failures when voters share the same IP address, e.g. when voting in the same WLAN environment.

The list of Foodle features comprises:

  • The interactive poll results table (shortcode [foodle-democracy-poll-list-log])
  • This shortcode only makes sense and therefore only works for registered users (else: no display) and registered voters (else: message)
  • All other functions work regardless this necessary restriction
  • A shortcode for logged-in users ([foodle-comments]) to collect and display user comments related to individuall polls (hint: in the back end Democracy poll list and each poll edit page, when hovering with the mouse over the related icon or touching it on a touch screen, a tooltip with a comments table preview is being displayed)
  • A shortcode for logged-in users ([foodle-poll-bar-graph]) to display the participation rate of individual polls by means of a bar graph (hint: when hovering with the mouse over the bar graph or touching it on touch screens, a tooltip with a list of users that did not vote yet is being displayed – the same is true in the back end Democracy poll list and each poll edit page by use of the related icon)
  • Several Democracy Poll shortcodes on one page/post (like before)
  • Full shortcode flexibility: Several Foodle shortcodes – even for the same Democracy Poll id with differing parameters – on one page/post
  • Email reminders for users who are late to vote
  • An unlimited number of user metafields to be defined and used (in user profile – can be switched off in Foodle settings)
  • In the user profile, for already existing metafields as well used by Foodle, these can be deactiviated elsewhere in the user profile in order to just be filled in the user profile’s Foodle area
  • A shortcode for a front end interface to these extra user metafields
  • Recovery of orphaned metafield field names, which still have data in the database (user meta)
  • Deletion of data in the database (user meta) for metafield field names, which are orphaned
  • Manual drag-n-drop fields sorting
  • Careful (!) selection and use of existing user metafields
  • Manual entry or drop-down entry in the user profile
  • Automated filling of user metafields by use of Regular Expressions
  • Easy overview and control over past user entries (normalization)
  • Flexible sorting definitions
  • Definition of role & user plugin-internal capabilities
  • Dashboard widget (and shortcode) to provide statistics and check for logical errors in democracy_q, democracy_a and democracy_log databases
  • A shortcode to link to the Foodle page/post
  • A shortcode to display content based on roles
  • A free name/title definition for Foodle, e.g. for the user profile and the email
  • Changeable highlighting of Foodle & Democracy Poll in the admin menu and admin toolbar
  • You can define a list of page/post IDs where the AJAX interactivitiy is switched off.
  • Switchable interactive explanations for all functions (‘Help-Tooltips’)
  • Warning-Tooltips can be disabled
  • Help-Tooltips and Warning-Tooltips are available anywhere for the administrator (front end and back end)
  • A smooth scrolling function is available anywhere for the administrator (front end and back end)
  • A scroll up button with Foodle settings to have control …

Ecrãs

  • Sample front end poll
  • Sample front end poll #2 (with comments)
  • Sample front end poll #3
  • Admin tab: Metafields
  • Admin tab: Normaization and sorting
  • Admin tab: Roles & User internal capabilities
  • Admin tab: Edit email
  • Admin tab: Shortcode usage
  • Admin tab: Foodle settings
  • Admin tab: Tips tab with detailed explanations
  • Admin tab: Tips tab with detailed explanations #2
  • Enhanced Democracy Poll edit screen
  • Enhanced Democracy Poll poll list screen
  • User profile extract example

Perguntas frequentes

FAQ #1: When updating a page, an error like “Updating failed. The response is not a valid JSON response.” appears. What does this mean?

This error typically appears with the “democracy” shortcode present on a page and is NOT linked to Foodle. A reason could not yet be determined, however, while unpleasant, this error is without any negative functional effect!

FAQ #2: During testing, I experienced that deleting one vote of a poll would sometines eliminate all votes. What can I do to avoid this behavior?

Your votes probably contain the same IP address, which typically happens if voters are in the same WLAN environment. For using Foodle, it is mandatory to switch Democracy’s logging and storing of IP addresses on! When re-voting, Democracy would delete all votes with same IP address. In order to avoid this, you can prevent Democracy from storing IP adresses in the Foodle area of each poll admin page.

FAQ #3: I have a few brilliant ideas to further enhance this plugin. What should I do?

That’s great to hear! Just contact the plugin author to propose your ideas :)!

Avaliações

Este plugin não tem avaliações.

Contribuidores e programadores

“Foodle Add-On for Democracy Poll” é software de código aberto. As seguintes pessoas contribuíram para este plugin:

Contribuidores

“Foodle Add-On for Democracy Poll” foi traduzido para 1 locale. Obrigado aos tradutores pelas suas contribuições.

Traduza o “Foodle Add-On for Democracy Poll” para o seu idioma.

Interessado no desenvolvimento?

Consulte o código, consulte o repositório SVN, ou subscreva o registo de alterações por RSS.

Registo de alterações

2.5.11.1

  • (Fix) Triggers to show the warning message for roles selection of the bar graph tooltip visibility were optimized.
  • Thorough test with WordPress 6.5 version.

2.5.11.0

  • (New) If those exist: Added a table with “unexpected voters” in front of the AJAX tooltip table with voters that did not vote, yet. Unexpected voters can occur when playing around with the voter settings after votes have been done.

2.5.10.1

  • (Tweak) Improved poll data gathering and related error handling.

2.5.10.0

  • (New) Individuals can be excluded from being considered as voters – regardless their role(s) – by the tab ‘Special Roles & Users’.

2.5.9.1

  • (Fix) Corrected the help tooltip for the bar graph text definition in the Foodle settings.

2.5.9.0

  • (New) Introduced bar graph text definition in the Foodle settings.

2.5.8.7

  • (Tweak) Added a little structural improvement and a dynamic warning for the bar graph tooltip roles selection in each Democracy Poll edit page.
  • (Tweak) A few code improvements.

2.5.8.6

  • (Fix) Language correction.

2.5.8.5

  • (Fix) Under certain circumstances, hide on mouse out did not work with warning tooltips. Fixed.

2.5.8.4

  • (Fix) Small bug fix.

2.5.8.3

  • (Tweak) The icon information above the poll list table was further improved and a second icon information underneath the list will show up as soon as the poll list is getting longer than 7 entries.

2.5.8.2

  • (New) Added parameter ‘foodle_tooltip_touch’ to the Foodle tooltip function (see Foodle tips-tab).
  • (Tweak) Added tooltip explanations to the icon information above the poll list table.

2.5.8.1

  • (New) Added an icon information above the poll list table.

2.5.8.0

  • (New) The visibility of the bar graph tooltip with users who did not vote yet can now be controlled by roles.
  • (Fix) The adherence to the visibility settings was further improved.

2.5.7.1

  • (Tweak) The tips tab content was further improved with relevant information.

2.5.7.0

  • (New) Added a new image for the dynamic icon to visualize the following: e) NOT all (maybe the brandnew) Foodle poll parameters have been saved so far, so they are still in their programmed default state.
  • (Fix) A few bugs were fixed.

2.5.6.0

  • (New) Added additional information to the tooltip with the list of users that did not vote so far.
  • (New) Added an indication in case the number of users to vote is zero (could e.g. happen when there’s an incorrect role selection for a poll).
  • (New) Added a dynamic icon in the Democracy poll list and edit pages to visualize the following: a) everyone voted already, b) not everyone voted so far, c) the numer of users to vote is zero or d) the participation rate exceeds 100%.

2.5.5.1

  • (Tweak) The tooltip table with users who did not yet vote is also available in the back end poll list an in each poll edit page (icon).

2.5.5.0

  • (New) A table with a list of users who did not vote so far for a poll is being displayed interactively as a tooltip when hovering with the mouse over the related bar graph (also available on touch screens: just touch the bar graph). Can be limited to administrators for each poll individually (= default).

2.5.4.2

  • (Fix) Fixed a bug with hiding Democracy Poll and Democracy Poll archives for certain roles.

2.5.4.1

  • (Tweak) Added some information to the bar graph (number of users that did vote and total number of users concerned by this poll, plus an indication in case the participation rate exceeds 100%).
  • (Tweak) A few optimizations for robustness.
  • (Fix) Fixed a bug where administrators could eventually not vote as long as the Foodle poll parameters weren’t yet saved at least once for a poll.

2.5.4.0

  • (New) Only voters assigned for a poll will be able to vote, provided, they can see the poll anyway. This logic includes the administrator role.
  • (New) Aside the visibility of comments, it can now be decided for each poll, whether comments can be entered, depending on roles.
  • (Tweak) Some strings were improved for better clarity.

2.5.3.0

  • (New) In each Democracy Poll edit page, it can be decided separately, whether administrators count for the pool of voters (bar graph), when they are selected. This provides additional flexibility for the visibility setup.
  • (Tweak) The shortcode [foodle-link-democracy-poll] is no longer visible in Democracy Poll archives, as these archives provide a link anyway.
  • (Tweak) Added classes ‘foodle-link-shortcode’ and ‘foodle-link-shortcode-xx’ with xx being the poll id to the [foodle-link-democracy-poll] output link.
  • (Tweak) Added some robustness to the bar graph animation function.

2.5.2.1

  • (Fix) Fixed a bug introduced with the interactive comments tooltip: the safety query before deleting all comments of a poll is back.

2.5.2.0

  • (Tweak) The interactive tooltip display of poll comments is now also available on touch screens (just touch the green icon).
  • (Fix) Added two missing CSS styles for the comments table in the back end.

2.5.1.0

  • (New) A comments table preview is being displayed interactively as a tooltip when hovering with the mouse over the related green icon, which indicates that comments are available for a poll.

2.5.0.7

  • (Fix) Make sure that the first (“original”) use of each of both shortcodes, [democracy] and [foodle-democracy-poll-list-log], will stay as the first in the list to be properly used by shortcode [foodle-link-democracy-poll].
  • (Tweak) Optimized the navigation tabs on the foodle admin page.

2.5.0.6

  • (Tweak) Bar graph visibility is now controlled as set in the Foodle settings like all other Foodle parts.
  • (Tweak) CSS structures further improved.
  • (Fix) A few strings improved.

2.5.0.5

  • (Tweak) Further CSS cleanup to cover “aggressive” themes.

2.5.0.4

  • (Tweak) Optimized the display logic of the ‘so far no comments’ message and some spacing with related CSS.

2.5.0.3

  • (Tweak) Optimized the display logic and text size of the new comment input title.

2.5.0.2

  • (Tweak) The title of both, the Foodle bar graph and the Foodle comments table, will only be removed, when inside the correct (!) Democracy textarea.

2.5.0.1

  • (Tweak) The participation rate bar graph will now update simultaneously when a vote is done or changed.
  • (Fix) Corrected a string.

2.5.0.0

  • (New) A new shortcode [foodle-poll-bar-graph] to display the participation rate of individual polls by means of a bar graph.

2.4.3.0

  • (New) The visibility of the Foodle scroll up button can now be controlled in detail throughout front end and back end.
  • (Tweak) Some structural improvements in the plugin files.

2.4.2.2

  • (Tweak) Scroll up button’s hand symbol was corrected and enlarged a bit.
  • (Fix) Scroll up button was lacking its help tooltip. Fixed.

2.4.2.1

  • (Tweak) The tips tab scroll up button was enhanced to a dynamic version and is now available everywhere in the Foodle admin pages and the Democracy admin pages.

2.4.2.0

  • (New) A new function was introduced: Smooth scrolling with various parameters also for administrator use in front end and back end.
  • (New) The tips tab now contains top links to the different chapters (incl. a scroll up button) for overview and easy access to the numerous functions, which can also be considered as a list of contents.
  • (Tweak) A few strings improved for better clarity.

2.4.1.0

  • (New) The use of id=”self” for shortcodes in the Democracy textarea now works as well in Democracy archives, i.e. when displayed through shortcode [democracy_archives].
  • (Tweak) Translation for role names is now available in Foodle tab ‘Special Roles & Users’ as well.
  • (Tweak) A few message and stability improvements.
  • (Fix) Under certain circumstances, when used more than once in one Democracy textarea, id=”self” did not properly work. This was fixed.

2.4.0.0

  • (New) Introduced visibility management: In each Democracy Poll edit page, the poll-related visibility of Democracy Poll, Foodle and the poll’s comments can be tailored in detail depending on the users’ roles.
  • (Tweak) Improved a few tooltips.
  • (Tweak) A few other minor improvements and adaptations.

2.3.7.6

  • (New) In each Democracy Poll edit page, an icon will indicate whether a poll did already receive comments (directly under the icon indicating the IP storage).

2.3.7.5

  • (New) In the Democracy Poll’s poll list, an icon will indicate whether a poll did already receive comments (directly under the icon indicating the IP storage).

2.3.7.4

  • (New) During formular edit in Democracy and Foodle, changed fields (incl. the first new answer) are marked golden for better overview.