PHPackages                             fof/polls - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. fof/polls

ActiveFlarum-extension[Utility &amp; Helpers](/categories/utility)

fof/polls
=========

 A Flarum extension that adds polls to your discussions

2.3.1(5mo ago)25122.4k↓33.2%15[3 PRs](https://github.com/FriendsOfFlarum/polls/pulls)8MITPHPCI passing

Since Jul 3Pushed 3mo ago3 watchersCompare

[ Source](https://github.com/FriendsOfFlarum/polls)[ Packagist](https://packagist.org/packages/fof/polls)[ Docs](https://friendsofflarum.org)[ Fund](https://opencollective.com/fof/donate)[ RSS](/packages/fof-polls/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (92)Used By (8)

Polls by FriendsOfFlarum
========================

[](#polls-by-friendsofflarum)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/c09c417452e2c87c99c0a11442698b486c6f1440b07ac900ab98c160390d2a6c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666f662f706f6c6c732e737667)](https://packagist.org/packages/fof/polls) [![OpenCollective](https://camo.githubusercontent.com/1903c197bb0307e60d6328653532b8a6b9890b898fbc92e314ab39d699491e74/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f70656e636f6c6c6563746976652d666f662d626c75652e737667)](https://opencollective.com/fof/donate) [![Patreon](https://camo.githubusercontent.com/be61fbf30767ef720f688fe7a8c6834d6cd3e477c32e4e6136a3a5bc66052b2e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70617472656f6e2d6461746974697365762d6639363835342e7376673f6c6f676f3d70617472656f6e)](https://patreon.com/datitisev)

A [Flarum](http://flarum.org) extension. A Flarum extension that adds polls to your discussions.

### Installation

[](#installation)

```
composer require fof/polls:"*"
```

#### Migrating from ReFlar Polls

[](#migrating-from-reflar-polls)

Make sure you've updated to the latest `reflar/polls` version and run `php flarum migrate` BEFORE installing `fof/polls`. You will not be able to install this extension if you have a version of ReFlar Polls older than v1.3.4 as well.

```
$ composer require reflar/polls
$ php flarum migrate
$ composer require fof/polls
```

### Updating

[](#updating)

```
composer update fof/polls
```

### Metadata update

[](#metadata-update)

To improve performance, Polls calculates and stores the number of votes when it changes.

As long as the extension is active, Polls will automatically keep those numbers up to date and you don't need to do anything.

If you are updating from a version prior to 0.3.3, if you disabled the extension for a while or if you made manual changes to the database you should run the following command to refresh the numbers:

```
php flarum fof:polls:refresh
```

You can only run the command when the extension is enabled in the admin panel.

Poll Groups Feature
-------------------

[](#poll-groups-feature)

### What Are Poll Groups?

[](#what-are-poll-groups)

Poll Groups are a feature that allows you to organize multiple polls under a single topic or subject. You can create a group and add related polls to it, making it easier to manage and present a collection of questions about the same theme.

### What Can You Use Poll Groups For?

[](#what-can-you-use-poll-groups-for)

- **Surveys:** Bundle several polls together to conduct multi-question surveys on a particular subject.
- **Topic-Based Polling:** Group polls by topics, such as feedback on different features, event planning, or research.
- **Community Engagement:** Facilitate deeper discussions by presenting sets of related questions.

### How to Use Poll Groups

[](#how-to-use-poll-groups)

1. **Enable Poll Groups:**
    Make sure the extension setting `Enable poll groups` is enabled in your admin panel.
2. **Permissions:**
    Poll groups use the following permissions:

    - *View poll groups (`canViewPollGroups`)* : Controls who can see poll groups
    - *Create poll groups*: Controls who can create new poll groups
    - *Moderate poll groups (`polls.moderate_group`)*: Allows moderators to edit and delete any poll groups
    - Individual users can always edit and delete their own poll groups
3. **Creating a Poll Group:**

    - Navigate to the Poll Groups page through the site navigation
    - Click "Start a Poll Group" and provide a name for your group
4. **Adding Polls to Groups:**

    - Go to the poll group detail view
    - Use the "Add Poll" button to create new polls within the group
    - The polls will be automatically associated with and displayed in the group
5. **Managing Poll Groups:**

    - Group creators can edit their group details and delete their own groups
    - Moderators with appropriate permissions can manage any poll groups
    - Deleting a group will remove the group but preserve its associated polls

### Example Use Case

[](#example-use-case)

For example, to gather comprehensive feedback about a new feature, create a poll group named "Feature Feedback" and add multiple polls asking about different aspects (usability, design, performance, etc.). Users will find all related polls conveniently grouped together for easy participation.

### Links

[](#links)

[![](https://camo.githubusercontent.com/0902ec237d4d38955be6c93a043a27694eb59f49ab91e47022b86cee1892afce/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f666f662f646f6e6174652f627574746f6e4032782e706e673f636f6c6f723d626c7565)](https://opencollective.com/fof/donate)[![](https://camo.githubusercontent.com/ef7b855018f1f680eeba6fd1ac470b9c1971ef883b2f4b9fcf41034274510e3f/68747470733a2f2f63352e70617472656f6e2e636f6d2f65787465726e616c2f6c6f676f2f6265636f6d655f615f706174726f6e5f627574746f6e2e706e67)](https://patreon.com/datitisev)

- [Packagist](https://packagist.org/packages/fof/polls)
- [GitHub](https://github.com/packages/FriendsOfFlarum/polls)
- [Discuss](https://discuss.flarum.org/d/20586)

An extension by [FriendsOfFlarum](https://github.com/FriendsOfFlarum).

###  Health Score

60

—

FairBetter than 99% of packages

Maintenance77

Regular maintenance activity

Popularity44

Moderate usage in the ecosystem

Community36

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor3

3 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~28 days

Total

83

Last Release

174d ago

Major Versions

0.4.1 → 1.0.02021-05-27

1.4.2 → v2.x-dev2023-07-12

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16573496?v=4)[IanM](/maintainers/imorland)[@imorland](https://github.com/imorland)

![](https://avatars.githubusercontent.com/u/1630413?v=4)[Gregor Hammerschmidt](/maintainers/GreXXL)[@GreXXL](https://github.com/GreXXL)

![](https://www.gravatar.com/avatar/0538135c1debcef5602dce7ece027909cc832b7a6284ab9189a19aa8de98d60d?d=identicon)[clarkwinkelmann](/maintainers/clarkwinkelmann)

![](https://www.gravatar.com/avatar/1298cdc0b2402a1aa34fb75a254947d655e090d62bd0531311331d369cac934e?d=identicon)[datitisev](/maintainers/datitisev)

---

Top Contributors

[![ShahiemS](https://avatars.githubusercontent.com/u/188719889?v=4)](https://github.com/ShahiemS "ShahiemS (68 commits)")[![dsevillamartin](https://avatars.githubusercontent.com/u/6401250?v=4)](https://github.com/dsevillamartin "dsevillamartin (61 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (41 commits)")[![KyrneDev](https://avatars.githubusercontent.com/u/13856015?v=4)](https://github.com/KyrneDev "KyrneDev (26 commits)")[![imorland](https://avatars.githubusercontent.com/u/16573496?v=4)](https://github.com/imorland "imorland (25 commits)")[![clarkwinkelmann](https://avatars.githubusercontent.com/u/5264300?v=4)](https://github.com/clarkwinkelmann "clarkwinkelmann (20 commits)")[![Ralkage](https://avatars.githubusercontent.com/u/2059356?v=4)](https://github.com/Ralkage "Ralkage (13 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![DavideIadeluca](https://avatars.githubusercontent.com/u/146922689?v=4)](https://github.com/DavideIadeluca "DavideIadeluca (4 commits)")[![Ziiven](https://avatars.githubusercontent.com/u/29644610?v=4)](https://github.com/Ziiven "Ziiven (3 commits)")[![davwheat](https://avatars.githubusercontent.com/u/7406822?v=4)](https://github.com/davwheat "davwheat (3 commits)")[![gianniguida](https://avatars.githubusercontent.com/u/53989450?v=4)](https://github.com/gianniguida "gianniguida (3 commits)")[![karaok491](https://avatars.githubusercontent.com/u/72854852?v=4)](https://github.com/karaok491 "karaok491 (3 commits)")[![glombers](https://avatars.githubusercontent.com/u/18645897?v=4)](https://github.com/glombers "glombers (2 commits)")[![iPurpl3x](https://avatars.githubusercontent.com/u/18526076?v=4)](https://github.com/iPurpl3x "iPurpl3x (2 commits)")[![novacuum](https://avatars.githubusercontent.com/u/1344084?v=4)](https://github.com/novacuum "novacuum (1 commits)")[![PepaR](https://avatars.githubusercontent.com/u/25554468?v=4)](https://github.com/PepaR "PepaR (1 commits)")[![rafaucau](https://avatars.githubusercontent.com/u/25438601?v=4)](https://github.com/rafaucau "rafaucau (1 commits)")[![Hiobi](https://avatars.githubusercontent.com/u/2171856?v=4)](https://github.com/Hiobi "Hiobi (1 commits)")[![spaeps](https://avatars.githubusercontent.com/u/1037160?v=4)](https://github.com/spaeps "spaeps (1 commits)")

---

Tags

flarum

### Embed Badge

![Health badge](/badges/fof-polls/health.svg)

```
[![Health](https://phpackages.com/badges/fof-polls/health.svg)](https://phpackages.com/packages/fof-polls)
```

###  Alternatives

[fof/byobu

Well integrated, advanced private discussions.

61105.8k9](/packages/fof-byobu)[fof/user-bio

Add a user bio to user profiles

2196.5k9](/packages/fof-user-bio)[fof/links

Manage Flarum primary navbar menu links

39118.3k2](/packages/fof-links)[fof/drafts

Allow users to create post and discussion drafts

1771.1k5](/packages/fof-drafts)[fof/nightmode

Add a Night Mode option for your users to use on your Flarum forum

3774.5k2](/packages/fof-nightmode)[fof/best-answer

Mark a post as the best answer in a discussion

26135.2k15](/packages/fof-best-answer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
