The Homework Reporting System
Copyright (C) 2000 Chris Lehmann
written for The Beacon School -- http://www.beaconschool.org
Author info: email: clehmann@beaconschool.org
Home Page: http://www.beaconschool.org/~clehmann/

Requirements:

(Or at least I know it works on this stuff...)

* PHP 3.0 or greater
* MySQL 3.22.32 or greater
* Apache Web Server

Install:

* Untar the files in a web-readable directory. The "faculty" directory
  contains the teacher-interface and the "student" directory contains
  the student-interface. All of the configuration and header/footer files 
  are in the "config" directory. 

* Run the following command: mysql < database.txt 
  This will set up the database "homework" for use with this project.

* Edit the config.inc.php file in the config directory. 

* I put the config symlinks in so that the include calls can work
  as is *or* if you put them into a secure (non-web-accessible) place like
  /usr/php/share and have your PHP configured so that directory is in the
  include path. That's an especially good idea if your students have shell
  access to MySQL.

* Password-protect (using .htaccess or another method) the "faculty"
  directory so that only teachers can access it. 

* For the purposes of this program, you cannot add/remove staff members 
  via the web. I did that so that only administrators could add / delete
  staff members from the list. I use (and recommend) phpMyAdmin to admin
  my MySQL databases, which makes it rather easy to add new teachers.
  phpMyAdmin is here: http://phpwizard.net/projects/phpMyAdmin/index.html

* If you don't use phpMyAdmin, you can add teachers by accessing MySQL
  from your shell prompt:
	mysql -u sample
	(this will put you into the mysql interface)
	use homework;
	INSERT INTO staff (teacher, username) 
	VALUES ('<TEACHER>','<TEACHERUSERNAME>');
	exit
  (The username function is not used for this project, but is used with
  other projects. For Beacon, we use an eight letter username... the
  users's first initial and the first seven letters of their last name.)

That should be it!

If you have questions, comments, updates, etc... please let me know:
clehmann@beaconschool.org 

-- Good luck!
-- Chris Lehmann
-- Technology Coordinator
-- The Beacon School
