GoogleSharing
=============
About GoogleSharing
-------------------
GS manages the sharing of documents stored in the Google servers and their synchronization
from the Plone application to Google Docs service. In this way, when a Plone user changes
the roles of other users on a specific document, for instance to share the document with
them or to restrict their access to the document, GS changes the document sharing attributes
in the Google Docs service accordingly. So, if a Plone user assigns another user the Editor
role on one of his documents, the other user will be able to read and modify that document
through his Google account.
To associate Plone and Google accounts, GS assumes that the email address attribute of Plone
users corresponds to their Google account.
The mapping of roles, on each specific document, from Plone to Google Docs is based on the
following rules: Plone users who have both the Editor and the Reader roles on a specific
document are assigned the writer role on the correspondent document on Google servers; Plone
users who have the Editor or the Reader roles are assigned the writer or reader role,
respectively, on the correspondent document on Google servers. The Collaborator and Reviewer
roles have not been considered.
Copyright and license
---------------------
Copyright (c) 2009 Federica D'Elia
This software is subject to the provisions of the GNU General Public License,
Version 2.0 (GPL). A copy of the GPL should accompany this distribution.
THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
FOR A PARTICULAR PURPOSE
See the `LICENSE` file that comes with this product.
Requirements
------------
FileSystemStorage, GoogleAuthentication, GoogleSystemStorage and gdata-1.3.0
must be correctly installed.
Installation
------------
With buildout
-------------
This example speaks of itself::
[buildout]
parts=
...
fss
...
eggs =
..
collective.googlesystemstorage
collective.googleauthentication
collective.googlesharing
iw.recipe.fss
iw.fss
...
...
zcml =
...
collective.googlesystemstorage
collective.googleauthentication
collective.googlesharing
iw.fss
iw.fss-meta
...
...
[fss]
recipe = iw.recipe.fss
zope-instances =
${instance:location}
storages =
global / flat
portale /portale site1 ${buildout:directory}/var/portale_fss_storage ${buildout:directory}/var/portale_fss_backup
Credits
-------
Main developer: D'Elia Federica <federica.delia@redturtle.it>
Changelog
=========
1.0.0
-----
* Initial release