Hello there!

Congratulations with the huge win which you are going to experience once you start using our amazing Share-one-Drive plugin which will save you tons of time!

  Let's get Started!

Getting Started

Requirements

  • WordPress 4.8+
  • At least PHP 5.5 with cURL extension
info_outline
If you are not sure which PHP version your website is running or if the cURL extension is enabled, install the WordPress phpinfo() plugin.
lightbulb_outline
Running PHP 7.x will increase the loading performance of the plugin and your site in general. Check your web host configuration panel if it is possible to upgrade your php version!

Plugin Installation

The Share-one-Drive installation doesn't differ from any other plugin installation process, so you might be familiar with this process already. If not, please follow instructions below.

  1. Login to WordPress Admin Dashboard on your website
  2. Go to [Plugins] -> [Add New]
  3. Click on the "Upload" button
  4. Browse to the plugin's zip file (it is the same archive you've downloaded from CodeCanyon) and choose that file.
  5. Click on the "Install Now" button
  6. Wait while plugin is uploaded to your server
  7. Click "Activate Plugin" button


warning
Can't you install the plugin and are you seeing The link you have followed has expired? Find solutions in this FAQ article: FAQ: I can't install the plugin: The link you have followed has expired
warning
Are you seeing the meessage Error: Cannot create the cache directory ... , or it is not writable? Please take a look at this FAQ article: FAQ: Cannot create the cache directory

Plugin Activation

After you have installed the plugin, it is necessary to activate your copy. This will enable the plugin settings and allows you to have direct access to the latest updates and to get support. In order to activate the plugin please follow these steps:

  1. Go to [Share-one-Drive] -> [Settings] in the WordPress Admin Dashboard on your website
  2. Click on the "Activate" button
  3. A new window will open and you will be redirected to Envato
  4. Click on the "Approve" button to activate the plugin
  5. Wait while the activation is processed
  6. Done!



warning
Is the activation not working? You can manually insert your purchase code by clicking on the 'Or insert your purchasecode manually and press Activate' button.

Plugin Updates

The plugin offers an automatic WordPress update mechanism. To use the automatic update option you must have license for the plugin and the plugin should be activated. When new version of the plugin will be available, you should click "Update now" link under the plugin on the WordPress Admin Dashboard - Plugins page.

It is also possible to update Share-one-Drive manually, to perform it please follow these steps.

  1. Go to our Updates Page
  2. Insert your purchase code, select the right plugin and press the "Download" button
  3. Login to WordPress Admin Dashboard on your website
  4. Go to Plugins page, deactivate the plugin and press uninstall. (your settings will be temporarily stored in the WordPress Database)
  5. Follow the Plugin Installation instructions to install the new version

file_download   Download latest Package

Licensing

Regular License is the most common type of licensing for Share-one-Drive. The regular license allows you to use the item in one single end product which end user is not charged to access or use. You can acquire regular license for your own website, or if you are a developer - for one client by transferring the license to your client when the project is finished.

The Licenses only covers the usage in one end product, which means that you will need a separate license for each site when the sites contain a different end product.


Example

  1. When the main site is a global site (.organization.com) for a organization and the subdomains are used by the local departments (newyork.organization.com, london.organization.com) you will need separate licenses.

  2. When the subdomain (shop.organization.com) is just part of the main domain (.organization.com) you only need 1 license.,

In order to read more about Regular license please visit CodeCanyon.

info   License Details

Usage

Shortcode Builder

Adding Share-one-Drive has never been easier! Although it has an impressive number of options, even beginners will manage to implement the plugin to their wishes with our intuitive workflow. A more detailed explanation of all the options in the Shortcode Builder can be found in this document.

Add shortcode via the Gutenberg Editor
  1. Create a new Page/Post or edit an existing one.
  2. To open the Shortcode Builder, add a Classic Block to your content, and press the first Share-one-Drive button in the toolbar of the Classic Block.
  3. Adjust the shortcode in the Shortcode Builder via all the controls and options
  4. Press the "Insert Shortcode" button, to add an instance to your Page
  5. Publish or Update the page and you are finished!



Add shortcode via the Classic Editor
  1. Create a new Page/Post or edit an existing one.
  2. To open the Shortcode Builder press the first Share-one-Drive button in the toolbar of the Classic Block.
  3. Adjust the shortcode in the Shortcode Builder via all the controls and options
  4. Press the "Insert Shortcode" button, to add an instance to your Page
  5. Publish or Update the page and you are finished!



info_outline
When you are using a 3rd party Page Editor, adding a simple Text Component / Text Block will in most cases give you access to the default MCE Editor with the plugin Shortcode Builder.
info_outline
The plugin has a standalone Shortcode Builder for situations where the Page Editor can't be used. Open it via the [WP Admin Dashboard] -> [Share-one-Drive] -> [Shortcode] menu.

Embed Documents

To embed single documents on your page, follow these steps:

  1. Create a new Page/Post or edit an existing one.
  2. Press the last Share-one-Drive button in the toolbar of the Page Editor. If you are not seeing the button, make sure that you are in the 'VISUAL' mode of the Page editor.
  3. Navigate to the File which you want to embed
  4. Check the checkbox of the file and press "Embed Files"
  5. Publish or Update the page and you are finished!

Global Options

All main plugin options can be set via the Share-one-Drive menu page. Most settings will speak for themselves but some others might need some additional information.

Private Folders

Private Folders allow you to link specific WordPress users to specific folders in the cloud. There are two ways you can use this feature: Manually and Automatically. In the Manual mode, you will link your WordPress Users to their own folder on your OneDrive by hand. In the Automatic mode, you let the plugin automatically manage the Private Folders.


Global settings automatically linked Private Folders


warning
The following settings are only used for all shortcodes with automatically linked Private Folders

Setting Description
Create Private Folders on registration After a new user has been created automatically create a user specific folder using in the shortcodes with the Private Folders feature enabled.
Create all Private Folders on first visit Create a all Private Folders automatically the first time the page with the shortcode is rendered. Creating folders takes around 1 sec per user, so it isn't recommended to enable this when you have tons of users.
Update Private Folders after profile update Update the folder name of the user after they have updated their profile.
Remove Private Folders after account removal Remove the specific Private Folders of an user after is deleted.
Name Template Template used when a Private Folder for an user is created. This template can contain several placeholders like %user_login%, %user_email%, %display_name%, %ID%, %user_role%, %jjjj-mm-dd%. If you want to be able to send notifications to the owner of this folder the template should contain %user_email%.

Private Folders in WP Admin Dashboard


The Private Folders feature can also be used in the File Browsers in the WordPress Admin Dashboard. To enable this, go to the tab called 'Private Folders' on the main plugin settings page (Share-one-Drive -> Settings). The behavior of the File Browsers in the Admin section can be changed via the setting "Private Folders in WP Admin Dashboard".


Advanced

Setting Description
"Lost Authorization" notification If the plugin somehow loses its authorization, a notification email will be send to this email address.
Own OneDrive App For an easy setup, the plugin is using its own OneDrive App. If you want to use your own OneDrive App, please read the extra instructions.
  Create own App
Business Accounts | Scope shared-links Who should be able to access the links that are created by the plugin? If set to Public the links will be accessible by anyone. Within Organization will make links accessible within your organization only. Anonymous links may be disabled by the tenant administrator.
Business Accounts | Google Doc Viewer In some occasions the API will not be able make a preview of a document while the Google Doc Viewer is able to create one. Or, if the User does not have Download permissions, the Google Doc viewer can provide a Preview Only view.
Name Template Template used when a Private Folder for an user is created. This template can contain several placeholders like %user_login%, %user_email%, %display_name%, %ID%, %user_role%, %jjjj-mm-dd%. If you want to be able to send notifications to the owner of this folder the template should contain %user_email%.
Load Javascripts on all pages By default the plugin will only load it scripts when the shortcode is present on the page. If you are dynamically loading content via AJAX calls and the plugin does not show up, please enable this setting. It will force the plugin to loads its scripts on all your pages. No worries about loading performances, as the files will automatically be cached by your browser once loaded.
Enable Font Awesome Library v4 compatibility If your theme is loading the old Font Awesome icon library (v4), it can cause conflict with the (v5) icons of this plugin. If you are having trouble with the icons, please enable this setting for backwards compatibility. To disable the Font Awesome library of this plugin completely, add this to your wp-config.php file: define('WPCP_DISABLE_FONTAWESOME', true);
Enable Gzip compression Enables gzip-compression if the visitor's browser can handle it. This will increase the performance of the plugin if you are displaying large amounts of files and it reduces bandwidth usage as well. It uses the PHP ob_gzhandler() callback.

info_outline
Please use this setting with caution. Always test if the plugin still works on the Front-End!
Nonce Validation The plugin uses, among others, the WordPress Nonce system to protect you against several types of attacks including CSRF. Disable this in case you are encountering a conflict with a plugin that alters this system.

info_outline
Please use this setting with caution! Only disable it when really necessary.
Shortlinks Shorten the shared links created by the plugin. The Shorten APIs of Shorte.st, Rebrandly and Bit.ly are supported

Integrations

ReCaptcha V3

reCAPTCHA protects you against spam and other types of automated abuse. With this reCAPTCHA (V3) integration module, you can block abusive downloads of your files by bots.


Video Advertisements (IMA/VAST)

The mediaplayer of the plugin supports VAST XML advertisments to offer monetization options for your videos. You can enable advertisments for the complete site and per Media Player shortcode. Currently, only Linear elements using MP4 are supported.

There are quite some providers that can be used to create your Ad campaigns and to get a VAST XML url. You could for instance use DoubleClick/Google Ad Manager. You can read more about that in the Google Ads Help center.

  Google Ads Help

Setting Description
VAST XML Tag Url Example: https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast&unviewed_position_start=1&cust_params=deployment%3Ddevsite%26sample_ct%3Dskippablelinear&correlator=
Enable Skip Button Allow user to skip advertisment after after the following amount of seconds have elapsed

Notifications

The plugin can send email notifications when files are downloaded, uploaded or deleted. The subject and (HTML) content of the emails can be controlled via this settings page.

The following placeholders can be used inside the template fields:


Placeholder Description
%site_name% Site title as set on the WordPress General Settings page
%number_of_files% Number of files (int) which are processed for this notification
%user_name% Name of the user that executes the action
%user_email% Email of the user that executes the action
%admin_email% Administration Email Address as set on the WordPress General Settings page
%file_name% File name
%file_size% File size in a readable format
%file_icon% Simple mimetype file icon
%file_relative_path% File path relative from the shortcode that is being used
%file_absolute_path% File path starting at the root folder of your account
%file_url% A preview link to the file
%folder_name% Folder name
%folder_relative_path% Folder path relative from the shortcode that is being used
%folder_absolute_path% Folder path starting at the root folder of your account
%folder_url% A preview link to the folder
%ip% IP of the user executing the action
%location% Country/Region/City of the user that executes the action. Use the http://www.geoplugin.net API service

The content of the notification will be added to a global email template which is stored in /templates/notifcations/default_notification.php. Don't edit this file directly as it will automatically be overwritten when updating the plugin. Instead, use the shareonedrive_notification_set_template filter to modify the location of the template that needs to be used.


Example
add_filter('shareonedrive_notification_set_template','change_notification_email', 10, 1);

public function change_notification_email($template_location, $notification){
    return WP_CONTENT_DIR .'/custom_notifications/default_notification.php'
}

Permissions

The Permissions tab controls who has access to which functionality of the plugin. You can use it (e.g.) to prevent specific administrators to access the plugin settings or disable the Shortcode Builder for certain Editors.

You can set permissions for who can

  • change the plugin settings;
  • link users to private folders;
  • see statistics and reports;
  • access the main File Browser;
  • add new shortcodes;
  • add direct links;
  • embed documents.


Statistics

To log all events which are executed by the plugin, Enable the Log Events setting on the Statistics tab. The logged events are accessible via the 'Share-one-Drive' -> 'Reports' menu.




Email summary

The plugin can send an overview of all the events that happend in a certain period. To enable this, the plugin has to log events and Summary Email setting on the Statistics tab should be enabled




The email template is stored in /templates/notifcations/event_summary.php. Don't edit this file directly as it will automatically be overwritten when updating the plugin. Instead, use the shareonedrive_events_set_summary_template filter to modify the location of the template that needs to be used.


Example
add_filter('shareonedrive_events_set_summary_template','change_event_summary_email', 10, 1);

public function change_event_summary_email($template_location, $notification){
    return WP_CONTENT_DIR .'/custom_notifications/event_summary.php'
}


Google Analytics

Is the report functionality of the plugin not sufficient for your situation? The plugin can send all download/upload events to Google Analytics.

If you enable this feature, please make sure you already added your Google Analytics web tracking code to your site. In most themes you will have a Custom Script box where you can add your Google Analytics code

All events in the plugin are registered in Google Analytics as 'Events'. So, in your Google Analytics Dashboard you will find this under 'Behavior' -> 'Events' -> 'Overview'


Shortcode Builder Options

The different plugin views: File Browsers, Galleries, Media Players, Upload Boxes are controlled via shortcodes. The shortcodes can be easily generated via the Shortcode Builder of the plugin which you can find in the WordPress Page Editor. This Shortcode Builder has an impressive number of options which will be explained in this section

General

On the General tab select which View you want to use to display your files. Each view has different options available which will automatically become available in the Shortcode Builder.

Available Views:

View Description
File Browser Display your documents via a File Browser. The File Browser can have Thumbnail or List view and can have an Upload Box attached.
  Demo
Upload Box Add a standalone Upload Box which allows your visitors to upload documents to a by you selected folder
  Demo
Gallery Display your images in a Gallery. The Gallery will be created automatically from a by you selected folder.
  Demo
Audio Player Create an Audio Player shortcode which will automatically build a playlist for the audio files in the by you selected folder
  Demo
Video Player Create an Video Player shortcode which will automatically build a playlist for the video files in the by you selected folder
  Demo
Search Box Basically the same as a File Browser, but will initially only show a Search input field.

Folders

Use the Folders tab to select which folder should be used a 'root' folder for this shortcode. On this tab you can also enable the Private Folder feature which will give users their own folder. You can find this setting in the 'Smart Client Area' section.

Setting Description
Start Folder Select which folder should be used as starting point. Users will not be able to navigate outside this folder. When using automatically created Private Folders, the specific folders will be created inside this top folder.
info_outline
Media files will have a code button behind the file name. Use this button to embed this file directly with a Media Player shortcode.

Smart Client Area

The plugin can easily and securily share documents on your cloud account with your users/clients. This allows your clients to preview, download and manage their documents in their own private folder. Specific permissions can always be set via User Permissions tab.

The Smart Client Area can be useful in some situations, for example:

  • You want to share documents with your clients privately
  • You want your clients, users or guests upload files to their own folder
  • You want to give your customers a private folder already filled with some files directly after they register


Setting Description
Mode Select if you want to link your users manually to their Private Folder or if the plugin should handle this for you.
Template Folder Automatically created Private Folders can be prefilled with documents from a template folder. The content of the template folder selected will be copied to the Private Folder when it is initiatly created.
Full Access By default, Administrator users will have access to the complete top folder and be able to navigate through all Private Folders. When you want other users to be able do browse outside their own Private Folders, you can use this setting
Quota Set maximum size of the Private Folder (e.g. 10M, 100M, 1G). When the Upload function is enabled, the user will not be able to upload when the limit is reached. Leave this field empty or set it to -1 for unlimited disk space.

Layout

On the Layout tab you can select how the shortcode should be rendered.

Sorting

Use the Sorting tab to change the sorting behavior of your documents.

Setting Description
Sort field Select the field that should be used to sort the documents. Values: Name, Size, Date of creation,Date modified, Shuffle
Sort order Select the sorting order of the documents: Ascending or Descending

Advanced

Setting Description
Allow Preview Allow documents to be previewed via this shortcode.
Inline Preview Open preview inside a lightbox. When disabled open in a new window.
Lightbox navigation Navigate through your documents in the preview lightbox. Disable when each document should be shown individually without navigation arrows.
Default on click event Select what should happen when an user clicks on a file in the File Browser: preview it, download it or open it in Onedrive.
Allow Searching Enable the search functionality for the shortcode.
Perform Full-Text search When enabled, the plugin will not only search for file name but also in the meta data of the plugin (e.g. content and description).
Allow ZIP Download Add a Download as ZIP action in the shortcode to download multiple files at once.

info_outline
This setting is only available if the server supports the creation of ZIP packages.
Auto Play Should the Media Player start playing when rendered. Autoplay is generally not recommended as it is seen as a negative user experience. It is also disabled in many browsers.

Exclusions

Use the Exclusions tab when you want to list specific files, folders or extensions only.

Setting Description
Show files with those extensions Add extensions separated with | e.g. jpg|png|gif. Leave empty to show all files.
Show the following files or folders Add files or folders by Name or ID separated with | e.g. file1.jpg|long folder name. Wildcards like * and ? are supported.
Hide files with those extensions Add extensions separated with | e.g. jpg|png|gif. Leave empty to show all files.
Hide the following files or folders: Add files or folders by Name or ID separated with | e.g. file1.jpg|long folder name. Wildcards like * and ? are supported.

Upload Box

The plugin can send email notifications when files are downloaded, uploaded or deleted via the shortcode. The subject and (HTML) content of the emails can be controlled via this settings page.



Setting Description
Allow folder upload Adds an Add Folder button to the upload form if the browser supports it. The plugin will also upload the folder structure.
Overwrite existing files By default, the plugin will auto-rename new uploaded files in case of a conflict. Enable this setting to overwrite the files instead.
Restrict file extensions Add extensions separated with | e.g. jpg|png|gif. Leave empty for no restriction.
Max uploads per session Number of maximum uploads per upload session. Leave empty for no restriction.
Minimum file size Minimum file size (e.g. 1 MB) when uploading files. Leave empty for no restriction.
Maximum file size Maximum file size (e.g. 100 MB) when uploading files. Leave empty for no restriction.

Notifications

The plugin can send email notifications when files are downloaded, uploaded or deleted via the shortcode. The subject and (HTML) content of the emails can be controlled via this settings page.

Setting Description
Download email notification Send a notification when files are downloaded?
Upload email notification Send a notification when files are uploaded?
Delete email notification Send a notification when files/folders are deleted?
Recipients Add email address who should receive the notification. Add multiple address separated by a comma ,. You can also use the following placeholders:

  • %admin_email% => Administration email address as set on the WordPress General Settings page
  • %user_email% => Email of the user that executes the action
  • %linked_user_email%=> Email addresses of users that can access the modified files via their Private Folders
When using %linked_user_email% in combination with automatically linked Private Folders, the folder names needs to contain the email address. You can achieve that by using the %user_email% placeholder in the global Name Template setting.
Skip notification of the user that executes the action Enable if the user that performs the actions shouldn't receive the notification

File Manipulation

By default, the shortcode will only allow users to preview and download files. If you want to allow different actions as well, you can control this on the File Manipulation tab.

The following actions can be enabled additionally:

  • Create shared links
  • Edit descriptions of files/folders;
  • Rename files/folders;
  • Move files/folders to different location;
  • Delete files/folders;
  • Create new folders
  • Edit Office documents

info_outline
Select via User Permissions tab which Users / User Roles are able to perform the allowed actions.

User Permissions

The Permissions tab controls who has access to which functionality of the shortcode. You can use it (e.g.) to hide the shortcode for certain Users or User Roles, or allow specific Users to Upload files.

You can set permissions for the following

  • who can see the shortcode;
  • who can download files;
  • who can upload files;
  • who can share files;
  • who can edit documents;
  • who can edit descriptions;
  • who can rename files/folders;
  • who can move files/folders;
  • who can delete files/folders;
  • who can add new folders.


Advanced Features

Private Folders

Private Folders Front-End

You can easily and securely share documents via OneDrive with your clients with the Private Folders feature. This feature allows your clients to preview, download and upload documents to their own private folder.

There are two ways you can use the 'Private Folders' feature: Manually and Automatically

In the Manual mode, you will link your WordPress Users to their own folder on your OneDrive by hand. This is can be useful in cases when you are already using client folders on your OneDrive, or if you want multiple users to use the same client folder.

To use the Private Folders feature in this mode, follow these instructions:

  1. Go to Share-one-Drive -> Private Folders in the WordPress Admin Dashboard
  2. Link your users to their folder on your OneDrive via the Link to Private Folder button
  3. Go to the Page Editor and open the Share-one-Drive Shortcode Builder
  4. Go to Folders panel and enable the Use Private Folders setting in the Smart Client Area section
  5. In the same section set the Mode to I will link the users manually
  6. Configure any other settings you need and press the "Insert Shortcode" button
  7. Done!

In the Automatic mode, you let the plugin automatically manage the Private Folders. The plugin will automatically link a user to its own Private Folder and it will create the Private Folder if needed in the by you seleted top-level folder. The advantage of this method is that you don't have to manage the folders manually. In this mode you can even select a template folder to fill the Private Folder with some starting material when it is created.

To use the Private Folders feature in this mode, follow these instructions:

  1. Go to the Page Editor and open the Share-one-Drive Shortcode Builder
  2. Go to Folders panel and enable the Use Private Folders setting in the Smart Client Area section
  3. In the same section set the Mode to Let the plugin automatically manage the Private Folders for me
  4. Configure any other settings you need and press the "Insert Shortcode" button
  5. Done!



info_outline
When you want to prefill newly created Private Folders, enable the Template Folder setting (Shortcode Builder -> Folders -> Smare Client Area).
info_outline
 You can control how the plugin is managing the Private Folders. Just take a look at the look at the Private Folders’ tab on the main plugin settings page (Share-one-Drive -> Settings).


info_outline
Via the User Permissions tab in the Shortcode Builder, you can always select what kind of actions (e.g. upload or delete documents) are allowed by your client.

Supported Integrations

WooCommerce Integration

Digital Downloads

Share-one-Drive integrates nicely into WooCommerce and it allows you to serve your Digital Downloads directly from OneDrive! To add a Digital Product from your OneDrive, follow these instructions:

  1. Create a new WooCommerce Product (Products -> Add New) or open an existing one
  2. In the Product Data section, tick the Downloadable checkbox
  3. On the General tab in the same section, click on the "Choose from OneDrive" button
  4. In the new window that opens, click on the File that should be added to your product
  5. Wait till the File is added to your product
  6. Done!


Upload integration

Share-one-Drive allows you to create products where your customers can directly attach their Documents after purchasing. The plugin can create a Order specific folder on the linked Cloud Account and it will add a customizable Upload Box to the order page and the Thank You page. In order to enable the Upload Box for your products, follow these instructions

  1. Create a new WooCommerce Product (Products -> Add New) or open an existing one
  2. In the Product Data section, tick the Uploads checkbox
  3. On the Upload to Cloud tab that appears, enable the "Upload to OneDrive" checkbox
  4. Set in the Title Upload Box the title which should appear above the Upload Box.
  5. Create your own Upload Box via the Build your Upload Box button, or edit the shortcode manually.
  6. In the Upload Folder Name field, set the template which should be used for the Order Specific Folders*.
  7. Save the product!


warning
* In order to use the Order Specific Folders, make sure that the Private Folder feature is enabled in the Shortcode. You can find this settings on the User Folders tab.


Contact Form 7 Integration

Do you want more flexibility than the Upload Form that is included? Share-one-Drive seamlessly integrates into the free Contact Form 7 plugin allowing you the create the perfect Form! To add Share-one-Drive to Contact Form 7, follow these instructions:

  1. Create a new Contact Form ([Contact] -> [Add New]) or open an existing one
  2. Click on the Share-one-Drive button to open the configuration panel of the field
  3. Click on the "Build your Share-one-Drive shortcode" button
  4. In the Shortcode Builder that opens, create the shortcode that you need
  5. Press "Insert Shortcode" to update the shortcode
  6. Insert the Form Field by pressing the "Insert tag" button
  7. Done!
info_outline
You can use the available input fields in your Contact Form to name the upload folder based on user input. To do so, just add the shareonedrive_private_folder_name to the Class attribute of your input field (i.e. [text* your-name class:shareonedrive_private_folder_name]).


Gravity Forms Integration

Do you want more flexibility than the Upload Form that is included? Share-one-Drive seamlessly integrates into Gravity Form allowing you the create the perfect Form! To add Share-one-Drive to your Gravity Form, follow these instructions:

  1. Create a new Gravity Form ([Forms] -> [New Form]) or open an existing one
  2. Open the Advanced Fields tab
  3. Drag the Share-one-Drive form element to your form
  4. Open the details of the newly added form element
  5. Click on the "Build your Share-one-Drive shortcode" button
  6. In the Shortcode Builder that opens, create the shortcode that you need
  7. Press "Insert Shortcode" to update the shortcode
  8. Save the Form by pressing the "Update Form" button
  9. Done!


Gravity PDF Integration

The free GravityPDF plugin allows you to automatically generate, email and download PDF documents with Gravity Forms. Share-one-Drive extends this plugin and allows you to store the generated PDFs directly on your OneDrive.

  1. Download and Install the GravityPDF plugin
  2. Head to [Forms] -> [Forms] and select the Gravity Form you want integrated.
  3. From the form editor page, hover over the Form Settings menu item and select PDF from the sub-navigation. Finally, click the Add New button to create a PDF.
  4. Edit the created PDF template, and go to the Advanced Tab
  5. Set the [ONEDRIVE] Export PDF to "Yes"
  6. In the [ONEDRIVE] Folder ID, set the ID of the folder where you want to store the generated PDF forms. You can find this ID via the Shortcode Builder by pressing the Create Shortcode button.
  7. Press "Update PDF" to save the settings
  8. Done!



Translations

The plugin is multi-language ready, and has a few translations in its package. If needed, you can quite easily translate the plugin by yourself. The plugin decides based on the language setting of your WordPress site, which translation it will load.

An easy way to translate the plugin is by using special WordPress Plugin: Loco Translate.


lightbulb_outline
Part of your purchase costs are gladly refunded in case you send in new translation files. Those new translations will be checked and added in the package for other customers.

Support

Policy

The purpose of the Help Center is to provide you with the right answers at the right time. Our support is provided only for direct product buyers. While applying at our Help Center you will be asked to provide valid purchase code of our products. Our Help Center is the only official support handling mechanism for this plugin. Questions sent using other channels may be ignored without notice. According to Envato rules, support mechanism is not mandatory for marketplace authors - we provide support because of good will and want to offer our customers best service possible. We keep rights not to provide support due to abuse or any other reasons that are against this policy.


What You Can Expect From Our Support?

There are certain things that you can expect from our Help Center:

  • We always have bug-related and technical support in priority
  • We respond to questions or problems regarding the plugin and its features
  • We are happy to receive proposals and ideas
  • Tiny custom requests can be served (low priority, depending on workload and good will)

What You Can Not Expect From Our Support?

There are certain things that are out of scope and will not be handled:

  • Generic WordPress questions
  • Issues related to 3rd party plugins
  • Customization requests
  • Any tickets that contain abuse or violence

Thank you for finding time to read this policy and remember that we are here to help you out.
Best wishes!

Pre-Support Actions

Before asking your question, please make sure:

  • You have read the documentation provided
  • Searched the answer within our FAQ articles and the comment section of the product page
  • Make sure you have the latest version installed.
question_answer   FAQ section question_answer   Comments section

Opening Support Ticket

In order to get response in reasonable time we are kindly asking you to provide following information while opening support ticket:

  • Always insert your purchase code for non-presale questions
  • A link to the page where you are having trouble
  • A temporarily(!) WP admin login when you encounter bugs or need help to integrate the plugin in your website. Double check the login credentials before submitting! Seriously.
  • A clear description of the problem and how to reproduce it
  • Screenshot of the problem
  • Add your WordPress Debug Log if you are encountering unexpected issues with the plugin.
  • Any other information that you find useful

All information provided is confidential and will not be provided to any third party.

help   Create a Support Ticket

Release Notes

We are constantly working on a new features and improvements for Share-one-Drive in order to keep your site and your business at the top. In this section you can find information on latest updates we created during lifetime of this plugin.

Date Version Features
1.11 28 November 2019
  • Fix: Bug with authorization tokens when moving plugin location
  • Fix: Bug prevening WooCommerce orders to show up when downloadable files are not longer accessible (e.g. when they are deleted from the cloud)
  • Fix: Prevent version updates to run on initial install
  • Added: Support for linking multiple OneDrive accounts
1.10.3 22 November 2019
  • Fix: Change in API throwed error when showing account information on main options page
  • Fix: Media Player could crash when using WordPress 4.9 or lower
  • Fix: Bug WooCommerce integration when loading 'Thank You' page while no order data is present
1.10.2 19 November 2019
  • Fix: Error when logging events for files without extension
1.10.1 13 November 2019
  • Improved: Generating zip downloads will not longer use memory
  • Improved: Extended Documentation
  • Improved: Minor layout changes
1.10 9 November 2019
  • Fix: Bug in Media Player preventing to stream captions
  • Fix: In French translation distorting main plugin options page
  • Added: Email summary for all activities in a certain period. You can enable this via 'Statistics' -> 'Summary Email' on the main plugin options page
  • Added: New permissions selector allowing you to select both WP Roles and WP Users
  • Added: Support for Chromecast and Airplay in Media Player
  • Improved: New notifications with more filters to modify it. The filter 'shareonedrive_notification' is deprecated and replaced with different 'shareonedrive_notification_...' hooks
  • Improved: The %linked_user_email% placeholder in Notification Recipients can now be used in all shortcodes.
  • Improved: System information tab rebuild.
1.9.6 1 November 2019
  • Added: New setting to enable/disable navigation in Lightbox
  • Added: Support for %linked_user_email% email notification placeholder for automatically linked Private Folders
  • Improved: Move action now has folder selection dialog to send files directly to destination
  • Improved: Filters to show/hide files or folders now support wildcards
  • Improved: Changed Layout of Folders in Gallery mode
  • Updated: MediaElement library to version 4.2.14
  • Updated: Plugin Update Checker to version 4.8.1
1.9.5 30 October 2019
  • Fix: Bug changed layout of submit button on Contact Form 7 forms containing plugin
  • Fix: Gravity Forms submission when Upload Box on last page
  • Fix: Breadcrumbs not rendered properly when navigating deeper than two levels
  • Fix: API 'skipToken' query parameter not working for all OneDrive accounts
  • Added: New setting to enable/disable navigation in Lightbox
  • Added: Support for wpDataTables with Gravity Form submissions containing plugin uploads
  • Added: Support for Gravity PDF allowing you to send your Gravity Form PDFs directly to OneDrive
  • Updated: Font Awesome Library to version 5.11.2
1.9.4 4 October 2019
  • Fix: Bug preventing to update/delete WP Users when using Private Folders feature while plugin isn't longer linked with Cloud Account
  • Fix: WooCommerce Upload box in Back-End Order not starting upload
  • Fix: Upload Box integration in Gravity Forms not working properly on multipages forms
  • Fix: Bug when using multiple Upload Boxes on same Contact Form 7 form
  • Fix: Shortcode Builder buttons not visible in Elementor Text Widget
1.9.3.1 25 September 2019
  • Fix: Bug in WooCommerce Upload integration preventing to create order specific folders
1.9.3 19 September 2019
  • Fix: Plugin stopped can stop working when cache files couldn't longer be updated (WP Engine).
  • Fix: Removed empty < a > anchors from breadcrumbs
  • Fix: Playlist layout on mobile devices
  • Improved: Separate move/rename/delete permissions for files and folders
  • Improved: Changed layout Shortcode Builder
1.9.2 9 September 2019
  • Fix: In case of a Multisite setup, email notifications will now be send to the site administrator instead of the global administrator
  • Fix: Media Player playlist could overflow container
  • Added: New shareonedrive_woocommerce_set_placeholders hook to set custom folder name placeholders for WooCommerce Private Folders
1.9.1 28 August 2019
  • Fix: Mediaplayer throwing javacript error when no media files are present in folder
  • Fix: Download button not accessible in Mediaplayer without playlist
1.9 22 August 2019
  • Added: Mediaeelement.js as default player for media files. Supports Captions via VTT files, IMA/VAST Video Advertising, speed control and more
  • Added: Download menu item for folders
  • Fix: Bug showing header container when no header elements are present
  • Fix: Not updating thumbnails when expired
  • Fix: Added lazy loading for small thumbnails when showing files in the File Browser list-view
  • Improved: Better compatibility when theme is using Font Awesome (v4) icons
  • Improved: Only loading CSS for the plugin skin when required
  • Updated: Font Awesome to version 5.10.1
  • Updated: Language translation files
1.8.16.2.1 15 August 2019
  • Fix: Bug Blueimp File Uploader not adding 'Content-Range' header when uploading files to OneDrive
1.18.16.2 15 August 2019
  • Added: Results for '...' in breadcrumb when showing search results
  • Improved: Lazy loading thumbnails in Lightbox
1.8.16.1 8 August 2019
  • Fix: Elementor Page Builder could crash when loading plugin shortcode
1.8.16 2 August 2019
  • Fix: File Browser not scrollable in Back-End
  • Added: Basic ID3 support for Audio files in Media Player
  • Improved: Responsive breadcrumb navigation using full path
  • Improved: Media Player playlist now supports folder structures
  • Updated: Font Awesome to version 5.10.0
  • Updated: Plugin Update Checker to version 4.7
  • Updated: Blueimp File Uploader
  • Updated: ReCaptcha library to version 1.2.2
1.8.15 26 June 2019
  • Fix: User Folders not properly deleted when WP Account was removed
  • Added: Link to upload folder in Contact Form7 and Gravity Forms
  • Added: Support for sub folders in playlist Media Player
  • Improved: Scroll event triggered after entering a folder
  • Improved: Enabled ZIP download for File Browser in WooCommerce Order detail page for products with Upload Box active
  • Updated: Font Awesome to version 5.9.0
1.8.14.1 10 May 2019
  • Fix: Not able to manually link Users to Private Folders
  • Added: Copy to Clipboard in Social Share popup
1.8.14 8 May 2019
  • Fix: Bug in Report export only exported the rows visible in the viewport. The new export is a complete CSV file
  • Fix: Folder upload didn't create the folder that was selected but only the subfolders inside it
  • Fix: Some PHP versions have trouble displaying the initial dataset for the Activities Graph in Report Dashboard
  • Fix: Bug in the visual Notifications Template Editor not properly saving changes
  • Added: Individual Admin accounts for global plugin permissions (e.g. who can change the plugin settings & see the Back-End File browser)
  • Added: Duration of media files present in the File Browser when this data is available
  • Added: New WooCommerce setting allow you to disable the Upload Form when the order has a specific status (e.g. Completed)
  • Improved: Changed the user name in Report Section to display name and added user ID as column
  • Improved: Some small layout changes
1.8.13 24 April 2019
  • VULNERABILITY: Unauthenticated PHP payload unserialization in processing Ajax Requests (Thanks to @Andrea Buri)
  • Updated: Blueimp File Uploader to version 9.29.0
1.8.12 28 March 2019
  • Fix: Bug preventing to click on submit button when Upload box is located inside a < form > tag
  • Fix: Folders in Gallery cannot be moved when user has permission to do so
1.8.11 19 March 2019
  • Fix: Not adding WooCommerce Notes when user is upload files to order
  • Fix: Uploading empty files not accepted by the OneDrive API
  • Fix: Few PHP 7.x compatibility issues
  • Fix: Bug in Video Player skin didn't always remove pause screen
  • Added: Upload support for folders keeping the folder structure intact
  • Added: ReCaptcha V3 Support
  • Added: Support for .URL file formats
  • Updated: FontAwesome Library to 5.7.2
  • Updated: Auto Updater library to version 4.5.1
  • Updated: Blueimp File Uploader Class
1.8.10 12 February 2019
  • Fix: Bug preventing adding/renaming of files and folders with French accents
  • Added: New setting to disable loading of FontAwesome Library in case there is a conflict with this library (e.g. with the WOffice theme)
  • Added: Button in Report Dashboard to clear all statistics
  • Improved: Only load Contact Form 7 Javascript file when required
  • Improved: Loading performance with multiple Media Players on the same page
1.8.9 19 January 2019
  • Fix: Shuffle sorting order not working properly
  • Fix: Bug in error handling mechanism
  • Added: Minimum upload size setting in the Shortcode Builder.
  • Added: WooCommerce Order notes will be added when new files are uploaded to the order
  • Added: New %wc_order_quantity% and %wc_product_quantity% placeholders for Private Folders name template when files are uploaded to order
  • Added: Added Support for WooCommerce Product Documents
  • Improved: Caching of shortcodes is now more stable on sites with high traffic
  • Improved: Update of the Multi Sites settings page allowing you to set a single OneDrive account when plugin is network activated
  • Updated: Font Awesome to version 5.6.3
  • Updated: Plugin Update Checker to version 4.5
  • Updated: Chart.js library to version 2.7.3
  • Updated: DataTables library to version 1.10.18
1.8.8 9 January 2019
  • Fix: Search function not working properly anymore when linked with a OneDrive Business account due to a change in the OneDrive API (search performance may drop!)
  • Fix: Shuffle sorting order not working properly
  • Fix: New uploaded files didn't always appear immediately in the File Browser
1.8.7 20 November 2018
  • Fix: Bug in the Contact Form 7 validation
1.8.6 7 November 2018
  • Fix: Bug preventing to remove authorization when access was revoked via OneDrive
  • Fix: Bug in Gravity Forms integration preventing IE/Edge/FF users to properly submit form
  • Added: Setting to select custom icon Set
1.8.5 31 Oktober 2018
  • Fix: Bug creating multiple menu's in the Dashboard for non-Administrator users
  • Fix: Not all required code was properly enqueued when using the 'Load Javascripts on all pages' setting
  • Fix: As of WooCommerce 3.4.7 the Downloadable Product URL now requires to have a valid file extension
  • Fix: Search function in the Search Box mode was looking in the complete OneDrive instead of the selected folder (Business Accounts only)
  • Fix: Rewrote API library to prevent conflicts with other API libraries
  • Added: New notification setting which allows you to prevent emails being send to the user that executes the download/upload/delete action
  • Improvement: Updated Google Analytics Event/Tracker code
1.8.4 25 September 2018
  • Fix: Delete action of upload queue trigger new file selection as well
  • Fix: FileBrowser/Gallery Checkbox was checked when previewing file
  • Added: Gutenberg Support via Classic Block
  • Improvement: Added visual feedback when downloading files as ZIP
1.8.3 18 September 2018
  • Fix: Bug in the Rebrand.ly URL Shortener Service when default Workspace was deleted
  • Fix: Conflict getMimeType() function with other plugins
  • Fix: Event Report for search events showing wrong path
  • Fix: Uploads are now processed individualy instead of simultaneously
  • Fix: Shortcode Builder not creating shortcodes when Private Folders feature is set to 'Manual'
  • Updated: Datatables library to version 1.10.18
  • Updated: Font Awesome 5.3.1
1.8.2 17 July 2018
  • Fix: Email tag in Contact Form 7 notification not rendered when Upload Field is required
  • Fix: Setting CURLOPT_HTTPHEADER option for cURL caused problems for some cURL versions
  • Fix: Upload notification didn't always include links to uploaded items
  • Improved: Browser handling when user tries to leave page while uploading files
1.8.1 5 July 2018
  • Fix: Plugin not always returning UTF8 valid characters breaking JSON encoding
  • Fix: Not able to use filenames with special characters
  • Fix: CSS issue when using the Media Player with Full screen
  • Fix: ZIP option visible in Shortcode Builder when server isn't able to generate ZIP files
  • Fix: Gravity Form entries not properly showing the list of uploaded files
  • Fix: Events Dashboard Layout
  • Fix: Upload bug when multiple Upload Boxes are present on the same page
  • Fix: Full Event Report table is now using the default WordPress DB connection
  • Added: Option to enable/disable Event Logs (Statistics -> Log Events)
  • Added: Option to set the click default behavior in the File Browser
  • Added: Direct embedding of single media files via the Shortcode Builder
1.8.0.1 11 June 2018
  • Fix: Javascript bug in the Settings Dashboard
1.8 6 June 2018
  • Added: Contact Form 7 integration
  • Added: New Report Dashboard to track user actions
  • Fix: Several minor bugs
1.7.3 4 June 2018
  • Fix: Preventing conflict with other Blueimp File UploaderHandler classes
  • Fix: Problems caused with multiple Media Player instances on the same page
  • Fix: Bug preventing you to swipe images in Lightbox
  • Fix: Bug not working search button events when another qtip library is present
  • Added: Follow URL shortcuts instead of downloading them
  • Added: New Shortlink services
  • Added: New 'Who can Share' permissions in Shortcode Builder
  • Added: New 'Allow Preview' option in Shortcode Builder.
  • Improved: Slightly reduced the number of Database calls being made
  • Updated: Awesome Font 5 library
1.7.2.2 23 April 2018
  • Fix: Plugin not submitting Gravity Form when custom submit button is used
  • Fix: Shortcode Builder creating shortcodes while no start folder is selected
  • Fix: Media Player not showing playlist properly with multiple instances on the same page
1.7.2.1 12 April 2018
  • Fix: Conflict with Awesomefont v5.0 svg loaders causing the popups to show up in the wrong place
  • Fix: Bug sending multiple notification emails when authorization has been lost
  • Fix: Bug preventing the Gallery to load images lazy
  • Fix: Bug wrong dimensions gallery thumbnails for Business Accounts
1.7.2 11 April 2018
  • Fix: Bug in the List/Grid view switch
  • Fix: Bug preventing to insert/embed files in the TinyMCE Editor
  • Fix: Bug hiding all checkboxes after unchecking the 'Check All' checkbox
  • Fix: Bug hiding the 'no access' container to show up
  • Fix: Bug preventing you to insert new downloadable files in WooCommerce Product
  • Improved: Modal Dialogs on mobile browsers
1.7.1 10 April 2018
  • Fix: Bug preventing upload of multiple documents in Gravity Form when upload is required
1.7 9 April 2018
  • Fix: Conflict with cache plugins occassionaly causes the plugin to crash
  • Fix: Validation bug in the Gravity Forms integration
  • Fix: Parent Folder not always visible when user is able to move files
  • Fix: CSS issue of settings fields in FireFox
  • Added: Shortcode Builder is now accessible via the Admin Menu as well
  • Added: Shortcode setting to show/hide Upload Folder button
  • Added: Shortcode setting to limit the number of uploads
  • Added: Setting to disable nonce validation (causes issues in combination with some User Management plugins)
  • Added: New filter shareonedrive_sort_filelist_settings, shareonedrive_sort_filelist to modify the file sorting
  • Added: WordPress Hook shareonedrive_after_private_folder_added($folder, $processor) which is fired after a new private folder is added
  • Added: New filter shareonedrive_gallery_entry_text to change the file and folder names in gallery
  • Improved: Complete revision of the main javascript file
  • Improved: Uploaded files will now be visible again in Upload Box after a Gravity Form submission fails
  • Improved: Changed shareonedrive_upload hook to filter allowing you to directly modify the uploaded files
  • Improved: Increased loading performance by using LocalStorage
  • Improved: Changed gzcompress() to gzencode()
  • Improved: Lazy Load thumbnails in Lightbox
  • Updated: Awesome Fonts to version 5.0

email   Looking for earlier changes? Ask!