NB-Public/groupfolders
14
0
Fork 0
mirror of https://github.com/netzbegruenung/groupfolders.git synced 2024-05-05 19:03:41 +02:00
Code Issues Projects Releases Wiki Activity
file_folderfamily_woman_woman_girl_boy Admin-configured folders shared by everyone in a group.
156 commits 34 branches 44 tags 5.8 MiB
PHP 56%
JavaScript 32%
TypeScript 6.4%
Vue 4.1%
CSS 0.9%
Other 0.6%
Go to file
Morris Jobke 70a2156298
Fix tx config 
Signed-off-by: Morris Jobke <hey@morrisjobke.de>
2018-02-12 23:03:29 +01:00
.tx Fix tx config 2018-02-12 23:03:29 +01:00
appinfo 1.2.0 2018-01-23 14:03:59 +01:00
build Fix quota bar width 2018-01-23 14:00:43 +01:00
img group fixes 2017-04-26 15:30:18 +02:00
js Fix quota bar width 2018-01-23 14:00:43 +01:00
l10n Move transifex config for updated l10n script 2018-02-12 17:16:31 +01:00
lib merge permissions when a user has access to a folder trough multiple groups 2017-11-08 14:12:13 +01:00
screenshots update readme and screenshots 2017-06-28 16:28:32 +02:00
templates group fixes 2017-04-26 15:30:18 +02:00
tests merge permissions when a user has access to a folder trough multiple groups 2017-11-08 14:12:13 +01:00
.babelrc mount group folders and wip ui 2017-04-13 17:45:49 +02:00
.gitignore 1.2.0 2018-01-23 14:03:59 +01:00
.php_cs.dist run php-cs-fixer 2017-08-15 16:56:32 +02:00
.scrutinizer.yml add scrutinizer config 2017-04-06 16:03:51 +02:00
.travis.yml allow failures for wrong phpunit versions for now 2017-06-09 15:28:09 +02:00
CHANGELOG.md add changelog 2018-02-04 15:59:46 +01:00
Makefile Move transifex config for updated l10n script 2018-02-12 17:16:31 +01:00
package-lock.json Fix quota bar width 2018-01-23 14:00:43 +01:00
package.json add missing dependency 2017-08-25 16:14:42 +02:00
postcss.config.js mount group folders and wip ui 2017-04-13 17:45:49 +02:00
README.md add api documentation to the readme 2017-08-28 11:28:23 +02:00
tsconfig.json build 2017-08-15 16:56:58 +02:00
webpack.dev.config.js allow changing mountpoint of existing group folders 2017-08-15 16:56:58 +02:00
webpack.prod.config.js allow changing mountpoint of existing group folders 2017-08-15 16:56:58 +02:00

README.md

Group folders

Admin configured folders shared by everyone in a group.

Configure folders

Folders can be configured from Group folders in the admin settings.

After a folder is created, the admin can give access to the folder to one or more groups and a quota can be assigned for the folder.

edit

Permissions to the content of a group folder can be configured on a per-group basis.

permissions

Folders

Once configured, the folders will show up in the home folder for each user in the configured groups.

folders

Notes

  • Currently using encryption on group folders is not supported, all files stored within a group folder will be stored unencrypted.
  • A new Group folder currently overwrites user folders with the same name. While this does not cause data loss, the users will see the new (empty!) Group folder and won’t be able to access their old folder. When the Group folder gets removed, the ‘old’ folder reappears. While we look into forcing group folders to be unique in an upcoming update, we recommend administrators to make sure the names are unique, for example by prefixing them in a certain way like GS_ and instructing users not to name their own top-level folders in a similar way.

API

Group folders can be configured externally trough the OCS Api.

For all POST calls the required parameters are listed, for more information about how to use an OCS api see the Nextcloud documentation on the topic

The following OCS calls are supported.

  • GET apps/groupfolders/folders: Returns a list of call configured folders and their settings
  • POST apps/groupfolders/folders: Create a new group folder.
    • mountpoint: The name for the new folder.
  • DELETE apps/groupfolders/folders/$folderId: Delete a group folder.
  • POST apps/groupfolders/folders/$folderId/groups: Give a group access to a folder
    • group: The id of the group to be given access to the folder.
  • DELETE apps/groupfolders/folders/$folderId/groups/$groupId: Remove access from a group to a folder.
  • POST apps/groupfolders/folders/$folderId/groups/$groupId: Set the permissions a group has in a folder
  • POST apps/groupfolders/folders/$folderId/quota: Set the quota for a folder.
    • quota: The new quota for the folder in bytes, user -3 for unlimited.
  • POST apps/groupfolders/folders/$folderId/mountpoint: Change the name of a folder.
    • mountpoint: The new name for the folder.