Code Monkey home page Code Monkey logo

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

  1. Download com.github.matterpoll.matterpoll-x.y.z.tar.gz from https://github.com/matterpoll/matterpoll/releases.
  2. Upload com.github.matterpoll.matterpoll-x.y.z.tar.gz file through System Console > Plugins > Plugin Management > Upload Plugin in Mattermost and enable the plugin.
    • Upgrades can be performed by uploading the lastest release and confirm overwriting of the duplicate plugin ID.

Settings

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
  • Default Settings: Choose settings, that will be pre-selected in 'Create Poll' dialog. Settings will not be applied to /poll command.

Note: Experimental UI is not supported in Mattermost Mobile due to its limited support for plugin extension (ref).

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 provide 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 and, in post card, show who voted for which answers (#431)
  • --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 > Site Configuration > Localization > Default Server Language. Language of messages that only a user can see (e.g.: help messages, error messages) use the language set in Settings > Display > Language.

The currently supported languages are:

  • English
  • French
  • German
  • Japanese
  • Korean
  • Polish
  • Russian
  • 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.

Plugin upload causes "Received invalid response from the server."

Ensure that the "Maximum File Size" (System Console > File Storage) is set to be larger than the com.github.matterpoll.matterpoll-x.y.z.tar.gz file.

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.

Matterpoll's Projects

matterpoll icon matterpoll

Create polls and surveys directly within Mattermost

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.