*********************
*****           *****
***** PHP QUIZZ *****
*****   v3.0b   *****
*****           *****
*********************

HELP FILE - ENGLISH VERSION 
03/29/2000


**** ABOUT ****
******************
Copyright 2000, PHP VAULT, Kidou and Mathias Daval. 
http://www.phpvault.com
This script is a freeware.
You can use it and modify it freely, as long as you leave the copyright and TELL US IF YOU ARE USING IT.
Please contact us for commercial use, and let us know if you found this script useful (webmaster@phpvault.com)


**** DESCRIPTION ****
*********************
PHP QUIZ is a script written in PHP allowing the webmaster to create an unlimited number of quizzes with a user-friendly web interface, and no database - and no programming skills either :-).

Functionalities:
- Create an unlimited number of quizzes with an unlimited number of questions; 
- Web administration interface;
- Ranking and stats for your quizzes; 
- Confirmation email; 
- Customization of the quiz display. 


**** INSTALLATION ****
**********************
You should have 6 files:
- quizz_voir.php3 : quiz display script;
- quizz_admin.php3 : administration script ;
- quizz_default_config.dat : default configuration data ;
- quizz_config_gen.dat : global parameters;
- quizz_compteur.dat : counter (number of quizzes);
- quizz_help.txt : this help file.

1. Copy the files in the same directory, accessible to reading and writing;
2. Open files quizz_admin.php3 and quizz_voir.php3 and modify path and URL of your quiz directory  (NB.: no trailing slash);
3. Go to: http://wwww.your_site.com/quiz_directory/quizz_admin.php3 
4. Default login and password are: admin/admin. DON'T FORGET TO CHANGE THEM IN THE "GLOBAL PARAMETERS";
5. Create and customize your quizzes;
6. The URL of your quizzes will be : "../quizz1/quizz_voir1.php3" for quiz#1,  "../quizz2/quizz_voir2.php3" for quiz#2, etc.


**** HOW DOES IT WORK? ****
***************************
PHP QUIZ creates one directory and 4 files for each quiz:
- quizzX/: directory where it will put the four following files;
- quizz_voirX.php3: main quiz display;
- quizz_dataX.dat: questions/answers;
- quizz_reponsesX.php3: answers and scores;
- quizz_configX.php3: configuration data.

N.B.:
1. Do not try to modify directly the data in the above files. Use the admin interface for that. 
2. Remember that none of the files are protected. You may wish to put the admin and configuration files (containing your password) in a secured directory. 



**** CUSTOMIZATION OPTIONS ****
*************************************
The administration interface allows you to create and manage your quizzes. You can use HTML tags. Remember that you can leave all the fields blank if you want. 
- "Browser window title": <TITLE> option of an HTML page, i.e. the title displayed at the top of the browser;
- "<BODY> options": <BODY> option of an HTML page.  You can put for instance: bgcolor=white to get a white background;
- "Font": e.g. <font size=2 face=Verdana> ;
- "Quiz title": title displayed on the quiz, which will also be used as the subject for confirmation mails;
- "Before each answer": e.g. <LI> to get bullets;
- "After each answer": e.g. <HR> to insert a separation line;
- "Footer": footer of the quiz page;
- "Number of scores displayed": put "0" to prevent score display;
- "Display the results and scores: if you select "No", results won't be displayed. You will eventually be able to display the score manually (cf. FAQs) ;
- "Email confirmation to user" : if you select  "Yes", a confirmation email will be sent to each user, including his answers and score;
- "Notify webmaster" : if you select "Yes", a notification email will be sent to the webmaster after each participation to the quiz;
- "Webmaster's email" : email to send the notification email to;


**** FAQS ****
**************
- What are the requirements?
You must have PHP 3.0 or above installed on your server.

- How many quizzes can be created?
In theory you can create an unlimited number of quizzes. But remember that PHP QUIZ does not use any database! It will generates 4 files for each quiz! 

- What is the "comment" line for in the admin interface?
You can write a comment that will appear after the display of the right answer. You can add HTML tags (for instance <BR> to display the comment on the next line).

- I don't want users to see the right answers. How can I do?
You just have to configure the "Results and scores display" to "No" on the admin interface. When you want to display the scores table, go to the admin interface and click on the link "Scores".

- How to upgrade PHP QUIZ without deleting previous quizzes?
Change all files but compteur.dat (which counts the number of quizzes on your quiz directory).

- Is there a MySQL version of PHP QUIZ?
Not yet! But there might be one in the future, be patient! :-)



--------------------------
(c) 2000, PHP Vault 