======================================== truFileManager v0.4.5 ---------------------------------------- http://redimido.glo.org.mx Author: Gabriel Orozco Ruiz Velazco E-mail: gabriel_orozco -at- trulinux.com ======================================== Notes: I have been thinking about renaming trufilemanager to "tfm". currently I will use tfm as a short name for trufilemanager only. tfm is being used now at some private and goverment sites where content is not highly sensitive, and by now its doing a good job. I would like to read news from you if you want to send me an email telling me you have use for it =) Changelog (new additions go up): Version Changes ======================================================================================== 0.4.5 Added: A better way to show the size of the files or directories. This is controled via a new row in config.php named "lShowNumbersHumanReadable" so be careful when you upgrade to 0.4.5. Added: Display of Version number (and copyright) at the bottom can now be disabled. this is done via a new row in config.php named "lShowVersion" so be careful when you upgrade to 0.4.5. Changed: Security is sligthly enhanced. now you can't use ../ in tfm. TBD: I'm working in disallow new files which can overwrite "read only" files. Also I'm working on "move" functionality, and a better, function-oriented code. with this, I think tfm can reach 0.5.0. I know: Code should work at least in spanish if the browser is configured for spanish, and later other languages. Page for the project should be available also in english. ---------------------------------------------------------------------------------------- 0.4.4 Added: Capacity to rename files. this needed to add a new row in config.php named "RenameOn" so be careful when you upgrade to 0.4.4. Added: Version number (and copyright) at the bottom, so you can know when you have an old and/or flawed version, so you can upgrade =) Changed: Now file sizes are comma-separated, so you can read the size better. ---------------------------------------------------------------------------------------- 0.4.3 Continuing with sorting output... now trufilemanager sorts directiries first and then sorts files. output is much more organized now =) Also fixed a bug where it was not savig an edited file, and made it more usable. if you have a 0.4.x version and want to upgrade, just overwrite index.hp with the new one and it's all. ---------------------------------------------------------------------------------------- 0.4.2 I overlooked what could happend when register_globals=on. well, the $_SESSION array is not set when register_globals is on. I included a trick from the FAQ on php site, and now trufilemanager functions as if register globals where always set to off, what effectively closed the issue. -- Okay... I did not resist the idea of sorting the output, so I added it. (1:30am, January 19th 2005) As always, if any bug or improvement, just send me an email =) ---------------------------------------------------------------------------------------- 0.4.1 There where a nasty bug that permited a user enter with typing a nonexistent username without password. it was fixed by using strict comparision (===). Also, as side efects of having Register_Globals=Off, there are some things you must carefully check and do: - chmod +x * (all files need to have the "x" access, as it should be obvious) - in php.ini increase size of post_max_size, from being 8M to a extent you think is right. increase size of upload_max_filesize. from 2M to a extent you think is right. While at it, I did some editing to make the program more visually appeal. Enjoy! ---------------------------------------------------------------------------------------- 0.4.0 Modified so it can work with "Register Globals" = Off. Fixed a nasty bug which caused anybody to be able to enter just clicking on "Login" while user/password where empty. Modified the Array of Permissions and also renamed it. (understandability). $ShowReadOnly variable changed to be $AllowGuestView for undestandability. ---------------------------------------------------------------------------------------- 0.3.3 Inserted a
for the admin/logout button so it is not near to the "delete" link when in admin mode. this is for security. 2004/11/12 By Gabriel Orozco ---------------------------------------------------------------------------------------- 0.3.1 Corrected the name of the login screen "cancel" button, so it will not be activated when somebody hit "cancel" on an edit window. now the login screen button is named "cancel_login". 2004/11/06 By Gabriel Orozco ---------------------------------------------------------------------------------------- 0.3.0 New array of user/password with also an array of rights for each user. also a new variable $ShowReadOnly will make it work like QTOFileManager if it is set to 0, asking for username/password in order to show any information. If set to 1, it will work as a public view repository until a login is issued when it will work as a full file manager with rights given on the array to the user. 2004/11/03 By Gabriel Orozco ---------------------------------------------------------------------------------------- 0.2.0 renamed to trufilemanager from gorvfilemanager Now trufilemanager does php sessions, so it is inherently more secure (as secure as a php session can be) also it is a full rewrite in order to make trufilemanager more understandable and easy to maintain. 2004/11/02 By Gabriel Orozco ---------------------------------------------------------------------------------------- 0.1.0 named gorvfilemanager (my initials are GORV). Intention was to create a good knowledge manager to publish public documents on my intranet, while enable admin people to maintain the repository. It was then pretty good when I found QTOFileManager 1.0 from Quentin O'Sullivan. (http://www.qto.com/fm), since his File Manager was pretty easy to learn (I didn't do php before this). Yeah, I know my 0.1.0 went point by point up to 0.1.29 or something like that too fast, but hey, I was learning php on the fly ;) ======================================================================================== INSTALLATION 1. Uncompress the trufilemanager on a directory 2. Edit the file config.php to match your needs. config.php is already commented and you should not find any problem with it. Don't forget to set your own username, password and rights on this file. WHAT IT DOES - Basically it will let you access all files on a director, with subdirectories included. you do not need to have a user/password, since it will enter on read-only mode. This is good for reporsitories where all want to read but only one should be able to modify content. - Once logged in, you can: -------------------------- - 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. - Do not forget to make executable (permission 577) at least all files included in the trufilemanager.tgz AUTHENTICATION trufilemanager(tfm) uses sessions so it's safe enough to work on bussinesss environments. 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 config.php file. ----> WARNING: you must set two variables on php.ini in order to achieve MAX FILE SIZE file size. x increase size of post_max_size, from being 8M to a extent you think is right. x increase size of upload_max_filesize. from 2M to a extent you think is right. ----> UPDATE: Now you do not need to modify your php.ini file. now you can make use of an added .htaccess file with bigger values. 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 config.php. 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 config.php. 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 RENAMING FILES/DIRECTORIES The program allows you to rename filenames or directories, but cannot rename to a new filename with a comma included, so be warned about this. You can always cancel the renaming process so it's pretty clean. This parameter is controled by the variable $RenameOn = { 0 | 1 } with 1 equals to allow rename. Change this setting on the file config.php. 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 on the file config.php. SECURITY The authentication system is using sessions now, so it is safer than previous versions. it is recommended altough that you use SSL encription for your web site. HELP and BUGS If you find any bugs or you need some help get in touch and I might be able to help/ Gabriel Orozco Ruiz Velazco E-mail: gabriel_orozco -at- trulinux.com E-mail: redimido -at- glo.org.mx Web Site: http://redimido.glo.org.mx 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. WARNING This program is not perfect. it can fail and as thus, you are invited to check it trhoughly before use. if you find a bug, please advise me in order to have it fixed. You are warned now. It may fail, so I cannot be held any responsability in case of any damage, ok?