Unzip PHPWebQuiz.zip and move the folder PHPWebQuiz for example into your folder [Program files]
To have easy access to the manual, create a shortcut from [Program files]\PHPWebQuiz\ReadMe.html
to your start menu folder.
To install PHPWebQuiz, copy the folder ..\PHPWebQuiz\English into your desired web publishing folder.
Of course, you may rename the folder ..\English as you like. Lets say, you rename it to ..\WQ!
If your web site uses for example the root folder C:\Inetpub\wwwroot\, for Windows servers it is recommended to
install PHPWebQuiz into your folder C:\Inetpub\wwwroot\cgi-bin\. The reason is, that a
hosting provider using Windows servers will have given most probably write permission to the whole folder "cgi-bin".
This means, you will have
a folder C:\Inetpub\wwwroot\cgi-bin\WQ\ with the necessary content (according the renaming above).
In the following lines, I will reference "your web site root folder" as [wwwroot] instead of "C:\Inetpub\wwwroot\" in the example above.
If you use a UNIX server, you may not use the cgi-bin folder, as in many standard configurations a php-script
will not run there. Any other folder will do, as you can give it write permission yourself.
Your folder [wwwroot]\cgi-bin\WQ\ needs to have script execute and write permission.
PHPWebQuiz is now installed in English. To install it in German, copy the folder
..\PHPWebQuiz\Deutsch instead of ..\PHPWebQuiz\English to your [wwwroot]\cgi-bin\ directory.
The start page Welcome.php contains two more options:
- You may automatically delete data records which are old
or where the respective quiz has not been finished.
To activate it, open Welcome.php with a text editor and delete the comment
signs "/*" on line 123 and "*/" on line 148! Here, you will find more information
about further details.
- You may activate a hit counter by deleting the comment
signs "/*" on line 159 and 189!
To run PHPWebQuiz, start your browser and open the URL
http://www.localhost/ stands for the URL of your web site!
If you open the URL
you get a page named "index.html", which will auto redirect you to the address above.
Security, more recent server settings
Depending on your type and version of your web server, you can use more restrictive security settings.
PHPWebQuiz may run with "write permission" denied on all folders and "read permission" denied in ...WQ\PHPWQScore and ...\WQ\QuizFiles
(but not there subdirectories).
If you rename all your knowledge files
and your rtfQuestion files
, you may even switch off read permission for the folders ...\WQ\QuizFiles\Knowledge
. You would then have to move any pictures to another folder with read permission granted.
Example for recent configuration changes: Even the Microsoft IIS 5.1 does not require to put PHP scripts in a cgi-bin directory any more.
By modifying locals.php
you can choose custom locations for your folders containing the quiz files and/or the score data.
Update March 20, 2008