FTP plugin - Droppy online file sharing

Introduction

Thank you for purchasing the FTP plugin for Droppy - Online file sharing, this documentation will help you installing, setting up the plugin.

Installation & Setup

To install the Droppy FTP plugin you will need to follow the steps below, or you can follow the instruction video below.

 

  1. Unzip the file you downloaded from Codecanyon.
  2. Go to the folder called "Files" and then open the folder called "droppy_ftp" inside there will be a file named "settings.json", open this file with your preferred text editor.
  3. Inside the file will be a list of different options, all available values can be found in the "configuration" section.
  4. Make sure to save the json file after you've changed the settings.
  5. Upload the entire "droppy_ftp" folder to the path application/plugins/ on your web server.
  6. That's it. The FTP plugin is now installed, please refer to the troubleshoot section if your uploads aren't working.

 

Installation video:


 

 

Continue to the section "Configuration" for more information about how to configure your FTP server.

Configuration

To configure the FTP plugin you'll need to open up the settings.json file that's inside the droppy_ftp folder

 

The FTP plugin supports different types of FTP connections. You are able to connect to a FTP server by username and password, you're able to connect to a SFTP server using an username and password and you're able to a SFTP server using an username and a RSA Private key.

 

The settings.json file has the following options:

 

type: (Choose the connection type)

method: (Login using a key file or a username and password)

host: (The connection address to the FTP/SFTP server (can be IP or a domain address)).

port: (The port of the FTP/SFTP server)

username: (The username to login with)

password: (The password of the user (Only use when method is set to password))

passphrase: (The passphrase of the key file (Only use when method is set to key))

key: (The local path to the RSA key file)

remote_path: (The storage path on the FTP server)

 

Example configurations:

 

FTP connection using username and password, storing files in a directory named "uploaddir"

{
  "ftp": {
    "type"        : "ftp",
    "method"      : "password",
    "host"        : "ftp.myhost.com",
    "port"        : "21",
    "username"    : "proxibolt",
    "password"    : "myS3cretP@ssword",
    "passphrase"  : "",
    "key"         : "",
    "remote_path" : "uploaddir/"
  }
}

 

SFTP connection using a RSA key file (secured with a passphrase), storing files in the home directory of the user

{
  "ftp": {
    "type"        : "sftp",
    "method"      : "key",
    "host"        : "server.mydomain.com",
    "port"        : "22",
    "username"    : "storageuser",
    "password"    : "",
    "passphrase"  : "mysecretpassphrase",
    "key"         : "keys/rsa.pub",
    "remote_path" : "home/storageuser/"
  }
}

 

If you need any help setting up your config then please feel free to contact us.

Progress of the system

This will explain how the upload is going from a file on someone's computer to a file stored on the FTP server.

  1. The user selects their files and clicks upload.
  2. All the files will first be separately uploaded to your web server.
  3. After all the files have been uploaded to your server Droppy will start zipping them together to one single file.
  4. The zip file will then be uploaded to your FTP Server.
  5. When the file(s) are successfully uploaded to your FTP server, Droppy will send out the emails to the receivers of the file.
 

Troubleshoot

Troubleshooting some problems that can occur:

 

Q: When I try to download a file it says "We are currently processing your files, please be patient"

A: This is the process when the file on your server is uploading to the FTP server, it can take a moment sometimes, this also really depends on your server's internet connection and disk speed. Please contact us when this process takes longer than you think it should take.

 

Q: When I try to install the plugin it says "Upload failed"

A: It can be that the upload fails, I will suggest you to try it again. If this problem keeps occuring I will suggest to contact us.

 

Q: There is no "Plugins" tab in my admin panel

A: Please update to the latest version of Droppy, Contact us if this didn't worked.

Changelog

V 1.0

- Intial release