Skip to content

Admin‐Guide: Nextcloud 28

germakoci edited this page May 23, 2024 · 6 revisions

Admin Documentation

Initial Configuration

In the liquid.ini file nextcloud28 needs to be enabled. So it has to contain a line: nextcloud28 = on in the [apps] section.

After that nextcloud28 will be available. Nextcloud users will be created when a liquid user visits Nextcloud for the first time. To allow users access, they need to be given the Can use Nextcloud 28 permission in the liquid-core admin interface.

liquid-core admins will have admin status in nextcloud28 as well.

Group Management

To add a new group or add users to a group click on the user icon in the top right corner of the window and select Users. This will open the user administration menu.

Adding a new group can be done by clicking on the + button next to the Groups entry in the sidebar.

Users can be added to existing groups by clicking on the Active users entry in the sidebar. Then the pencil symbol on the right can be used to edit a user. In the groups column you can afterwards edit the users group memberships.

Add user to group

Group Folders

To share a folder between groups, the groupfolder plugin is enabled. This is the preferred way to share files and also the way to synchronize files with hoover. Only group folders are scanned by hoover and can be used to create collections from them.

Managing group folders can be done by clicking on your profile Icon in the top right corner and then Administration settings. In the sidebar scroll down a bit until you find the Group folders entry. There you can create and edit group folders.

When you grant permissions to a group make sure to only give Write permissions and no Share or Delete permissions, to prevent colleagues to issue additional share links or to delete each-other work (also note that when Deleting files in a Nextcloud collection, the content of that file remains available in Hoover).

Screenshot 2024-05-23 at 14 51 25

App token

For hoover to be able to access the Nextcloud files an app token needs to be created and added to the user in the hoover admin menu. In Nextcloud go to Profile icon -> Administration settings and click on Security in the sidebar. There you can add a new app token at the bottom. Copy that app token and go to the hoover admin menu.

Choose Users, click on the user that you created the token for (your own user) and scroll down until you find the WebDAV Password field. Enter the token there and click Save.

Hoover can now synchronize your group folders and collections can be created from them.

Collections based on Nextcloud folders can be public (available for everybody with access to Liquid) or can be private (for specific users to search). Note that for the moment there is no syncronisation between existing groups in Nextcloud and groups in Hoover - the permissions in Hoover need to be manually added to correspond to permissions in Nextcloud.

App token

Hoover Nextcloud Collections

To add a collection from a Nextcloud folder, go to the hoover admin menu and click the Add button next to the Nextcloud collections entry. Then you can choose the directory from the dropdown which should become a collection and give it a name. The directory dropdown supports simple search. Collection names must be lowercase alphanumeric and at least 3 letters long. No other settings are needed (additional processing features could be enabled), you can click Save and the new collection will be processed.

Add nextcloud collection

Enable Sharing

Enabling sharing between individual users in Nextcloud can be enabled by clicking your Profile Icon -> Administrational settings -> Sharing (In the Administration section) and then enable the desired option.

The relevant settings are in the Privacy settings for sharing section: You can

  1. Allow username autocompletion (this will give suggestions upon typing into the sharing field). If enabled this can also be limited to autocompletion for only users within the same group.
  2. Allow autocompletion when entering the full name. This means no suggestions will be shown, you can only select the user after entering the full name.

Enable sharing