INSTALL - phpExplore v1.4 - (c) 2001 J.C. Cardot <taz98@altern.org>

Prerequisites :
- a web server with php3 installed
- mysql only if you need file locking

Installation :

1. Unpack the tarball
 - somewhere in your web site (preserving the directory structure)
or :
 - in a temporary directory on your workstation, then FTP everything to the server, preserving the directory structure (and the case of the names, i.e. linux and LINUX are not the same).

The prefered place is the root of the web site, since many servers have php configured in "safe-mode" where php scripts can't access to files elsewhere than in their own directory or sub directories.

By default, it will create two entries :
- explore2.php3
  this is the page you will access to explore, edit, s.o.
- explore2
  this is the directory where phpExplore stores all its files.
- .cvs
  this directory will contain some information about the file locking provided with phpExplore.

You can rename the explore2 directory, but don't forget to change the $explore_dir affectation at the beginning of explore2.php3.

2. modify the explore2/private/passwd file

You can add many users. One line per user, a line is of the shape :
'user:passwd'.
Don't forget to check that nobody can access the passwd file with a web browser (the .htaccess file should prevent that, but...)

Note1 : authentification uses cookies.

Note2 : you may also add a authentification at the server level. For example, an Apache server will use a .htaccess file like this one :
---
  AuthUserFile /secret/path/to/password
  AuthName "Restricted access"
  AuthType Basic
  <Limit GET POST>
     require valid-user
  </Limit>
---
where the file /secret/path/to/password stores the logins and unix crypted passwords.
For example:
---
  login1:crypted_pwd1
  login2:crypted_pwd2
  login3:crypted_pwd3
---
and the /secret/path/to/ directory should contain a .htaccess file like this :
---
  deny from all
---
in order to prevent someone who would have discovered the pass to your passwd file to get it.
Note that in this case, you will password protect the whole directory where you installed phpExplore and all sub-directories. You should then install phpExplore in a sub directory, or you will prevent normal users to access your site.


3. file locking :
(if you don't need it, skip this section, but keep the .cvs directory anyway)
It needs a mysql server.
You have to :
- modify the following lines of explore2/include/sql.php3 :
  $dbhost = "the.host.com";  // may also be "localhost"
  $user = "db_username";
  $password = "db_password";
  $usebdd = "database_name";
- create a table named 'cvs', with the following SQL definition :
  CREATE TABLE cvs (
     user varchar(32) NOT NULL,
     fichier varchar(255) NOT NULL,
     dateheure datetime DEFAULT '0000-00-00 00:00:00' NOT NULL
  );
In order to activate the use of file locking, each user will have to clic the "Activate CVS" button.

4. If your web server doesn't like the .php3 file extension, rename all .php3 files to .php, and replace all "php3" strings with "php" or whatever extension you chose in the files :
explore2.php3
explore2/include/edit.inc
explore2/include/explore_vars.inc
explore2/include/initcvs.inc
(ok, I'll add a configuration tool in the next version for this kind of things ;)

5. that's all ! Just call http://your.host/your/path/explore2.php3
in your web browser and enjoy !
