Title: Google Documents Widget plug-in

This widget allows you embed your Google document in your TeamPage article. Available for both of Google Apps for business and free Google accounts.

Download

Click the link below to download the zip file of this plugin.

Google Documents Widget plugin /db/attachments/forum/6405/share/

77.8 KB

com.traction.googledocs-1.11.zip

Mar 2, 2015

10:56:03 AM EST

Install

Log in to your TeamPage and open Server Settings > Plugins page to upload the zip file.

After you complete uploading, you will see "I18N ERROR". This error means "At this moment, the internationalization resources (language files) are not loaded yet." Don't worry. It is harmless. Just restart your TeamPage server in Server Settings > General > Manage Server page to solve this error. If your TeamPage server is hosted in Traction Software's cloud environment, you need restart your TeamPage server twice.

After restarting (twice), you will see the plugin is displayed without error like this.

Basic Usage

Sharing Settings in Google

Your Google document is set to be private as default. This means that your document embedded in a TeamPage article will be hidden from people. You should check and change the sharing setting in Google.

If you use Google Apps for business

Open your document in Google Docs Editor. Double-click the document or select the menu below.

Select [File] > [Publish to the web...] menu.

Click [Publish] button. If you want to share your document with people who have your company's Google Apps only, you should turn on [Require viewers to sign in with their Your Company Name account] checkbox.

Now your document is published and abled to be embedded. Copy the URL.

If you use a free Google account

Right-click the document you want to embed and select [Share...] menu.

You can invite people by typing their email addresses, or click [Advanced] link.

In the Advanced setting dialog, you can see that the document is private. Nobody but you can view and edit the document. Click [Change...] link.

Select [On - Anyone with the link] and click [Save] button.

Now the document is shared with anybody who knows the link. Copy the link URL.

Insert Widget

Click the [Insert/Edit Widget] button and select [Google Documents] item.

Paste your document's URL or ID in [Your Documents URL or ID] text box.

In some cases, you will have to enter your domain name and/or select document type etc, but just click [OK] for now.

You will see the widget is in your article. Submit it.

You will see that your Google document is embedded and displayed in your article.

Options

Document URLs

Your document has several soft of URLs. Here are example. (Note: if you are using Google Apps and your document is published to people in your company only, your domain name will be inserted after /a/ in the URL.)

In the sharing setting dialog
https://docs.google.com/(a/DomainName/)DocumentType/d/DocumentID/edit?usp=sharing
In the document editor view
https://docs.google.com/a/DomainName/DoumentType/d/DocumentID/edit#gid=0
In the Get Link dialog
https://drive.google.com/open?id=DocumentID&authuser=1

If you paste the 3rd URL above, you will have to select Document Type option in the widget dialog, because the URL doesn't include "DocumentType" and the widget can not identify the type properly.

Document ID

You can specify your Google document by entering ID as well. Since it is not possible to identify the type of your document from ID, you have to select proper type.

Domain Name of Your Google Apps

If 1) you are using Google Apps and 2) you turned on [Require viewers to sign in with their Your Company Name account] checkbox to limit the range of sharing within your company and 3) you specify the document by the ID or the "Get Link" URL, you have to fill in your Google Apps' domain name.

The URL to embed the document must contain your Google Apps' domain name, e.g. /a/tractionsoftware.com, but the widget can not find your domain name in the ID or the "Get Link" URL.

The "Get Link" URL here means the URL which you can get from [Get Link] menu and contains "open", e.g. https://drive.google.com/open?id=DocumentID&authuser=0.

Attachments:

googledocs.png
install1.png
install2.png
share01.png
share02.png
share03.png
share04.png
shared05.png
widget01.png
widget02.png
widget03.png
widget04.png
select_doctype.png
specify_by_id.png
domain_name.png
apps_image3.png
apps_image4.png

Shared Files for Forum6405

Article: Forum6405 (permalink)
Categories: :Doc:Forum
Date: March 1, 2015; 10:22:21 AM Eastern Standard Time

Author Name: Takashi Okutsu
Author ID: takashi