MAIAN_UPLOADER v.1.3

Read Me File

AUTHOR & SCRIPT INFO:

  • Maian_Uploader is an easy to install and configure script that enables visitors to upload multiple files to your server.
  • Written by David Ian Bennett. ©2003.
  • Originally Released: 1 Jan 2003.
  • This Version Released: 26th October 2003
  • E-Mail: david@maiandream.co.uk
  • Website: http://www.m-dream.co.uk
  • Script Version: 1.3
  • Licence: GPL (Freeware) (See the licence.txt file for more information)
FEATURES:

  • Utilises the PHP LIB template class to enable you to easily add this script to your exisiting website via HTML templates.
  • Specify as many upload fields as you want, allowing multiple uploads to the same server.
  • HTML formatted e-mails with links to your files. Visitor doesn`t see link in his/her e-mail unless specified.
  • Choice of two simple admin interfaces where you can delete/view files.
  • Script checks if file(s) already exists and gives one of two options. An error message or an alternative file name.
  • Allow only the file types you specify to be uploaded. This prevents someone from uploading a malicious script and executing it on your server. (Optional)
  • Keep a record of all uploads in a log file. (Optional)
  • Multi Language Support.
  • Script checks for valid e-mail address and input in other form fields.
  • md5 password encryption.
  • Browser output via CSS. (Themes included or create your own)
  • Allow visitors to send comments with their uploads. (Optional)
  • Allow visitors to see a link to their file(s) after being uploaded. Ideal if you are running image hosting. (Optional)
  • User can specify if he/she wants to receive confirmation of their submission.
  • Easily add banner or text link to the top of the page.
  • Nice clean interface.
REQUIREMENTS:

  • A server that supports PHP. Version 4.0 or higher is recommended!
  • The ability to set file permissions (Usually only applicable on UNIX hosts). If you aren`t using the log feature, you won`t need this.
  • A suitable text editor to edit the config.php & .CSS files. conText comes highly recommended! You can use Notepad or Wordpad.
INSTALLATION:

  • Using a text editor, open up the inc/config.php file and edit the preferences to suit your own needs.
  • Upload all the files in binary mode into a directory on your server.
  • Chmod the "uploads" and "log" directories to 777.
  • Access the maianuploader.php file in your browser. ie: http://yoursite.com/uploads/maianuploader.php
  • Give it a try and see if it works ok!
  • VIEWING ADMIN AREAS!
  • There are a choice of two as follows:
  • If you are logging files, access the admin.php file in your browser. ie: http://yoursite.com/uploads/admin.php
  • If you are NOT logging files, you can still view/delete files in your browser by accessing the admin2.php file in your browser. ie: http://yoursite.com/uploads/admin2.php
  • Log in with the password you specified in the inc/config.php file.
  • Further customization can be done by editing the HTML emplates and CSS files. See below for more info:
  • Thats it, you`re done! Enjoy!
TEMPLATES:

  • This script utilises the PHPLIB template class and provides you with easy to edit HTML templates. You can find these in the /templates/ directory.
  • You can create your own from scratch if you wish, however there are a few things which MUST remain intact or else the script may malfunction.
  • Firstly, within the template files you`ll see place holders for template variables. ie: {TITLE} {THEMES} These MUST remain in place in whatever new template you design.
  • Secondly, the form field name attributes in the index.html file MUST remain the same. ie:
  • <input type="text" size="30" name="field_name">
  • <input type="text" size="30" name="field_email">
  • <input type="text" size="30" name="field_subject">
  • If your new form doesn`t have these field names, the script will not work.
  • Finally the form action must remain as "maianuploader.php?action=upload".
  • Further customization can be done by choosing or editing any of the .CSS files. They are found in the /templates/themes/ directory. To preview the themes visit: http://www.m-dream.co.uk/scripts/maianuploader/maian_uploader.php
  • Hope you have fun either working with the provided templates or creating your own.
SERVER PATH PROBLEMS:

  • For the uploads to work you need to specify your server path, or root directory. This is not a URL.
  • There is a file called path.php within this script to help you out.
  • To detect your server path, simply access the path.php file in your browser. Samples are shown to help you out.
LOG FILE PROBLEMS:

  • Firstly, make sure the "log" directory is chmoded to 777. If you are unsure of this, contact your web hosting company.
  • The script automatically creates a file inside that directory called "uploads.log" once something is uploaded for the first time.
  • If you see errors on the screen that your server is unable to create the "uploads.log" file, the best thing is try is to open notepad or any other text editor and save a blank document as "uploads.log". Use the "Save as" function. Upload the "uploads.log" file into the "log" directory and chmod it to 777.
  • When you upload another file, the information will be written to the file you have created.
  • IMPORTANT NOTE: The log file you create manually MUST be called "uploads.log".
  • When enabled, the log file displays the following information:
    date & time | ip address | name | e-mail address | file name | file size
  • To view info in your log file access your admin.php file.
VIEWING LOG PROBLEMS (admin.php):

  • Some of you may find that when you access your admin.php file you don`t see anything. The first thing to make sure is that you have the log file enabled in the inc/config.php file. ie: $log = "1";
  • If you still don`t see anything, it might be that your server does not support CHMODDING.
  • If this is the case, you can still view or delete files by accessing admin2.php.
UPLOAD PROBLEMS:

  • Some of you may find that you cannot upload files more than 2MB in size. This is because on most servers, the max upload size for files in PHP is set to 2mb.
  • To change this you`ll need to have access to your PHP.ini file. Look for the following: upload_max_filesize
  • If you are unsure of what your server is set to, do the following:
  • Open up a text editor and type the following: <? phpinfo(); ?>
  • Save the file with a .php extension, upload it, then access it in your browser.
COMMON ERROR:

  • Some of you may find that when you click the "Upload Files(s)" button, you get an error saying "ERROR! Please include your name".
  • Please note that this is not a scripting error, but something to do with the way that PHP is configured on your server.
  • Maybe its running in SAFE MODE? Check with your web hosting company for more information.
  • There are issues when uploading files to a server using PHP.
  • If you are running an old version of PHP for instance, you may need to change the global variable $_FILES to $HTTP_POST_FILES in the maianuploader.php file.
  • Some of you may find the answers to your problem by visiting: http://us3.php.net/features.file-upload
  • Please note as I don`t know how servers are configured, I won`t be able to help you myself with regards to this problem. Thank you!
TESTING ENVIRONMENT & CODING INFORMATION:

  • Coded using the free text editor conText.
  • Browser output tested in IE6. (Sorry if it looks wrong in netscape)
  • Server Environment: Linux Server running PHP v4.3.3
LANGUAGE PACKS:

  • This script supports multi languages via language files. If you wish to send me a new language pack I would be very grateful. Full credit remains in the actual file and also on my website. Submit language packs to me at: languagepacks@maiandream.co.uk
  • Current available languages are:
  • ENGLISH
  • DANISH (Thanks to Steen Pedersen)
  • DUTCH (Thanks to Rick Corstens)
  • FRENCH (Thanks to Charly G)
  • SPANISH (Thanks to David Cubillo)
  • SWEDISH (Thanks to Daniel Ögren)
  • Special thanks to the above guys for updating the language files for me for the lastest version.
SCRIPT HISTORY:

  • 26/10/03 - Version 1.3 Released. Added templates, admin interfaces and HTML formatted e-mails.
  • 14/9/03 - Version 1.2 Released. Re-written to include more features. (file types, multiple uploads, file prefix, multi language & log file).
  • 19/4/03 - Version 1.1 Released. Completely re-written to include header, footer and style sheet. Also, script checks to see if file exists. Error check for blank fields
  • 16/1/03 - Version 1.0 Released.
FUTURE DEVELOPMENT:

  • No plans for any additional features at present.
RATE THIS SCRIPT:

  • If you like this script and have a spare few moments, please rate this script by using the form on M-Dream!
SCRIPT SUPPORT:

COMMENTS/FEEDBACK:

  • If any of you experience any problems with this script, please send me an e-mail to the above address detailing the exact error messages you are receiving. As many problems are caused by servers running in SAFE MODE, you may wish to check that isn`t the cause of your problem before contacting me. Alternatively, if you have no problems, let me know what you think. This version has come about due to the kind feedback of many people. Additional feedback aids future development! Thank you very much for trying this script out!

© 2003. David Ian Bennett.