README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

# Polls
![php7](https://github.com/nextcloud/polls/actions/workflows/app-code-check-7.yml/badge.svg)
![php8](https://github.com/nextcloud/polls/actions/workflows/app-code-check-8.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)


This is a poll app, similar to doodle or dudle, for Nextcloud written in PHP and JS / Vue.

## Features
- :bar_chart: Create / edit polls (datetimes 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
- Create anonymized polls (participants names get pseudonymized for other users)
- Limit possible answers per option and per user
- Subscribe to notifications
- 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

## 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.