Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pixelbrackets/mattermost-poll

Poll Slash Command for Mattermost
https://github.com/pixelbrackets/mattermost-poll

integration mattermost php poll slash-commands webook

Last synced: about 6 hours ago
JSON representation

Poll Slash Command for Mattermost

Awesome Lists containing this project

README

        

# Mattermost Poll

[![Version](https://img.shields.io/packagist/v/pixelbrackets/mattermost-poll.svg?style=flat-square)](https://packagist.org/packages/pixelbrackets/mattermost-poll/)
[![Build Status](https://img.shields.io/gitlab/pipeline/pixelbrackets/mattermost-poll?style=flat-square)](https://gitlab.com/pixelbrackets/mattermost-poll/pipelines)
[![Made With](https://img.shields.io/badge/made_with-php-blue?style=flat-square)](https://gitlab.com/pixelbrackets/mattermost-poll#requirements)
[![License](https://img.shields.io/badge/license-gpl--2.0--or--later-blue.svg?style=flat-square)](https://spdx.org/licenses/GPL-2.0-or-later.html)
[![Mattermost Integration](https://img.shields.io/badge/mattermost-slash_command-blue.svg?style=flat-square)](https://about.mattermost.com/community-applications/)

Poll Slash Command for Mattermost.

`/poll supper soup salad "taco and burito" burger`

![Screenshot](./docs/screenshot.png)

## Requirements

- PHP
- MySQL

The Mattermost instance calling this service has to be version 4.2 or greater
(provide »Interactive Message Buttons« feature).

## Installation

1. Clone project to desired directory
1. Run `composer install`
1. Edit `.env` file
1. Initialize database
```bash
./bin/console doctrine:database:create
./bin/console doctrine:migrations:migrate
```
1. Configure webserver to serve `web` directory
- Development / Test: Run `php bin/console server:start 127.0.0.1:8000`
- Production: [Configure webserver for Symfony Apps](https://symfony.com/doc/current/setup/web_server_configuration.html)
and [export `.env` file](https://stackoverflow.com/questions/19331497/set-environment-variables-from-file/20909045#20909045)
1. Open homepage to see the »Request URL« needed for »Slash Commands«

### Integration into Mattermost

1. Add new »Slash Command« in each Teamspace in Mattermost
1. Use the »Request URL« shown on the homepage of the service

## Source

https://gitlab.com/pixelbrackets/mattermost-poll/

Mirror https://github.com/pixelbrackets/mattermost-poll/

## Demo

🚀 https://mattermost-poll.app.pixelbrackets.de/

## Usage

- Type the slash command, followed by the poll title, followed by all answers
- Separete the title and each answer with spaces
- use quotes to include spaces in a string

Create a poll with a title and four answers
```
/poll supper soup salad "taco and burito" burger
```

## License

GNU General Public License version 2 or later

The GNU General Public License can be found at http://www.gnu.org/copyleft/gpl.html.

## Author

Dan Untenzu ( / [@pixelbrackets](https://github.com/pixelbrackets))

## Changelog

[./CHANGELOG.md](./CHANGELOG.md)

## Contribution

This script is Open Source, so please use, patch, extend or fork it.