Child pages
  • Google Drive Quick Links
Skip to end of metadata
Go to start of metadata

 

Summary

The Google Drive Quick Links app allows a user to maintain quick links to frequently accessed Google Drive documents directly from within Liferay. The app allows users to browse and choose documents from Google Drive to be added as Quick Links. It allows the user to open and delete such links. This application is an integration with Google Picker API.

 


Google Drive Quick Links app consists of a portlet which uses the Google Picker Iframe. The portlet allows the user to select the files through the Google Picker Iframe. The google picker uses OAuth and none of the user credentials are kept in the portlet application. The only information stored is the current Liferay userId along with the document Id, name and url to make available the quick links from the portal. 

The installation steps are as follows:

  1. Obtain Google Drive Quick Links app from the Liferay Marketplace.
  2. Deploy the app in your existing Liferay installation. If you haven’s installed Liferay, please download and follow the instructions to do so.
  3. Configure the Google Drive Client Id and Developer Key, as it will be explained below.
  4. Add the portlet to the page.

This is the initial view for Google Drive Quick Links app. 

 

The application requires that the client Id and Public API Access key be set in the control panel for the application to communicate with Google API.

 

The client ID and developer key for the application can be obtained using the following steps:

  1. Visit the following page and create a new Google project:

https://console.developers.google.com/project

2. Click on your project that you has created

3. In the sidebar on the left, select APIs & auth.

4. In the displayed list of available APIs, find the Google Picker API and set its status to ON.

 

5. Select Credentials from the left sidebar.

6. Create a new client ID by selecting Create New Client ID → Web Application

  • Authorized javascript origins: This will be the domain name or url of your application.
  • Authorized redirect URI: Leave it empty.

 

 

7. Create a developer key by clicking the button under Public API Access sectionCreate New Key and select the Browser Key option. The generated API Key is your developer key.

Once you have your developer key and client id go to Liferay → Admin → Control Panel → Portal Settings

On the right side you will see a set of options. Look for the link Google Drive.

Enter your client Id and developer key on the corresponding fields and click save. 

 

 

 Features

Once the plugin is installed, you can click the Select File button and start adding links to the portlet:
Once the Google Picker is opened, you can select one of your files and then click the Select button. This way the selected file will be added to your list of My Quick Links.

For each link you have two actions:
1. Open it in Google Drive, by clicking on its name. The document will be opened in a new tab/window.
2. Delete it. This will only remove the link from Quick Links app. It does not delete the file in Google Drive.

If the user is not authenticated in google and he/she tries to open a document which for some reason doesn't have permissions, by clicking on document name, Google shows a page with a notification about a permission request and sends an email to the document's owner to manage the permission request.




Name field allows a file name length up to 200 characters
URL (link to a file in Google Drive) field allows a link length up to 150 characters

This app has been tested in IE9+,Safari 6.13, Firefox 29, Chrome 34.

However for IE9+ Google Drive present next issue:

When the document is displayed, an error window is showed, however you can close it and see the document. A compatibility warning is presented at top of document view:

 

The latest source code is located at the following location:

https://github.com/rivetlogic/liferay-google-drive-quick-links

We welcome feature/bug reports concerning the Google Drive Quick Links app. Discussion helps to clarify the ways the app can be used and also helps define directions for future development. Please post your concerns at http://issues.rivetlogic.com/browse/LRA

 

Fix: updating the embedded api.js file to the new available one.
New feature: Help page.
Company credits.


  • No labels