https://github.com/heimrichhannot/contao-email_voting

Email-based voting system using efg forms
https://github.com/heimrichhannot/contao-email_voting

Last synced: 2 months ago
JSON representation

Email-based voting system using efg forms

• Host: GitHub
• URL: https://github.com/heimrichhannot/contao-email_voting
• Owner: heimrichhannot
• Created: 2015-08-11T12:48:09.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2017-01-19T09:30:17.000Z (about 9 years ago)
• Last Synced: 2025-01-20T00:53:18.924Z (about 1 year ago)
• Language: PHP
• Size: 408 KB
• Stars: 1
• Watchers: 9
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Contao E-Mail Voting

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](docs/formfields.png)

### 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](docs/form.png)

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

![alt myModulePreview](docs/form_email.png)

### Step 4

The activation site needs to contain an activation module:

![alt myModulePreview](docs/article.png)

*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