We apologize for untranslated text, you can use the Google Translation button to get an automatic translation of the web page in the language of your choice.

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.

create-google-apis-console
Creating a Google API Project

In the page that appears, click the Services link in the left menu.

gac-services
Services menu

The list of services appears to the right of the menu. Select the Drive API Service by clicking the activation button ON / OFF.

gac-drive-api-not-activated
Drive API Service not activated

It is possible that the terms of service appear. Check I agree to these terms. and click the Accept button.

terms-of-services
Review terms of service

The list of services appears with the Drive API Service activated.

gac-drive-api-activated
Drive API Service activated

Click the API Access link in the left menu.

gac-api-access
API Access menu

In the page that appears, click the Create an OAuth 2.0 client ID... button.

gac-create-oauth-client-id
Create OAuth 2.0 client ID

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.

create-client-id_branding-info_sitename-prop
Application's name / Site name property in Administration Area

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
create-client-id_clientid-settings
Client ID Settings

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.
client-id_branding-info
Branding information / Client ID

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.

googledrive-admin-properties
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:
    1. The current workspace is used if it is connected to a Google account,
    2. Otherwise, the parent workspace is used if there is one and it is connected to a Google Account,
    3. 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 connect-googledrive.

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
    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.

    google-account-login
    Check the logged Google Account

Then, you must allow access by clicking the Allow Access button.

allow-access
Request Permission

Administration Area page is refreshed and you should see disconnect-googledrive instead of connect-googledrive.

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 connect-googledrive.

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 connect-googledrive.

A new window opens in which you must allow access by clicking the Allow Access button.

allow-access
Request Permission

The edit page of your profile is refreshed and you should see disconnect-googledrive instead of connect-googledrive.

Disconnect From Google Drive

If you want to disconnect from Google Drive, go to the edit page of your profile / User Account and click disconnect-googledrive.

Click the Yes button in the confirm modal window.

A new window opens in which you must revoke access to the site.

revoke-access
Revoke Access

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.

addgoogledrive
Add a Google Docs document from Add menu

A new modal window opens with four steps: Source, Templates, Attendees and Informations

googledrive-modal-step1
Add a Google Docs document - Modal form: Source
  1. 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
      Document Google Document DOC 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
      Spreadsheet Google Spreadsheet XLS 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
      Presentation Google Presentation PPT application/vnd.ms-powerpoint
      PPTX application/vnd.openxmlformats-officedocument.presentationml.presentation
      PPS application/vnd.ms-powerpoint
      Drawing Google Drawing WMF 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.

  2. 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.

    googledrive-modal-step2
    Add a Google Docs document - Modal form: Templates
  3. Attendees:

    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.

    googledrive-modal-step3
    Add a Google Docs document - Modal form: Attendees
  4. 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.

    googledrive-modal-step4
    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 prohibit-icon.

googledrive-ctxmenu
Edit with Google Docs - Contextual menu

 

googledrive-editwith
Edit with Google Docs and 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.

googledrive-viewer
Google Docs Viewer

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.

    googledrive-modal-fetch
    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

    googledrive-modal-stop
    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'

googledrive-portlet-docs
Google Docs Portlet

La Portlet Google Drive Explorer

You can add a portlet that displays the contents of a Google Drive according to the priorities defined previously.

googledrive-portlet-explorer

Portlet Google Drive Explorer

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.

googledrive-instant-searchgoogledrive-search-full

 

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.

gdrive-wiki

Wiki : Insert link to a Google Drive document

gdrive-wysiwyg

Wysiwyg : Insert link to a Google Drive document

FAQ

1. Le message "vous ne semblez pas être connecté à votre compte Google" persiste.

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?

Information

Version
  • 3.1
Stability
  • Stable
Compatibility
  • JPlatform 10 SP1
    JPlatform 10 SP2
Certified by Jalios
  • Yes
Price
  • Module payant
Support
  • Jalios Support
Author
  • Jalios SA
License
  • Jalios
Size
  • 4.33 MB
Updated
  • 8/17/18
Download
  • 16
Required Plugins
OAuth
v 1.2