CW Classroom Admin Help - Administrator Guide

📚 Quick Navigation

🔐 Admin Access

Understanding admin privileges and access control

🔐 Administrator Access & Privileges

✅ What You Can Access as Admin

✓ Full access to all teacher functionality
✓ Full access to all student functionality
✓ System-wide classroom administration panel
✓ User management and permissions
✓ Advanced system monitoring and analytics

🎯 Navigation & Menu Structure

Training Menu Access

• 🎓 CW Classroom (Teacher) - Full teacher dashboard
• 📚 CW Classroom (Student) - Full student dashboard
• Access to all training programs

Account Menu Access

• 🎓 CW Classroom Admin - Administrative panel
• Advanced user management
• System configuration

💡 Pro Tip: As an admin, you can test the complete user experience by accessing both teacher and student dashboards. This helps you understand the workflow from all perspectives when assisting users.

👥 User Management

🔄 User Roles & Permissions

🛡️ Administrator

• Full system access
• Teacher + Student capabilities
• User management
• System configuration

👨‍🏫 Teacher

• Create classrooms
• Invite students
• Manage lessons
• Track progress

👨‍🎓 Student

• Join classrooms
• Complete lessons
• View progress
• Access training

⚙️ Managing User Flags

1

Access Database or Admin Panel

Navigate to your admin panel or database management interface to modify user permissions.

2

Locate User Flags

Users table contains these important flags:

• is_admin - Administrator privileges
• teacher_flag - Teacher capabilities
• student_flag - Student capabilities

3

Set Appropriate Flags

Users can have multiple flags. Admins typically have all three flags enabled for full testing capabilities.

⚠️ Important: Always ensure admins have both teacher_flag and student_flag set to 1 in addition to is_admin for full access to all classroom features.

🏫 Classroom System Overview

🎯 Key Features You Oversee

📝 Classroom Management

• Teachers can create unlimited classrooms
• Customizable descriptions and settings
• Real-time student enrollment tracking
• Pending invitation management

👥 Student Management

• Email-based invitation system
• Secure token-based enrollment
• Student progress tracking
• Classroom activity monitoring

📊 Database Structure (For Reference)


📁 Core Tables:
├── 👤 users (id, username, hash, salt, is_admin, teacher_flag, student_flag)
├── 🏫 classrooms (id, name, description, teacher_id, created_at)
├── 📧 classroom_invitations (id, classroom_id, email, token, status, expires_at)
├── 👥 classroom_students (id, classroom_id, student_id, enrolled_at)
└── 📈 classroom_activities (id, classroom_id, student_id, activity_type, created_at)

💡 Admin Insight: The system uses secure token-based invitations with expiration dates. Invitations automatically expire after 7 days for security.

⚙️ Advanced System Features

🔔 Toast Notification System

We've implemented a modern toast notification system that replaces all popup alerts:

• ✅ Success notifications - Classroom creation, invitations sent
• ❌ Error notifications - Connection issues, validation errors
• ⚠️ Warning notifications - Form validation, missing data
• ℹ️ Info notifications - Feature announcements, help messages

Features: Auto-close, manual close buttons, center-screen positioning, beautiful glassmorphism design

🔐 Security Implementation

Session Management

• PHP session-based authentication
• Automatic session validation
• Role-based access control
• Secure logout functionality

API Security

• CORS headers properly configured
• Input validation and sanitization
• SQL injection prevention
• Token-based invitation system

📱 User Interface Improvements

• Responsive Design: Works perfectly on desktop, tablet, and mobile
• Dark Theme: Professional dark interface reducing eye strain
• Intuitive Navigation: Clear menu structure and logical workflow
• Real-time Updates: Dynamic content loading without page refresh
• Loading States: Clear feedback during API operations

🔧 Administrator Troubleshooting Guide

❌ Common Access Issues

Problem: "Please log in to access your classroom dashboard"

Solution:

Check if user has proper flags: is_admin=1, teacher_flag=1, student_flag=1
Clear browser cookies and session storage
Ensure API endpoints are accessible
Check browser console for JavaScript errors

Problem: Admin menu not showing

Solution:

Verify is_admin flag is set to 1 in database
Check global menu JavaScript is loading correctly
Ensure session data includes admin flag

Problem: Database connection errors

Solution:

Check .env file database credentials
Verify database server is running
Test database connection with simple query
Check database user permissions

🛠️ Advanced Diagnostics

Use these diagnostic pages:

• test-classroom-access.html - Test all classroom access points
• debug-db-connection.php - Database connectivity test
• api/session.php - Session information API

⭐ Administrative Best Practices

🏗️ Initial System Setup

1

Set Up Admin Account Properly

Ensure your admin account has all necessary flags:

is_admin = 1, teacher_flag = 1, student_flag = 1

2

Test All User Flows

Before launching, test the complete user experience from all perspectives (admin, teacher, student).

3

Configure Email System

Ensure email invitations are working properly for classroom enrollment.

🔄 Ongoing Maintenance

Regular Tasks

• Monitor classroom creation rates
• Clean up expired invitations
• Review user activity logs
• Update system documentation

User Support

• Help with permission issues
• Assist with classroom setup
• Troubleshoot technical problems
• Provide feature training

🎯 Pro Admin Tip: Regularly access the system as both teacher and student to experience what your users see. This helps you provide better support and identify potential improvements.

🛡️ CW Classroom Administrator Guide

📚 Quick Navigation

🔐 Admin Access

👥 User Management

🏫 Classroom Overview

⚙️ System Features

🔧 Troubleshooting

⭐ Best Practices

🔐 Administrator Access & Privileges

✅ What You Can Access as Admin

🎯 Navigation & Menu Structure

Training Menu Access

Account Menu Access

👥 User Management

🔄 User Roles & Permissions

🛡️ Administrator

👨‍🏫 Teacher

👨‍🎓 Student

⚙️ Managing User Flags

Access Database or Admin Panel

Locate User Flags

Set Appropriate Flags

🏫 Classroom System Overview

🎯 Key Features You Oversee

📝 Classroom Management

👥 Student Management

📊 Database Structure (For Reference)

⚙️ Advanced System Features

🔔 Toast Notification System

🔐 Security Implementation

Session Management

API Security

📱 User Interface Improvements

🔧 Administrator Troubleshooting Guide

❌ Common Access Issues

Problem: "Please log in to access your classroom dashboard"

Problem: Admin menu not showing

Problem: Database connection errors

🛠️ Advanced Diagnostics

⭐ Administrative Best Practices

🏗️ Initial System Setup

Set Up Admin Account Properly

Test All User Flows

Configure Email System

🔄 Ongoing Maintenance

Regular Tasks

User Support

📋 Quick Reference

🔗 Important URLs

🗄️ Database Tables