User Documentation
For: School Administrators, Operators, and End Users
This guide covers daily usage of RMT Attendance System. Perfect for SaaS customers who receive login credentials and start using immediately.
- System URL (e.g., yourdomain.com/login)
- Email address for login
- Password
- Your role (Admin or Operator)
Getting Started
First Login
Step 1: Access the System
- Open your web browser (Chrome, Firefox, Safari, or Edge recommended)
- Navigate to your system URL provided by administrator
- You'll see the login page
Step 2: Login
- Enter your email address
- Enter your password
- Optional: Check "Remember Me" to stay logged in
- Click "Login" button
- Click your name in top-right corner
- Select "Profile" or "Change Password"
- Enter new secure password
Dashboard Overview
After login, you'll see the main dashboard with:
Statistics Cards (Top Row)
- 📊 Total Students - Number of active students in system
- ✅ Today's Attendance - Check-ins recorded today
- 🍽️ Available Menus - Active menu items for selection
- 📅 Monthly Attendance - Total check-ins this month
Charts & Analytics
- Attendance Trend - Last 7 days line chart showing daily attendance
- Popular Menus - Bar chart of most selected menu items
- Meal Distribution - Breakfast vs Lunch vs Dinner breakdown
Recent Activity
- Table showing latest attendance records
- Quick view of recent check-ins with student name, menu, and time
Navigation Menu (Left Sidebar)
- 🏠 Dashboard - Main overview page
- 👥 Students - Manage students
- 🍽️ Menus - Manage food menus
- 📋 Attendance - View attendance records
- 📊 Reports - Analytics and exports
- ⚙️ Settings - System configuration (Admin only)
- 👤 Users - User management (Admin only)
- 🔍 Scanner - Open QR code scanner
Student Management
Adding a New Student
Method 1: Manual Entry (Individual Student)
- Click "Students" in the sidebar menu
- Click the "Add New Student" button (usually green button at top-right)
- Fill in the student information form:
Field Required? Description Student ID ✅ Required Unique identifier (e.g., 2024001, SCI001) Name ✅ Required Full student name Email Optional Student email address Phone Optional Contact number Gender Optional Select Male or Female Class Optional Class/Form/Year (e.g., Form 5A, Grade 12) Program Optional Stream/Program (e.g., Science, Arts, Engineering) Address Optional Student's address - Click "Save" button
- Success! QR code is automatically generated
- You'll be redirected to student details page where you can view/print the QR code
Bulk Import from Excel
Add multiple students at once using Excel file:
Step 1: Download Template
- Go to Students page
- Click "Import Students" button
- Click "Download Template" link
- Save the Excel file to your computer
Step 2: Fill in Student Data
- Open the downloaded Excel file
- You'll see these columns:
- Column A: Student ID (Required) - Must be unique
- Column B: Name (Required) - Full name
- Column C: Email (Optional)
- Column D: Phone (Optional)
- Column E: Gender (Optional) - "male" or "female" only
- Column F: Class (Optional)
- Column G: Program (Optional)
- Column H: Address (Optional)
- Fill in your student data (one student per row)
- Do not modify or delete the header row!
- Save the file
- Student ID must be unique (no duplicates)
- Maximum 1000 students per import
- Use .xlsx or .xls format only
- Gender must be exactly "male" or "female" (lowercase)
- Don't add extra columns
Step 3: Upload and Import
- Back in the system, click "Choose File"
- Select your filled Excel file
- Click "Import" button
- System validates the data
- If successful, all students are imported with QR codes generated automatically
- If errors, you'll see specific error messages (e.g., "Row 5: Student ID already exists")
Viewing Student List
The student list page shows all students in a table with powerful search and filter options:
Search Features:
- Search Box: Type to search by name, student ID, email, or phone
- Class Filter: Dropdown to filter by specific class
- Program Filter: Dropdown to filter by program/stream
- Active Status: Toggle to show only active students
Actions for Each Student:
- 👁️ View - See full student details and attendance history
- ✏️ Edit - Modify student information
- 🔍 Show QR - Display QR code for printing
- 🗑️ Delete - Remove student (soft delete - can be recovered)
Editing Student Information
- Find the student in the list
- Click "Edit" button
- Modify any field as needed
- Click "Update"
- Changes saved immediately
Viewing Student Details
Click "View" button to see:
- Complete student profile
- Generated QR code
- Full attendance history (all check-ins)
- Total attendance count
- Favorite menus
- Recent activity
Printing QR Codes
Print Individual QR Code:
- Go to student details page
- Click "Show QR Code" or "Print QR"
- QR code displays in full-page format with:
- Student name
- Student ID
- Large, scannable QR code
- Use browser print (Ctrl+P / Cmd+P)
- Print on A4 paper
Print QR Codes in Bulk:
- Go to Students page
- Click "Print QR Codes" button
- Select students using checkboxes (or "Select All")
- Click "Print Selected"
- QR codes display in 4x2 grid format (8 QR codes per A4 page)
- Each code includes:
- Student name
- Student ID
- Scannable QR code
- Print (Ctrl+P / Cmd+P)
- Use white paper, avoid colored paper
- Print in portrait orientation
- Use good quality printer for clear codes
- Laminate QR cards for durability
- Test scan before distributing to students
Deactivating Students
To temporarily disable a student without deleting:
- Edit the student
- Uncheck "Active" checkbox
- Save changes
Result: Inactive students cannot check in. QR scan will show error message.
Use cases:
- Student on leave
- Suspended student
- Graduated but keeping records
QR Scanner Guide
The QR Scanner is the fastest way to record attendance.
Accessing the Scanner
Method 1: From Dashboard
- Click "Scanner" in the sidebar menu
Method 2: Direct URL (for Kiosk)
- Bookmark this URL:
https://yourdomain.com/scanner - Use on dedicated tablet/computer for scanning station
First-Time Setup
Step 1: Unlock Scanner (if PIN enabled)
- If system has PIN protection, enter the 4-6 digit PIN
- Contact admin if you don't know the PIN
Step 2: Grant Camera Permission
- Browser will ask: "Allow camera access?"
- Click "Allow"
- Camera feed appears
- Permission is remembered for future visits
- Site must use HTTPS (secure connection with padlock icon)
- Check browser permissions in address bar
- Close other apps using camera (Zoom, Skype, etc.)
- Try different browser (Chrome recommended)
How to Scan (Step-by-Step)
Complete Check-in Process:
- Student Approaches
- Student presents QR code (card/printout/phone screen)
- Position QR Code
- Hold QR code 15-30cm from camera
- Keep it steady and flat
- QR code should fill about 50% of frame
- Ensure good lighting
- Automatic Detection
- System detects QR code automatically (1-2 seconds)
- Beep sound (if enabled)
- Student information appears on screen:
✅ Student Found! Name: Ahmad bin Ali ID: 2024001 Class: Form 5A Program: Science Stream
- Select Menu
- Available menus display with images and prices
- Click desired menu item
- Example options:
🍽️ Select Your Menu: [ Nasi Lemak - RM 5.00 ] [ Fried Rice - RM 4.50 ] [ Mee Goreng - RM 4.00 ]
- Confirm
- Click "Submit" button
- Or wait for auto-submit (if configured)
- Success!
- Green success message appears:
✅ Attendance Recorded! Ahmad bin Ali Nasi Lemak - Breakfast 8:45 AM
- Message auto-dismisses after 3 seconds
- Green success message appears:
- Ready for Next Student
- Scanner resets automatically
- Next student can scan immediately
⏱️ Average Time: 3-5 seconds per student!
Understanding Meal Types
The system automatically detects meal type based on current time:
| Meal Type | Time Range | Example |
|---|---|---|
| Breakfast | 6:00 AM - 10:59 AM | 8:30 AM → Breakfast |
| Lunch | 11:00 AM - 2:59 PM | 12:45 PM → Lunch |
| Dinner | 3:00 PM - 11:59 PM | 6:30 PM → Dinner |
Common Scanner Errors & Solutions
❌ "Student Not Found"
- Cause: QR code not in database or student deleted
- Solution: Check if student exists, use manual entry
⚠️ "Already Checked In"
- Cause: Student already checked in for this meal today
- Solution: Student can check in again for next meal type
- Example: Had breakfast at 8 AM, can check in for lunch at 12 PM
❌ "Student Inactive"
- Cause: Student account is deactivated
- Solution: Contact admin to reactivate student
🔍 "Unable to Detect QR Code"
- Cause: Poor lighting, damaged QR, blurry image
- Solution:
- Improve lighting
- Move QR closer/farther
- Clean camera lens
- Print fresh QR code if damaged
Scanner Session Statistics
The scanner displays real-time statistics:
- Today's Check-ins: Total count for today
- Last Scan: Last student scanned and time
- Session Count: Count for current session
Locking the Scanner
When leaving the scanner unattended:
- Click "Lock Scanner" button
- Scanner locks immediately
- To unlock, enter PIN again
Menu Management
Adding a New Menu
- Click "Menus" in sidebar
- Click "Add New Menu" button
- Fill in the form:
Field Required? Description Name ✅ Required Menu item name (e.g., "Nasi Lemak") Description Optional Brief description of the item Category ✅ Required Main, Drink, Side, Dessert, Other Price ✅ Required Price in RM (e.g., 5.00) Image Optional Upload photo (JPG, PNG - max 2MB) Display Order Optional Sort order (lower numbers show first) - Click "Save"
- Menu appears in scanner immediately!
Uploading Menu Images
Image Guidelines:
- Recommended size: 800x600 pixels
- Maximum file size: 2MB
- Formats: JPG, PNG, GIF
- Square or landscape orientation preferred
- Clear, appetizing food photo
Editing Menu
- Go to Menus page
- Click "Edit" button next to menu
- Modify any field
- Upload new image (optional)
- Toggle availability:
- Available - Shows in scanner
- Unavailable - Hidden from scanner
- Click "Update"
Deleting Menu
- Click "Delete" button next to menu
- Confirm deletion
- Menu removed permanently
Attendance Recording
Recording Methods
Two ways to record attendance:
Method 1: QR Scanner (Recommended - Fast)
- Use the QR Scanner (see Scanner Guide above)
- Average time: 3-5 seconds per student
- Automatic meal type detection
- Duplicate prevention built-in
Method 2: Manual Entry (Backup)
- Click "Attendance" → "Record Attendance"
- Fill in the form:
- Student: Select from dropdown (searchable)
- Menu: Select from available menus
- Date: Date of attendance
- Time: Time of check-in
- Meal Type: Auto-detected from time (can override)
- Notes: Optional remarks
- Click "Save"
Viewing Attendance Records
- Click "Attendance" in sidebar
- View all check-in records in table
Table Columns:
- Date & Time
- Student Name & ID
- Menu Selected
- Meal Type (Breakfast/Lunch/Dinner)
- Recorded By (username)
- IP Address (for tracking)
Filtering Attendance Records
Use filters to find specific records:
- Date Range: From date → To date
- Meal Type: All / Breakfast / Lunch / Dinner
- Student: Search by name or ID
Example Queries:
Query 1: "All lunch check-ins in November"
- From: 2024-11-01
- To: 2024-11-30
- Meal Type: Lunch
Query 2: "Ahmad's attendance this week"
- From: (Monday date)
- To: (Friday date)
- Student: Ahmad
Deleting Attendance Records
If an error was made:
- Find the incorrect record
- Click "Delete" button
- Confirm deletion
- Record removed permanently
Duplicate Check-in Prevention
The system automatically prevents:
- Same student checking in twice for same meal type on same day
- Example: Ahmad had breakfast at 8 AM → tries to scan again at 9 AM → Blocked
Allowed:
- ✅ Breakfast at 8 AM → Lunch at 12 PM → Dinner at 6 PM
- ✅ Different students scanning anytime
Blocked:
- ❌ Breakfast at 8 AM → Breakfast again at 9 AM
Reports & Analytics
Dashboard Statistics
Real-time statistics available on dashboard:
- Total Students: Active students count
- Today's Attendance: Check-ins today (updates live)
- Available Menus: Active menu items
- Monthly Attendance: Current month total
Attendance Trends Chart
7-Day Attendance Trend (Line Chart)
- Shows daily check-ins for last 7 days
- Helps identify patterns:
- Which days have low attendance
- Weekly trends
- Holiday effects
Popular Menus Chart
Most Selected Menu Items (Bar Chart)
- Top 10 menu items by selection count
- Useful for:
- Menu planning
- Inventory management
- Understanding student preferences
- Removing unpopular items
Meal Type Distribution
Breakfast vs Lunch vs Dinner (Pie Chart)
- Percentage breakdown of meal types
- Shows which meal has highest attendance
- Helps with resource allocation
Exporting Reports to Excel
Step-by-Step:
- Go to "Reports" page
- Select filters:
- Date range (From → To)
- Meal type (optional)
- Student (optional)
- Click "Export to Excel" button
- File downloads automatically (e.g.,
attendance_report_2024-11-01_to_2024-11-15.xlsx) - Open in Excel/Google Sheets
Excel File Contains:
- All filtered attendance records
- Columns:
- Date & Time
- Student ID
- Student Name
- Class
- Program
- Menu Selected
- Meal Type
- Price
- Recorded By
- IP Address
- Pre-formatted for printing
- Totals at bottom
- Monthly reports for management
- Billing/invoicing parents
- Audit trail
- Further analysis in Excel
- Archive records
User Roles & Permissions
Admin Role
Full System Access - Can do everything:
- ✅ View Dashboard
- ✅ Manage Students (Add, Edit, Delete, Import)
- ✅ Manage Menus (Add, Edit, Delete)
- ✅ Record Attendance (Scanner & Manual)
- ✅ View Attendance Records
- ✅ Generate Reports & Export Excel
- ✅ Manage System Settings
- ✅ Manage User Accounts (Add, Edit, Delete operators)
- ✅ View Subscription Status
Operator Role
Limited Access - Daily operations only:
- ✅ View Dashboard
- ✅ View Student List (read-only)
- ✅ Record Attendance (Scanner & Manual)
- ✅ View Attendance Records (filtered)
- ✅ Generate Reports & Export
- ❌ Cannot Add/Edit/Delete Students
- ❌ Cannot Manage Menus
- ❌ Cannot Access Settings
- ❌ Cannot Manage Users
Managing Users (Admin Only)
Adding a New User:
- Click "Users" in sidebar
- Click "Add New User"
- Fill in:
- Name
- Email (for login)
- Password (min 8 characters)
- Role: Admin or Operator
- Active: Check to enable account
- Click "Save"
- User can now login with email and password
Editing User:
- Modify name, email, role, or active status
- Leave password blank to keep current password
- Enter new password to change it
Deactivating User:
- Edit user → Uncheck "Active" → Save
- User cannot login anymore
- All data preserved
Frequently Asked Questions (FAQ)
General Questions
Q: What browsers are supported?
A: Chrome, Firefox, Safari, and Edge (latest versions). Chrome recommended for best scanner performance.
Q: Can multiple people use the system simultaneously?
A: Yes! Multiple users can login and work at the same time. Multiple scanners can operate simultaneously without conflicts.
Q: Do I need internet connection?
A: Yes, internet is required for real-time database updates and multi-device access.
Q: Is my data secure?
A: Yes. The system uses:
- Password hashing (cannot be reversed)
- HTTPS encryption (if SSL configured)
- Role-based access control
- CSRF protection on all forms
Student Management
Q: Can I edit a student's Student ID?
A: Yes, but a new QR code will be generated. The old QR code won't work anymore. Distribute the new QR code to the student.
Q: What happens if I delete a student?
A: Student is soft-deleted (not permanently removed). Their attendance history is preserved. Database admin can recover if needed.
Q: How many students can I import at once?
A: Maximum 1000 students per Excel import. For larger batches, split into multiple files.
Q: Can a student have multiple QR codes?
A: No, each student has one unique QR code based on their Student ID. If you change the Student ID, the QR code changes.
QR Scanner
Q: Can students scan QR from phone screen?
A: Yes! QR codes work from printed cards, phone screens, tablet screens, or computer screens - as long as the image is clear.
Q: Why does camera require HTTPS?
A: Modern browsers block camera access on non-secure (HTTP) sites for privacy. Your admin must enable SSL/HTTPS.
Q: What if a student scans twice by accident?
A: System prevents duplicate check-ins. Second scan for same meal type will be blocked with error message.
Q: Can a student check in for all three meals?
A: Yes! Students can check in once per meal type per day:
- Breakfast (once)
- Lunch (once)
- Dinner (once)
Attendance & Reports
Q: How long is attendance data stored?
A: Forever (unless manually deleted). All records are preserved indefinitely. Export old data if you want to archive.
Q: Can I edit an attendance record?
A: No, editing is not allowed (for audit integrity). Admins can delete incorrect records and create new ones with notes explaining the correction.
Q: Can I generate monthly reports?
A: Yes! Go to Reports, set date range (e.g., Nov 1-30), and export to Excel. You'll get a complete monthly report.
Q: Can parents see their child's attendance?
A: Not in current version. However, you can export filtered reports for specific students and email to parents.
Menus
Q: Can I temporarily disable a menu without deleting?
A: Yes! Edit the menu and toggle "Available" to "Unavailable". It won't show in scanner but remains in database. Re-enable anytime.
Q: What if I don't have menu images?
A: Images are optional. Menus work fine without images - just text will display in scanner.
Q: Can I change menu prices?
A: Yes, edit the menu anytime. Price changes apply immediately. Past attendance records keep old prices.
Troubleshooting
Q: I forgot my password. How do I reset it?
A: Contact your system administrator. They can reset your password via the Users management page.
Q: QR codes are not displaying. What's wrong?
A: Possible causes:
- Storage link not created (admin must run create-storage-link.php)
- Storage folder permissions (admin must set to 755)
- GD extension disabled (admin must enable in cPanel)
Q: Scanner freezes or crashes. What should I do?
A: Refresh the page (F5). If problem persists:
- Close other apps using camera
- Try different browser
- Restart device
- Contact admin if issue continues
Q: System is slow. How can I speed it up?
A: Contact admin. They can:
- Clear cache
- Optimize database
- Archive old records
- Check server resources
Getting Help
Q: Where can I get support?
A: Contact your system administrator or support team with:
- Exact error message (screenshot if possible)
- Steps to reproduce the issue
- Your role (Admin/Operator)
- Browser and device info
- Start with adding a few test students
- Print their QR codes
- Test the scanner thoroughly
- Add real students after comfortable
- Train operators before going live
- Keep backup of student data
← Back to Documentation Home