Latest revision as of 05:32, 28 May 2010

Project ROAR: Rhea Online Testing Resource

Introduction

Project ROAR was initiated in the Spring semester of 2010, as an attempt to provide students and professors the ability to create online tests; a forum for academic interaction, where professors could test students, and students in turn could post their own questions. The inspiration for this project came from the evident lack of an open source testing platform. Freshmen in the school of engineering, physics and math for example, are required to pay as much as $25 for similar testing software, simply to have access to pre-existing quizzes and tests. The RHEA Development team decided to overcome this problem by conceptualizing an open source web-app based on the Rhea server, that would give students and professors the same ability without the need for these expensive third party software.

ROAR can be visited here.

The ROAR Team

• Professor Mireille Boutin (Faculty Adviser)
• Zach Mason (Graduate Student Adviser)
• Aakash Lamba (Co-Project lead, programmer, Web Designer)
• Dhruv Lamba (Co-Project lead, programmer, Web Designer)

Documentation

• Project ROAR is intended to be a long-term project that starts off with a concept and basic functionality, which can then be expanded by future teams.
• This page will serve as the ROAR development team project log, wherein all the documentation and project details may be accessed by future development teams.

The initial thought process: how ROAR was born

This section includes a preview of what the development team initially came up with for how ROAR should look and feel, as well as its functionality. The following PDF includes the thinking behind the name ROAR, as well as a mock web page showing its intended features.

Media:roar_concept.pdf

Tools

• Since the eventual goal for ROAR is to be integrated into the MediaWiki platform where RHEA lives, what is needed is a php or javascript based web app that communicated with the RHEA database.
• Therefore, for those interested in the project, a working knowledge of the following tools is recommended:
  • HTML
  • PHP
  • CSS
  • SQL

• In addition knowing how to set up and work on a LAMP/WAMP server is very useful.

Code Repository

• Rather than making individual form handling pages, it is much cleaner to organize the web app using functions.

Here is how a well organized php file ends up looking like

*****************************************
<?php


function basic_html(){

   $html = <<<page_html
              <!--------SOME HTML---------------->
           page_html;
   return $html;
}

function1(){
}
function2(){
}

if{(some action required) 
     $html .= functioncall1();
}elseif{(some other action)
     $html .= functioncall2();
}else{
     $html .= basic_html;
}

echo $html;
?>
***********************************************

• Thus, the entire program is extremely easy to manage and various actions can be handled separately to display certain html code that can be neatly tucked away within functions.
• Now what was given above was a very top level design of how to make a web app. The following section provides code snippets that explain the process in more detail.

Actions

• One of the way php decides what to do with user input data is through actions.
• HTML forms, radio buttons, checklists etc. all need a defined action when the data is submitted. The handling action may be a page, or another function within the web page.
• Since we described in built functions as a better way of doing things, the method described here will use functions.

<form action="index.php?action=doThis"  method="post"><input type="submit" value = "Do This"></form>

• This code generates a very simple button that says Do This. The form lives inside some html code within the file index.php.
• Now whenever the user presses this button, the form passes the value doThis into the form action.
• This action value is now available for handling, but to access it, we need the following code:

$action = $_GET["action"];

• Once this is done, the value of action lives inside the variable $action. Now this can be used to call a certain function that handles this particular action. Something like

$html .= handleAction($action);

function handleAction($action){

if($action == "doThis"{
   $html = some_html_code for the desired action}
   }
return $html

}

• What this means is that everytime the variable action receives the value doThis from the above form, the handleAction function loads

the desired action html code into the variable $html which is returned by the handleAction function.

• Once returned the statement

$html .= handleAction($action); 

Entire Code

• To access the entire code, you may click the link below
• Media:ROAR_REV_04_09_2010.zip
• Media:ROAR_REV_04_11_2010.zip
• Media:ROAR_REV_04_30_2010.zip

User Manual

ROAR currently lives on a test server at web page : msee393mac3.ecn.purdue.edu/roar which is our test page. The web page allows professors to create assessments for their classes and later place links for the created assignments on their web page. To do this, the following instructions apply:

• 1:Click on the link Create New Assignment
• 2:Login with your username and password ******** (At the moment, to test ROAR beta 1.1 we are only giving out the password for creating quizzes to users who want to participate in the Beta testing process. To get the password, please email dlamba above)
• 3:Once logged in, you may use the on-screen menu to create your quiz.
• 4:When finished, you may place a link to the created quiz on the New Assignments page by simply clicking Complete Quiz followed by OK.
• 5:To place a link on your own course page/website you may simply right click on the link to your quiz and click on Copy Link Location.
• 6:When on your webpage/Rhea page, simply paste the hyperlink to the assessment and this should make a link to the quiz available.

Semester Summary and Future Goals

The learning curve for making this web application was obviously a big one. While we got a basic page working that allows logged in users to create a quiz, as well as take one of the available quizzes; there were several more features that are summarized below that we would have liked to integrate into ROAR had we more time:

• The ability to have a formula bar to allow users type in symbolic equations into the questions.
• The ability to have a picture upload section in the question making section to allow users to add graphs, pictures and scanned notes
• The ability to have an equation checking algorithm that would let quiz takers enter a formula, in LaTex for example, and check for its correctness.

Last Edit:Dlamba 21:30, 3 May 2010 (UTC)