All Scripts backed by 10 years in business, free support, free updates and a 30 day money back guarantee.
Download Purchase Programming F.A.Q. Support Contact
Commercial Perl Scripts
All Form Pro Updated
Count It
Form Mailer + Attachments
Client File Manager
Da Godfaddah
Dropbox Updated
FAQ Builder
HT Manager Updated
RegisterHT
Mailing List Server
Page Updater - Text
Page Updater Pro Updated
PS Guestbook Updated
PS Lightning Search Updated
Quick File Mailer
Quick MySQL
Select-A-File
Upload Center
Free Perl Scripts
Access Log Viewer
All Form
Epoch Converter
Error Log Viewer
Invoice Center
PS Upload
Question Manager
Quick CHMOD
QuickHT
Site File Finder
Site File Lister
SSI Tag Maker
Perl Modules
Monger Calendar
Monger File
Monger Mail
Monger Persist
JavaScript Generators
PopUp Windows
Meta Gen
RGB / Hex Converter
Page Colors
Sudoku
Tutorials and FAQs
Cookies
Using CuteFTP
Using WS_FTP
Installing Scripts
Debugging
Utilities
env_vars.pl
backup.pl
restore.pl
check_email.pl
date.pl
dayname.pl
fileage.pl
format_length.pl
format_url.pl
getfile.pl
parse.pl
redirect_html.pl
Free Services
Epoch Converter
TLD Registries
RGB/Hex FInder
Colour Checker
ASCII Codes
Policies
Terms and Conditions
Privacy Policy
Refund Policy
Site Map

Form Processor with no SPAM from robots.

Anti-spam, anti-robot, anti-flame, Guestbook for your website.

Manage Remote websites from your website. Allow clients to update sections of their own web pages.

Secure file manager with upload progress meter. A printer's best friend. Find out more.

DropBox 2.1

Supported Servers : Unix, Linux, FreeBSD, Sun, BSDOS, Mac, Windows
Price : USD $39.00
Requires : Perl / cgi-bin
Version : 2.1
Original Release Date : November 2001
Latest Release Date : March 2009
F.A.Q : Click here for F.A.Q.
Users Guide : Click here for Users Guide
Online Demo : Admin Demo - Public Upload Demo

Quality Perl Script Guarantee This Perl Script has been quality guarantee stamped by our customers. If this script does not perform for you on your server as advertised, we'll issue you with a full refund plus a 10% credit voucher.

  1. Beginning
    1. Disclaimer
    2. Introduction
    3. Requirements
    4. Configuration
    5. Installation
      1. Linux/Unix/Mac Servers
      2. Common Installation Problems on Linux/Unix/Mac Servers
      3. Windows Servers
      4. Common Installation Problems on Windows Servers


  2. Administrative Functions
    1. Administration Function Bar
    2. Log in
    3. Log out
    4. Main List
    5. Change Passwords
    6. Settings
    7. Autoresponders


  3. Managing Folders
    1. Adding a new folder
    2. Editing a folder
    3. Purging a folder's files
    4. Deleting a folder


  4. Managing Files
    1. Listing all files in the system
    2. Deleting an individual file
    3. Renaming an individual file
    4. How to add/view notes associated with a file


  5. Public Drop Box
    1. How to use the Drop Box template
    2. How to require custom fields
    3. Renaming the drop box script


  6. Support


Please read the Perl Services Licensing Agreement

By downloading, purchasing, acquiring and/or implementing any PerlServices software, you agree to be bound by the terms and conditions of the distribution policy.

To Top




Introduction

Thank you for choosing Dropbox. This CGI upload script provides for the transfer of files from your website to your server with a smooth and easy to use interface for retrieving and managing uploaded files. Additionally, you can create multiple folders for your customers to upload files to, create and edit notes associated with each file uploaded, and send personalized auto-responders to your customers after a file upload takes place.

To Top




Requirements

Dropbox requires Perl with a functioning cgi-bin. Some servers place size limitations on the size of files that can be uploaded. While this program has been successfully used with files over 1Gigabyte in size, the program will be limited by any restrictions the server has in place.

To Top




Configuration

Path To Perl
All CGI programs written in Perl must start with a line that tells the web server where to look for the Perl interpreter. This means the very first line of each of the .cgi or .pl files MUST be the path to Perl. Here are some examples of common paths to Perl:

#!/usr/bin/perl
#!/usr/bin/perl5
#!/usr/lib/perl
#!/usr/local/bin/perl

This program was shipped with a default path of: #!/usr/bin/perl

On most servers, this should be all that is required. You do not have to set any variables.

This program uses our advanced set-up routine, which will resolve paths, create directories and set permissions on data directories. If the program encounters a problem during the set-up process, you will be given specific directions on what to do. If the instructions given don't allow you to successfully install the program or you are not comfortable following the instructions, contact us through the Perl Services Support

To Top



Installation - Linux/Unix/Mac Servers

[script] refers to the first portion of the name of the CGI Scripts you purchased.
  1. Setting the Path to Perl. Open all CGI Scripts (except [script]_key.cgi) in a Plain Text Editor and make sure the first line of the CGI Script is the Path Perl for your server. Most Users can skip this step being the default Path to Perl shipped in the CGI Script is very common.

    NB: if you do not you a Plain Text editor such as Windows NotePad or Mac Textedit (in Plain Text Mode), your Text/HTML editor will add extraneous code to the CGI Script when you save it which will result in a server 500 Error.

  2. Upload all CGI Scripts to your cgi-bin or any cgi enabled directory and CHMOD all the CGI Scripts to 755. It is imperative that you upload (transfer) all CGI Scripts to your server in ASCII mode.

    If you forget to CHMOD all CGI Scripts to 755, Step 3 will yield a Server 500 Error.

    If you do NOT upload (transfer) all CGI Scripts to your server in ASCII mode, Step 3 will yield a Server 500 Error.


  3. Load your Browser, point it to the [script]_setup.cgi file and follow the on-screen instructions for installation. For example, in your browser, type :

    http://www.yourdomainname.com/cgi-bin/[script]_setup.cgi

  4. Enter a Username and Password. This will be your Username and Password for the Administration Section. If the Setup Routine is successfully processed a link to the Administration Section will appear on the resulting page. Click the link to access the Administration Section with the Username and Password you just entered in the Setup Script.

    Should you encounter any Permission problems with the Setup Routine follow the instructions returned by the Script.
Upon successful completion of the Setup Routine the [script]_setup.cgi_setup.cgi script attempts to delete itself. This ensures the Setup Routine can not be repeated by another Surfer who would effectively reset your Administration Section Username and Password. Manually delete the [script]_setup.cgi CGI Script you uploaded if the Setup Routine could not automatically delete it (Refresh your FTP directory listing to check). Should you ever forget your Administration Section Username and Password you can repeat this Step to set a new Username and Password.

To Top



Common Installation Problems - Linux/Unix/Mac Servers

NB: Shared Secure Servers, VPS, SBOX and Free Servers.

  1. Server 500 Error. This most often occurs because Step 2 was not followed precisely. Make sure the CGI Scripts you are uploaded are CHMOD to 755, the folder the CGI Scripts reside in is also CHMOD to 755, and the CGI Scripts were transferred in ASCII Mode. Auto-Detect only detects the extensions you specify in your FTP client's Settings.

  2. I can initially load the Setup Script and punch in my Username and Password, but when I submit the Form, I receive 404 Error Page or an alternate Error Page stating "Page Cannot be found".

    This suggests your Server is operated by a very nervous System Administrator employing strict security measures, you're using a Shared Secure Server which dynamically sets your domain name to something other than the a standard Top Level Domain (www.yourdomainname.com) or sbox is employed by your server.

    In any case, open [script]_key.cgi in Plain Text Editor (not a WYSIWYG Text Editor, nor a Rich HTML Editor) and enter the URL to the folder you uploaded the CGI Scripts to in the $SecureServer Variable. If you uploaded the CGI Scripts to your cgi-bin, then you'd set the following:

    $SecureServer = "http://www.yourdomainname.com/cgi-bin";

    Do NOT enter the CGI Script name, do NOT enter a trailing slash. After setting the Variable refresh the Setup Routine's Page that asks you to enter your Username and Password. Unless you refresh the initial Setup Page, the Form's URL will not be updated to reflect your Variable value.

  3. I cannot find the correct path to my WebSpace or the required Data Directories and/or Password file cannot be created.

    You need to find that Path. Ask your host, or Download a copy of our free E-Vars CGI Script and install it on your server. CHMOD it to 755 then load it in your Web Browser which will print your Server's environment variables and other useful information. Determine your Server's Document_ROOT or Absolute Server Path to the folder your home page (index.html) resides in. You may need to append "/www" or "/httpdocs" to your Document_ROOT or Absolute Server Path to complete the path to your Writable WebSpace.

    Once you've determined your Absolute Server Path, open [script]_key.cgi in Plain Text Editor (not a WYSIWYG Text Editor, nor a Rich HTML Editor) and set the $DefaultData Variable. For example:

    $DefaultData = "/var/username/www/htdocs";

    Finally, on some Server's it's necessary to CHMOD the folder just above your WebSpace to 777 granting permission to the CGI Script to create the Required Directories at WebSpace Level. In the example above, the "htdocs" folder would need to have it's permissions set to 777.

  4. We offer a very reasonably priced Custom Installation Service. We'll Setup the CGI Script for you and send you the Log in details which you can update at your own leisure. If we cannot successfully Setup the CGI Script we will refund both the Installation fee and the purchase price of the CGI Script. To Order Custom Installation, please fill in our Secure Installation Order Form.


To Top



Installation - Windows Servers

[script] refers to the first portion of the name of the CGI Scripts you purchased.
  1. Your Windows Server may not execute CGI scripts even if Perl is Supported. Many Server Administrators do not modify the Registry to accommodate Scripts with a .cgi extension. In this case, see Renaming the drop box script to convert your copy to a .pl version as most Windows server support .pl scripts by default.

  2. Setting the Path to Perl. Your Server may or may not require the Path to Perl. It's highly likely you don't need it, and you can ignore this Step. However you may want to check with your Host if you can not load the Setup Script in your web Browser.

    NB: if you do not you a Plain Text editor such as Windows NotePad or Mac Textedit (in Plain Text Mode), your Text/HTML editor will add extraneous code to the CGI Script when you save it which will result in a server 500 Error.

  3. Upload all CGI Scripts to your cgi-bin or any cgi enabled directory. It is imperative that you upload (transfer) all CGI Scripts to your server in ASCII mode.

    If you do NOT upload (transfer) all CGI Scripts to your server in ASCII mode, Step 3 will yield a Server 500 Error.

  4. Load your Browser, point it to the [script]_setup.cgi file and follow the on-screen instructions for installation. For example, in your browser, type :

    http://www.yourdomainname.com/cgi-bin/[script]_setup.cgi

  5. Enter a Username and Password. This will be your Username and Password for the Administration Section. If the Setup Routine is successfully processed a link to the Administration Section will appear on the resulting page. Click the link to access the Administration Section with the Username and Password you just entered in the Setup Script.

    Should you encounter any Permission problems during the Setup Routine, you need to contact your Host and request "Full Read/Write Permissions" be applied to at least one folder on your Server. Many Servers have at least one writable folder, often named "database". See Common Installation Problems below for more information.
Upon successful completion of the Setup Routine the [script]_setup.cgi_setup.cgi script attempts to delete itself. This ensures the Setup Routine can not be repeated by another Surfer who would effectively reset your Administration Section Username and Password. Manually delete the [script]_setup.cgi CGI Script you uploaded if the Setup Routine could not automatically delete it (Refresh your FTP directory listing to check). Should you ever forget your Administration Section Username and Password you can repeat this Step to set a new Username and Password.

To Top



Common Installation Problems - Windows Servers

NB: Shared Secure Servers, VPS, SBOX and Free Servers.

  1. Server 500 Errors are usually misleading on Windows Servers. It seems to be the default error page for just about every error. Make sure you typed in the correct Website Address (URL) to the CGI Scripts on your server. Make sure the CGI Scripts were transferred in ASCII Mode. Auto-Detect only detects the extensions you specify in your FTP client's Settings.

  2. I can initially load the Setup Script and punch in my Username and Password, but when I submit the Form, I receive 404 Error Page or an alternate Error Page stating "Page Cannot be found".

    This suggests your Server is operated by a very nervous System Administrator employing strict security measures, you're using a Shared Secure Server which dynamically sets your domain name to something other than the a standard Top Level Domain (www.yourdomainname.com) or sbox is employed by your server.

    In any case, open [script]_key.cgi in Plain Text Editor (not a WYSIWYG Text Editor, nor a Rich HTML Editor) and enter the URL to the folder you uploaded the CGI Scripts to in the $SecureServer Variable. If you uploaded the CGI Scripts to your cgi-bin, then you'd set the following:

    $SecureServer = "http://www.yourdomainname.com/cgi-bin";

    Do NOT enter the CGI Script name, do NOT enter a trailing slash. After setting the Variable refresh the Setup Routine's Page that asks you to enter your Username and Password. Unless you refresh the initial Setup Page, the Form's URL will not be updated to reflect your Variable value.

  3. I cannot find the correct path to my WebSpace or the required Data Directories and/or Password file cannot be created.

    You need to find that Path. Ask your host, or Download a copy of our free E-Vars CGI Script and install it on your server. You will need to rename the E-Vars CGI Script to "myserver.pl" if your Server only executes Scripts with .pl extensions. Upload it to your cgi-bin or any cgi executable folder then load it in your Web Browser which will print your Server's environment variables and other useful information. Determine your Server's Document_ROOT or Absolute Server Path to the folder your home page (index.html) resides in. You may need to append "\\www" or "\\httpdocs" to your Document_ROOT or Absolute Server Path to complete the path to your Writable WebSpace.

    Once you've determined your Absolute Server Path, open [script]_key.cgi in Plain Text Editor (not a WYSIWYG Text Editor, nor a Rich HTML Editor) and set the $DefaultData Variable. Be sure to separate folder names with two backslashes, not one slash. For example:

    $DefaultData = "C:\\html\\username\\htdocs";

  4. We offer a very reasonably priced Custom Installation Service. We'll Setup the CGI Script for you and send you the Log in details which you can update at your own leisure. If we cannot successfully Setup the CGI Script we will refund both the Installation fee and the purchase price of the CGI Script. To Order Custom Installation, please fill in our Secure Installation Order Form.


To Top




Administration Function Bar

After logging into the administration program, the top portion of the screen will contain the above administration function bar. Use this to navigate the various options and functions that this File Management Script offers.

To Top




Log in

Whenever you wish to use the Dropbox administration program, you must first sign into the program. Enter the full URL to the dropbox_admin.cgi script in the address line of your browser. Unless you're already logged in, you will be prompted to do so. Enter your user name and password and click the button.

To Top




Log out
Whenever you are done working with the program or are going to be stepping away from your desk, we strongly urge you to log out by clicking the "Log out" link at the top of the page. Even if your working from home and stepping away from the desk, EXIT THE PROGRAM.

To Top




Main List

When you sign into the administration program, you will be presented with a list of all folders and files in the system. This screen can also be reached at any time you are signed into the program by clicking on "List All Files" on the function bar.

To Top




Change Password

When you installed Dropbox, a second Administrative User with restricted access was automatically created. The log in details for this user are :

Username: 222222
Password: 222222

You can change either administrative password at any time by clicking on "Change Password" while logged in to Dropbox. To change your password, you need to enter five pieces of information on the Change Password screen. First, you must enter your current user name and password. This information is validated against current values just to make sure someone doesn't change the information if you walk away from your terminal. Once changed you are immediately logged out and will need to log in again with your new details.

To alternate between Administrative users, use the Log out Link to erase all session cookies. When using the Change Password function, you are updating the log in details of the User you're currently logged in as.

To Top




Settings

Once the Script has been installed, it's time to configure it to meet your needs. The Settings of importance are the File Settings. Log in and click on "Settings", then scroll down a little. The Set Up routine will have prepoulated all settings fields however you can modify them to change locations and functionality.

Directory files will be uploaded to

This is the absolute server path to the directory all folders you create will be created in. If you modify this path, it is important that the second last directory in the path already exists. The last directory in the path can be auto-created by the scripts. Assume this is your server's path to your home page:

/home/httpd/vhosts/yourdomain.com/htdocs

... and you want to store all folders you create within the Dropbox Admin section in a folder named "dropbox", which resides in a folder named "customers". Then you would enter the following path ...

/home/httpd/vhosts/yourdomain.com/htdocs/customers/dropbox

... which is fine, as long as the "customers" folder already exists. Dropbox can create the last folder ("dropbox"). By default, Dropbox will have defined your server's absolute root path followed by "dropbox" in this setting. If you leave this unchanged, your dropbox will be created at web level (the same level as your homepage) and any folder you create, will be stored inside the "dropbox" folder.

The Web Site Address files will be uploaded to

This path must correspond with the above directory path, but starts with "http" so it can point to your uploaded files and you can view them online. If you retain the default directory setting, then the correct setting for this would be :

http://www.YOURDOMAINNAME.com/dropbox

Both settings must ultimately point to the same end folder, which in this case is the "dropbox" folder at your web space level. Email Settings

These settings are used to deliver the Autoresponders after a file has been uploaded using Perlservices.net's Dropbox.

Path to Mail Program

The default path set by Dropbox to your mail program is

/usr/sbin/sendmail

This applies to all Unix type servers. If this fails, try

/usr/lib/sendmail

When using /usr/lib/sendmail wait a few minutes for the email to arrive after uploading a file. If you're running Dropbox on a Windows server, or the above settings do not work on your server, then you'll need to enter the path to your server's SMTP mail agent. Which is almost always

mail.YOURDOMAINNAME.com

where YOURDOMAINNAME.com is your website address.

If all of the above fails, your host will need to be contacted.

To Top




Autoresponders

Dropbox incorporates Autoresponders can be delivered to both the Customer and the Administrator. You must set each to "Yes" via the "Settings". Both messages sent are also found in the "Settings". You can modify these and incorporate the use of special markers to automatically personalize the messages. For example, the following message :

Thank you for your submission %%%fname%%%

would be received by the Recipient as

Thank you for your submission Jenny

if the uploader entered "Jenny" in your Dropbox file upload form. These templates can be sent as Rich HTML or as Plain Text. If using Rich HTML which is regular HTML, you must include absolute paths in your links and images (http://www....).

The following markers can also be utilized in both Autoresponders :

%%%Files%%% The names of all files uploaded
%%%DATE%%% The date and time the file upload took place
%%%IP%%% The file uploader's IP Address
%%%Host%%% The file uploader's ISP host address
%%%email%%% The file uploader's email address. Presuming the email field is still in the upload form
%%%fname%%% The file uploader's first name. Presuming the fname field is still in the upload form
%%%custom%%% Any of the custom fields you have added to your upload form. Replace the word "custom" with the name you have given to the form field. For example if you added a form field to your File Upload Form that requests the Submitter's City:

<input type="Text" name="city">

Then you'd use %%%city%%% in your Autoresponder messages, and that would be replaced with the value entered by your file uploader.


To Top




Adding a new folder

To add a new user, click on the "Add Folder" link on the administration function bar. You will be presented with a page that provides you with the ability to create up to ten new folders. You can enter one folder name, ten folder names or any amount in between. Create as many folders as you like, there is no limit to the number of file upload folders Dropbox can manage.

To Top




Editing a folders name

You can not edit a folder name once added. You can, however, delete the folder and then add one with the new name.

To Top




Purging a folder's files

To purge a folder of it's files, click on the "List All Files" link on the administration function bar. From the list of folders, click on the "Purge" link on the same line as the folder name. You will be asked to confirm your selection. Purging the folder's files removes ALL of the stored files along with all notes for those files.

Please note that purging a folders files is a permanent and irreversible course of action. Once you click the OK button on the confirmation you can NOT undo this delete. All of that folders files and associated notes will be permanently removed from the system.

To Top




Deleting a folder

To delete a folder, click on the "List All Files" link on the administration function bar. From the list of folders, click on the "Delete" link on the same line as the folder name. You will be asked to confirm your selection.

Please note that deleting a folder is a permanent and irreversible course of action. Once you click the OK button on the confirmation you can NOT undo this delete. All folder information and all files and associated notes will be permanently removed from the system.

To Top




Listing all files in the system

To list all users files in the system, click on the "List All Files" link on the administration function bar. This "List All Files" page provides the ability to view a list of all uploaded files in each and every folder from one page, download a file and view the notes associated to a file.

To Top




Deleting an individual file

From the list of files and folders, click on the "Delete" link on the same line as the file name. You will be asked to confirm your choice. Click on the OK to proceed with the delete. Deleting a file is a permanent and irreversible course of action. Once committed, it can not be un-done.

To Top




Renaming an individual file

From the list of all folders and files, click on the "Rename" link on the same line as the file you want to rename. A pop up box will appear asking for the new file name. Here is a breakdown of what will occur based on your input:
  1. If you click cancel or submit an empty value, nothing happens.
  2. If you type a new name with an extension, the file will be renamed to that value you entered.
  3. If you type a new name without an extension, the current extension will be maintained.
  4. If you attempt to rename a file to an extension that is not permitted, you will be notified the name change did not take place.
  5. If you rename the file to a name that already exists in that users folder, the existing file will be replaced with the new file and the file that previously had that name will be permanently removed from the system.
  6. If you rename a file with spaces in the name, the program will convert those spaces to underscores.


To Top




How to add/view notes associated to a file

From the list of files and folders, click on the "Notes" link on the same line as the file name. A pop up window will appear containing the current content of the "Notes" associated to that file. If the content field is blank, there are no notes. You simply edit the current notes or add new content in the editable field of the pop up window. When completed, click the "Update Notes" button. When you are finished with the notes window, click on the "x" in the upper right hand corner.

To Top




How to use the Drop Box template

The Public Drop Box template is called "dropbox.html". Do NOT rename this file. This file is uploaded to the same directory as perl scripts. You do not link to or call this HTML document in your browser. Instead, you link to or call the "dropbox.cgi" script which in turn processes the template HTML document.

Feel free to edit/modify/change this HTML document as necessary. There are only a few rules you must follow:

  1. The opening form tag must remain un-changed.

  2. The hidden form field tag named "action" must remain un-changed.

  3. The marker "%%%destination_list%%%" must remain somewhere in the document. It is replaced by the perl scripts with your current list of folders.

  4. You can include as many file fields as you please. The file fields must be named FILE1, FILE2, FILE3, etc, etc. The name of these file fields must be in UPPER CASE. E.g.

    <input type="file" name="FILE2">

  5. You can add many of your own custom fields as you like. E.g.

    <input type="Text" name="Zip_Code" value="%%%Zip_Code%%%">

    <textarea name="Instructions" rows="6">
    %%%Instructions%%%"
    </textarea>

The special markers are replaced with User submitted values when the page reloads after an attempted file upload. We recommend you upload the default template as is and run it first to see it in operation before you begin making changes. When you are ready to make changes, first, make a backup copy on your hard drive.

To Top




Required fields

If you want some of your forms fields to be required, then you specify those field names in a hidden field. Separate each field name with a comma but do not add any spaces. For example, if you had three fields you wanted required:

<input type="text" name="email">
<input type="text" name="address">
<input type="text" name="city">


....then you would specify these as required fields using the following hidden field:

<input type="hidden" name="required" value="email,address,city">

To Top




Renaming the drop box script

Do not rename the HTML document. This is unnecessary as the filename is not actually displayed anywhere on your site. To change the extension of the perl upload scripts from .cgi to .pl, rename all .cgi files, then in dropbox.cgi, dropbox_admin.cgi and dropbox_setup.cgi, redefine the following variable form "cgi" to "pl".

my $ext = "cgi";

You'll find the variable near the top of the aforementioned files.

To rename the scripts from "dropbox" to something else, rename all perl scripts, but not the HTML document, then in dropbox.cgi, dropbox_admin.cgi and dropbox_setup.cgi, redefine the following variable form "dropbox" to "newname" where "newname" is the new name of the files without the extension.

my $ScriptName = "dropbox";

If renaming the files from "dropbox", you will need to either re-install the scripts, or rename the existing data directory located in the /psjs_datalogs folder which is at the same level as your website's homepage. Inside /psjs_datalogs rename the "dropbox$FolderPass" folder to the new name you've given the scripts, without the extension. The $FolderPass portion should remain unchanged.

To Top




Support

If you have difficulties setting up this program, we will install it for you. The installation fee is US$30. Installation can be ordered via our Secure Online order form. If we are unable to install the program because of a problem with the program, your installation fee and the purchase price of the script will be refunded in full.

To Top





  ©2009 All rights reserved, PerlServices.net. Website hosting by LinuxHostingPlans.com