# Polls - an app, similar to doodle or dudle, for Nextcloud written in PHP and JS/Vue.
![php](https://github.com/nextcloud/polls/actions/workflows/app-code-check.yml/badge.svg)
![psalm](https://github.com/nextcloud/polls/actions/workflows/static-analysis.yml/badge.svg)
![tests](https://github.com/nextcloud/polls/actions/workflows/phpunit.yml/badge.svg)
![puild](https://github.com/nextcloud/polls/actions/workflows/nodejs.yml/badge.svg)
![lint](https://github.com/nextcloud/polls/actions/workflows/lint.yml/badge.svg)
[![Dependabot status](https://img.shields.io/badge/Dependabot-enabled-brightgreen.svg?longCache=true&style=flat-square&logo=dependabot)](https://dependabot.com)
[![Software License](https://img.shields.io/badge/license-AGPL-brightgreen.svg?style=flat-square)](COPYING)


## Features
- :bar_chart: Create / edit polls (date/times and texts)
- :date: Set a closing date
- :lock: Restrict access (all site users or invited users only)
- :speech_balloon: Comments
- Share poll with users, groups, contacts and circles
- Invite external users with a unique link or via email address
- Hide results permanently or until the poll is closed
- Confirm options after poll closing
- Allow proposals from participants
- Create anonymized polls (participants names get pseudonymized for other users)
- Limit possible answers per option and per user
- Subscribe to notifications per poll
- Get hints about possible conflicting entries in your calendar around the date option
- Switch between list and table view
- Configure your preferred view for date and text polls
- Usable via REST-API

## Bugs
- https://github.com/nextcloud/polls/issues

## Screenshots (table view)
Create a new poll from the navigation bar and get an overview of your polls
![Overview](screenshots/overview.png)

#### Vote and comment (list view)
![Vote](screenshots/vote.png)

#### Edit poll inside the vote page
![Edit poll](screenshots/edit-poll.png)

#### Add shared links to your poll
![Share poll](screenshots/shares.png)

#### View the vote page on mobiles
![Vote mobile portrait](screenshots/mobile-portrait.png)

## Installation / Update
This app is supposed to work on Nextcloud version 19+.

### Install latest release
You can download and install the latest release from the [Nextcloud app store](https://apps.nextcloud.com/apps/polls).

### Install from git
If you want to run the latest development version from git source, you need to clone the repo to your apps folder:

```
git clone https://github.com/nextcloud/polls.git
```

* Install dev environment with ```make dev-setup```
* Compile polls.js with ```npm run build```
* Run a complete build with ```make all``` (installs dev env, runs linter and builds the polls.js)

## Contribution Guidelines
Please read the [Code of Conduct](https://nextcloud.com/community/code-of-conduct/). This document offers some guidance to ensure Nextcloud participants can cooperate effectively in a positive and inspiring atmosphere, and to explain how together we can strengthen and support each other.

For more information please review the [guidelines for contributing](https://github.com/nextcloud/server/blob/master/.github/CONTRIBUTING.md) to this repository.