Filetrip Documentation


“Filetrip plugin”

Filetrip - Backup, Collect, and Sync Gigabyte files from your website

Last Updated:May 1st, 2016
By: iTechFlare Ltd

Filetrip is a very unique and powerful wordpress plugin that not only help you acquire & manage digital information (Files, Videos, Music, Audio, Documents and Archives), the plugin mainly integrates your website to the cloud and let you sync almost any digital files into the two top cloud storage services available on the internet (Dropbox & Google Drive), where you can almost forward and distribute all of your website Media and acquired digital content to whatever channel you want.



The plugin also provides a complete management features and allow wordpress admins to instantiate unlimited uploaders that connect priori and individually to a specific selected folder through either (Dropbox, or Google Drive) channels or the Wordpress channel with a singleton media folder. Moreover, the plugin is responsive and highly configurable with a contemporary design and native UX animation for swiftness and maximum usability in both backend and frontend.

The plugin by default will add the capability of sending any native Media file to whatever selected cloud channel supporting a maximum size of 1GB per file, where the default targeted cloud folder can be configured from Filetrip settings.

Website owners also will have the privilege of scheduling either complete or specific backup (SQL, Files, and SQL+Files) for their website, in which it can be done manually, or automatically through WP cron jobs. The awsome feature here is that whenever a backup is generated a full configurable automation process of email notification and backup content transmission to either Dropbox, or Google Drive, or both could be configured to be handled gracefully and seamlessly in the background using chuncked upload, letting you easily upload a multi-gigabyte archived backup file.

Features

  • Let you create unlimited frontend uploaders that if it receive approval from administrator, it will be transmitted to whatever pre-selected pre-configured cloud storage (Dropbox, or Google Drive), or Wordpress media as a singleton folder media channel
  • Converts your Media library into a Filetrip compatible, where you can transmit any files with multi-gigabyte of size seamlessly in the background, in which the transmission will handeled even if the user close the transmission window, as the process might take a while.
  • Back up to your own Server
  • Works on Linux and Windows Servers.
  • Schedule automatic backups with cloud storage transmission and email notification capabilities
  • Execute manual backups and transmit them manually to whatever selected channel
  • Responsive layout
  • Upload notification sent through EMail
  • Allow diverse MIME (File Types) that are not natively accepted by Wordpress
  • Isolated media section for review and approve
  • Accept (Documents, Audio, Video, Music, and Archives)
  • Frontend upload preview and delete features for users
  • Responsive design that will make the uploader works with (Mobile, Tablets, and Desktop)
  • Global setting page
  • Cross browser compatibility (IE 9+, Firefox, Chrome, Opera, Safari)
  • Unlimited instantiation of Filetrip uploaders with independent different settings
    • Max upload size
    • Max upload limit per session
    • Customize theme and colors
    • Change uploader's logo
    • Allow guests to upload
    • Filter extensions
    • Enforce title and description submission along with uploads
    • Debug mode
    • more
  • Drag and Drop
  • AJAX progress indicator

Setup

This section describes how to install the plugin and get it working.

Uploading in WordPress Dashboard

  1. Navigate to the 'Add New' in the plugins dashboard
  2. Navigate to the 'Upload' area
  3. Select filetrip.zip from your computer
  4. Click 'Install Now'
  5. Activate the plugin in the Plugin dashboard

Using FTP

  1. Download filetrip.zip
  2. Extract the filetrip directory to your computer
  3. Upload the filetrip directory to the /wp-content/plugins/ directory
  4. Activate the plugin in the Plugin dashboard

Filetrip Settings

Using Filetrip setting page, you can configure the following:

Setting fields

Option Default Description
Select Dropbox folder empty After activating Dropbox you can use this field to define the destination Dropbox folder where the forwarded Media files will be transmitted.
Select Google Drive Folder empty After activating Google Drive you can use this field to define the destination Google Drive folder where the forwarded Media files will be transmitted.
Notify admin about new uploads empty By enabling this option, an automatic notification will be sent thourgh Email whenever a user uploads files to your website.
Notify admin about scheduled backup generation false By enabling this option, an automatic notification will be sent thourgh Email whenever a schduled website backup is been generated.
Admin notification template false This textbox enables admin to change the template of the the upload notification
Notification email false If this Email field left blank, the plugin will assume the main Wordpress admin email is selected.
Allow extra file types empty Enable any extra file types (MIME) that you want them to be natively supported by wordpress, either by backend Media uploads, or by frontend user uploads. However frontend uploaders should have another level of extension filter that you need to configrure for individual uploaders.

Scheduled backup / Manual Backup

Options:
  • You can use (Settings -> Filetrip Settings -> Custom Backup Schedule tab) to either execute a manual backup or configure and save scheduled backup
  • Before executing manual backups, make sure to select the desired backup mode (Database Only, or Full Backup)
  • Once manual backup is been generated the admin can easily go to the below section of generated backups, and from Send to cloud column, he or she can click over either Dropbox icon, or Google Drive icon to transfer the backup to the default configured destination folder
  • The automatic backup doesn't require any intervention, the plugin uses the Wordpress internal WP-Cron library, to generate backup and automatically transfer them into both channels (Dropbox, and Google Drive). NOTE: Automatic backup is based on user visits, so this feature might leave unpleasent customer experience if it is been scheduled with short periodic time.
  • Full backup (Site Files + SQL) will be generated, with providing the option of either selecting SQL only, or Files only.
  • The admin can flexibly schedule backups hourly, weekly, daily, or monthly
  • The admin can enable backup email notification from settings
  • The backup will exclude the backup folder in yout website, so it will not increase in size
  • The admin have the capability of defining the maximum number of recent backup to be saved in the website server

Configuring Dropbox and Google Drive Settings

Here is a video toturial that will guide you on how to create, configure and activate your own Dropbox & Google Drive apps so you will be fully accountable for the digital information transmitted into your cloud end points.

 

Create new Filetrip upload instance with independent settings

To creat new Filetrip uploader go to (Menu -> Filetrip -> Add New):

New Filetrip item option details

Option Default Description
Upload channels empty Here is where you need to check the channels that you would like the files been uploaded using this specific uploader to be transmitted to, either by bulk approve or by single approval in (Menu -> Media -> Filetrip manage upload) section
Dropbox folder empty After activating Dropbox you can use this field to define the destination Dropbox folder for digital files uploaded using this specific Filetrip uploader.
Google Drive folder empty After activating Google Drive you can use this field to define the destination Google Drive folder for digital files uploaded using this specific Filetrip uploader.
Allow website guests to upload files false By checking this box, visitors will be authorized to upload digital files in whatever instance you created.
Enforce information submission false Force user to send Title and Description for every file he uploads
Disable Drag & Drop effect false Checking this option will remove drag and drop effect, and convert it into regular HTML multi-upload button
Max file size (MB) '10 MB' Using this option you can define the maximum size limit of a file.
Max file upload limit '10' This option allow you to control how many uploads the users can do for every single session.
Strictly allow extensions '' Allow only entered extensions (Use comma seperator). Leave it empty to allow WP default mime list.
Debug false Enable debugging for trouble-shooting.
Debugging info target '' Only works if Debug is enabled. Target HTML element, for class name add "." letter prefix. For ID based targeting put "#" letter.
Uploader message '' Direction for users that will be displayed in the bottom of the uploader box
File Title placeholder '' Only works with enforce submission option being enabled. Customize title placeholder
File Description placeholder '' Only works with enforce submission option being enabled. Customize description placeholder.
Theme Options 'section' Options related to plugin theme.

Extra notes about the cloud channel section

Selecting cloud folder will show a popup window so you can traverse in your cloud service folders as follow

 


Shortcode generation & usage

Once a user creates Filetrip uploader, an automatic shortcodes will be generated and listed under (Filetrip -> Filetrip).

Filetrip Form Integration #back to top

With our File Upload Field, you can have your users upload documents, photos and other media along with the other data you collect from them Caldera forms. This makes it really convenient to ask for screenshots on a Customer Support Form or accept videos, music, and resumes in PDF or Word on an Employment Application form. The possibilities are endless when you can easily accept and store files from your users.

Drag & Drop Filetrip Upload Element

As shown in the picture, you will just need to drag and drop Filetrip Upload element into your custom form to start the fun.

As shown in the picture, you will just need to drag and drop Filetrip Upload element into your custom form to start the fun.

Configuring Filetrip Upload

As any other Form element in Caldera, you need to give your element a name; then, you can magically select ready and pre-configured Filetrip Uploaders from the Dropdown box highlighted in red in the figure shown above. So all of your configuration of the uploader will be inherited from Filetrip Upload section, and you can reasily tune your configuration at any given time to change the behaviour, GUI and constraints of your selected uploader.

Preview the form

The above picture shows how a test form looks at the front-end. If you want to quickly play around with the plugin and create this same form, you will find a ready template for it once you create a new form at Caldera, the form template name should be found as "Registration Form". You will also find a basic Contact Us form as a template when you create a form.

Here we have given a guidance pertaining on where and how you can find Filetrip Upload form element for Caldera. As all of the basic and advanced tutorial on how to create a form has already been discussed in the previous Section


Frontend glance

After placing your shortcode in any post or page, a frontend Filetrip uploader will be intelligently constructed for your users according to the settings given to this uploader. Here is a responsive example of one uploader:


Bulk approval action leads to bulk transmission process ↓


Filetrip Addon Effect on Media Section

When users start uploading, administrators could be notified through email by Filetrip. Otherwise, admin's should go to (Media -> Filetrip Upload Manager) to manage, review and approve uploads. Bulk action is supported (Approve, & Delete), and for instance once approve bulk action is executed over multple files, the whole files will be transferred through uninterruptible process to their corresponding uploader bound channels, which are either (Wordpress, or Dropbox, or Google Drive) or any combination of them. Check the following image sample.



Example: If someone click over a Dropbox icon, the transfer process will start and finalized as shown in the following picture:

FAQ

How scheduled backups will be generated ? And why am I having a problem ?

"NOTICE": The plugin uses cron job system (WP Cron) to execute scheduled backup. For WordPress to recognize when to execute a backup job, your website (inner clock) needs to be set regularly. And this set happens whenever someone (including you) visits your site. If your site happens to not being visited for a period of time, WordPress's inner clock gets sort of slow. In that case it takes an extra server-side cron job to regularly call http://yourdomain/wp-cron.php and tell WordPress what time it is.

A simple way to find out whether WP Cron works as it should on your site, try to create a new post and delay its publishing time by 10 minutes or so. Then leave your site (that’s important), come back after 11 minutes and check whether your scheduled post has been published. If not, you’re very likely to have an issue with WP Cron.

Why does transmission process go away ?

By default PHP has its time limit set to 30 seconds. The plugin will attempt to set the time limit to unlimited in order to complete the backup, however if safe mode is enabled this will not be possible. In addition the Apache TimeOut directive has a default of 300 seconds (5 minutes) that cannot be altered without manual intervention. It is not recommended you change this value. However, the plugin has been designed to get around these limitations by using a backup monitor that will detect if the backup has gone away and resume it from where it stopped. In short, this is a feature! :-)

Does the plugin backup the WordPress databse?

It sure does. Your database tables will be dumped to a SQL file that can be used to import into a database when you need to restore or move your website.

Where are my backup files located?

The backup are tagged with your domain name and location in [www.yourdomain.com/wp-content/filetrip-{random-string}].

Sources and Credits


Big thanks for the following great opensource utilities:


Demo page

Once again, thank you so much for purchasing this plugin. As we said in the beginning, we will be happy to help you if you have any questions relating to this plugin. We take pride in our work and we really care about our users. Thanks again!

Copyright © 2009-2017 iTechFlare. All Rights Reserved.

Go To Table of Contents