WP File Download Addon documentation

 

Introduction

WP File download got an addon that adds several features: Google Drive synchronization, DropBox synchronization, OneDrive synchronization, Social file locker. It has to be installed as a separated plugin.

 

I. WP FILE DOWNLOAD ADDON INSTALL

1.1 Install

In order to install our plugin addon, you should use standard WordPress installer or unzip and put all the folder in /wp-content/plugin.

Then click on activate plugin, to see WP File Download menu appear on the WordPress left menu.

WP File download addon will add the features in the default WP File Download environment.

1.2 Update the addon

In order to update the WP File Download, you can use the WordPress default updater. You can also remove and install the new version from a .zip file downloaded on www.joomunited.com. In any case, you won’t lose any content because everything is stored in the database.

Be sure to always have the latest version to avoid security and stability problem.

To update the paid version, you need to login to your JoomUnited account from the WordPress settings: Settings > General

Then use your JoomUnited account login and password. After a successful login, the button turns to blue with a text Disconnect my JoomUnited account

Then finally, you can update all the JoomUnited commercial plugins from the WordPress standard updated.

update-wpfd-addon-finish

II. GOOGLE DRIVE INTEGRATION

2.1 Create a Google Drive App

The Google Drive integration is distributed as a separate Add-on. You need to install this add-on (plugin) additionally to WP File Download.

First, you need a Google dev App to connect your website to Google Drive. Go to https://console.developers.google.com/project and create a new project.

Then set up a project name (no space, no accent)

Then wait a few seconds for the project creation…

If it's the first time you're using the Google Drive API, you'll need to activate it.

enable-api

From the left menu, click on “API Manager”

Then on the left menu “Credentials” >> “New credentials” >> OAuth client ID (if asked, add a name to your OAuth consent screen).

Now, the most important step.

  • Select “Web application” and add a name of your choice.
  • Authorized JavaScript origin: http://www.your-domain.com (replace by your domain name, no slash)
  • Authorized redirect URIs: http://your-domain.com/wp-admin/admin.php?page=wpfdAddon-cloud&task=googledrive.authenticate (replace by your domain name)

Then… voilà! You got your ID and Secret to add in the WP File Download configuration

2.2 Login to Google Drive in WP File Download

Then go back in WordPress admin and click on the menu WP File Download > Configuration > Cloud connection tab > Google Drive settings. Paste your

  • Client ID
  • Client secret

Then save the configuration and click on the Google Drive connection button

google-drive-connect

Finally, login to your google account by clicking on Connect Google Drive button

If you haven’t made any mistake you should validate the authorization in a new window like bellow

 The connection should be a success ☺

Then you can create Google drive folders and upload files in it!

2.3 How it works? What can I do with GG Drive?

How does it work? 

WP File download will generate a root folder on your Google Drive with the site name


All the categories and subcategories added in WP File Download will be added under this folder.

What are the sync directions?

It works in both directions! You can add a file from Google Drive and see it WP File Download or add a file in WP File Download and see it in Google Drive. It also means you can manage WordPress files from your desktop using Google Drive sync software. That’s crazy! Yes we know ☺

Also if you erase a file from Google Drive you have to empty trash to erase it from Google Drive.

google-drive-category

 

Get rid of the error: error: "invalid_scope when connecting WP File Download with Google Drive"

Google has recently introduced a new security layer that forces apps to be verified.  If you've created the app with your Google account and then you log in from WordPress with the very same account you won't see this error.
This error will only appear if you've created an App with a Google account and trying to connect to Google from WordPress with another account.

In this case, you need your app to get approved by Google following this process: https://support.google.com/code/contact/oauth_app_verification

III. DROPBOX INTEGRATION

3.1 Create a Dropbox App


The Dropbox integration is distributed as a separate Add-on. You need to install this add-on (plugin) additionally to WP File Download. The addon includes integration for Google Drive too.

First, you need a Dropbox App to connect your website to a Dropbox account. Go to https://www.dropbox.com/developers and create a new app. 

Then set up an app type "Dropbox API", "Full Dropbox" and an app name

File categories from WP File download will be added as folders @ the root of your Dropbox account (great for a dedicated Dropbox account). If you select "App folder" all folders/files will be stored under a single folder (avoid the mess in your Dropbox account).

 


Then you're almost done, your app is created and you got your App key and secret

3.2 Login to Dropbox in WP File Download

Then go back in WordPress admin and click on the menu WP File Download > Configuration > Cloud connection tab > Dropbox settings. Paste your

  • App key
  • App secret

Then save the configuration and click on the Dropbox connection button

You'll have to validate the access authorization for app access, just click allow.

Finally, an authorization code will be generated and you'll have to copy it in WP file download configuration

 The connection should be a success ☺ Then you can create folders, subfolders in Dropbox and in WP File download, everything will be sync!

new-category-cloud

3.3 How it works? What can I do with Dropbox?

How does it work? 

Dropbox can sync folders/subfolders and files on your WP File download interface and the same is possible on the other way (from WP File download to Dropbox).

What are the sync directions?

It works in both directions! You can add a file from Dropbox and see it WP File Download or add a file in WP File Download and see it in Dropbox. It also means you can manage WP File Download files from your desktop using Dropbox sync software. That’s crazy! Yes we know ☺

wpfd-dropbox-cat

IV. ONEDRIVE INTEGRATION

4.1 Microsoft OneDrive Application

The OneDrive integration is distributed as a separate Add-on. You need to install this add-on (plugin) additionally to WP File Download. The addon includes integration for Google Drive and Dropbox too.

First, you need a Microsoft App to connect your website to a OneDrive account. Go to: https://apps.dev.microsoft.com/login and create a new app.

Then set up an app name and click on: Add platform > Web button

Next copy your website URL into the redirect URLs field e.g: "https://localhost/wordpress_4.7/wp-admin/plugins.php" and then hit Save.

Then you're almost done, the password is missing only. Hit the button: Generate New Password.

A password is generated right away and opened in a lightbox, make a copy.

 

4.2 Login to OneDrive

Then go back in WordPress admin and click on the menu WP File Download > Configuration > Cloud connection tab > Onedrive settings. Paste your

  • App ID
  • Password

Then save the configuration and click on the OneDrive connection button

You'll have to validate the access authorization for app access, just click Yes.

The connection should be a success ☺ Then you can files folders, subfolders in OneDrive and in WP File Download, everything will be synchronized!

Note: WP File download addon does not support Business account

V. SOCIAL LOCKER

5.1 Social locker configuration

WP File Download Social Locker will lock your files download behind a set of social buttons unless the visitor likes, shares the content on Facebook or tweets your page. It helps to improve the social performance of your website, get more likes/shares, build quality followers and attract more traffic from social networks. The addon also includes the features: Google drive and Dropbox file and folder synchronization.

From the plugin configuration you can activate the social locker: WP File Download > Configuration > Social locker tab

social-locker-tab

 

Facebook Locker

Facebook locker: lock file download with a Facebook share or like.
FB locker option: share a page URL or like your Facebook page to unlock.
The Facebook like locker can be activated right away it does not require any App.

To enable the social locker, you need to create a Facebook App. In order to create a Facebook App ID, you can access here: https://developers.facebook.com
First, you need to Register.

Then, you can create your new App ID.

Finally, copy and paste the code to Facebook App ID

The other options are:

  • Force share Url: force an URL for all facebook sharing instead of the current page URL
  • Facebook language: frontend language for social buttons

Twitter Locker

The locker types are:

  • Twitter locker: lock file download with a Twitter tweet or follow
  • Twitter locker option: tweet or follow your twitter to unlock

The other locker options are:

  • User to follow: set an URL of your Twitter profile (for example https://twitter.com/JoomUnited)
  • Force URL to tweet: force an URL for all Twitter sharing instead of the current
  • Tweet: default tweet content, default content, can be edited by user
  • Via: add the screen name of the user to attribute the Tweet
  • Session duration (sec): when a file is unlocked, determine how long the user will be able to download the file without re-sharing it

5.2 Use the Social locker

Then, in order to lock single file or category, you need to switch Lock content by social to YES in the right column when you have opened your file manager.