Skip to content

parnic-sks/matterpoll

 
 

Repository files navigation

Matterpoll Logo

Build Status Code Coverage Go Report Card CII Best Practices Releases

Matterpoll is a plugin for Mattermost. It allows users to create poll by using a slash command.

Matterpoll plugin screenshot

Installation

In Mattermost, open Main Menu > Plugin Marketplace to install and configure Matterpoll.

Settings

After the plugin has downloaded and been installed, click the Configure button. Alternatively, you can configure Matterpoll from System Console > Plugins > Matterpoll.

  • Trigger Word: Change trigger word for poll command. (default /poll)
  • Experimental UI: Enable new experimental UI for poll posts:
    • Change button color of voted answers
    • Hide poll management buttons (Add Option / Delete Poll / End Poll) from users who don't have permission

Usage

/poll "Is Matterpoll great?" creates a poll with the answer options "Yes" and "No". You can also leave out the double quotes and just type /poll Is Matterpoll great?.

If you want to define all answer options by yourself, type /poll "Is Matterpoll great?" "Of course" "In any case" "Definitely"- Note that the double quotes are required in this case.

/poll show up a modal for creating a poll.

Poll Settings

Poll Settings provider further customisation, e.g. /poll "Is Matterpoll great?" "Of course" "In any case" "Definitely" --progress --anonymous. The available Poll Settings are:

  • --anonymous: Don't show who voted for what at the end
  • --progress: During the poll, show how many votes each answer option got
  • --public-add-option: Allow all users to add additional options
  • --votes=X: Allow users to vote for X options

Localization

Matterpoll supports localization of user specify messages. You can change language of poll message by setting it in System Console > General > Localization > Default Server Language. Language of messages that only a user can see (e.g.: help messages, error messages) use the language set in Account Settings > Display > Language.

The currently supported languages are:

  • English
  • France
  • German
  • Japanese
  • Korean
  • Polish
  • Simplified Chinese
  • Spanish
  • Traditional Chinese

Troubleshooting

Pressing the poll buttons does nothing and creates a 400 error in the Mattermost log

Make sure to set your Site URL properly. For example, this error happens in case you set SiteURL starting with http://, in spite of running Mattermost server through https.

Contributing

We welcome contributions for bug reports, issues, feature requests, feature implementations and pull requests. Feel free to file a new issue or join the Matterpoll channel on the Mattermost community server.

For a complete guide on contributing to Matterpoll, see the Contribution Guideline.

About

Poll plugin for Mattermost

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 83.9%
  • JavaScript 13.1%
  • Makefile 2.9%
  • TypeScript 0.1%