Authorizing Dropbox (Professional extension)

As PDF Invoices & Packing Slips for WooCommerce – Professional is installed and activated, the new Cloud Storage tab is added via WooCommere > PDF Invoices > Cloud Storage. In order to proceed:

  1. Cloud storage has to be enabled.
  2. Dropbox has to be selected as the Cloud service.
  3. The settings need to be saved.
 1 = Enable cloud storage, 2 = Select Dropbox
 3 = Save changes

Linking account to Dropbox #

Once the changes are saved, a new notice will appear towards the top of the page. This notice requests a valid Dropbox access code be provided.

Dropbox authorization notice

Clicking on the permalink that reads “this link” will lead to a login screen, allowing you to log into dropbox. If you are already logged-into Dropbox, this step will be skipped.

After a successful login, click on the blue “Finish authorization” button.

After clicking the button, the browser will redirect back to the plugin settings, where a successful login will be display login info of the connected account in a section.

This section shows:

  • The name and email address of the logged-in account.
  • The location of the Dropbox folder to which documents will be uploaded.
  • Actions that can be performed for the account. Unlinking the connected account is one of the actions.

Troubleshooting #

Revoke and re-authorize the app #

You may get the following notice:

"Your access token has been retrieved, but the refresh token or the token expiration details are missing. To fix this, please revoke the current permissions for this app following the steps outlined in our revoke and reauthorize documentation. After revoking, reauthorize the application to ensure you receive all necessary tokens for full functionality."
  • Fix this by going to the Dropbox connection dialog box at WooCommerce > PDF Invoices > Cloud storage.
  • Check the ‘Delete refresh token on unlinking‘ option (make it active, set it to true, etc).
  • Click the ‘Unlink Dropbox account‘ button.

CSRF Token issue #

You may get an error that appears as a blank screen with the following text:

CSRF token required

This happens if the connection was interrupted, like refreshing a page while the connection was still being established.
In order to resolve this, you must clear your browser’s cookies. This process may be different per web browser.

How to clear browser cache: #

Non-active license #

Active plugin license — Plugins Menu

 If the Professional extension license has not been activated on the WordPress installation, the notice will instead be a warning that must be resolved, in order to proceed.

The message reads:

Activate your Professional extension license!

To keep Dropbox API limits under control, you are required to activate your Professional extension license to use this service. See how to activate your license here, or clear the cache here. 
 License activation warning

License cache #

If for some reason the license has been successfully activated on the site like in the image above, yet the activation notice will not disappear, then the Professional extension license cache needs to be cleared.

Path: WooCommerce > PDF Invoices > Advanced > Tools > Clear extensions license cache.

Extension License Cache cleared with success!

Access code validity #

Upon authorizing access to Dropbox, an access code is generated. This code is only usable once. This means that each time the linked Dropbox account is unlinked, a new access code will need to be generated.

Plugin conflicts #

Plugins that manipulate the behavior of Admin Notices need to be deactivated in order to see the Dropbox authorization notice.

Admin notice hidden by conflicting plugin

A known conflicting plugin is:

  • Hide admin notices by Rémi Leclercq
Some plugins that manipulate the WordPress admin notices Collapse