.. include:: ../Includes.txt


.. _configuration:

=============
Configuration
=============

Target group: **Administrators**

How to configure the extension.

Configuration Module
====================

Once the extension is installed, a new backend module gets visible. Most probably at bottom of your backend.

.. figure:: ../Images/AdministratorManual/BE-Module.png
   :width: 400px
   :alt: Backend Module

At the first call, you will receive a warning for an empty configuration.

.. figure:: ../Images/AdministratorManual/NewConfiguration.png
   :width: 5008px
   :alt: Backend Module

Click at the button "create a new configuration"


.. figure:: ../Images/AdministratorManual/Configuration.png
   :width: 5008px
   :alt: Backend Module

- **Administration backend user group**: Choose a backend user group, which is allowed to edit the configuration
- **Election manager backend user group**: Choose a backend user group, which is allowed to edit the election
- **Poll manager backend user group**: Choose a backend user group, which is allowed to edit polls
- **Plugin PID**: Page ID of the election plugin
- **Number of mails to send at once**: Set number of mails, which will send out in one request. In a normal environment 100 Mails should be possible
- **Email address of the sender**: Valid email, which is used to send out the mails.
- **Name of the sender**: Name of the sender, which is displayed in the mail
- **Debug mode (will send all invitations to the configured test mail, but creates only dummy tokens)**: Enables the debug mode
- **Debug test e-mail**: Mail which is used in debug mode.

When you are ready, please choose "save and close" to proceed.

Page Plugin
===========

Choose now the page module and the election plugin, to the page, you added to the configuration

Edit Configuration
==================

.. figure:: ../Images/AdministratorManual/EditConfig.png
   :width: 5008px
   :alt: Backend Module

If you want to edit an existing configuration (and you are member of the administration group), you can use the tool icon to edit the configuration.

Next step
=========

:ref:`Use the extension <user>`.