[Pkg-owncloud-commits] [owncloud-doc] 38/227: Created new File Sharing page

[David Prévot]

This is an automated email from the git hooks/post-receive script.

taffit pushed a commit to branch master
in repository owncloud-doc.

commit 7db32a3dce0764016e87aed11f1889bbe4eb76c6
Author: Carla Schroder <carla at owncloud.com>
Date:   Tue Sep 2 10:43:23 2014 -0700

    Created new File Sharing page
---
 .../configuration/configuration-file-sharing.rst   |  72 +++++++++++++++++++++
 admin_manual/images/sharing-admin.png              | Bin 0 -> 35361 bytes
 admin_manual/images/sharing-user-local.png         | Bin 0 -> 7988 bytes
 admin_manual/images/sharing-user.png               | Bin 0 -> 29462 bytes
 4 files changed, 72 insertions(+)

diff --git a/admin_manual/configuration/configuration-file-sharing.rst b/admin_manual/configuration/configuration-file-sharing.rst
new file mode 100644
index 0000000..a1cc1d9
--- /dev/null
+++ b/admin_manual/configuration/configuration-file-sharing.rst
@@ -0,0 +1,72 @@
+File Sharing
+=======
+
+ownCloud users can share files with their ownCloud groups and other users on 
+the same ownCloud server, and create public shares for people who are not 
+ownCloud users. You have control of a number of user permissions on file shares:
+
+* Allowing users to share files
+* Allowing users to create public shares
+* Requiring a password on public shares
+* Allowing public uploads to public shares
+* Requiring an expiration date on public share links
+* Allowing resharing
+* Restricting sharing to group members only
+* Allowing email notifications of new public shares
+* Excluding groups from creating shares
+
+You may also allow users to create server-to-server shares (see "Configuring 
+Server-to-Server Sharing" in the Admin manual).
+
+Configure your sharing policy on your Admin page in the Sharing section.
+
+.. figure:: ../images/sharing-admin.png
+
+* Check ``Allow apps to use the Share API`` to enable users to share files. If 
+  this is not checked, no users can create file shares
+* Check ``Allow users to share via link`` to enable creating public shares for  
+  people who are not ownCloud users. This creates a hyperlink, just like a 
+  Web page, so your ownCloud server needs to be accessible to whoever you are 
+  sharing with
+* Check ``Enforce password protection`` to force users to set a password on all 
+  public share links. This does not affect local user and group shares
+* Check ``Allow public uploads`` to allow outside users to upload files to 
+  public shares
+* Checking ``Set default expiration date`` sets a default expiration date on 
+  public shares, and checking ``Enforce expiration date`` makes it a requirement
+* Check ``Allow resharing`` to enable users to re-share files shared with them
+* Check ``Restrict users to only share with users in their groups`` to confine 
+  sharing within group memberships
+* Check ``Allow users to send mail notification for shared files`` so that 
+  users can send email notifications when they create new public shares
+* Check ``Exclude groups from sharing`` to prevent members of specific groups 
+  from creating any file shares in those groups. When you check this, you'll 
+  get a dropdown list of all your groups to choose from. Members of excluded 
+  groups can still receive shares, but not create any
+
+This is how it looks when a user creates a public share with passwords and 
+expiration dates required:
+
+.. figure:: ../images/sharing-user.png
+
+This what a local share looks like. The user creating the share controls 
+re-sharing, editing, updating, and deletion privileges:
+
+.. figure:: ../images/sharing-user-local.png
+
+Creating Persistent File Shares
+-----------------------
+
+When a user is deleted, their files are also deleted. As you can imagine, this 
+is a problem if they created file shares that need to be preserved, because 
+these disappear as well. In ownCloud files are tied to their owners, so 
+whatever happens to the file owner also happens to the files.
+
+One solution is to create persistent shares for your users. You can retain 
+ownership of them, or you could create a special user for the purpose of 
+establishing permanent file shares. Simply create a shared folder in the usual 
+way, and share it with the users or groups who need to use it. Set the 
+appropriate permissions on it-- at a minumum ``share`` and ``create``-- and then 
+no matter which users come and go, the file shares will remain. Because all 
+files added to the share, or edited in it, automatically become owned by the 
+creator of the share regardless of who adds or edits them.
\ No newline at end of file
diff --git a/admin_manual/images/sharing-admin.png b/admin_manual/images/sharing-admin.png
new file mode 100644
index 0000000..9278819
Binary files /dev/null and b/admin_manual/images/sharing-admin.png differ
diff --git a/admin_manual/images/sharing-user-local.png b/admin_manual/images/sharing-user-local.png
new file mode 100644
index 0000000..f7bd629
Binary files /dev/null and b/admin_manual/images/sharing-user-local.png differ
diff --git a/admin_manual/images/sharing-user.png b/admin_manual/images/sharing-user.png
new file mode 100644
index 0000000..6f56925
Binary files /dev/null and b/admin_manual/images/sharing-user.png differ

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-doc.git