.. include:: ../Includes.txt


.. _usagePollAdministration:


Poll administration
-------------------

As author of a poll (or administrator) you can edit or finish the poll and you can reset all existing votes.

Below the voting table, authors see an additional box:

.. image:: Images/poll-admin-box.png
   :alt: Administration box for polls, available for poll authors and administrators.
   :width: 75%

Here you can edit, delete or finish the poll (voting process).

.. note::
   Once the first participant placed its vote, the poll can not get deleted anymore.


Instead you can reset all existing votes, until the poll status is "closed":

.. image:: Images/poll-admin-box-with-existing-votes.png
   :alt: Administration box for polls, when the poll already has got votings.
   :width: 75%


With enabled suggestion mode
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

When the suggestion mode has been enabled and is not finished yet, you can finish the suggest mode:

.. image:: Images/poll-admin-box-suggestion-mode-active.png
   :alt: Administration box, when suggestion mode is enabled and active
   :width: 75%
   :class: with-border


Editing published polls
~~~~~~~~~~~~~~~~~~~~~~~

When you've already published a poll and edit its options or change an option related setting (like :ref:`yesNoMaybe`),
all existing votes get removed!

The affected settings and the options section got a "Caution!" label set.

.. image:: Images/poll-settings-during-edit.png
   :alt: Poll settings with "Caution" label, during editing
   :width: 85%


Finish voting
~~~~~~~~~~~~~

The poll author can finish a poll anytime he/she want, after the poll has been published, **unless** an expiration date
has been set, in settings of the poll. Then, the finish action can only get triggered, when the expiration date is
reached.

When finishing the poll, you need to select a final option.

.. image:: Images/finish-poll.png
   :alt: The poll author can finish the poll and select a final option.
   :width: 50%
   :class: with-border


Once a poll has been finished, the show action displays the final option, selected by poll author.

.. image:: Images/finished-poll.png
   :alt: The poll is finished, the poll author has selected a final option.
   :width: 50%
   :class: with-border