Embed Any Document Plus

  1. Install
  2. Google Drive Picker
  3. Settings & Options
  4. Get API Keys
  5. Shortcode & Attributes
  6. FAQ

Google Drive Picker Plugin for WordPress by AWSM Innovations

Drivr 1.1

WordPress Plugin

Thank you for purchasing our plugin. If you have any questions that are beyond the scope of this help file, please feel free to email via our user page contact form here. Thanks so much!

Drivr Intro

Drivr helps you to add files from your Google Drive Account to your WordPress site quickly and seamlessly.

What makes Drivr stands out is the way it handles different type of files. If you choose an image file, you will get a friendly interface to add it into content editor just like WordPress' default Media Library. If you choose a media file or a document Drivr will ask you if you want to embed it to your website.

Drivr uses Google Drive Picker API to let users interact with their Google Drive Account.

Key Features

File Picker

  • View files from your Google Drive Account
  • Drag-n-drop upload files to your Google Drive Account
  • Search files within your Google Drive Account
  • Categorized tabs based on file types
  • Easily activate/deactivate and reorder tabs
  • BONUS: Search and Embed videos from YouTube

File Handling

  • Supports all file types
  • Embed Media files and Documents
  • Option to add files as plain links
  • Insert images to Visual Editor and as Featured Image
  • Options for images to change dimensions, add captions, etc

What can you use this plugin for?

1. To host Media and Download files in your Google Drive

There are multiple benifits for hosting your files in Google Drive. Especially when you have large files and videos to share.

2. Embed Documents, Spreadsheets and Presentations

There is no better solution when it comes to managing your Documents online. Go host them all in your Google Drive and just use Drivr to emebed them directly!

3. Search and Embed videos from YouTube

Well, this is actually a bonus feature! You can easily search for YouTube videos in the picker and embed them in just one click.

Quick Start Guide

Install Plugin → Configure APIs → Start Using Drivr!

A novice or an expert, you will not need anything more than 5 minutes to get this plugin installed and working in your WordPress website. Read the documentation carefully before you start. We agree that API configuration is a little bit tricky and looks 'high-tech'. Don't worry about it. Our step-by-step guide will help you to tackle it easily.

A. Installing Plugin

Add Plugin

Before beginning the installation and configuring of the plugin, you must first have WordPress already installed on a server. Once you have setup a copy of WordPress, there are two ways you can go about installing the plugin:

  1. FTP Upload: Unzip the download and upload the plugin directory /awsm-drivr/ into your WordPress plugins directory /wp-content/plugins/
  2. WordPress Upload: This is definitely the easiest route for most. Simply navigate to Plugins› Add New Plugin› Upload. Click the "browse" button and locate the still zipped plugin folder. The plugin will be uploaded and installed in a matter of seconds.

B. Adding files from your Google Drive

Drivr is integrated seamlessly into the post editor. With a click on 'Add From Drive' button it lets you access your Google Drive Account in a Modal Window, which actually is known as Google Drive Picker.

Click on the button right next to 'Add Media' button in visual editor to get started.

Add Document

It will open the Google Picker!

Google Drive Picker

Look how it works

Note: The files must be 'Public' for users to be able to access them. How to make them public.

C. Settings

C.1. General Settings

Here you can enable/disable tabs and reorder them.

C.2. Keys

This is the first thing you will have to do after installing the plugin. You will have to get Google API Access and paste the keys in this screen. How to obtain keys.

D. Getting Google Drive API Keys

Click here to Watch the video guide

Follow the steps below carefully to generate the keys.

  1. Click this link
  2. Click on 'Create Project' button
  3. Give your project a name and click on 'Create'
  4. Click on 'Go to APIs overview'
  5. Search and enable Google Drive API and Google Picker API
  6. Click on 'Credentials' link in the left sidebar
  7. Click on 'OAuth consent' tab, enter a product name and click on 'Save'. You can leave the rest of the fields blank.
  8. Now click on 'Create Credentials’ dropdown button and select OAuth Client ID
  9. Select 'Web application' as Application type, enter your WordPress website's URL with 'www.' as Authorized Javascript origin (http://www.yourwebsite.com) and click on 'Create button
  10. Now you have your Client ID created. You are almost there. Let's create your API key! Click on 'Create credentials' dropdown button again and click on 'API Key'
  11. Now copy Client ID and API Key from the 'Credentials' page and paste them in your website's 'Cloud Settings' page
  12. Join this Google Group for the plugin to work for your account.

NOTE: Any change you make in the API settings may take 5 to 10 minutes to reflect in your website.

E. Shortcode & Attributes

Example of a shortcode by Drivr is below

[drivr id="JHs2ojs344SSa32aS" type="video"]

Attributes are explained below

id Drive ID of the file
Accepted Arguments: valid Drive ID
type Document type
Accepted Arguments: video, audio, application, presentation, form

G. FAQs

1. Can I remove download/popout buttons from the embed?

Unfortunately we do not have the privilege to alter any features and options that comes by default with the Google Drive Embed, including the download button.

2. Google Drive popup shows an error.

Usually errors show up when the API settings are not configured properly. In that case, please double-check the API configurations with the steps. Make sure you have enabled Drive API and Google Picker API in API Manager. If it’s still not working, try generating a new API key and client ID.

Common Errors

1. The API developer key is invalid: One of the reason that causes this error is the URL format of 'HTTP Referrer' you have submitted in Browser API Key section. Use wildcards to make sure it works perfectly throughout the website. If your website is http://example.com, enter *.example.com/* as HTTP Referrer, without the 'http://' protocol

2. Error 400 - origin_mismatch: Double checking the 'Javascript Origin URL' you have submitted for 'Client ID' would usually solve this issue. Unlike the HTTP Referrer URL, you cannot use any wildcards here and it must contain the 'http' protocol. If you are using this plugin on http://news.example.com/, enter http://news.example.com as Javascript Origin URL, without the trailing slash '/'.

NOTE: Any change you make in the API settings may take 5 to 10 minutes to reflect in your website.

3. How to make the files public?

Making a file public:

Making a folder public:

G. Changelog

V 1.1 [19 Aug 2016]

V 1.0 [26 July 2016]

For more information and instructions visit our website..

This is an AWSM Project.