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 Docs Plugin 3.1

Description

The Google Docs plugin integrates the Google Docs Web Office Suite (http://docs.google.com/) in your site.

The Google Docs plugin allows you to:

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

This plugin requires JCMS 8 SP1.

Warning

The Google Docs plugin will not be improved. It is replaced by the Google Drive 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 Docs plugin, you must read this section.
If you just want to use the Google Docs 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 Docs 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/GoogleDocsPlugin/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 Docs 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 Docs plugin Administration properties.

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 Docs.
    Note: When a member adds a new Google Docs document, the document is created into his Google Drive. If you choose this mode, each member can also reference one of his existing Google Docs documents in JCMS.
  • Yes: This is the centralized mode. You must connect the Google Enterprise Account to Google Docs.
    Note: When a member adds a new Google Docs document, the document is created into the Google Drive of the centralized Account.

The Template Categories property defines the categories that are used for Google Docs 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 Docs. For this, go to the Administration Area / Operation and click Connect to Google Docs.

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 to Google Docs instead of Connect to Google Docs.

User Guide

Connect to Google Docs

You must allow the site to access Google Docs. For this, go to the edit page of your profile / User Account and click Connect to Google Docs.

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 to Google Docs instead of Connect to Google Docs.

Disconnect From Google Docs

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

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 Docs, please read Connect to Google Docs.

Add a Google Docs Document

If you want to add a Google Docs document, go to the Publish menu in the top bar of the home page, then click Add Document Google Docs.

addgoogledocs
Add a Google Docs document from Publish menu

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

step-source
Add a Google Docs document - Modal form: Source
  1. Source:

    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.

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

    step-attendees
    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 the Workspace in which the Google Docs document is stored. By default, the field is filled by the current Workspace,

    • Select Categories,

    • Enable tracking the readers on the document.

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

contextual-menu
Edit with Google Docs - Contextual menu

 

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

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

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

  • 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-edition
    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 or by the current member.

Note: You can also add a Google Docs document from the portlet by clicking on link 'Add a Google Docs document'

portlet
Google Docs Portlet

Information

Version
  • 3.1
Stability
  • Stable
Compatibility
  • JCMS 8 SP1
Certified by Jalios
  • Yes
Price
  • Module payant
Support
  • Jalios Support
Author
  • Jalios SA
License
  • Jalios
Size
  • 1.12 MB
Updated
  • 5/30/13
Download
  • 33
Required Plugins
OAuth
v 1.2