Configuring a campaign to allow file uploads with DriveUploader

If you want to configure a campaign to allow users to upload files, that's now possible using DriveUploader! Using DriveUploader, you can configure a button that users can use to select their file, which will then be uploaded and the URL to the file will be included in the final campaign submission.

To get started, you’ll first need a Pro DriveUploader account. The uploader itself will need the following settings configured:

You should then have an upload URL that looks something like this: https://driveuploader.com/upload/abcdefg/ - Note down the final value after /upload/ (“abdefg” in this case) - You will need this key in Digioh.

And finally, make sure that the API option is enabled for the uploader.

Note: if you want to allow multiple files to be uploaded, please make sure to update the Quantity.

In Digioh, once you have the Campaign created, you can add DriveUploader by:

1. Install the necessary Digioh extension by going to Extensions under the account dropdown.
2. Search for “Drive Uploader” under the Miscellaneous section and install the template.
3. In the campaign itself, on the Button that users will use to select their file add Button Metadata uploader_key : <the key from the upload URL>
4. Still on the button, configure which form field will hold the URL to the file by adding Button Metadata uploader_link : <custom field>: Make sure this field is not in use in any other forms on the campaign.
5. If you want the upload to be required, also add Button Metadata uploader_required : true:
6. You can also add a text element with Element Metadata uploader_file_name : <uploader key> - This will automatically replace any entered text for the element with the file name:

Optional widget-level settings

The following settings are configured as Metadata on the widget itself, not on the button like the settings above.

If you want to have additional upload buttons, you will need a separate Upload URL for each. They will then each be configured the same as above using their respective uploader keys.

Customizing the subfolder source

By default, the extension determines the Google Drive subfolder name by looking for an email address in this order: the widget-level uploader_email_field metadata, the previously set boxapi.email value, or the standard email field on the form.

If your campaign collects the email address in a custom field instead of the standard email field, add widget Metadata uploader_email_field : <custom field> (for example, custom_N) to tell the extension which field's value should be used as the subfolder name. If this is not set, the standard email field is used.

Customizing the required upload error message

When uploader_required : true is set on a button and a user submits without uploading a file, the default error message is "Please upload all the required files". To customize this text, add widget Metadata uploader_required_error_message : <your message> with the error message you'd like displayed instead.

Multiple upload buttons

If you want to have additional upload buttons, you will need a separate Upload URL for each. They will then each be configured the same as above using their respective uploader keys.

Please Note: For testing the new campaign that you've created, you'll need to test live on site - The DriveUploader functionality does not function in Digioh's preview mode.

Any questions? Feel free to email us at support@digioh.com!