Customizing Student Links

Students take tests by clicking on a link to one of these 3 files: TakeTest.asp, TestMenu.asp, and TestCode.asp. The one the teacher chooses depends upon specific application needs.  Students can also review test content by playing the Academic Olympics Game with a link to game/StartGame.asp.

  1. If you want to put a DIRECT link from your course materials to a SPECIFIC test, then create a link to TakeTest.asp.

    • General Link Instructions:
      • TakeTest will only ask for the student's name and password. Then it will take the student to the test specified.
      • The link to TakeTest.asp is normally set to open in a NEW window. The exceptions are listed below under Window Display Options.
      • The names of the student and Test Areas as well as the Test ID are all hidden in the link parameters as shown below.
      • If NO parameters are set as part of the link, then TakeTest will ask for the name of the student and Test Areas as well as the Test ID.
    • Setup and Confirmation features:
      • If the test is setup in Advanced Features to allow and confirm new names, then to enter a new name the student must check the "Click here if you are a NEW student" box.
        • Every student or employee must have a unique password, ID or employee number.
      • If the test is setup to allow new names without confirming them or to request no name at all, then the "Click here if you are a NEW student" box does not appear
        • Students or employees can have the same passwords.
    • Setup By-Pass Parameters
      • If these parameters ARE entered with the link to TakeTest, then this page will only ask for the student name and password.
      • It is possible to add parameters for the student name or password so that even these fields do not appear, for example, when doing a survey.
      • Test Area: Since there can also be any number of Test Areas, the one the teacher wants these students to access must be specified.
      • Test ID: A Test Area can have any number of tests in it. Each test has a Test ID that identifies the specific test the student is to take.
      • This is what the hyperlink to TakeTest.asp should look like:
         http://www.robotutor.com/RoboTutor10/taketest.asp?testarea=Everyone9&testpassword=A11
      • If you are linking to the RoboTutor site, you only need to enter the Test ID (shown in green at the very end). The Test ID (test password) is a unique number or name that you assign a test when you create it. If you are on another site, you also need to change the path (blue) and the names of your student and Test Areas (lavender).
        •
      • If you would like to have your students or employees enter 1 or more Sorting Codes (course number, teacher, age, etc.) when they log into a test, add &code=true to the end of the hyperlink shown above.
      • Sorting Codes can be used in Student Administration to select students for various reports.
        •
        • You can also enter the Sorting Code directly in the command line if you want that code for every student. For example, &code=Jones3 for Mr. Jones' 3rd period. 
          • To add several Sorting Codes from the command line, include a COMMA between them, but NO spaces. For example: &code=Jones,Period3
    • Window Display Options and Student Links:
      • If you setup the test in Advanced Features to open in a New Browser window, then you should set any link to the test to open in a NEW window.
        • If you are using the Training Menu, then the link the link should be:
           http://{URL}/robotutor10/default.asp
      • If you setup the test in Advanced Features to open Full Screen, then you should open the test in the same window as the link.
        • If you are using the Training Menu, then the link the link should be:
           http://{URL}/robotutor10/default.asp?window=1
        • When linking to the Training Menu or directly to the test, adding "window=1" makes it so the Exit button returns to the previous page rather than closing the window.
           
  2. If you want your students to see a MENU of all tests in a specific Test Area, then create a link to TestMenu.asp.
     
    • TestMenu is designed to automatically create a menu of all tests in a specific Test Area. All the links from this menu are automatically set so students only need to enter their names.
    • The names of the student and Test Areas as well as the title on the menu page are all hidden in the link parameters as shown below.
    • The link to TestMenu.asp should always be set to open in a NEW window.
    • If NO parameters are set as part of the link, then TestMenu will ask for the name of the Test Area and the title for the test menu.
    • If these parameters ARE entered with the link to TestMenu, then this page will not display and the student will go directly to the menu itself.

    • This is what the hyperlink to TestMenu.asp should look like:
      http://www.robotutor.com/RoboTutor10/TestMenu.asp?
      testarea=everyone9&testtitle=My Tests

      •

    • If you are linking to the RoboTutor site, you only need to enter a test title (shown in green at the end). If you are on another site, you need to change the path (blue) and the names of your student and Test Areas (lavender).

  1. If you want to use a "test" in a GROUP PRESENTATION or an ANONYMOUS SURVEY, you will probably NOT want the program to ask for a student name and password.

  • To skip the Log-In page, the hyperlink should look like the following. Notice it is the same as the above except the text in blue has been added. You can use whatever first name, last name, and student password you prefer. Everyone who takes the test will go in under that name.
     http://www.robotutor.com/RoboTutor10/taketest.asp?firstname=Student&lastname=Survey1&studentpassword=Survey1
    &    testarea=Anonymous&testpassword=A11
    • Note: the values in lavender shown above (firstname=Student, lastname=Summary and studentpassword=12345) can be substituted with any other values you prefer as long as they are not used by any existing student.
  • Another option is to have TakeTest list all the tests in a specific Test Area using a drop-down menu in place of the text field that asks for the Test ID.  That way students can simply pick a test. You could have a Test Area with nothing but the tests in a specific subject. To start the game with a drop down menu, replace testpassword={Test ID} with testpassword=testmenu like this: http://www.robotutor.com/RoboTutor10/taketest.asp?firstname=Student&lastname=Survey1&studentpassword=Survey1
    &    testarea=Anonymous&testpassword=testmenu

  1. It may be desirable at times to restrict student access to tests and course materials by linking them to TestCode.asp.  An example is where students are paying for the right to take an online course.  To setup RoboTutor for this purpose, follow these steps:

    • From the main menu, click on System Administration. Access is limited to those who know the password to this area.
    • On the next page, scroll down to the Access Codes section and enter the number of pass codes you want to generate in the # field.
    • Enter the number of months the pass codes will be usable once they are activated in the Mo. field.
    • Enter the URL where the students will go to see the course materials.
      • RoboTutor comes with 3 course templates already setup in the /courses folder. Then use a path to that folder as your URL above. The URL you put in the form to create Access Codes for /course1 would then be http://{your server}/robotutor10/courses/course1/CourseTitle1.asp.
      • Note, if you click the Test Link button and your address is CORRECT, then you should get the following: Application Error, A Pass Code was not specified. It says this because you should not be able to access these pages without a test code number.
    • Click Submit and a page appears that lists the pass codes generated. Be sure and print it.
    • The next step is to generate the course materials using the files in your new course folder.
      • Open CourseMenu1.asp in an HTML editor such as FrontPage.
      • Add or delete menu links as needed.
      • Modify the Final Exam link at the bottom to include your Test Area and the password to the test.
      • Do the same for each of the Section pages.
      • When the course materials are finished and on the network, put a link for your students to TestCode.asp. Give (or sell) to each of your students one of the pass codes. You can put a link directly to the log-in page or use the Training Menu with Test Access Codes.
        • To link directly, use: http://{your server}/RoboTutor10/testcode.asp
          • . Enter the URL in System Admin when you create the codes.
        • To link using the Training Menu, enter the URL in Setup Training Menu and leave the URL blank when you create the Access Codes in System Admin. If you enter URLs in both, then the URL used in System Admin will override the one in the Training Menu.
      • Students will be only asked for their Access Code. Once they enter their name, it is tied to that Access Code and all they need to do in the future is enter the code to access the course materials.
         
        •
  2. If you want your students to PLAY a GAME using the questions from any test, then create a link to game/default.asp.
     
    • The names of the Test Area and Test ID are usually hidden in the link parameters as shown below.
    • No Student Records are saved in the Test Area database, so no reference needs to be put in the code.
    • The link to StartGame.asp should always be set to open in a NEW window.
      • Note, the files for the game are all in the Game folder under the main menu. Your links must therefore include the name of the folder as shown below.
    • If NO parameters are set as part of the link, then StartGame will ask for the Test Area (testarea) and the Test ID (testpassword).
    • If these parameters ARE entered in the parameters with the link to StartGame, then StartGame will only ask for the names of the players.

    • This is what the hyperlink to StartGame.asp should look like:
             http://www.robotutor10.com/robotutor10/Game/default.asp?testarea=Anonymous&testpassword=MyTest&Help=Answers

    • If you are linking to the RoboTutor site, you only need to enter the name of the Test Area (shown in lavender) and  Test ID (shown in green at the end). If you are on another site, you need to change the path (blue).

    • Another option is to have StartGame list all the tests in a specific Test Area using a drop-down menu in place of the text field that asks for the Test ID.  That way students can simply pick a test. You could have a Test Area with nothing but special game versions of the tests. To start the game with a drop down menu, replace testpassword={Test ID} with testpassword=testmenu like this:
      http://      www.robotutor10.com/robotutor10/Game/default.asp?testarea=Anonymous&testpassword=testmenu&Help=Tutorial

    • To make a link to a game, go to the Question List page and click the Game link at the bottom of the page. When it opens in your browser, copy the Address and put it anywhere you want a link.
      • To have the game display the CORRECT answer when students miss a question, the path to the game should have Help=Answers at the end. This is the default when you click on the Game link.
      • To have the game display the TUTORIAL answer when student miss a question, change Answers to Tutorial so it looks like this: Help=Tutorial.
      • To have the game display both CORRECT and TUTORIAL answers, use Help=Both
      • To have the game display nothing, use Help=