Skip to content

Latest commit

 

History

History
157 lines (101 loc) · 4.17 KB

README.md

File metadata and controls

157 lines (101 loc) · 4.17 KB
Raw

Workspace

Create shared workspaces and delegate management of their members and groups.

Workspace Home

Workspace allows managers to :

  • Create shared workspaces
  • Delegate management of each workspace to users (workspace managers) in order for them to :
    • choose members
    • create groups
    • configure advanced permissions on workspace folders
  • All through a simple unified interface, designed to simplify your users' experience and make them autonomous

This app is a Nextcloud extension of the Groupfolders app.

For more information, please visit our website (french content).

Warning

We found an incompatibility with the latest release of Groupfolders.

These are the compatible versions until we address those issues:

Workspace GroupFolders
all versions 16.0.0 to 16.0.9
all versions 17.0.0 to 17.0.3

Documentation

For more details, please go to the admin documentation, or user documentation.

Installation

Requirements

From Nextcloud 25

  • PHP 8.0
  • Nextcloud 25 or after
  • Install Group Folders on the Nextcloud app store

For Nextcloud 24 and before

Limit the Workspace app to specific groups

In your "application management" administrator interface, limit the application to the following groups: GeneralManager and WorkspacesManagers.

🔧 Configure Groupfolders for Workspace

From Nextcloud 25

In Settings > Group folders > Group folder admin delegation section, add the group GeneralManager to the first field, and the group WorkspacesManagers to the second field

For Nextcloud 24 and before

In Settings > Group folders > Group folder admin delegation section, add the groups GeneralManager and WorkspacesManagers.

Define which users will be General Managers

Add the users in charge of creating Workspaces to the GeneralManager group.

Contributing

Workspace is a Free Software that you can contribute freely to. If you would like to contribute by making a bug report or suggest a functionality for example, we invite you to read our contribution policy beforehand.

Development and Build

Requirements

  • npm v10.0.0
  • node v20.0
  • php v8.0
  • composer v2.0.13
  • make v3.82
  • git v1.8

📦 Building the app

First, clone into your apps directory (example: /var/www/html/nextcloud/apps/).

git clone https://github.com/arawa/workspace.git

Then, you can build app :

cd workspace
make

🚨 Caution : You must install npm and composer before use make command line.

If it's okay, we can use or dev the Workspace app !

📦 Create an artifact

make source

An artifact will be created in the build/artifacts/source from the project.

📦 For Nextcloud 21 and 24, build Arawa\Groupfolders

Clone this app into your apps directory (example: /var/www/html/nextcloud/apps/) and switch of the branch to be in allow-admin-delegation-stable21.

git clone https://github.com/arawa/groupfolders.git
cd groupfolders
git checkout allow-admin-delegation-stable21

Then, you can build.

make

🚨 Caution : You must install npm and composer before use make command line.

After this, you can enable the Groupfolders app.

📋 Running tests

Front-end

npm run test

Back-end

composer run test

or

sudo -u nginx /usr/local/bin/composer run test

Security Issues

Please, read the security.txt.

If you want to report us a security issue. Please, read our security-policy.md file.