heimrichhannot/contao-email_voting

Email-based voting system using efg forms

2.0.1 2017-01-19 09:30 UTC

This package is not auto-updated.

Last update: 2023-01-21 09:04:08 UTC


README

The module offers functionality for using an EFG form to be a voting form.

In order to offer a certain amount of protection against fake votes, every vote needs to be confirmed via email.

Only one vote per email is possible.

Technical instruction

Step 1

Add the necessary fields to a new EFG form:

alt myModulePreview

Step 2

Activate "Save formdata (efg)" in the form configuration (alias field could be email).

Step 3

After adding the necessary fields, link them in the form's config:

alt myModulePreview

In order to confirm the voting, an email has to be sent:

alt myModulePreview

Step 4

The activation site needs to contain an activation module:

alt myModulePreview

The module doesn't need any further configuration

Features

Modules

Name Description
ModuleEmailVotingActivation A module taking a token in the GET parameter to activate the voting.

Hooks

Name Arguments Description
processEfgFormData -> generateTokenLink $objTemplate, $arrItem, $objModule Adds a token link in order to use it in the confirmation email after a voting
validateFormField -> validateVotingEmailFormField $objWidget, $intId Checks for existing votings for a certain email address