apGDrivePlugin

It is a plugin for [symfony 1.4] (http://symfony.com/legacy) working with Google Drive.

Plugin connects to Google Drive and scans a map of new files if they are detected they are converted to .pdf format and downloaded to the local machine (if needed, converted files can be stored on Google Drive in separate folder)

Main components

Component type	Description
Config file path	config/gdrive.yml
Google API submodule library path	plugin/apGdrivePlugin/lib/vendor/google-api
File name validate pattern	CR Pack Visi ([\w]+-[\d]+) ([\d]+) [\S ]+
Plugin module name	ap_gdrive
Processing task:action name	gdrive:processing

example of file name parse:

Filename: CR Pack Visi COR-7800 1 Autovision Versailles.pdf

Result: CustomerId - COR-7800, EntityId - 1

Config file:

config/gdrive.yml

    client_secret_code: <google application secret code>
    client_id: <google application client id>

    source_folder_name: folder-1/folder-1.1/folder-1.1.1 # / - is directory delimiter
    destination_folder_name: folder-2/folder-2.1/folder-2.1.1 # / - is directory delimiter

    #root path from storage is: web/uploads
    local_store_reports: /AdWords/%customerId%/%year%/%month%/ #  %customerId% , %year% and %month% - it's a system tokens

configuration parameters description:

Param name	Description
client_secret_code	[Google application] (https://console.developers.google.com/project) OAuth credentials client secret
client_id	[Google application] (https://console.developers.google.com/project) OAuth credentials client id
source_folder_name	Google Drive folder tray where is sored files
destination_folder_name	Google Drive folder tray where make a converted file copy
local_store_reports	Local folder tree for store converted files

Google API Submodule

All you need is initiate submodule and update him:

• in plugin root path git submodule init git submodule update
• in application root path git submodule update --init --recursive - this command init and update all your submodules from application

Plugin module routes

Route name (from: routing.yml)	Module action	Methods	Parameters
g_doc_prepare	/ap_gdrive/init	GET POST	Don't have parameters
g_doc_folder_tree	/ap_gdrive/tree/:folder	GET POST	:folder - folders name string
g_doc_download_file	/ap_gdrive/download/:id/:hash	GET	:id - file id, :hash - string generated automatical with file information

Processing file task parameters:

gdrive:processing <param> <param>

Parameter	Short alias	Default value	Accept value	Description
removeConvertedTag	-r	false	false true	Remove converted tag of previously converted files for process repeated
makeCopy	-c	true	false true	Create copy of converted file on google drive in destination_folder_name specified in config file

Example call task with parameters: gdrive:processing -r true -c false

How enable plugin

After installing the plugin and enable the module to be accessed from application follow to g_doc_prepare link where you have 2 buttons: Get auth code and Set token (These buttons are active until the token set). All you need must press the Get auth code then you will be redirected Google login page where the plugin will have to confirm access to your files on Google Drive. After this you will receive a Auth Code which need to be copied and pasted into the field Generate auth code the page where the buttons and press the Set token.