__________________________________
  PHP File uploader
  version  : 0.1 
  released : 14 November 2007
 ==================================

Thank you for downloading this script. I hope you will find it useful.


The main goal of this script is to provide a user friendly web-based interface 
for handling file uploads. If your website suports PHP5, you can deploy this script 
to let your users/customers to upload files.

Another great use of this script is to provide secure file transmission. How many 
times your clients needed to send you a confidential file? And did they send it 
as an e-mail attachment because that was the easiest and fastest way they knew?
Now you can give your clients the https URL address to your file upload page.


== Requirements:
- PHP5


== Browser requirements
I tested the page with many browsers (FF, Opera, MS IE6, MS IE7, Safari 3.0). 
The page should work with all browsers even if JavaScript is not enabled.


== Features:
- arbitrary number of files can be uploaded (one by one)
- any file type can be uploaded (all file types are allowed). 
  See the FAQ to learn how to check file extensions.
- there is no maximum allowed file size. 
  See the FAQ for more information about maximum file size.
- files cannot be deleted after they have been uploaded! 
  It is important to tell the user to carefully choose the file he wants to upload 
  as there is no way to remove it (maybe in the future I will enhance the script 
  to allow the user to remove the file he uploaded).  
- Ajax user interface. File is uploaded without page refresh. The user is showed 
  an activity indicator icon while the file is being uploaded. 
- valid HTML code, unobtrusive JavaScript code


== Installation steps:
1. Upload it to a subdirectory of your website in the same manner 
   of which it was unzipped (keep directory structure the same).
2. Rename the upload folder '_newsletter_xxxxx' to something that is hard to guess 
   (example: _newsletter_s7i510js4S9M3o1Qp.
3. Give write permissions to PHP on the upload folder 
   (PHP must be allowed to move uploaded files to this folder).
4. Open index.php file for editing. 
   On line 3, replace _newsletter_xxxxx with the new name you chose in step 2 for your upload folder.
5. Try the upload page in your browser.


== Bugs, Known issues:
- with MS IE6 you can upload only one file - for some unknown reason the form is 
  not submitted for the second time.


== TODO
I can think of the following improvements:
- allow users to delete files they removed 
  It could be useful if someone made a mistake and uploaded another file.
- to implement a limit on the number of files one user can upload in a given period (a day)
  Users might be able to upload a lot of large files and consume all available disk space.

Of course, the UI can be enhanced with some effects, animations but I do not 
think it would be useful. The most important for me is that the upload page is 
short and easy to use. Also the page should work with all browsers.


== Contribution
  How can you help?
- use it and tell me what could be improved, what you like/dislike
- if you find a bug or security hole, let me know so that I can fix it immediately
- if you improved the code/UI and you want to share it with others, let me know so that I can share the download link on my blog
- English is not my native language. If you think that some text could be rewritten better, do not hesitate to tell me.
- tell about the script to others (digg, blog about it, etc)


== License
licensed under the terms of the MIT License, see the included MIT-LICENSE file.


== Contact
 Attila Szabo (contact@w3net.eu)
 http://w3net.eu/?p=50