Skip to content

Latest commit

 

History

History
122 lines (86 loc) · 3 KB

README.md

File metadata and controls

122 lines (86 loc) · 3 KB
Raw

Preference Voting Build Status

This plugin lets you rank multiple options in order of preference, instead of just choosing one.

This way, the most preferred option by all the voters can win, even if it is not the most popular one.

This voting method is also known as Condorcet method for Voting, Card Sorting, Ranked Choice Voting (RCV) or Instant Runoff Voting (IRV).

Examples:

Setup:

  • Available options A, B, C, D
  • People voting 5

Traditional voting:

Votes:

  • User1 = A
  • User2 = A
  • User3 = B
  • User4 = C
  • User5 = D

Results in traditional voting:

  • A = 2
  • B = 1
  • C = 1
  • D = 1

Explanation:

A gets 2 votes from user1 and user2 and all the other options get one vote each. Users 3, 4 and 5 might prefer to have the option B before having the option A, but since the majority voted for A, A will be the winner.

Voting with the plugin:

Votes:

  • User1:
    • A
    • B
    • C
    • D
  • User2:
    • A
    • B
    • D
    • C
  • User3:
    • B
    • D
    • C
    • A
  • User4:
    • C
    • B
    • D
    • A
  • User5:
    • D
    • B
    • C
    • A

Results voting with the plugin:

  • B
  • D
  • C
  • A

Explanation:

If we calculate the average position of the options in the votes the winner would be B.

Installing via uploaded ZIP file

  1. Log in to your Moodle site as an admin and go to Site administration > Plugins > Install plugins.
  2. Upload the ZIP file with the plugin code. You should only be prompted to add extra details if your plugin type is not automatically detected.
  3. Check the plugin validation report and finish the installation.

Installing manually

The plugin can be also installed by putting the contents of this directory to

{your/moodle/dirroot}/mod/sortvoting

Afterwards, log in to your Moodle site as an admin and go to Site administration > Notifications to complete the installation.

Alternatively, you can run

$ php admin/cli/upgrade.php

to complete the installation from the command line.

TODO - Roadmap

  • Allow students to see results using a plugin setting
  • Detailed view of the results
  • More tests (PHPUnit and Behat)
  • Colors! Colors are always nice!

License

2023 Odei Alba [email protected]

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.