Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nextcloud/polls
🗳️ Polls app for Nextcloud
https://github.com/nextcloud/polls
doodle nextcloud poll vote
Last synced: 5 days ago
JSON representation
🗳️ Polls app for Nextcloud
- Host: GitHub
- URL: https://github.com/nextcloud/polls
- Owner: nextcloud
- License: agpl-3.0
- Created: 2016-02-20T16:06:23.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-10-27T01:31:10.000Z (about 2 months ago)
- Last Synced: 2024-10-29T15:51:05.769Z (about 1 month ago)
- Topics: doodle, nextcloud, poll, vote
- Language: JavaScript
- Homepage: https://apps.nextcloud.com/apps/polls
- Size: 42.8 MB
- Stars: 256
- Watchers: 17
- Forks: 73
- Open Issues: 89
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: COPYING
- Authors: AUTHORS.md
Awesome Lists containing this project
- awesome-nextcloud - polls - Polls app for NC (Apps / Official)
README
# Polls - an app, similar to doodle or dudle, for Nextcloud written in PHP and JS/Vue.
[](https://dependabot.com)
[](COPYING)
[](https://api.reuse.software/info/github.com/nextcloud/polls)
# Free meeting schedule tool
- :next_track_button: Easy poll creation
- :hammer_and_wrench: Highly customizable
- :envelope: Make your poll confidential by hiding the results until you want them to be discovered
- :dark_sunglasses: Obfuscate participants' names from other participants
- :timer_clock: Set an automatic expiry date
- :heavy_plus_sign: Allow participants to add more options
- :white_check_mark: Limit votes per option or user
- ... :currency_exchange: and a lot more
- :mailbox_with_mail: Invite everyone you want
- :rocket: Export your poll to different spreadsheet formats or HTML
- :red_envelope: Let Polls automatically remind your invited users
- :speech_balloon: Comments
- :ballot_box_with_check: Confirm options after poll closing
- :loudspeaker: Subscribe to notifications per poll
- :date: Get hints about possible conflicting entries in your calendar around the date option
- :toolbox: Usable via REST-API
- Supports the following nextcloud apps
- Circles
- Contacts
- Activity
## Installation / Update
This app is supposed to work on Nextcloud version 21+.
### Install latest release
You can download and install the latest release from the [Nextcloud app store](https://apps.nextcloud.com/apps/polls).
## Available occ commands
| Command | Description |
| - | - |
| `polls:db:clean-migrations` | Remove obsolete migrations, which are no more needed |
| `polls:db:purge` | Drop Polls' tables and remove migration and settings records |
| `polls:db:rebuild` | Rebuild Polls' database including indices |
| `polls:index:create` | Create all necessary indices and foreign key constraints |
| `polls:index:remove` | Remove all indices |
| `polls:poll:transfer-ownership ` | Transfer poll ownership from to |
| `polls:share:add [--user USER] [--group GROUP] [--email EMAIL] [--] ` | Add user/group/email with to shares |
| `polls:share:remove [--user USER] [--group GROUP] [--email EMAIL] [--] ` | Remove user/group/email with from shares |
## Support
- Report a bug or request a feature: https://github.com/nextcloud/polls/issues
- Community support: https://help.nextcloud.com/c/apps/polls/
## Screenshots
#### Manage your polls and create new ones
#### Many configuration options
#### Share your poll with other people
#### Vote on mobile
### 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 setup-dev``` or
* install runtime environment with ```make setup-build```
* Compile javascript with ```npm run build```
* Run a complete build with ```make appstore``` (Find the output in the build directory)
* call `occ app:enable polls` to enable Polls
### Installation variants
### First time install
Nextcloud executes
* unexecuteted `migration classes` (not listed in the `*_migrations` table) and the
* `install` repair step.
### After a version update (changed version attribute in appinfo/info.xml)
Nextcloud executes
* `pre-migration` repair steps,
* unexecuteted `migration classes` (not listed in the `*_migrations` table) and the
* `post-migration` repair steps
### Enabling already installed but disabled app without version change
Nextcloud executes
* `pre-migration` repair steps,
* unexecuteted `migration classes` (not listed in the `*_migrations` table) and the
* `post-migration` repair steps and the
* `install` repair step
❗ As a compromise at the moment we allow the index creation to be ran twice when enabling the app via app store or `occ`, to ensure all indexes are created properly for every install/update/enabling path.
## Removing Polls from instance
Call `occ polls:db:purge` to remove Polls completely.
* removes all Polls related tables
* removes all Polls related migration records
* removes all Polls related app config records (this also disables Polls)
This does not remove Polls' files (call `occ app:remove polls` to remove it complete afterwards) but it resets Polls into an 'uninstalled' state. Enabling the app is then equivalent to a first time install and calls the migration and the install repair step (see above).
## 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.