Bored Chat

General Category => BoredSkull Mods => Topic started by: Deaks on Nov 20, 2026, 02:11 PM

Title: Ranked Polls
Post by: Deaks on Nov 20, 2026, 02:11 PM
Ranked Polls v1.1.0
Give Your Community a Better Way to Vote!

By BoredSkull (https://boredskull.net/) for SMF 2.1.x
ISC Licence



Overview

Why settle for choosing just one option when members could rank their preferences?

Introducing Ranked Polls, a modification that brings ranked-choice voting to SMF using the instant-runoff voting system.

Instead of selecting a single answer, members arrange poll options in order of preference. If no option receives a majority of the continuing votes, the lowest-ranked candidate is eliminated and their votes transfer to voters' next available choices.

The process continues until a winner is determined.

Whether you're running community elections, choosing event locations, selecting new forum features or making group decisions, Ranked Polls provides a flexible alternative to traditional polls.

Best of all, your existing SMF polls remain completely unchanged!

100% Hook Based - No Core or Theme File Edits Required!



Create Ranked Polls Using SMF's Existing Poll System

There's no separate poll creation interface to learn.

Ranked Polls integrates directly with SMF's existing poll functionality.


Ranked polls can be introduced only where needed without affecting the rest of your forum.



An Intuitive Voting Experience

Ranked Polls makes expressing preferences straightforward.


Members can express their preferences without needing to understand how the counting system works.



Optional Anonymous Ballots

For elections or sensitive community decisions, Ranked Polls offers configurable ballot anonymity.

Administrators can choose:


Anonymous ballots are stored without member IDs, timestamps or linking identifiers.

A separate voter record prevents duplicate submissions without connecting individual members to their ranking choices.

This provides a voting option for communities where ballot privacy matters.



Instant-Runoff Voting Explained

Ranked Polls uses instant-runoff counting to identify the winning option.

Rather than simply counting first choices, it considers voters' next preferences when an option is eliminated.

How it works:


When options are tied, Ranked Polls applies a consistent sequence of tie-breaking rules:


Every round can be examined, making the counting process transparent.



Detailed Results & Visualisations

Ranked Polls goes beyond simply announcing a winner.

Members can explore how the result was reached through detailed round-by-round reporting.


CSV exports are available to administrators and, optionally, poll creators.

Anonymous ballots are shuffled during export, and exported cells are protected against spreadsheet formula injection.



Designed to Work With SMF

Ranked Polls integrates with the existing SMF poll system rather than replacing it.




What's New in v1.1.0?

Version 1.1.0 includes additional reliability, permissions and scheduled-task corrections.


Includes the improvements introduced in v1.0.1:




Administration & Configuration

After installation, navigate to:

Admin > Configuration > Ranked Polls

From here, administrators can configure the boards where ranked polls are available and control ballot anonymity and other ranked-poll settings.

The dedicated Create ranked-choice polls board permission determines which membergroups can create them.



Installation & Requirements


Install using SMF's Package Manager.

Upgrading from v1.0.0 or v1.0.1:

Use the Package Manager's upgrade option.

Existing ballots, settings and poll metadata are preserved during the migration, including the expanded ballot storage introduced in v1.0.1.

Important: Back up your database before upgrading. Testing the upgrade on a staging installation is recommended before applying it to a live forum.



Why Choose Ranked Polls?

Traditional polls are useful when members have one clear favourite, but community decisions are often more complicated.

Ranked Polls lets members express their preferences beyond a single choice and provides a transparent way to identify the result through successive counting rounds.

With accessible voting, configurable anonymity, detailed visual results and native SMF integration, it's suited to elections, competitions and everyday community decisions.

More Than One Choice. One Clear Result.



Developed by BoredSkull (https://boredskull.net/)

Licence: ISC

Giving every preference a place in the vote.

Awaiting Approval: https://custom.simplemachines.org/index.php?mod=4533