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.
|