Last Updated: 2026-05-27 | Applies to: IK v1.2+ | Role: Administrator, Teacher
Exam Module Architecture
The Exam Management System is built with a modular trait-based architecture:
IK_Exam_Module (Main Loader)├── IK_Exam_Types → Create/manage exam categories├── IK_Exam_Schedule → Create exam timetables├── IK_Result_Entry → Enter and verify student marks├── IK_Report_Cards → Generate and publish report cards└── IK_Exam_Analytics → Performance analytics and charts
Exam Management Pages
Navigate to: 📝 Exams in the main menu
Dashboard Cards:
┌─────────────────────────────────────────────────────┐│ 📝 Exams Management │├──────────────┬──────────────┬──────────────────────┤│ 🏷️ Exam Types│ 📅 Schedule │ ✏️ Result Entry ││ Create exam │ Create date │ Enter marks, verify, ││ categories │ sheets │ publish results │├──────────────┼──────────────┼──────────────────────┤│ 📄 Report │ 📊 Analytics │ ││ Cards │ View trends │ ││ Generate PDFs│ & insights │ │└──────────────┴──────────────┴──────────────────────┘
Exam Dashboard Stats
The exam dashboard shows 4 key metrics:
| Metric | What It Tracks | Source |
|---|---|---|
| Exam Types | Active exam categories | ik_exam_types WHERE is_active = 1 |
| Active Schedules | Upcoming exams (≥ today) | ik_exam_schedules WHERE exam_date ≥ CURDATE() |
| Pending Results | Schedules with draft/no results | Schedules after exam date without published results |
| Published Cards | Published report cards | ik_report_cards WHERE is_published = 1 |
Exam Workflow (Complete Flow)
Step 1: Create Exam Types ↓Step 2: Create Exam Schedule (date sheet) ↓Step 3: Enter Results (after exam) ↓Step 4: Verify Results (optional approval) ↓Step 5: Publish Results ↓Step 6: Generate Report Cards ↓Step 7: View Analytics
Recent Exams Table
Shows last 5 exams with status badges:
| Exam | Class | Date | Status |
|---|---|---|---|
| Mid-Term | Grade 10 | May 15, 2026 | ✅ Published |
| Unit Test 3 | Grade 9 | May 10, 2026 | 📝 Submitted |
| Final Term | Grade 8 | May 5, 2026 | 📄 Draft |
Status Badges:
- 🟢 Published - Results are public
- 🟡 Submitted - Results entered, awaiting verification
- ⚪ Draft - No results entered yet
Upcoming Exams Table
Shows next 5 scheduled exams:
| Subject | Date | Time | Room |
|---|---|---|---|
| Mathematics | May 30, 2026 | 9:00 AM - 11:00 AM | Hall A |
| English | May 31, 2026 | 9:00 AM - 11:00 AM | Hall B |
| Science | June 1, 2026 | 9:00 AM - 11:00 AM | Lab 1 |
Article 24: Creating Exam Types
Apprentice Lesson Setup
Chapter: Exams & GradebookLesson Title: "Setting Up Exam Types and Categories"Lesson Type: Step-by-Step GuideLabels: [Admin] [Guide] [Setup]
Article Content
Last Updated: 2026-05-27 | Applies to: IK v1.2+
What are Exam Types?
Exam Types define the categories of examinations in your institution:
Examples:
- Mid-Term Examination
- Final Term Examination
- Unit Test
- Monthly Test
- Pre-Board Examination
- Practical Examination
- Oral Assessment
Exam Type Properties
Each exam type has:
| Property | Description | Example |
|---|---|---|
| Name | Display name | "Mid-Term Examination" |
| Category | Grouping type | term, monthly, unit, final, practical |
| Max Marks | Default maximum marks | 100.00 |
| Weight % | Contribution to final grade | 30% (mid-term) + 70% (final) |
| Active | Enable/disable | Yes/No |
| Campus | Campus scope | All campuses or specific |
Exam Categories
| Category | Use For | Typical Weight |
|---|---|---|
term | Term/semester exams | 50-100% |
monthly | Monthly tests | 10-20% each |
unit | Unit/chapter tests | 5-15% each |
final | Final/annual exams | 50-70% |
practical | Lab/workshop exams | 20-30% |
oral | Viva/oral exams | 10-20% |
Creating an Exam Type
Navigate to: 📝 Exams → 🏷️ Exam Types
┌─────────────────────────────────────────┐│ Add New Exam Type │├─────────────────────────────────────────┤│ Exam Name: [Mid-Term Examination] ││ Category: [Term ▾] ││ Max Marks: [100.00] ││ Weight %: [30.00] ││ Active: [✓] ││ Campus: [All Campuses ▾] ││ ││ [Save Exam Type] │└─────────────────────────────────────────┘
Database Storage
Stored in wp_ik_exam_types:
sql
exam_type_id | exam_name | exam_category | max_marks | weight_percentage | is_active 1 | Mid-Term Examination| term | 100.00 | 30.00 | 1 2 | Final Examination | final | 100.00 | 70.00 | 1 3 | Unit Test 1 | unit | 50.00 | 10.00 | 1
Grade Calculation with Weights
Example: Final Grade Calculation
Mid-Term (30% weight): Student scored 85/100 → 85 × 0.30 = 25.5Final Exam (70% weight): Student scored 90/100 → 90 × 0.70 = 63.0────────────────────────────────────────────────────────────Final Weighted Score: 25.5 + 63.0 = 88.5%Grade: A
AJAX Operations
All exam type operations use AJAX for smooth interaction:
| Action | AJAX Method | Description |
|---|---|---|
| Create | save_exam_type | Add new exam type |
| Read | get_exam_type | Get single exam type details |
| Update | save_exam_type | Edit existing (same as create) |
| Delete | delete_exam_type | Remove exam type |
| List | list_exam_types | Get all exam types |
Comments are closed.