readme.txt

PHP文件管理器,功能还不是很强.也只有这样了

本压缩包为解决www.sportingon.net空间不能进行文件夹操作的问题而制作。包含一个PHP文件管理器和一个ASP建文件浃工具。PHP文件管理器已由阿江汉化。

当然，经过汉化的PHP文件管理器也可以在其他支持PHP的空间使用。

本压缩包包含的文件：
qtofm.php4     PHP文件管理器主文件。
COPYING        PHP文件管理器的英文版版权文件。
arrowicon.gif  图片，返回上一层文件夹
fileicon.gif   图片，文件
foldericon.gif 图片，文件夹
readme.txt     本文件
newdir.asp     用来创建文件夹的简单程序（ASP）
传播时请保留本压缩包的完整性。

PHP文件管理器和阿江的ASP新建文件夹工具组合起来，
可以完成www.sportingon.net空间的文件夹操作和文件操作。

因为那这个PHP文件管理器在www.sportingon.net的根文件夹里是不能删除文件、上传文件和创建文件夹的，所以我们用 newdir.asp 来创建，在新创建的文件夹中可以用PHP文件管理器来管理，功能全部正常。

使用方法是：

1、将本压缩包中的所有文件上传至服务器根目录。
2、点击 newdir.asp ，进入阿江ASP新建文件夹工具页面，按照提示创建你想创建的文件夹。
3、回到www.sportingon.net的文件管理界面，刷新一下仍然看不到我们创建的文件夹，这是因为www.sportingon.net的管理工具本身并没有显示文件夹的能力。
4、点击 qtofm.php4 ，进入PHP文件管理器，一切一目了然。注意，只有进入自己创建的目录中才可以不受限制的使用这个文件管理器，所以建议把自己的所有文件都放到一个文件夹里。

当然，也可以在上传这些文件前对qtofm.php4进行设置，设置选项包括增加密码一项，用来防止别人使用这个文件管理器来修改您的网站。设置办法见该文件。

阿江的个人主页 http://www.ajiang.net
电子邮件 [e-mail]
ICQ 137608002
OICQ 2315516



QTOFileManager 1.0
http://www.qto.com/fm
Author: Quentin O'Sullivan
E-mail: [e-mail]


INSTALLATION

1. Put the php file and the 3 gif images in a directory

2. You may want to change the configuration variables in the top 
of the program but this is optional, you can just use the default settings.


WHAT IT DOES
- Upload and delete files from the directory (folder) the program is in and any sub directories.

- It can authenticate the user (optional)

- It allows you to edit a file (optional)

- Specify which file extensions can be edited

- Add and remove directories (optional)

- Specify the max hard drive space allowed

- Specify the max file size allowed

- You can designate file names as being hidden and they will then not show
up in the file manager e.g. .htaccess

- The program will strip out any % characters from a file name because these 
cause problems.

- When the program calculates the total size of the files it adds up the size of all the files 
including the hidden ones.


AUTHENTICATION
If you want authentication you must set the $user and $password configuration 
variable in the program. If you don't want authentication set $user = ""
Please note the authentication system is not bullet proof, it could be broken into
if someone was determined enough


MAX FILE SIZE
The program sets a limit for the maximum allowed file size. The default is 1MB. You 
can change this by setting the $MaxFileSize configuration variable in the program.


MAX HDD SPACE
The program sets a limit for the maximum total size of all files in the directory. The 
default is 100MB. You can change this by setting the $HDDSpace configuration variable 
in the program.


HIDDEN FILES
The program allows for hidden files. You can designate a file as a hidden file by adding 
the file name to the $HiddenFiles array in the program. 
e.g. $HiddenFiles = array("file1.ext","file2.jpg","file3.jpg");


EDITING FILES
The program by default allows you to edit files with the extensions .htm .html .txt
If you want to edit files with other extensions you need to change the $EditExtensions
configuration variable in the top of the program. Just add or remove extensions from 
the $EditExtensions array. You can also turn file editing off altogether by setting
$EditOn = 0 


ADD AND REMOVE DIRECTORIES (FOLDERS)
The program allows you to add and delete directories. This functionality can be turned
off by setting $MakeDirOn = 0 in the configuration variables at the top of the program


SECURITY
The authentication system is not bullet proof, it could be broken into
if someone was determined enough. Do not use this program in directories that 
contain important files such as credit card numbers.


HELP and BUGS
If you find any bugs or you need some help get in touch and I might be able to help/

Quentin O'Sullivan
E-mail: [e-mail]
Web Site: http://www.qto.com


CUSTOMISING
The HTML page is at the very bottom of the program file you should be able to easily
customise this for your web site by either hand coding the HTML or using an editor
such as Dreamweaver.

The HTML that makes up the file manager itself is in the program code and you may 
require some knowledge of PHP to alter this although you should be able to change 
the fonts with only HTML knowledge. The look of the file manager has been designed 
to be very neutral so that it can easily slot into an existing web site without clashing
with the existing colors.
 

LICENSE
This program is distributed under a GNU General Public License (GPL). Please read 
the GNU License file for more information about how you can distribute the program.