Template Categories
Understanding email template categories and their purposes
Overview
SSAdmin email templates are organized into four main categories based on their purpose and target audience. Each category contains templates for specific communication scenarios.
Template Categories
Admissions
Templates related to the application and admission process for both Level 1 and Level 2 students.
Purpose: Communicate application status, acceptance, and enrollment information
Templates:
| Template | Purpose | Sent To |
|---|---|---|
| Application Approved | Notify applicants of approval | Approved applicants |
| Application Rejected | Notify applicants of rejection | Rejected applicants |
| L1 Acceptance Letter | Level 1 acceptance with fees | Level 1 accepted students |
| L2 Acceptance Letter | Level 2 acceptance with fees | Level 2 accepted students |
| L2 Application Acknowledgement | Confirm L2 application received | Level 2 applicants |
Key Information Included:
- Student names and contact details
- Tracking/RD numbers
- Fee breakdowns and payment deadlines
- Orientation dates
- Campus information
When Sent:
- After application review
- Upon acceptance or rejection
- After application submission (acknowledgement)
Assessments
Templates for acknowledging student assessment submissions and providing results.
Purpose: Confirm exam and quiz submissions, provide scores and grades
Templates:
| Template | Purpose | Sent To |
|---|---|---|
| Exam Acknowledgement | Confirm exam submission and provide results | Students who completed exams |
| Quiz Acknowledgement | Confirm quiz submission and provide results | Students who completed quizzes |
Key Information Included:
- Student and course names
- Assessment name
- Score and grade
- Pass/fail status
- Submission timestamp
- Passing score threshold
When Sent:
- Immediately after exam submission
- Immediately after quiz submission
- After grading is complete
Payments
Templates related to tuition payments, receipts, and reminders.
Purpose: Acknowledge payments and remind students of pending fees
Templates:
| Template | Purpose | Sent To |
|---|---|---|
| Payment Acknowledgement | Receipt for successful payment | Students who made payments |
| Payment Reminder | Remind of pending payment | Students with outstanding fees |
Key Information Included:
- Payment amount
- Payment channel/method
- Transaction reference
- Date and time
- Payment link (for reminders)
When Sent:
- Immediately after successful payment
- On scheduled reminder dates
- Multiple reminders if payment pending
Referees
Templates for referee communication during the application process.
Purpose: Request and acknowledge referee recommendations
Templates:
| Template | Purpose | Sent To |
|---|---|---|
| Referee Invitation | Invite referee to submit recommendation | Referees (Minister/Employer) |
| Referee Referral Acknowledgement | Thank referee for submission | Referees who submitted |
| Student Referral Acknowledgement | Notify student of referee submission | Students whose referees submitted |
Key Information Included:
- Referee and student names
- Referee type (Minister/Employer)
- Unique referee link
- Submission details
- Form data summary
When Sent:
- When student adds referee
- When referee submits recommendation
- When student's referee completes form
Template Variables
Each template uses specific variables that are populated with real data when sent:
Common Variables
Used across multiple templates:
firstName,lastName,fullName- Recipient namesemail- Recipient emaildate- Current or specific date
Student-Specific Variables
rdNo- Student RD numberstudentId- Student IDintake- Intake periodcampus- Campus namelevel- Academic level
Financial Variables
amount- Payment/fee amounttotalFee- Total feeapplicationFee- Application feeinitialDepositFee- Initial depositinstallmentFee- Installment amountcampus1stPaymentDeadline- First payment deadlinecampusFinalPaymentDeadline- Final payment deadline
Assessment Variables
courseName- Course nameexamName/quizName- Assessment namescore- Student scoregrade- Letter gradepassingScore- Minimum to passmaxScore- Maximum possiblesubmittedAt- Submission timestamp
How Templates Work
Template Rendering
- Trigger Event: Action occurs (e.g., exam submission)
- Data Collection: System gathers relevant data
- Variable Population: Template variables filled with real data
- Email Rendering: Template rendered with data
- Email Sent: Rendered email sent to recipient
- Archiving: Email archived for compliance
Sample Data vs. Real Data
Sample Data (in preview):
- Pre-defined example values
- Used for testing and verification
- Shows template structure
Real Data (in production):
- Actual user information
- Current dates and amounts
- Live transaction details
Template Customization
Templates are maintained in the codebase and follow RHEMA branding guidelines:
Branding Elements:
- RHEMA logo and colors
- Official contact information
- Social media links
- Professional formatting
Content Guidelines:
- Clear, concise messaging
- Professional tone
- Accurate information
- Actionable next steps
Best Practices
Choosing the Right Template
-
Identify the Event:
- What triggered the need for communication?
- Who is the recipient?
- What information do they need?
-
Select Appropriate Category:
- Admissions for application-related
- Assessments for exam/quiz results
- Payments for financial transactions
- Referees for recommendation process
-
Verify Variables:
- Ensure all required data is available
- Check data format matches template expectations
- Confirm default values exist for optional fields
Testing Templates
-
Use Email Preview:
- Review template before deployment
- Check all categories regularly
- Verify sample data renders correctly
-
Test with Real Data:
- Send test emails to admin accounts
- Verify variables populate correctly
- Check formatting in different email clients
-
Monitor User Feedback:
- Track user reports of email issues
- Update templates based on feedback
- Improve clarity and usability
Common Workflows
How do I find the right template for a communication?
- Identify the purpose (admission, assessment, payment, referee)
- Navigate to Email Preview
- Browse the relevant category
- Review template descriptions
- Preview template to confirm
How do I understand what data a template needs?
- Preview the template
- Scroll to Sample Data section
- Review the JSON structure
- Note all variable names
- Verify data availability in system
How do I verify a template will work for my use case?
- Access Email Preview
- Find relevant template
- Review sample data
- Check if your scenario matches
- Test with real data if possible
Template Updates
Templates may be updated for:
- Content Changes: Updated information or messaging
- Design Improvements: Better formatting or branding
- New Features: Additional variables or sections
- Bug Fixes: Corrections to errors or issues
Template updates are managed by the development team. If you notice issues with templates, report them to HQ Admin or system administrators.
Permissions/Access
| Action | HQ Admin | Campus Admin |
|---|---|---|
| View All Categories | Yes | Yes |
| Preview Templates | Yes | Yes |
| View Sample Data | Yes | Yes |
Related Features
- Email Preview - Preview individual templates
- Email Archiving - View sent emails
- Archive Management - Search archived emails