{% extends "help/base.html" %} {% load i18n %} {% block help_con %}

{% trans "Use folder permission for fine-grained access control" %}

{% blocktrans %}For shared libraries or folders, you can set permission to its sub-folders for a person or a group. Available permissions are the same as the ones described in sharing libraries. Here are some use cases:{% endblocktrans %}

{% trans "Folder permissions are only effective for libraries and folders you share to others. To effectively set folder permissions to its sub-folders, you should first share the parent library or folder; otherwise the folder permission won't take effect." %}

{% trans "One important design goal of folder permission is to support hierarchical permissions:" %}

{% trans "Basic usage" %}

{% blocktrans %}Only library's owner can set folder permissions for its sub-folders. In the file browsing interface, click "more operations" button, choose "permission" in the drop-down menu. In the pop-up window, you can see and set folder permissions on this folder.{% endblocktrans %}

{% blocktrans %}If you want to see all folder permissions set in a library, hover the mouse on the library. Click "more operations" button, choose "Folder Permission" in the drop-down menu. In the pop-up window, you can see and set folder permissions in this library.{% endblocktrans %}

{% blocktrans %}When other users navigate into a folder, there will be a small "eye" icon next to "read only" sub-folders. When the user navigate into that sub-folder, he/she won't be able to add/modify/delete files.{% endblocktrans %}

{% blocktrans %}If a "read only" folder is synced to PC with the Seafile desktop App, changes under a "read only" folder won't be uploaded to the cloud.{% endblocktrans %}

{% trans "Advanced: priority between different permissions" %}

{% trans "Here is a more complex example:" %}

{% blocktrans %}Supposed the folder structure looks like "A/B", user "John" is in group "Staff". If you set "read only" permission on folder A for John, and, you also set "read write" permission on folder "A/B" for group "Staff". Then John's permission to folder "A/B" is still only "read only". That's because, according to rule 2, "read only" permission is first matched for folder "A/B" and user "John", which is inherited from its parent "A".{% endblocktrans %}

{% endblock %}