🗳️ Polls app for Nextcloud
Перейти к файлу
René Gieling 434b84befa
Merge pull request #3087 from nextcloud/enh/flex-settings
move template for settings into base component
2023-09-24 23:19:46 +02:00
.github Update release.yml 2023-08-31 18:09:23 +02:00
.tx [tx-robot] Update transifex configuration 2022-10-01 02:50:37 +00:00
appinfo version update 2023-09-11 20:43:25 +02:00
docs add option duration to API 2021-06-03 20:56:36 +02:00
img fix icon color of dashboard widget 2023-01-07 00:59:50 +01:00
l10n Fix(l10n): Update translations from Transifex 2023-09-24 01:25:24 +00:00
lib Fix migration error 2023-09-11 20:41:02 +02:00
screenshots optimize screenshots for appstore 2022-10-14 14:27:02 +02:00
src/js Merge pull request #3087 from nextcloud/enh/flex-settings 2023-09-24 23:19:46 +02:00
templates cs-fix 2023-04-15 11:13:49 +02:00
tests use correct share for expected share 2023-08-31 15:18:11 +02:00
.editorconfig Version 0.8.1 (#260) 2017-12-19 11:14:58 +01:00
.eslintrc.js vue/no-unused-properties 2021-10-15 00:09:04 +02:00
.gitignore add prettier for vetur and vscode 2022-04-02 15:28:47 +02:00
.l10nignore prepare 1.1.0 2020-01-21 19:39:32 +01:00
.php-cs-fixer.dist.php Adding activities (#2154) 2021-12-29 00:58:24 +01:00
CHANGELOG.md version update 2023-09-11 20:43:25 +02:00
COPYING Added 0.8.0 changelog (#182) 2017-10-13 22:10:11 +02:00
Makefile composer optimization 2023-06-09 18:03:14 +02:00
README.md Fix app update and duplicate removal (#2893) 2023-05-07 21:34:16 +02:00
_config.yml Set theme jekyll-theme-slate 2018-08-30 20:26:43 +02:00
babel.config.js use @nextcloud/babel-config 2022-02-03 10:19:48 +01:00
composer.json composer optimization 2023-06-09 18:03:14 +02:00
composer.lock Build(deps-dev): Bump doctrine/dbal from 3.6.6 to 3.6.7 2023-09-23 02:34:18 +00:00
jsconfig.json add prettier for vetur and vscode 2022-04-02 15:28:47 +02:00
package-lock.json Build(deps): Bump @nextcloud/dialogs from 4.2.0 to 4.2.1 2023-09-22 01:14:21 +00:00
package.json Build(deps): Bump @nextcloud/dialogs from 4.2.0 to 4.2.1 2023-09-22 01:14:21 +00:00
phpunit.integration.xml migrate configuration 2021-09-13 09:03:37 +02:00
psalm-baseline.xml update psalm config 2023-08-13 17:11:38 +02:00
psalm.xml prepare psalm for OpenAPI 2023-08-13 18:31:48 +02:00
stylelint.config.js change to @nextcloud/stylelint-config 2022-02-02 17:16:17 +01:00
webpack.config.js rename dashboard source 2022-10-28 19:51:56 +02:00

README.md

Polls - an app, similar to doodle or dudle, for Nextcloud written in PHP and JS/Vue.

psalm tests puild lint Dependabot status Software License

Free meeting schedule tool

  • ⏭️ Easy poll creation
  • 🛠️ Highly customizable
    • ✉️ Make your poll confidential by hiding the results until you want them to be discovered
    • 🕶️ Obfuscate participants' names from other participants
    • ⏲️ Set an automatic expiry date
    • Allow participants to add more options
    • Limit votes per option or user
    • ... 💱 and a lot more
  • 📬 Invite everyone you want
  • 🚀 Export your poll to different spreadsheet formats or HTML
  • 🧧 Let Polls automatically remind your invited users
  • 💬 Comments
  • ☑️ Confirm options after poll closing
  • 📢 Subscribe to notifications per poll
  • 📅 Get hints about possible conflicting entries in your calendar around the date option
  • 🧰 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.

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 <source-user> <target-user> Transfer poll ownership from to
polls:share:add [--user USER] [--group GROUP] [--email EMAIL] [--] <id> Add user/group/email with to shares
polls:share:remove [--user USER] [--group GROUP] [--email EMAIL] [--] <id> Remove user/group/email with from shares

Support

Screenshots

Manage your polls and create new ones

Manage Polls

Many configuration options

Vote

Share your poll with other people

Edit poll

Vote on mobile

Share poll

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. 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 to this repository.