**** Author : Philippe Rigaux, rigaux [at] lri.fr
**** 
**** This is the MyReview system for web-based management
**** of conferences. The code is free, 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
**** 

HOW TO 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. In that case you should report
   these changes in the DBInfo.php file which contains the necessary
   information to access the database for PHP scripts.

   Next you must 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: try
   to access the URL and test using the login myreview@lri.fr/08b271.

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: on a production site you must modify the 
 'passwordGenerator' parameter which is used for generating 
  passwords. 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>";
	?>

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

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.

   Note that while the PRESENTATION is fully customizable, but not 
   the NAVIGATION. The system relies on a few set of modules which are
   interrelated.

     - SubmitAbstract.php and SubmitPaper.php: the submission interface
     - Review.php: the reviewing interface
     - Admin.php: the administration interface

   You are free to organize your site to point appropriately on these
   pages, but you cannot change their names.

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

TO COME SOON
============

Priority 1: Documentation

Priority 2: (forthcoming functionalities)
    - Customization of the review form