{"id":13527731,"url":"https://github.com/matterpoll/matterpoll","last_synced_at":"2025-04-01T09:32:02.063Z","repository":{"id":37484492,"uuid":"116854535","full_name":"matterpoll/matterpoll","owner":"matterpoll","description":"Create polls and surveys directly within Mattermost","archived":false,"fork":false,"pushed_at":"2025-03-25T07:40:55.000Z","size":8640,"stargazers_count":273,"open_issues_count":41,"forks_count":80,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-25T08:35:45.900Z","etag":null,"topics":["golang","hacktoberfest","mattermost","mattermost-plugin"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matterpoll.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-09T18:29:29.000Z","updated_at":"2025-03-12T08:34:30.000Z","dependencies_parsed_at":"2023-12-19T15:07:48.542Z","dependency_job_id":"fab27836-4bcd-446c-b3e6-35b159c560da","html_url":"https://github.com/matterpoll/matterpoll","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matterpoll%2Fmatterpoll","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matterpoll%2Fmatterpoll/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matterpoll%2Fmatterpoll/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matterpoll%2Fmatterpoll/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matterpoll","download_url":"https://codeload.github.com/matterpoll/matterpoll/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246616358,"owners_count":20806120,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["golang","hacktoberfest","mattermost","mattermost-plugin"],"created_at":"2024-08-01T06:01:58.919Z","updated_at":"2025-04-01T09:32:02.057Z","avatar_url":"https://github.com/matterpoll.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# ![Matterpoll Logo](images/logo.svg)\n\n[![Build Status](https://img.shields.io/circleci/project/github/matterpoll/matterpoll/master.svg)](https://circleci.com/gh/matterpoll/matterpoll)\n[![Code Coverage](https://img.shields.io/codecov/c/github/matterpoll/matterpoll/master.svg)](https://codecov.io/gh/matterpoll/matterpoll/branch/master)\n[![Go Report Card](https://goreportcard.com/badge/github.com/matterpoll/matterpoll)](https://goreportcard.com/report/github.com/matterpoll/matterpoll)\n[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/2588/badge)](https://bestpractices.coreinfrastructure.org/projects/2588)\n[![Releases](https://img.shields.io/github/release/matterpoll/matterpoll.svg)](https://github.com/matterpoll/matterpoll/releases/latest)\n\nMatterpoll is a plugin for [Mattermost](https://mattermost.com/). It allows users to create poll by using a slash command.\n\n![Matterpoll plugin screenshot](images/screenshot.png)\n\n## Installation\n\n1. Download `com.github.matterpoll.matterpoll-x.y.z.tar.gz` from https://github.com/matterpoll/matterpoll/releases.\n2. Upload `com.github.matterpoll.matterpoll-x.y.z.tar.gz` file through **System Console \u003e Plugins \u003e Plugin Management \u003e Upload Plugin** in Mattermost and enable the plugin.\n   * Upgrades can be performed by uploading the lastest release and confirm overwriting of the duplicate plugin ID.\n\n\n## Settings\nYou can configure Matterpoll from **System Console \u003e Plugins \u003e Matterpoll**.\n\n* **Trigger Word**: Change trigger word for poll command. (default `/poll`)\n* **Experimental UI**: Enable new experimental UI for poll posts:\n  - Change button color of voted answers\n  - Hide poll management buttons (Add Option / Delete Poll / End Poll) from users who don't have permission\n* **Default Settings**: Choose settings, that will be pre-selected in 'Create Poll' dialog. Settings will not be applied to `/poll` command.\n\nNote: **Experimental UI** is not supported in Mattermost Mobile due to its limited support for plugin extension ([ref](https://github.com/mattermost/mattermost-mobile/issues/3883#issuecomment-1148519369)).\n\n## Usage\n\n`/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?`.\n\nIf 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.\n\n`/poll` show up a modal for creating a poll.\n\n### Poll Settings\n\nPoll Settings provide further customisation, e.g. `/poll \"Is Matterpoll great?\" \"Of course\" \"In any case\" \"Definitely\" --progress --anonymous`. The available Poll Settings are:\n- `--anonymous`: Don't show who voted for what at the end\n- `--progress`: During the poll, show how many votes each answer option got and, in post card, show who voted for which answers ([#431](https://github.com/matterpoll/matterpoll/pull/431))\n- `--public-add-option`: Allow all users to add additional options\n- `--votes=X`: Allow users to vote for X options. Default is 1. If X is 0, users have an unlimited amount of votes.\n\n## Localization\n\nMatterpoll supports localization of user specify messages. You can change language of poll message by setting it in **System Console \u003e Site Configuration \u003e Localization \u003e Default Server Language**. Language of messages that only a user can see (e.g.: help messages, error messages) use the language set in **Settings \u003e Display \u003e Language**.\n\nThe currently supported languages are:\n- English\n- French\n- German\n- Japanese\n- Korean\n- Polish\n- Russian\n- Simplified Chinese\n- Spanish\n- Swedish\n- Traditional Chinese\n\n\n## Troubleshooting\n\n#### Pressing the poll buttons does nothing and creates a 400 error in the Mattermost log\n\nMake sure to set your [Site URL](https://docs.mattermost.com/configure/configuration-settings.html?highlight=site%20url#site-url) properly.\nFor example, this error happens in case you set SiteURL starting with `http://`, in spite of running Mattermost server through https.\n\n#### Plugin upload causes \"Received invalid response from the server.\"\n\nEnsure that the \"Maximum File Size\" (System Console \u003e File Storage) is set to be larger than the `com.github.matterpoll.matterpoll-x.y.z.tar.gz` file.\n\n## Contributing\n\nWe welcome contributions for bug reports, issues, feature requests, feature implementations and pull requests. Feel free to [**file a new issue**](https://github.com/matterpoll/matterpoll/issues/new/choose) or join the [**Matterpoll channel**](https://community.mattermost.com/core/channels/matterpoll) on the Mattermost community server.\n\nFor a complete guide on contributing to Matterpoll, see the [Contribution Guideline](CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatterpoll%2Fmatterpoll","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatterpoll%2Fmatterpoll","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatterpoll%2Fmatterpoll/lists"}