Hello there!

Requirements

• WordPress 5.3+
• At least PHP 7.4 with cURL extension. PHP 8.0 compatiable

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

Multi Site / Network

The plugin does support WordPress Multi Sites. You can activate the plugin on network level or on the sub sites individually.

When you have activated the plugin on network level, you can link the plugin to multiple accounts. In that case, each sub site will have access to the accounts that are linked in the network configuration. You can also link the plugin to multiple Drive accounts per sub site when you haven't linked the plugin on network level.

Please keep in mind that 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.

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!

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

Licensing

Envato Market is the only exclusive distributor for the WP Cloud Plugins.

The Envato Market offers Regular Licenses and Extended Licenses for the plugin.

The Regular License is the most common type of licensing. 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.

Regular License vs Extended License

You will need an Extended License when the plugin is used on a section of your site which is accessible by paying users (e.g. via memberships, subscriptions, product purchases, etc...). If the plugin is only used on a free accessible section on your site, a Regular License is the one you are looking for.

Which license for Single site, multiple site, unlimited sites?

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.

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)
   -> Separate licenses
   
   
2. When the subdomain (shop.organization.com) is just part of the main domain (.organization.com)
   -> A single license
   
   
3. When the plugin is used both on a live site (.organization.com) and its development/staging environment (localhost, dev.organization.com, etc)
   -> A single license
   
   
4. When you want to use the plugin on multiple domains (a-organization.com and b-organization.com)
   -> Separate licenses
   
   
5. The plugin is used on a section of your site which is only accessible after paying (memberships, subscriptions, product purchases, etc...)
   -> Extended License

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

Link an OneDrive Account

After you have activated the plugin, you can link multiple Cloud accounts to the plugin:

1. Go to [Share-one-Drive] -> [Settings] in the WordPress Admin Dashboard on your website
2. Click on the "Add account" button
3. A new window will open and you will be redirected to the login page of OneDrive
4. Click on the "Allow" button to authorize the plugin to access your data
5. Wait while the authorization is processed
6. Done!

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. Open the WP Cloud Plugin section and add a the plugins block
3. Adjust the configuration in the panel on the right by pressing the 'Edit via Shortcode Builder' button
4. Publish or Update the page and you are finished!

Add shortcode via Divi Page Builder

1. Create a new Page/Post or edit an existing one.
2. Add the plugin block
3. Adjust the module in the configuration panel by pressing the 'Configure module' button or by editing the raw shortcode
4. Publish or Update the page and you are finished!

Add shortcode via Elementor

1. Create a new Page/Post or edit an existing one.
2. Open the WP Cloud Plugin section and add a the plugins block
3. Adjust the configuration in the panel on the right by pressing the 'Edit via Shortcode Builder' button
4. Publish or Update the page and you are finished!

Add shortcode via Beaver Builder

1. Create a new Page/Post or edit an existing one.
2. Open the WP Cloud Plugin section and add a the plugins block
3. Adjust the module configuration in the panel by pressing the 'Edit via Shortcode Builder' button
4. 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!

Create Direct Links

To add shared links to your documents, follow these steps:

1. Create a new Page/Post or edit an existing one.
2. Press the second 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 of which you want to create a shared link
4. Check the checkbox of the file and press "Insert Link"
5. Publish or Update the page and you are finished!

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!

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

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

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.

Notifications

The plugin can send email notifications when the plugin loses its authorization to one of the cloud accounts, and files are downloaded, uploaded or deleted. The email settings and (HTML) content of the emails can be controlled via this settings page.

Sender settings

Notifications

The following placeholders can be used inside the template fields:

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.

add_filter('shareonedrive_notification_set_template','change_notification_email', 10, 2);

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.

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'

Webhooks

The built in Webhooks function is an easy way to get automated messages based on all events the plugin logs. The plugin can send a JSON object to a by you specified listener URL, containg all information regarding the event that is being logged.

You can enable the Webhook functionality via the Statistics tab under Log Events -> Webhook Endpoint URL.

{
  "total": 1,
  "events": [
    {
      "timestamp": "2022-05-01T00:05:00+00:00",
      "type": "useyourdrive_previewed_entry",
      "description": "John Johnson previewed the file UK Festival Market Report.pdf",
      "data": {
        "entry": {
          "id": "1-y9psKPDJCycz38c2sN_a3lRoO9S",
          "name": "UK Festival Market Report.pdf",
          "mimetype": "application/pdf",
          "size": "2 MB",
          "icon": "https://...",
          "description": "Festival Insights and the UK Festival Awards are proud to release the UK Festival Market Report 2017.",
          "thumbnail": "https://...",
          "preview_url": "https://...",
          "download_url": "https://...",
          "is_dir": false,
          "parent_id": "0By3zfuC9ZTdGZCT1pUd0E",
          "parent_path": "/Path/To/Folder"
        },
        "account": {
          "id": "1030123322434145",
          "name": "Your Account name",
          "email": "[email protected]",
          "image": "https://..."
        }
      },
      "user": {
        "ID": "3",
        "user_login": "John Johnson",
        "user_nicename": "john-johnson",
        "user_email": "[email protected]",
        "display_name": "John Johnson"
      },
      "page": "https://yoursite.com/page"
    },
    {
      "timestamp": "2022-05-01T00:05:01+00:00",
      "type": "shareonedrive_deleted_entry",
      ...
    }
  ]
}

<?php
// Optional: Prevent replay attacks by ensuring this request has been signed
// recently (+/- 5 minutes). The request timestamp is in ms!
$time_difference = abs((time() - intval($_SERVER['HTTP_X_WPCP_TIMESTAMP'])) / 1000);

if ($time_difference > 300) {
  exit('Invalid request timestamp');
}

// Calculate challenge hash by concatenating the request timestamp with the
// webhook secret with a semicolon in between: "timestamp;secret".
// Hash is created with SHA256 encoded as hexdecimal lowercase string.
$secret = 'your_secret';
$challenge = hash('sha256', $req_timestamp.';'.$secret);

// Calculate request body signature using the challenge hash as secret.
// Signature is a HMAC SHA256 hash encoded as hexdecimal lowercase string.
$req_raw_body = file_get_contents('php://input');
$expected_signature = 'sha256='.hash_hmac('sha256', $req_raw_body, $challenge);

// Compare expected with received signature.
$req_signature = $_SERVER['HTTP_X_WPCP_SIGNATURE'];

if ($expected_signature !== $req_signature) {
  exit('Invalid signature');
}

// Finally, parse the JSON request body and process the received events.
$data = json_decode($req_raw_body, true);

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.

Content

Use the Content 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.

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

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.

Advanced

Exclusions

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

Upload Box

Add a standalone Upload Box which allows your visitors to upload documents to a by you selected folder. You can prefix the file name of the uploaded file and also dynamically set a folder location.

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.

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

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.

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

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!

Advanced Custom Fields (ACF)

Use the Advanced Custom Fields plugin to take full control of your WordPress edit screens & custom field data. The ACF integration of the plugin allows you to select files and folders in the cloud to your pages and posts! Use the get_field() function to get access to the metadata of the items to display this in any theme template file.

1. Create a new Field Group ([Custom Fields] -> [Add New]) or open an existing one
2. Add a new field, and select the field type [WP Cloud Plugins] -> [Google Drive items]
3. Select which data should be returned for the get_field() function
4. Select in the Location section where the Field Group should appear
5. Save the Field Group
6. Done! You can now add file/folder information via the edit screens

Fluent Forms Integration

Do you want more flexibility than the Upload Form that is included? The plugin seamlessly integrates into the Fluent Forms plugin allowing you the create the perfect form! To add the plugin in your form, follow these instructions:

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

WPforms Integration

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

1. Create a new Form ([WPForms] -> [Add New]) or open an existing one
2. Open the WP Cloud Plugins Fields tab
3. Drag the plugins form element to your form
4. Open the details of the newly added form element
5. Click on the "Open Shortcode Builder" 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
9. Done!

Formidable Forms Integration

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

1. Create a new Form ([Formidable] -> [Forms] -> [Add New]) or open an existing one
2. Open the Add Fields tab
3. Drag the plugins form element to your form
4. Open the details of the newly added form element
5. Click on the "Open Shortcode Builder" button on the Advanced tab
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
9. Done!

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!

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!

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.

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.