Skip to main content

WP File Download Addon: Dropbox Integration

1. Login to Dropbox in WP File Download

Automatic mode

From now, you can save a lot of time while connecting to the Dropbox server. First, to use this feature, you have to link your JoomUnited account at Menu Settings > General, please click on the WordPress settings link if you have not connected.

 

unconnected-dropbox

 

Then go back to the settings and just click on Connect Dropbox button on the right corner.

 

automatic-dropbox

 

Then follow the next steps to finish the connection.

 

auto-dropbox-connected

 

Manual mode

With the credentials in the previous step, please go to WordPress admin and click on the menu WP File Download > Configuration > Cloud Connection tab > Dropbox settings section. Paste your

  • App key
  • App secret

Then save the configuration and click on the Dropbox connection button.

 

reconnect-dropbox

 

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

 

allow-dropbox-app

 

The connection should be a success ☺ If the selected access type is Full Dropbox, then you can select a root folder where files will be uploaded.

 

select-root-folder

 

Simultaneously, you will see the "Watch changes from Dropbox" button. In order to use this feature please add the URL in the warning message to {your App name} > Settings tab at Step 3:

e.g: https://{your-domain}/wp-admin/admin-ajax.php?action=dropboxPushListener

 

webhook-url

 

Then in the WP File Download setting, click on "Watch changes from Dropbox" button to activate the option. If you turn off, Files and Folders will not be synchronized immediately from Dropbox to your WP File Download.

 

watch-changes-dropbox

 

Then you can create folders, subfolders in Dropbox and in WP File download, everything will be sync!

 

create-dropbox-cat

 

Update from Dropbox v1 API to v2 API version

Due to a major change in the Dropbox API on 19 February 2022 the Dropbox apps previously created require an update to the API v2 to work again. If your app was created recently before the date mentioned or you used the automatic connector (you didn't create a custom App), there are chances you just need to logout/login to resolve the issue.
If not, you should follow these steps to move your data from the old Dropbox app to a new app.

 

Option 1: Continue to use your old Dropbox App

Case 1: You used automatic connector

This is the easiest scenario. Just open the plugin Settings > Cloud connection > Dropbox and Disconnect/Reconnect from your Dropbox account to resolve the issue.

 

cloud-connection

 

Case 2: You used a custom Dropbox App created recently

Please try to add Authorized redirect URIs in Dropbox settings to your Dropbox App and reconnect the Dropbox account in WP File Download. If it works, that’s all what you need to do.
If this procedure is not working, you should move to the option 2 below.

Add the Authorized redirect URIs under the OAuth 2:

 

token-expired-dropbox

 

And at the Permissions tab, you should set permissions as the image below.  Then you should click on Migrate button.

 

permission-dropbox-setup

 

Then reconnect the App from WP File Download settings

 

reconnect-dropbox

 

Option 2: Connect a new Dropbox app and move files

Step 1. You should create a new Dropbox App and connect your Dropbox account from the WP File Download settings. Please follow these steps detailed in the chapter 1 from this documentation to proceed.

 

create-app

 

Step 2. Move your Dropbox files and resynchronize

After connecting your new Dropbox App to your WordPress website, you should move all folders and files from the old App root folder in Dropbox. Just drag'n drop all your folders under the new folder used by the new app.
Then wait for the full synchronization, depending on the amount of data it may take a while.

 

new-app-file-move

 

2. How does it work? What can I do with Dropbox?

How does it work? 

WP File download will generate a root folder on your Dropbox.

 

 

All the folders and sub-folders added in WP File Download will be synchronized under the root folder. And vice versa, all your files and categories from that root folder on Dropbox will be synchronized to your WP File Download dashboard on Wordpress.

What are the sync directions?

It works in both directions! You can add a file from Dropbox and see it in 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

 

3. 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 and OneDrive 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. 

 

create-dropbox-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.

 

app-create-dropbox

 

At OAuth 2 section, paste the Redirect URl from WP File download Dropbox settings on the Redirect URls field, then click Add button. The URl should be like this: "https://joomunited.com/wp-admin/admin.php?page=wpfdAddon-dropbox&task=dropbox.authenticate"

 

redirect-url-dropbox

 

And at the Permissions tab, you should set permissions as the image below.

 

permission-dropbox-setup

 

Remember to click on Submit button at the bottom to save the settings.

Note: WP File Download permission is not inherited from Dropbox's permission.