📚 Help Center

Learn how to use the Law Test Randomizer

🚀 Quick Start Guide

1

Sign Up or Log In

Create a new account or log in with your existing passphrase

2

Navigate Dashboard

Use the main dashboard to access all features based on your role

3

Start Working

Teachers can upload tests, students can take assigned tests

👨‍🏫 Teacher Guide

📤 Upload Tests

Upload CSV files containing your law test questions. Download our ready-to-use template with sample questions to get started quickly. The system automatically randomizes question order for each student.

📋 Manage Tests

Activate or deactivate tests as needed. Only active tests can be taken by students.

🎯 Assign Tests

Assign specific tests to individual students in your class.

👥 Manage Students

Review and approve student requests to join your class.

📊 View Results

See detailed test results including scores and individual answers for each student.

👨‍🎓 Student Guide

🏫 Join a Class

Enter your teacher's invite code to request access to their class. Wait for approval.

📝 Take Tests

Click on assigned tests to start taking them. Questions will be randomized for each attempt.

📈 View Scores

See your completed test scores on your dashboard. Detailed results are available to your teacher.

📖 Detailed Instructions

📁 CSV Format for Pasting

When pasting questions, your CSV rows should follow this format:

💡 Quick Start with Template

The easiest way to get started is to download our CSV template from the "Upload New Test" section. It includes:

  • Correct header format
  • 5 sample law questions
  • Proper CSV formatting examples
  • Ready to customize with your content
Question,Option A,Option B,Option C,Option D,Correct Answer
"What is the primary source of law?","Constitution","Statutes","Case Law","Regulations","A"
"Which amendment protects freedom of speech?","First","Second","Fourth","Fifth","A"

Important Notes:

  • First row must contain headers exactly as shown
  • Correct Answer column should contain the letter (A, B, C, or D)
  • Questions and options can contain quotes - use proper CSV escaping
  • Each row represents one question with four multiple choice options

🔐 Account Management

🔧 Admin Features

For Teachers Only: The Admin panel allows you to:

  • Add new teacher accounts
  • Add new student accounts
  • Run database queries for advanced management
  • View system statistics and usage data

🎲 Test Randomization

The system automatically randomizes tests to ensure academic integrity:

  • Question Order: Questions appear in different orders for each student
  • Fair Assessment: All students receive the same questions, just in random order
  • Automatic Process: No additional setup required - randomization happens automatically

❓ Frequently Asked Questions

How do I create an account?

From the login page, click "Don't have an account? Sign up". Fill in your full name, choose your role, and create a strong passphrase (10+ characters with at least one letter and one number, no spaces). Each passphrase must be unique—if the one you pick is already in use, choose a different combination.

How do I upload a test?

As a teacher, go to your dashboard and find the "Upload New Test" section. You can download our CSV template with sample questions to get started quickly, then customize it with your own content. Choose your CSV file, optionally add a title, and click "Upload Test".

Why can't my student see the test I uploaded?

There are three possible reasons:

  • The test needs to be activated (toggle the status in "Manage Tests")
  • The test needs to be assigned to the specific student
  • The student needs to be approved to join your class
How do students join my class?

Students enter your teacher invite code in the "Join Teacher's Class" section. You'll see their request in "Pending Requests" and can approve or deny access. Invite codes are visible in your dashboard—keep your personal passphrase private.

Can students retake tests?

Currently, students can only take each assigned test once. Once completed, they can view their score but cannot retake the test.

How is test randomization handled?

The system automatically randomizes the order of questions for each student when they take a test. This happens behind the scenes - no setup required. All students get the same questions, just in different orders.

I forgot my passphrase. How do I recover it?

Passphrases are stored securely and cannot be retrieved. Ask your teacher or an administrator to reset your passphrase from the Admin dashboard. They can issue a temporary passphrase that you should change after logging in.

My passphrase is already taken. What should I do?

Passphrases must be unique across the system. If you receive a duplicate warning, choose a new combination that includes both letters and numbers—longer phrases are more secure and less likely to clash with other users.

What file formats are supported for tests?

Currently, only CSV (Comma Separated Values) files are supported. Make sure to follow the exact format shown in the detailed instructions above.

💬 Need More Help?

If you can't find the answer to your question in this help center, please contact your system administrator or IT support team.

When contacting support, please provide:

  • Your role (Teacher or Student)
  • What you were trying to do
  • Any error messages you received
  • Screenshots if applicable