WebTester Documentation (Under Development)

Table of Contents

 

Installing WebTester

Manual Installation

Installing WebTester is pretty straightforward. Upload the archive to your web server root directory, and type the following command:

tar -zxvf webtester.tar.gz

This should extract WebTester into its own folder (called webtester). After extracting, you should be able to type the following into your web browser:

http://www.yourdomain.com/webtester/license.php

Continue installation at the Licensing section.

Using the installation wizard

If you are on a Windows machine, you can use the installation wizard. Just follow the onscreen instructions, and it will automatically upload the files for you. After it is complete, you are presented with the following license screen:

License Setup

After installation, you will be presented with this license screen:

If you have a license, copy and paste it into the license text field. If you do not, click the trial license link to get a trial license. Some servers are not able to write license files automatically because of permissions. If your server has this problem, you can place the text into a file called license.txt and upload it to WebTester's root directory. If you are unable to obtain a trial license, visit the support forums and request one.

After your license is setup, you need to setup the database.

Database Setup

For database host, enter your MySQL servers address. If you are using the current machine, you can just enter localhost.

For database name, enter the database name you would like to use. This can be 'webtester' in most cases.

For database username and password, enter the username and password for the MySQL server that you would like to use.

If you are using cPanel, enter your cPanel username, password, and domain so WebTester can create the database for you.

If you get any errors, please contact support, and we can manually create the database for you.

After installing, you can log in with the default username of admin, and password of admin.

Taking a Test

There will now be a default Sample Test installed. You can access it by going to http://www.yourdomain.com/webtester (or http://www.yourdomain.com if you installed WebTester in your web server root directory)

Follow the onscreen instructions to take the sample test.

Logging In

After installing WebTester, you can login to the administration side by going to http://www.yourdomain.com/webtester/admin (or http://www.yourdomain.com/admin if you installed WebTester in your server root directory). The default login details are:

Username: admin
Password: admin

Test Management

After logging in, you are presented with the Test Management screen:

Creating a Test

To create a test, click the icon. It will bring up this form:

For Name, enter a name that will describe the test.

For Passing Score, enter the minimum score required to pass the test.

Type your instructions using the HTML editing box.

Select the Subject you would like this test to belong to.

Check the Enabled box to enable the test

Check the Randomize Questions box to have every test shuffled.

Check the Require Login box to require test takers to login

Check the Email Instructor Results to have the test results emailed to the test creator (instructor)

Check the Email User Result box to have the test results emailed to the test taker

Select the Email Template to use when sending emails

Select the Report Template to show when the test is finished.

Set up a time limit if the you would like the test completed in a certain time.

When finished, click Create to create the new test.

Creating & Modifying Test Questions

After creating a test, you are presented with the Question Editor pictured above. To create a new question, click the icon in the upper left. To edit a question, just click the icon or click on the question text.

You are now presented with the form below:

Use the HTML form to type the question text that the user will see.

If you enter something in Short Answer, that will be the correct answer. Note that users must match what you typed in exactly, except that the field is not case sensitive. For example, if you enter "TEST" into short answer, and the test taker enters "test" they will get the answer correct. But, if you enter "$25" and the test taker enters "25" they will get the question incorrect. Make sure your questions instruct the test taker on how to enter this answer, if formatting is important.

The next 6 answer fields are for multiple choice questions. If you enter only 2 out of the 6, only those two will be displayed. Put a checkmark in the 'Correct' box to mark which answers are correct.

You can specify how many points a question is worth by entering a point value in the Points box. For example, if you have a 10 question test and each question is worth 1 point, test takers can score 10/10 points (100%). But, lets say you have a 10 question test with the first 9 questions worth 1 point, and the last question worth 91 points. If they get every question wrong except for the last question, they will get a score of 91/100. Or, if they get every question right except for the last one, they will score only a 9/100.

Using Math Formulas

To use math formulas in WebTester, use the following sytax:

[tex]\sqrt{9}[/tex]

This will generate an image that looks like this:

You can generate these TeX and LaTeX formulas by hand, or there is a program called MathType that can help you generate them.

Reording Test Questions

To change the order that questions are presented in, click the icon in the question editor. Then, drag and drop the questions into whatever order you want.

Viewing Question/Test Statistics

To view statistics collected for questions, click on the icon. If you click on a specific question, it will only show you statistics for that question only. If you click the same icon in the toolbar, it will show you statistics for all questions for that test.

Deleting Questions

To delete a question, click the icon next to it, or put a checkmark next to the questions you would like to delete and click the same icon in the toolbar. On the next page, confirm that you want to delete the selected questions.