Copyright (C) 2005 Lito : http://phpfilenavigator.litoweb.net
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
If you like colaborate in this proyect sending translations or bug errors, please contact with me by email (firstname.lastname@example.org) or in the web phorum (http://phpfilenavigator.litoweb.net/phpBB2/)
I notice that my english is very very bad.
This application was tested in systems Windows XP and several Linux distributions with PHP versions from 4.0.6 since 4.3.8, with which I recommend that one settles being based on these conditions. Also it's tested (only tested ) in PHP 5.0.3.
It's tested also in Apache servers from 1.3.31 to 2.0 (and some older versions) and diverse tests in IIS servers.
It requires in addition the Mysql version 4.0.* to the correct working with the file and directories indexation.
To a total funcionality, it's recommended the installation of GD >= 2.0.1 libraries to images treatment and the ZLIB libraries to file compression.
In the web download, exists always a file that contain the software, also can have more possible downloads with more languages and new utilities.
By defautl, since 1.5.8 version, the availables languages are spanish and english, but the package contain too the languages galician, dutch, italian, french and german into the directory data/idiomas/.
To download the PHPfileNavigator from console:
Before the installation we are due to assure that the directories "data/conf/", "data/logs/", "data/info/" and "tmp/" must have writing permissions to the web server user (usually apache), also in update mode, the file "data/conf/basicas.inc.php" must have writing permissions.
By default the software have availables the Spanish and English languages, but you can install in Galician, Dutch, Italian, French or German unziping the zip file that you need in the directory "data/idiomas/".
This software allow several installation and upgrade modes.
To the first installation, show must cover this data:
Email: email to send the hackers os logins alerts
GD2: If have GD2 library
ZLIB: If have ZLIB library
Host: Data base server name (default localhost)
Name: Data base name (must exists)
Usuer: User with data base access
Password: User Password
Table prefix: The tables can will be created with a prefix in order to avoid overwrite the yet existing.
Nombre: Nick of the administrator
User: User to load in the PHPfileNavigator
Password: Admin Password
Repeat Password: Repeat the password
Name: Name of diretory that exists as initial root, can be same as
"Initial ROOT", "Web root", "Public Web", ...
Absloute Path: Absolute path of the initial directory. You must use "" instead of "\", and end the path with "". For example: /var/www/html/directory/
Web path: Access absolute web path. For example: /directory/
Host: Domain for this path. If we have a web server with several domains , this can allow relacionate each root whit a domain.
Configuration file: By default "default". This configuration files are in folder "data/conf/" and can allow the preferences for each root.
In case that we have an older PHPfileNavigator version, we can choose between "Upgrade from version <= 1.5.7" or "Upgrade from version > 1.5.7", and we don't have to cover any data and install the application without delete the MySQL data.
If we have a version already installed and return to choose the option "Install", then it delete the data in MySQL tables.
The installation basic data (data base access, language, GD2, ZLIB, ...) is stored in the file "data/conf/basicas.inc.php" and we can change this values if it's necessary.
To a correct upgrade, you must overwrite the older installation with new files , saving a backup of files paths.php and "data/conf/default.inc.php", the first file contain the application paths, and the second the initial preferences. These preferences can be different in new and older version, so the recommendable it's review the files to compare the changes and overwrite the older file with the new.
Once time executed the installer, you must delete the folder "instalar/" or come back the install screen.
PHPfileNavigator is made up of the following structure:
PHPfileNavigator |-- data | |-- accions | |-- conf | |-- idiomas | | |-- eng | | |-- es | |-- include | |-- info | |-- logs | `-- plantillas |-- imx | `-- ico |-- instalar |-- js |-- tmp `-- xestion |-- indexador |-- raices `-- usuarios
In the folder "data/idiomas/" there are all availables languages, some ones in zip format. To use this languages, only have to unziped and change the language configuration in "data/conf/basicas.inc.php".
In the folder "data/conf/" can find the configuration files. By default exists two, "basicas.inc.php" created after installation and "default.inc.php" that contain the root configuration. Several roots can be related with only a configuration file, or you can create so many configurations as you need.
In the folder "data/logs/" is stored the MySQL errors in the file "sql.php". This file save each error with data/time, file and query.
The folder "instalar/" contain the installer and you must delete after installation.
The folder "xestion/" contain the users and roots administration, and the file and folder indexed.
Basically the PHPfileNavigator allows the file and directories navigation and administration in a remote server, but in addition it allows the accomplishment of certain extra actions:
To create this protection, only have to click in a folder icon in the file list. Then choose the "Protect" option and write the user and pass that can access by web. To delete this protection, only send the from with blank fields.
To do this, we will should to acess how admin in the root administration and put a limit size in "Size limit" field.
Then the PHPfileNavigator obtain the actual folder size and will create in "data/info/" a folder with root id and two files onto, one with root limit and other with actual size, that will update when copy, delete, upload, ...
The admin user will have posibility to create users and roots, and related.
One user or root can be deleted or inactive if you need.
So we can view this thumbnails in the file list and the tree view.
These are single some of the multiple functions which it has this application distributed under license GPL.
WARNING: The use by several roots is not nothing recommendable on same path or subpath since it can cause problems with the indexed and the limitor of size.
If I create a root "var/www/html/" and other "var/www/html/directory/", and limit some one (or two) in file size, when I'm working in some one and add files, or delete or move or copy,... the other root isn't going away to find out and the file search will give back incorrect information and the actual folder size is incorrect.
If you think that this tool can you be useful and you like that I continue in the development (although my English is terrible), please do a donation in the PAYPAL button.
To all peple that colaborate in the PHPfileNavigator, THANKS.