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.
DropBox 2.1
|
 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.
|
- Beginning
- Administrative Functions
- Managing Folders
- Managing Files
- Listing all files in the system
- Deleting an individual file
- Renaming an individual file
- How to add/view notes associated with a file
- Public Drop Box
- 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
To install this program, you must have an FTP client and be familiar with how to use its basic functions. If your not sure how to achieve any of the stated functions or commands with your FTP client, please refer to our tutorial on installation and on using FTP clients at:
http://www.perlservices.net/perlfaqs/index.html
Having set the path to Perl, it's time to install the program.
Here are the installation steps:
1. Open your FTP client and connect to your web space.
2. In your cgi-bin create a sub-directory with any legal name that you want (i.e. "uploads").
3. CHMOD this sub-directory to 755 (rwx-rx-rx).
4. Change into this sub-directory with your FTP client.
5. Making sure your FTP client is set to transfer in ASCII mode and not binary mode, transfer all files into the newly created sub-directory.
6. CHMOD all files to 755 (rwx-rx-rx).
7. Launch your web browser and in the address line of the browser, type the full URL to the dropbox_setup.cgi script:
i.e. http://www.foo.com/cgi-bin/uploads/dropbox_setup.cgi
8. You should now see a set-up screen asking you to enter a User Name and Password. If you see this screen, it means the program has been configured correctly. Enter your new User Name and Password. Enter the Password a second time in the space provided. Submit the form.
Once you have received the screen that says "Set-up Successful" your program is installed, configured and ready to run. The first thing you should do is log into the admin program and click on "Settings". You can modify the dropbox folder location, email templates and general settings, or leave them as they are.
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:
- If you click cancel or submit an empty value, nothing happens.
- If you type a new name with an extension, the file will be renamed to that value you entered.
- If you type a new name without an extension, the current extension will be maintained.
- 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.
- 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.
- 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:
- The opening form tag must remain un-changed.
- The hidden form field tag named "action" must remain un-changed.
- The marker "%%%destination_list%%%" must remain somewhere in the document. It is replaced by the perl scripts with your current list of folders.
- 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"> - 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
