**** Author : Philippe Rigaux, rigaux [at] lri.fr
**** 
**** This is the MyReview system for web-based management
**** of conferences. MyReview is distributed under the GPL licence,
**** and you can use and modify it
**** at will. I will appreciate if you give me some feedback, though.
**** 
**** The systems runs under PHP/MySQL and a web server like Apache.
**** It has been tested under Linux and Windows. Note that MySQL
**** can easily be replaced by any other DBMS: there is a BD.class.php
**** class that encapsulates all the DB functionalities
**** 

QUICK INSTALL
-------------
   All the files should be located in a directory accessible to
   the web server. In the following I assume that the directory is
   /apache/htdocs/myreview, and that the URL to access the system  
   is http://localhost/myreview 

   First you need to create a MySQL DB as well as a user to access the DB.
   The script CreateDB.sql provides the commands. 

   mysql> source CreateDB.sql

    You can change the DB or user name. Now, check that DBInfo.php
    is writable by any user, and that both the FILES subdirectory
    and the tmpPDF subdirectory are executable AND writable. 
    Access to the URL:
             http://localhost/myreview/
    with a web browser: the automatic installation script will be launched.
    Just fill the fields and submit the form.

   If you prefer the manual install, you should report
   the DB and MySQL user infos in the DBInfo.php file which
   contains the necessary information to access the database 
   for PHP scripts. You must also, in a manual install.
   create the schema of the database:

     mysql> source Schema.sql
 
   If you changed the name of the DB, replace 'USE Review' at
   the beginning of the script with 'USE my_db_name'.
   
                         --------------

   OK: it is installed (simple enough?). 
   You should now be able to access and use the system. If you chose
  the manual install, you can connect as an admin
   using the login myreview@lri.fr/08b271. 
   See the doc.pdf for details.
   
GETTING STARTED
===============

 The initial configuration is presented in a form, accessible
 from the administration interface. You should modify the values
 according to your own choices. 

 VERY IMPORTANT: 

    1/ on a production site you must modify the 
       default value of 'passwordGenerator' parameter ('pwd')
        which is used for generating
        passwords (this is done with the automatic install). 
        When you submit the new value, your own
        password is modified, and displayed at the top of the form.

           YOU MUST NOTE AND REMEMBER THIS NEW PASSWORD.

        If you ever forget an administrator password, you
        can use the following script to recover it.

	<?php
	require_once ("Util.php");

	$user = "myreview@lri.fr";
	$db = new BD (NAME, PASS, BASE, SERVER);
	$config = GetConfig($db);
	echo "The password of <b>$user</b> is <b>"
	      . PWDMember($user, $config['passwordGenerator']) . "</b>";
	?>

   2/ The FILES subdirectory MUST be accessible in write mode
       to the web server (uploaded papers are stored there)

   3/ The tmpPDF subdirectory MUST be accessible in write mode
       to the web server (temporary PDF documents are stored there)

   4/ The PHP configuration must set the 'magic_quote_gpc'
      parameter to 'on'. This ensures that all quotes 
      transmitted via HTTP (for instance when a form is submitted)
      are escaped properly (\' instead of ').
  
      MYREVIEW WILL NOT WORK CORRECTLY IF MAGIC_QUOTES_GPC IS OFF

HOW TO CUSTOMIZE THE SITE
=========================

  One of the main aspects of MyReview is the use of PHP
  templates. This means that the HTML code is completely
  separated from the PHP code. In the subdirectory
  templates, you will find a set of files with .tpl extension.
   The most important one is 'Page.tpl'. Basically it is 
   an HTML page with two specific "entities": {TITLE} and {BODY}. 
   The systems simply takes this "templates" and instanciates
    the entities with the proper content. So
   if you provide your own HTML pages with the same entities,
    everything will work transparently. Two examples
    are provided: SimplePage.tpl, and acmgis.tpl (an advanced
    design with CSS, JavaScript, images). Rename one of
   them to Page.tpl, and see the result.
   
   The other .tpl files contain all the pieces of text
   displayed in the pages. You can modify everything (change
   the language for instance) without being burdened with PHP code.

   Part of the site was originally written in French so the code
   contains few parts with french comments. A good occasion
   to learn this great language.    

TO COME NEXT
============

    - Authors rebuttal
    - Support for camera-ready preparation
    - PDF output