README

Latest Version: 2.3.5
Released: 2019-02-24
Contact: iionly@gmx.de
License: GNU General Public License version 2
Copyright: (c) iionly, Juho Jaakkola, Kevin Jardine, John Mellberg and Dr Sanu P Moideen

Description

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

1. 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,
2. Copy the poll plugin folder into you mod folder,
3. Enable the Poll plugin in the admin section of your site,
4. Check the Poll plugin settings and adjust the settings according to your preference.

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 (kevin@radagast.biz) 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.