Google Drive Plugin 3.1
Description
The Google Drive plugin allows you to manage the content present in different Drive.
The Google Docs plugin allows you to:
- Browse in a Drive
- Search for documents on the Drive via the JCMS search
- Create Google Docs documents (Documents, Spreadsheets, Presentations, Drawings)
- Share documents edited with Google Docs in your site with other members,
- View documents edited with Google Docs through a embedded viewer in your site,
- Co-edit documents edited with Google Docs without leaving your site.
This plugin requires the OAuth plugin.
Screenshots
1. Google Docs viewer
|
Installation
Installation
Install Jalios Google Docs Plugin and OAuth Plugin, and restart JCMS.
Configuration
If you are the site administrator and you need to configure the site to use the Google Drive plugin, you must read this section.
If you just want to use the Google Drive plugin as a user, please read the User Guide section.
Google APIs Console
First, you must create a Google APIs Project. If you don't have it, you can create it here.
Click the Create Project... button.
In the page that appears, click the Services link in the left menu.
The list of services appears to the right of the menu. Select the Drive API Service by clicking the activation button ON / OFF.
It is possible that the terms of service appear. Check I agree to these terms. and click the Accept button.
The list of services appears with the Drive API Service activated.
Click the API Access link in the left menu.
In the page that appears, click the Create an OAuth 2.0 client ID... button.
A new modal window opens in order to create a Client ID. You must enter:
- Product Name: The Product Name should be the same name as your site, the latter being defined in the properties of the administration area.
- Product Logo: The Product Logo must be a public URL and the size should not exceed 120x60 pixels.
The previous information will be shown to users whenever you request access to their private data using your new client ID.
Click the Next button.
In the next page, you must enter Authorized Redirect URIs:
- Application type: You must select Web application.
- Your site or hostname: Click on (more options)
- Authorized Redirect URIs: You must add the URLs that provide access to the callback page of the Google Drive plugin. If you have multiple sites, you can add multiple URLs (one per line).
The URL must be of the type:http(s)://www.mywebsite.com[:port]/[WEBAPP]/plugins/GoogleDrivePlugin/jsp/oauth1callback.jsp
Click the Create client ID button to create an ID.
The new Client ID is created, you can see:
- Branding information, with the Product name and Product logo
- Client ID and Client secret used by the Google Drive plugin.
Note: If you would like more information about Google APIs console, please visit Google APIs Console Help
Administration properties
You must copy your Client ID and Client secret previously created in the Google Drive plugin Administration properties.
You can see the Centralized storage mode property:
- No: This is the distributed mode.
Your configuration is now ready. You can start editing with Google Drive.
Note: When a member adds a new Google Drive document, the document is created into his Google Drive. If you choose this mode, each member can also reference one of his existing Google Drive documents in JCMS. - Yes: This is the centralized mode. You must connect the Google Enterprise Account to Google Drive.
Note: When a member adds a new Google Drive document, the document is created into the Google Drive of the Centalized account or a Workspace according to the following priorities:- The current workspace is used if it is connected to a Google account,
- Otherwise, the parent workspace is used if there is one and it is connected to a Google Account,
- Otherwise, if the current workspace and all these parents are not connected, it then uses the centralized account
The Template Categories property defines the categories that are used for Google Drive document templates.
A template is a document uploaded under a root of category defined in this property.
Google Enterprise Account in Administration Area
If you chose the centralized mode, you must configure the centralized Google account (Google Enterprise Account).
You must allow the site to access Google Drive. For this, go to the Administration Area / Operation and click 
.
A new window opens.
-
If you're not already logged in to Google, enter the username and password of the Google Enterprise Account.
Google Account Login -
If you are already connected, verify that the account used in the window that opens is the Google Enterprise account. Otherwise, you need to sign out and relogin with the correct Google Enterprise Account.
Check the logged Google Account
Then, you must allow access by clicking the Allow Access button.
Administration Area page is refreshed and you should see 
instead of .
Google Account in a Workspace
If you chose the centralized mode, it is possible to manage a Google Drive by Workspace.
To do this, you need to go to the Workspace administration area/ Configuration and click .
The documents that will be created from this Workspace or from the children Workspace will be stored on the Drive of Google Account used in this Workspace.
User Guide
Connect to Google Drive
You must allow the site to access Google Drive. For this, go to the edit page of your profile / User Account and click .
A new window opens in which you must allow access by clicking the Allow Access button.
The edit page of your profile is refreshed and you should see instead of .
Disconnect From Google Drive
If you want to disconnect from Google Drive, go to the edit page of your profile / User Account and click .
Click the Yes button in the confirm modal window.
A new window opens in which you must revoke access to the site.
After revoking access, you can close the window.
If you want to connect again to Google Drive, please read Connect to Google Drive.
Add a Google Docs Document
If you want to add a Google Drive document, go to the Add menu in the top bar of the home page, then click Documents -> Google Docs document.
A new modal window opens with four steps: Source, Templates, Attendees and Informations
-
Source:
You can select the Workspace in which the Google Docs document is stored. By default, the field is filled by the current Workspace,
This step allows you to choose how to add the Google Docs document.
-
Start a blank document:
This option allows you to create a new Google Docs Document from a blank document or from a document template.
You must enter the Document title and select a Google Document type: Document, Presentation, Spreadsheet and Drawing.
-
Post a file:
This option allows you to create a new Google Docs Document from a local document.
Documents, spreadsheets, and presentations you create, as well as files that you upload, have some limits built in. Please refer to Google Docs, Sheets, Slides and size limits for more information.
You must choose a valid document type:
Google Document Type Document Types Mime Types 
Google DocumentDOC application/msword DOCX application/vnd.openxmlformats-officedocument.wordprocessingml.document HTML text/html HTM text/html RTF application/rtf ODT application/vnd.oasis.opendocument.text JPEG image/jpeg GIF image/gif JPG image/jpeg PNG image/png PDF application/pdf 
Google SpreadsheetXLS application/vnd.ms-excel XLSX application/vnd.openxmlformats-officedocument.spreadsheetml.sheet HTM text/html ODS application/x-vnd.oasis.opendocument.spreadsheet CSV text/csv TAB text/tab-separated-value TSV text/tab-separated-values TXT text/plain 
Google PresentationPPT application/vnd.ms-powerpoint PPTX application/vnd.openxmlformats-officedocument.presentationml.presentation PPS application/vnd.ms-powerpoint 
Google DrawingWMF application/x-msmetafile -
Reference an existing Google Document:
This option allows to retrieve a Google Docs document from your Google Drive.
Note: This option is available only in distributed mode.
-
-
Templates:
This step only appears whether you chose to create a Google Docs document from a blank document.
A template is a document uploaded under a root of category defined in the Template Categories property. Severals ID of category can be provided.
Add a Google Docs document - Modal form: Templates -
This step is optional, you can choose whether to assign access level for members. You can invite members to:
- edit: The members with this access level can edit the document and share the document with other members.
- comment: The members with this access level can only add comments to the document (not available for Google spreadsheets).
- consult: The members with this access level can only view the document.
These members will be notified by Alert. You can add a personal message in the Message field.
Add a Google Docs document - Modal form: Attendees -
Informations:
This step is optional, you can give more details about the document:
-
Add a description of the document,
-
Select Categories,
-
Enable tracking the readers on the document.
Add a Google Docs document - Modal form: Informations -
Edit with Google Docs
You can edit an existing document in your site from the contextual menu or from the detailed template of the document, and click the Edit with Google Docs... button.
Documents, spreadsheets, and presentations you create, as well as files that you upload, have some limits built in. Please refer to Google Docs, Sheets, Slides and size limits for more information.
You can prohibit editing with Google Docs by clicking the icon of prohibiting editing 
.
The Google Docs Viewer
After creating a Google Docs Document, you can go to the detailed template of the document, on which appears the Google Docs Viewer.
The Google Docs viewer is linked to Google Drive, and the supported browsers are those supported by Google Drive. To know system requirements and supported browsers, please refer to System requirements and supported browsers.
Menu bar at the top of the viewer provides different actions:
-
Full screen:
Opens the document in full screen mode.
-
Download:
Downloads a copy of the document and update the JCMS File Document.
Download a copy of the document -
Share:
Assigns access level for members. Please refer to How to invite attendees for more information.
-
Open in Google Docs:
Opens the Google Docs document directly in Google Drive.
-
Tracking:
Each member can indicate whether his modifications are completed on the document. The author of the document can remind members to come completing their modifications.
-
Stop Edition:
Stops edition with Google Docs, remove the Google Docs Document in Google Drive. You can download the Google Docs document before the stopping of edition in order to upload a new version of this document
Stop Google Docs Edition
The Google Docs Portlet
You can add a portlet that displays Google Docs documents, which can be refined by:
- The current workspace
- The current member as author
- Shared documents with the current member
Note: You can also add a Google Docs document from the portlet by clicking on link 'Add a Google Docs document'
La Portlet Google Drive Explorer
You can add a portlet that displays the contents of a Google Drive according to the priorities defined previously.
The features present in the Portlet are:
- Refresh the current folder: This can be useful when a person makes changes directly on the Drive site without going through JCMS
- Create a new document in Google Docs in the selected folder of the Portlet
- Upload one or more files in the selected folder of the Portlet
- Create a new folder
- Rename a file
- Share a file/folder
- Delete one or more files/folders
- Move files/folders
- Download file
- Upload a new version of a file
Search documents in a Drive
The search feature in JCMS integrates search files in the Drive of the current Google account according to the priorities defined previously.
Wiki / Wysiwyg : Insert link to a Google Drive document
It is possible to insert a link to a Google Drive document in Wiki or Wysiwyg fields from Google Drive of the current account accoring to the priorities defined previously.
FAQ
Si le message suivant persiste alors que vous êtes bien connecté à votre compte et que vous avez déjà suivi les 2 liens proposés dans le message :
Vérifiez si module dans votre navigateur empêche l'interrogation du service tiers Google.
Par exemple "Adblock plus" propose un filtre "Fanboy Annoyances List" qui bloque cette vérification.
De manière générale, configurez votre intranet dans la liste blanche de tels outils (bloqueur de pub) afin d'éviter ce genre d'effet collatéraux.
Dans l'exemple présent, si vous souhaitez juste appliquer une règle corrective, nous vous proposons la règle suivante :
@@||accounts.google.com/CheckCookie?
