EDocman Dropbox plugin

The Edocman - Dropbox plugin allows you to integrate Edocman with Dropbox. As you know, Dropbox is a service that keeps your files safe, synced, and easy to share. Bring your photos, docs, and videos anywhere and never lose a file again. So, there are many benefits to storing Edocman documents on the third party storeages like Dropbox. It will help you reduce the used memory of server, the documents will be store safely.

Edocman Dropbox integration only works with PHP 8.1 or higher.

How to setup

You should go to Extensions -> Plugins to filter "Edocman - Dropbox plugin" and enable it.

The Dropbox plugin works based on Dropbox API. So you should create the Dropbox Application to get Application Key, Secret and Access token. To create the Dropbox Application, please following these steps:

  1. First of all, access your account, specifically in the reserved area where you can configure an App, from this address: https://www.dropbox.com/developers/apps/create

  2. Click on “App console” in the left menu and then select “Dropbox API app”. Set the various options like shown in the image (click to enlarge it), give a name to the App and click on Create app button.

  3. Enable the Following Permissions
    To allow Edocman to upload files, create folders, delete folders/files, and copy files, make sure you check (enable) these permissions:

    • files.content.write (Allows the app to upload, modify, move, or delete files and folders.)
    • files.content.read (Allows the app to read file content and metadata.)
    • files.metadata.write (Allows the app to create, move, and delete folders and files.)
    • files.metadata.read (Allows the app to read file and folder metadata.)

  4. After creation, you will see your App information, including the App key (client_id) and App secret.

  5. Get the Authorization Code:

    • To obtain a refresh token, you first need to get an authorization code.
    • Open your browser and navigate to the following URL (replace API_KEY with your actual App key): https://www.dropbox.com/oauth2/authorize?client_id=API_KEY&response_type=code&token_access_type=offline
    • For example, if your App key is abc123, the link will be: https://www.dropbox.com/oauth2/authorize?client_id=abc123&response_type=code&token_access_type=offline
    • Log in to Dropbox if prompted, and allow access to your app.
    • After granting access, Dropbox will display an authorization code. Please copy this code and enter it, along with your API Key and Secret Key, into the corresponding fields in the Edocman Dropbox plugin form.
    • Edocman will then automatically obtain the Refresh Token based on the information you have provided, so you do not need to manually find or enter the Refresh Token yourself.

Plugin Parameters

PropertyDescription
App Key Dropbox Application key.
App Secret Dropbox Application secret.
Authentication Code This code can be retrieved by running link: https://www.dropbox.com/oauth2/authorize?client_id=API_KEY&response_type=code&token_access_type=offline. Replace API_KEY by your Application key
Refresh token This value will be updated automatically, you don't need to enter anything in this parameter
Root foler (Dropdox/Edocman) When you publish the plugin, Edocman will create one directory called Edocman in your Dropbox directory. In default, all documents will be stored within this folder. But you can create sub-folder of directory Edocman and make it to become main folder of Edocman extension on Dropbox. For example, you can enter: /edocment1

If your turned on the Configure option: Use Herachical Folder Structure, when creating categories, you can specify the folder where documents from this category will be stored, and Edocman-dropbox plugin will create that folder on your Dropbox account. Of course, it should be the subfolder of Root folder


When you turn on this plugin, the documents will be uploaded into your Dropbox account through 2 ways: Single upload and Ajax upload. The Bulk upload doesn't work in this case.


When you delete documents from Edocman, the document files on Dropbox will be removed too.