Summary
Overview
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.
Installation
The installation steps are as follows:
- Obtain Google Drive Quick Links app from the Liferay Marketplace.
- Deploy the app in your existing Liferay installation. If you haven’s installed Liferay, please download and follow the instructions to do so.
- Configure the Google Drive Client Id and Developer Key, as it will be explained below.
- Add the portlet to the page.
Configuration
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: | |
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.
| |
7. Create a developer key by clicking the button under Public API Access section, Create 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: | |
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. |
Table Schema
Browser Compatibility
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:
Code repository
The latest source code is located at the following location:
https://github.com/rivetlogic/liferay-google-drive-quick-links
Contact Us
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