Survey plugin for Elgg 1.12

This plugin is forked from Poll plugin 1.10.2. Some of the implementation ideas also come from knowledge_database plugin from Facyla, with insights from Evan Winslow proposal at Elgg/Elgg#6808

This plugin has a different aim than "poll", and is not backward-compatible. In fact, both plugin can be enabled and used at the same time to provide simple polls and more complex surveys.

Survey plugin provides survey features such as:

• multiple questions,
• extended set of available question types (notation, free text, multiple choices, etc.)
• nice results views, and results filtering, per question and per responder
• CSV results export It is intended to admins and optionally group admins rather than to simple members.

For reference : Parent plugin Poll readme

Poll plugin for Elgg 1.10 Latest Version: 1.10.2 Released: 2015-02-15 Contact: [email protected] License: GNU General Public License version 2 Copyright: (c) iionly, Juho Jaakkola, Kevin Jardine, John Mellberg and Dr Sanu P Moideen

This plugin allows adding of polls (both site-wide polls and optionally also group-specific polls). The number of choices to vote on is free to choose for each poll. Optionally, a (longer) description can be added to a poll. An admin can also (optionally) make a single poll the site's current featured poll. The widgets included are a "My polls" widget that shows a user's polls on his profile page and/or dashboard, a "Latest community polls" widget for the dashboard (and if the Widget Manager plugin is available also on the index page), a group's polls widget for group profile pages and the "Featured poll" widget showing the site's current featured poll on the dashboard (and if the Widget Manager plugin is available also on the index page). Notification on creation of new polls is optional (admin setting) and the creation of river entries for new polls and voting on polls can also be enabled/disabled in the plugin settings.

The poll plugin has a long history (see below), has been released in various versions by different developers and a few word about the compatibility of this new release of the poll plugin seem necessary. Basically, there exist two classes of the "poll" plugin (or "polls" plugin respectively): most of the versions are based quite closely on the original version of the "poll" plugin by John Mellberg. Each of them is compatible to the other versions of the "poll" plugin regarding existing polls but there is quite a mess regarding compatibilty to Elgg itself (at maximum Elgg 1.7 anyway). The other class consists actually only of the "polls" plugin of Kevin Jardine. The polls plugin of Kevin is a complete re-write, works also on Elgg 1.8 but is not compatible with the other poll plugins.

With this new release I've tried to merge the two classes of the poll(s) plugin again. While it's based on Kevin's polls plugin I've renamed it again to poll plugin, tried to fix the remaining issues and also included an upgrade script for existing polls created with any former version of the poll plugin.

Installation

(0. If you have a previous version of the poll plugin installed, first disable the poll plugin and remove the poll plugin folder of the old version from your mod folder,)

1. Copy the poll plugin folder into you mod folder,
2. Enable the Poll plugin in the admin section of your site,
3. Check the Poll plugin settings and adjust the settings according to your preference.

Changelog

1.12.0 : 20160412 - updated to Elgg 1.12

1.8.20.1 : 20150312 - rewritten survey plugin

• multiple questions per survey
• question types : text, longtext, pulldown, checkboxes, multiselect, rating, date
• improved results on survey page
• detailed results page + per question + per user
• charts (using elgg_dataviz plugin)
• add comments setting + disable comments by default

1.8.20 : 20150219 - Facyla fork based on poll 1.10.2 from iionly

• back to Elgg 1.8
• FR translation
• start implementing multiple questions and answers types

1.10.2:

• Based on version 1.9.2,
• Fix of deprecation issues occuring on Elgg 1.10 (namely changing output/confirmlink view to output/url view).

1.9.2 (thanks to Juho Jaakkola!!!):

• Major cleanup / simplification / restructuring / updating / move to more object oriented code,
• Conversion of javascript code into an AMD module,
• Finnish translations added.

1.9.1.1:

• Fixed a deprecation issue (with the hopefully soon to be released Widget Manager plugin for Elgg 1.9) with widgets urls (clickable title link).

1.9.1:

• Updated version 1.8.1 for Elgg 1.9.

1.8.1:

• Optional time limitation on polls (poll results are still shown afterwards but voting is no longer possible). Time limitation on polls can be enabled/disabled by plugin setting. Thanks to Jerome Bakker for the inspiration to this feature (and some initial code for implementing it, too),
• Optionally make a poll an open poll (it's visible who voted for which poll choice). Thanks to tacid for the inspiration to this feature (and most of the code for implementing it, too),
• Latest comments made on polls in sidebar on "All" and "Mine" poll pages,
• Consistent display of poll creator, poll creation date, number of votes, number of comments and tags in all widgets, the list view and full view,
• Removal of files no longer in use (that's why you should remove the plugin folder of any previous version to get rid of them, too).

1.9.0:

• Updated version 1.8.0 for Elgg 1.9.

1.8.0:

• Some general code cleanup,
• Fix remaining issues of deprecated function usage,
• Fixed widgets (both with and without usage of Widget Manager plugin),
• Fixed notification sending,
• Added (optional) description field,
• Added convert script for existing polls that have the old response data structure of the original poll plugin.

Contributors / History

The original Elgg 1.x Poll plugin was written by John Mellberg (http://www.syslogicinc.com) and modified by Team Webgalli (www.webgalli.com) to work with Elgg 1.5.

Kevin Jardine at Radagast Solutions ([email protected]) rewrote the original code to create the Polls plugin for Elgg 1.6/1.7.

Anirup Dutta removed some deprecated functions to create a preliminary version to work with Elgg 1.8.

Kevin Jardine rewrote the plugin completely for Elgg 1.8.

Stephen Clay contributed some bug fixes and suggestions.

Jerome Bakker (http://www.coldtrick.com) contributed some missing language strings, title and breadcrumb fixes and fixes to eliminate PHP warnings/notifications.