Admin Modules

​

Overview

​

Core Module

​

AdminCore

• Link Title: “Program Dashboard”
• Module Type: “manage”
• Seq: 0
• Choosable: Yes

• Program dashboard with statistics
• Deadline/permission management
• Program settings configuration
• Quick access to all admin modules
• Statistics overview (students, teachers, classes)
• Testing data cleanup

• dashboard - Main program dashboard
• deadlines - Manage registration deadlines
• settings - Program settings editor
• delete_test_data - Remove test accounts
• newpermission - Create custom permissions
• permissions_mgmt - Permission management interface

• Student registration numbers
• Teacher registration numbers
• Class statistics (submitted, approved, scheduled)
• Resource usage
• Capacity tracking

​

Class Management

​

AdminClass

• Admin Title: “Class Management for Admin”
• Link Title: “Manage Classes”
• Module Type: “manage”
• Inline Template: “listclasses.html”
• Seq: 1
• Choosable: Yes

• Bulk class approval/rejection
• Change class status (accepted, cancelled, etc.)
• Bulk edit class properties
• Assign rooms to multiple classes
• Manage class flags
• Export class data

• manageclass - Individual class management
• reviewclass - Approve/reject classes
• bulkchangeclass - Bulk edit multiple classes
• class_status - View class status reports

• Status changes (Cancelled, Rejected, Accepted, etc.)
• Room assignments
• Resource assignments
• Grade range modifications
• Duration changes

​

AdminReviewApps

• Admin Title: “Application Review”
• Link Title: “Review Applications”
• Module Type: “manage”
• Choosable: Yes

​

ClassFlagModule

• Admin Title: “Class Flags”
• Link Title: “Flag Classes”
• Module Type: “manage”
• Choosable: Yes

• Create custom flag types
• Apply flags to classes
• Filter by flags
• Bulk flag operations

​

ClassSearchModule

• Admin Title: “Class Search”
• Link Title: “Search Classes”
• Module Type: “manage”
• Choosable: Yes

• Teacher name
• Class title/description
• Status
• Grade range
• Category
• Resources
• Scheduling status

​

Scheduling Modules

​

AJAXSchedulingModule

• Link Title: “AJAX Scheduling”
• Module Type: “manage”
• Seq: 7
• Choosable: Yes

• Drag-and-drop class scheduling
• Real-time conflict detection
• Room capacity checking
• Teacher availability verification
• Resource availability checking
• Multi-user collaboration (change log)
• Schedule comments and locking

• ajax_scheduling - Main scheduling interface
• ajax_schedule_class - Schedule a single class
• ajax_change_log - View scheduling changes

​

AutoschedulerFrontendModule

• Admin Title: “Automatic Scheduler”
• Link Title: “Automatic Scheduler”
• Module Type: “manage”
• Choosable: Yes

• Configure scheduling constraints
• Run automated scheduling
• Review suggested schedules
• Apply or reject suggestions

​

SchedulingCheckModule

• Admin Title: “Scheduling Diagnostics”
• Link Title: “Check Schedule”
• Module Type: “manage”
• Choosable: Yes

• Teacher conflicts (teaching multiple classes at once)
• Room conflicts (double-booked rooms)
• Student conflicts
• Resource conflicts
• Lunch/break validation

​

Resource Management

​

ResourceModule

• Admin Title: “Resources”
• Link Title: “Manage Resources”
• Module Type: “manage”
• Choosable: Yes

• Create/edit classrooms
• Define resource types (projectors, computers, etc.)
• Assign resources to rooms
• View resource requests from teachers
• Assign requested resources
• Resource availability by timeslot

• resources - Main resource management
• resource_timeslots - Resource availability by time
• assign_resources - Fulfill teacher requests

​

AdminMaterials

• Admin Title: “Materials Tracking”
• Link Title: “Track Materials”
• Module Type: “manage”
• Choosable: Yes

​

Communication Modules

​

CommModule

• Admin Title: “Communications Panel”
• Link Title: “Send Email”
• Module Type: “manage”
• Seq: 3
• Choosable: Yes

• Select recipients by multiple criteria:
  • Registration status
  • Classes enrolled/taught
  • Grade level
  • Geographic location
  • Custom queries
• Email templates
• HTML and plain text
• CC and BCC support
• Email preview
• Send test emails

• Students: confirmed, enrolled, waitlisted, by grade, etc.
• Teachers: with classes, by approval status, etc.
• Volunteers
• Custom filters

​

GroupTextModule

• Admin Title: “Group Texting”
• Link Title: “Send Text Messages”
• Module Type: “manage”
• Choosable: Yes

​

Reports and Lists

​

ListGenModule

• Admin Title: “Generate Lists”
• Link Title: “Lists”
• Module Type: “manage”
• Seq: 4
• Choosable: Yes

• Student lists (confirmed, enrolled, by class, etc.)
• Teacher lists (with classes, by status, etc.)
• Volunteer lists
• Custom filtered lists
• Export to CSV/Excel

​

ProgramPrintables

• Link Title: “Program Printables”
• Module Type: “manage”
• Seq: 5
• Choosable: Yes

• Class rosters
• Student schedules
• Teacher schedules
• Room schedules
• Attendance sheets
• Nametags
• Catalog
• Certificate
• Checklists
• Student labels
• Many more…

​

NameTagModule

• Admin Title: “Name Tags”
• Link Title: “Name Tags”
• Module Type: “manage”
• Choosable: Yes

• Multiple name tag formats
• Custom fields (name, school, grade, etc.)
• Barcode generation
• PDF output

​

MailingLabels

• Admin Title: “Mailing Labels”
• Link Title: “Mailing Labels”
• Module Type: “manage”
• Choosable: Yes

​

User Management

​

AdminMorph

• Admin Title: “User Morphing Capability”
• Link Title: “Morph into User”
• Module Type: “manage”
• Seq: 34
• Choosable: Yes

• Search for any user
• Pre-filtered searches (students, teachers, volunteers)
• Morph into their account
• See what they see
• Test registration flows
• Switch back to admin account

• Testing user experience
• Troubleshooting registration issues
• Demonstrating features

​

BulkCreateAccountModule

• Admin Title: “Bulk Account Creation”
• Link Title: “Create Accounts”
• Module Type: “manage”
• Choosable: Yes

​

UserGroupModule

• Admin Title: “User Groups”
• Link Title: “User Groups”
• Module Type: “manage”
• Choosable: Yes

​

UserRecordsModule

• Admin Title: “User Records”
• Link Title: “User Records”
• Module Type: “manage”
• Choosable: Yes

​

Financial Modules

​

LineItemsModule

• Admin Title: “Line Items”
• Link Title: “Manage Costs”
• Module Type: “manage”
• Choosable: Yes

• Set base program fee
• Create optional items (meals, t-shirts, etc.)
• Set prices and availability
• Define financial aid line items

​

AccountingModule

• Admin Title: “Accounting”
• Link Title: “Accounting”
• Module Type: “manage”
• Choosable: Yes

​

FinAidApproveModule

• Admin Title: “Financial Aid Approval”
• Link Title: “Approve Financial Aid”
• Module Type: “manage”
• Choosable: Yes

• View applications
• Approve/deny requests
• Set award amounts
• Send notifications

​

CreditCardViewer

• Admin Title: “Credit Card Viewer”
• Link Title: “View Payments”
• Module Type: “manage”
• Choosable: Yes

​

Volunteer Management

​

VolunteerManage

• Admin Title: “Volunteer Management”
• Link Title: “Manage Volunteers”
• Module Type: “manage”
• Choosable: Yes

​

Survey Management

​

SurveyManagement

• Admin Title: “Survey Management”
• Link Title: “Manage Surveys”
• Module Type: “manage”
• Choosable: Yes

• Create surveys
• Define questions
• Per-class or per-program surveys
• View responses
• Export results

​

Display Modules

​

BigBoardModule

• Admin Title: “Big Board”
• Link Title: “Big Board”
• Module Type: “manage”
• Choosable: Yes

​

AdmissionsDashboard

• Admin Title: “Admissions Dashboard”
• Link Title: “Admissions”
• Module Type: “manage”
• Choosable: Yes

​

AdminVitals

• Admin Title: “Program Vitals”
• Link Title: “Vitals”
• Module Type: “manage”
• Choosable: Yes

​

Testing and Development

​

AdminTestingModule

• Admin Title: “Testing Tools”
• Link Title: “Testing”
• Module Type: “manage”
• Choosable: Yes

​

DeactivationModule

• Admin Title: “Program Deactivation”
• Link Title: “Deactivate”
• Module Type: “manage”
• Choosable: Yes

​

Specialized Modules

​

ClassChangeRequestModule

• Admin Title: “Class Change Requests”
• Link Title: “Class Changes”
• Module Type: “manage”
• Choosable: Yes

​

CheckAvailabilityModule

• Admin Title: “Check Availability”
• Link Title: “Check Teacher Availability”
• Module Type: “manage”
• Choosable: Yes

​

TeacherEventsManageModule

• Admin Title: “Teacher Events Management”
• Link Title: “Manage Teacher Events”
• Module Type: “manage”
• Choosable: Yes

​

MapGenModule

• Admin Title: “Map Generation”
• Link Title: “Generate Maps”
• Module Type: “manage”
• Choosable: Yes

​

JSONDataModule

• Admin Title: “JSON Data API”
• Link Title: “JSON Data”
• Module Type: “json”
• Choosable: Yes

• Export data in JSON format
• API endpoints for integration
• Used by mobile apps and external tools

​

Development Notes

​

Creating a Custom Admin Module

from esp.program.modules.base import ProgramModuleObj, needs_admin, main_call
from esp.utils.web import render_to_response

class MyAdminModule(ProgramModuleObj):
    doc = """Description of administrative functionality."""
    
    @classmethod
    def module_properties(cls):
        return {
            "admin_title": "My Admin Tool",
            "link_title": "My Tool",
            "module_type": "manage",
            "seq": 50,
            "choosable": 1,
        }
    
    @main_call
    @needs_admin
    def mytool(self, request, tl, one, two, module, extra, prog):
        context = {'program': prog}
        # Add your admin logic here
        return render_to_response(self.baseDir() + 'main.html', request, context)

​

Admin Module Best Practices

1. Always use @needs_admin: Protect admin views with the decorator
2. Provide clear documentation: Use the doc attribute to explain what the module does
3. Handle bulk operations carefully: Validate before making mass changes
4. Log important actions: Use Django logging for administrative actions
5. Provide confirmation: Ask for confirmation before destructive operations

​

See Also

• Program Modules Overview
• Student Modules
• Teacher Modules
• Onsite Modules