Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Dropbox Importer Addon

Share This Post!

Are you an avid user of Dropbox and want to connect Envira Gallery with your Dropbox images? The Dropbox Importer Addon for Envira Gallery connects to two perfectly. This doc details how you can import images from your Dropbox account, straight in to your Envira Galleries.


Please follow our instructions on how to install and activate addons.

In this instance, you’ll be activating the Envira Dropbox Importer Addon.

Once the Addon is activated, you’ll need to authenticate Envira Gallery with Dropbox.

Navigate to the WordPress Admin » Envira Gallery » Settings page. Then select the Dropbox tab, followed by the Get Code button.

To begin connecting your Dropbox account select the Get Code button.

A Dropbox screen will open for you to login and then select the Allow button.

You'll be asked to authorize Envira Gallery by Dropbox.

Next, copy the authorization code provided by Dropbox.

After Authorizing Envira Gallery you'll be given an authorization code.

Finally, return to the WordPress Admin » Envira Gallery » Settings » Dropbox tab and paste the code into the provided field, then select the Save button.

Select the Save button after pasting the authorization code provided by Dropbox to finish connecting your account.

If successful, you’ll see on screen confirmation of successful authentication with Dropbox.

Once your Dropbox account is successfully connected with Envira Gallery a confirmation of this will appear.


First, create a new or edit an existing Gallery.

Second, click the Select Files from Other Image Sources button.

Select Files From Other Sources button will provide additional ways you can add images and videos to your gallery.

Third, select the Insert from Dropbox link in the left sidebar to view available files and directories.

Select the Insert from Dropbox option to begin adding images from your Dropbox account.

Then select the image(s) you would like to include in your Gallery. You can also click on folders to then select images within folders and sub folders.

Finally, once you have selected the image(s) you want to add, select the Insert into Gallery button.

Once you've selected the Dropbox images you want to add to your gallery, select the Insert button.

After your images have been successfully added to your gallery you’ll see them in the Images tab while editing your gallery.

Images added from Dropbox will appear in the Images tab when editing your gallery.


A: Envira Dropbox Importer requires that you grant Envira read only access to all images in your Dropbox account.


A: No, Envira Dropbox Importer only allows you to import images from Dropbox into WordPress Media Library.


A: There are several ways to improve the successful and quick browsing of your directories.

  1. Navigate to the Dropbox tab at Envira » Settings and make sure that the option for showing thumbnails is unchecked. While it’s nice to see a preview of the image, in large galleries, this can cause issues in performance.
  2. If a directory has a large number of images, it will also significantly slow the process. You may want to consider reorganizing your images into separate folders in Dropbox. This will allow Envira Dropbox Addon to work more quickly for your convenience.
  3. If the above doesn’t resolve the issue, check to make sure that you do not have a large image file (100MB+) in the directory that you are viewing.

A: This is most likely a large image file. Dropbox doesn’t allow thumbnails of images over 20MB in size.


A: There are some limitations. Files over 20MB may take longer or fail with the [object Object] error. In some cases, it may resolve the issue to add the following to your wp-config.php in the main WordPress installation directory:

define('WP_MEMORY_LIMIT', '500M');
define('WP_MAX_MEMORY_LIMIT', '500M');

Before adding this, check with your host about any memory restrictions that they may have.


Developers

Filters

FileFilter NameArguments
/includes/global/common.php
 envira_dropbox_importer_tmp_dir_pathapply_filters( 'envira_dropbox_importer_tmp_dir_path', $dir, $destination )
 envira_dropbox_importer_tmp_dir_urlapply_filters( 'envira_dropbox_importer_tmp_dir_url', $dir, $destination )
 envira_dropbox_importer_thumbnails_dir_pathapply_filters( 'envira_dropbox_importer_thumbnails_dir_path', $dir, $destination )
 envira_dropbox_importer_thumbnails_dir_urlapply_filters( 'envira_dropbox_importer_thumbnails_dir_url', $dir, $destination )

Actions

FileAction NameArguments
/includes/admin/settings.php
 envira_gallery_settings_dropbox_importer_tab_noticedo_action( 'envira_gallery_settings_dropbox_importer_tab_notice' )

Changelog

1.1.8 (2017-06-27)

  • Updated: Uses new Dropbox v2 API. Note: must re-connect with Dropbox API.
  • Added: Option to turn on/off thumbnails.

1.1.7.1 (2016-11-03)

  • Fix: Cases where image titles with apostrophes break image
  • Fix: Various minor bug fixes

1.1.7 (2016-04-16)

  • Fix: Prevent success / error notices on Settings screen from jumping

1.1.6 (2016-03-17)

  • Refactored code for "Insert from Other Image Sources” for better performance
  • Added: Better error reporting on import routine

1.1.5 (2016-03-03)

  • Fix: HTML characters on authorisation notices wrongly encoded

1.1.4 (2016-02-25)

  • Updated: Spanish Translations

1.1.3 (2016-01-14)

  • Fix: Display error message if search fails

1.1.2 (2015-12-23)

  • Updated: Spanish translations

1.1.1 (2015-12-10)

  • Updated: Spanish Translation
  • Fix: Display errors when inserting instead of throwing JS error

1.1.0 (2015-12-03)

  • Added: Compat with Envira Gallery 1.4.0+ new media view / selection tool
  • Added: Spanish translation

1.0.2 (2015-11-19)

  • Fix: Compat with BackupBuddy backups

1.0.1 (2015-10-07)

  • Fix: Set URL as image when importing image from Dropbox, so that it works in Lightbox mode

1.0.0 (2015-10-29)

  • Initial release of the addon.
Share This Post!