🗳️ Polls app for Nextcloud
Перейти к файлу
dependabot[bot] 8b583597e7
Merge pull request #3534 from nextcloud/dependabot/npm_and_yarn/vite-5.2.12
2024-05-29 01:49:52 +00:00
.github skip tests for 8.0 and cross fingers 2024-05-28 21:41:38 +02:00
.tx [tx-robot] Update transifex configuration 2022-10-01 02:50:37 +00:00
appinfo bring back PHP 8.0 - fixes #3530 2024-05-28 21:15:09 +02:00
docs added groupinvitations to poll API 2024-05-23 15:09:58 +02:00
img fix icon color of dashboard widget 2023-01-07 00:59:50 +01:00
l10n Fix(l10n): Update translations from Transifex 2024-05-28 01:12:24 +00:00
lib cs-fix 2024-05-25 23:36:35 +02:00
screenshots optimize screenshots for appstore 2022-10-14 14:27:02 +02:00
src/js tidy up 2024-05-26 09:32:25 +02:00
templates reduce to one single template 2023-10-20 08:19:19 +02:00
tests migrate xml-schema 2024-05-16 19:23:40 +02:00
vendor-bin update packages 2024-05-28 21:32:22 +02:00
.editorconfig Version 0.8.1 (#260) 2017-12-19 11:14:58 +01:00
.eslintrc.cjs fix linters, remove babel 2024-05-07 10:56:02 +02:00
.gitattributes use bamarni/composer-bin-plugin for tools 2024-03-26 11:05:37 +01:00
.gitignore update xlsx 2024-04-09 08:55:33 +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
.prettierignore change config to support prettier (#3482) 2024-05-06 22:38:06 +02:00
.prettierrc.json change config to support prettier (#3482) 2024-05-06 22:38:06 +02:00
CHANGELOG.md changelog 2024-05-25 22:31:28 +02:00
COPYING Added 0.8.0 changelog (#182) 2017-10-13 22:10:11 +02:00
Makefile removed /css from package 2024-05-12 21:02:42 +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
composer.json bring back PHP 8.0 - fixes #3530 2024-05-28 21:15:09 +02:00
composer.lock update packages 2024-05-28 21:32:22 +02:00
jsconfig.json add prettier for vetur and vscode 2022-04-02 15:28:47 +02:00
package-lock.json Bump vite from 5.2.11 to 5.2.12 2024-05-29 01:47:01 +00:00
package.json Bump vite from 5.2.11 to 5.2.12 2024-05-29 01:47:01 +00:00
phpunit.integration.xml migrate configuration 2021-09-13 09:03:37 +02:00
psalm-baseline.xml update baseline 2024-03-16 15:07:25 +01:00
psalm.xml dep updates and psalm settings 2024-02-08 12:46:11 +01:00
stylelint.config.cjs tidy 2024-05-12 20:26:28 +02:00
update-app-version.mjs synchronize app version with npm version 2023-11-11 14:45:01 +01:00
vite.config.js heal config 2024-05-11 21:01:00 +02: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.