====== schulzevote Plugin ======

---- plugin ----
description: A plugin for embedding a poll in a wiki page
author     : Adrian Lang 
email      : dokuwiki@cosmocode.de 
type       : syntax, action
lastupdate : 2021-11-02
compatible : 
depends    : 
conflicts  : 
similar    : 
tags       : vote, poll

downloadurl: https://github.com/cosmocode/dokuwiki-plugin-schulzevote/zipball/master
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-schulzevote/issues
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-schulzevote/
donationurl: 
----

===== Download and Installation =====

[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Syntax and Usage =====

A voting is created as following:

  <vote>
  Candidate A
  Candidate B
  Candidate C
  </vote>

To add a closing time for the poll, add a date to the vote definition:

  <vote 2025-01-01>
  Candidate A
  Candidate B
  Candidate C
  </vote>

The vote can be aligned horizontally as well:

  <vote 2025-01-01 right>
  Candidate A
  Candidate B
  Candidate C
  </vote>

  <vote 2025-01-01 center>
  Candidate A
  Candidate B
  Candidate C
  </vote>

  <vote 2025-01-01 left>
  Candidate A
  Candidate B
  Candidate C
  </vote>

Users can only vote once on every voting. A wiki page can only contain one voting. The closing date and the alignment can be changed while a vote is running, but changing the candidates list will reset the voting. The current winner (if one exists) is shown below the voting.