Holidays

The Holidays feature allows you to manage and display institutional holidays in an interactive calendar view. This guide covers creating different types of holidays, targeting specific audiences, and navigating the calendar.

Overview

The Holidays system helps you:

• Define institutional holidays for the academic calendar
• Differentiate holiday types (National, Institutional, Custom)
• Target specific audiences (all, specific classes, or staff)
• Visualize holidays in a monthly calendar view
• Automatically notify students, parents, and staff via announcements

Accessing Holidays

1. Navigate to Operations in the sidebar
2. Click on Holidays
3. You’ll see an interactive calendar displaying all holidays

Note: Access is controlled by permissions under the operations.holidays module.

Understanding the Calendar

Calendar View

The holidays calendar displays a monthly view with:

• Days with holidays highlighted with a subtle background
• Holiday badges showing each holiday as a colored pill
• Easy navigation between months

![Holidays Calendar - Screenshot placeholder showing the monthly calendar view]

Holiday Type Colors

Holidays are color-coded by type for easy identification:

Calendar Navigation

Changing Months

• Use the navigation arrows in the header to move between months
• The calendar updates to show holidays for the selected month

Viewing Holiday Details

• Click on any holiday badge to view its full details
• A dialog opens showing complete information

Creating a Holiday

Step 1: Open the Create Dialog

1. Click the “Add Holiday” button in the header
2. The creation dialog will open

![Add Holiday Button - Screenshot placeholder showing the button location]

Step 2: Enter Basic Details

Title (Required)

• Enter a clear, descriptive name for the holiday
• Examples:
  • “Diwali”
  • “Independence Day”
  • “Annual Sports Day”
  • “Mid-term Break”

Date (Required)

• Select the holiday date using the date picker
• For multi-day holidays, you may need to create multiple entries

Description (Optional)

• Add additional details about the holiday
• Examples:
  • “Celebration of lights - school closed”
  • “National holiday - no classes”
  • “Staff development day - students holiday”

Step 3: Select Holiday Type

Choose the appropriate type from the dropdown:

The type affects how the holiday appears on the calendar (color-coded).

Step 4: Configure Audience

Select who this holiday applies to:

All (Default)

• Holiday applies to everyone in the institution
• Entire school/college closed
• Use for: National holidays, complete breaks

Class(es)

• Holiday applies to specific classes only
• Other classes continue as normal
• Use for: Class-specific events, grade-level activities
• When selected: A class multi-select field appears
  • Search and select one or more classes
  • Example: “Only Grade 12 holiday for board exam preparation”

Staff

• Holiday applies to specific staff members only
• Other staff continue working
• Use for: Department-specific days, staff development
• When selected: A staff multi-select field appears
  • Search and select specific staff members

Mixed

• Holiday applies to selected classes AND selected staff
• Use for: Complex scenarios with specific groups
• When selected: Both class and staff multi-select fields appear

![Audience Selection - Screenshot placeholder showing the audience dropdown and conditional fields]

Step 5: Send Announcement (Optional)

Send Announcement Checkbox

• Check this to automatically create an announcement for the holiday
• The announcement will be sent to the targeted audience
• Useful for informing parents and students about upcoming holidays

Step 6: Save the Holiday

1. Review all entered information
2. Click “Save” to create the holiday
3. On success:
   • Dialog closes
   • Holiday appears on the calendar
   • If announcement option was checked, announcement is created

Viewing Holiday Details

From the Calendar

1. Locate the holiday badge on a calendar date
2. Click on the holiday badge
3. A detail dialog opens showing:
   • Holiday title
   • Full description
   • Date(s)
   • Holiday type
   • Applicable classes (if targeted)
   • Applicable staff (if targeted)
   • Creation information

![Holiday Detail Dialog - Screenshot placeholder showing the detail view]

Holiday Information Displayed

Managing Holidays

Editing a Holiday

1. Click on the holiday badge in the calendar
2. In the detail dialog, click “Edit” (if available)
3. Modify the necessary fields
4. Click “Save” to update

Note: Editing capability depends on your permissions.

Deleting a Holiday

1. Click on the holiday badge in the calendar
2. In the detail dialog, click “Delete” (if available)
3. Confirm the deletion
4. Holiday is removed from the calendar

Warning: Deleting a holiday cannot be undone. Associated announcements are not automatically deleted.

Calendar Features

Monthly Navigation

Header Controls

• Left Arrow (◀) - Go to previous month
• Right Arrow (▶) - Go to next month
• Current month and year are displayed in the center

Quick Access

• The calendar starts at the current month
• Navigate to past months to view historical holidays
• Navigate to future months to see upcoming holidays

Day Highlighting

Days with holidays are visually highlighted:

• Subtle background color on the date cell
• Ring/border effect to draw attention
• Holiday badges displayed within the cell

Responsive Design

• Desktop: Full calendar with all holiday details visible
• Mobile: Compact view with scrollable calendar
• Calendar automatically adjusts to screen size

Best Practices

Planning Holidays

1. Plan ahead

   • Add holidays at the start of the academic year
   • Include all known national holidays
   • Add institutional events as they’re scheduled

2. Be consistent

   • Use clear, consistent naming conventions
   • “Diwali Holiday” not “diwali”, “DIWALI”
   • Include year if needed for multi-year visibility

3. Provide descriptions

   • Brief explanation helps staff and parents
   • Include any special instructions
   • Mention if partial closure or specific timings

Audience Targeting

1. Default to “All” when appropriate

   • Most holidays apply to everyone
   • Only use targeted audiences when necessary

2. Use class targeting for

   • Board exam preparation days
   • Grade-specific events
   • Class trips or activities

3. Use staff targeting for

   • Professional development days
   • Department meetings
   • Administrative holidays

4. Use mixed targeting for

   • Complex scenarios only
   • Document clearly in description

Announcements

1. Enable for important holidays

   • Ensures parents receive notification
   • Especially for unplanned holidays

2. Consider timing

   • Create holiday with announcement in advance
   • Last-minute holidays may need separate urgent announcement

3. Don’t duplicate

   • If announcement checkbox is used, don’t create manual duplicate
   • Check Communication → Announcements to verify

Holiday Types Guide

National Holidays

Definition: Government-declared public holidays applicable nationwide

Examples:

• Independence Day (August 15)
• Republic Day (January 26)
• Gandhi Jayanti (October 2)
• State formation days

Settings:

• Type: National
• Audience: All (typically)
• Send Announcement: Optional (well-known dates)

Institutional Holidays

Definition: Holidays specific to your institution

Examples:

• Foundation Day / Annual Day
• Parent-Teacher Meeting day (holiday for students)
• Examination preparation days
• Staff appreciation day

Settings:

• Type: Institutional
• Audience: Varies (All, Classes, or Staff)
• Send Announcement: Recommended

Custom Holidays

Definition: Any other holidays not covered above

Examples:

• Local festivals (region-specific)
• Weather-related closures
• Emergency closures
• Extended breaks
• Special events

Settings:

• Type: Custom
• Audience: As needed
• Send Announcement: Highly recommended (unexpected)

Troubleshooting

Common Issues

Problem: Cannot see the “Add Holiday” button

• Solution: You may not have creation permissions. Contact your administrator.

Problem: Holiday not appearing on calendar

• Solution:
  • Check if you’re viewing the correct month
  • Refresh the page
  • Verify the holiday was created successfully (check for success notification)

Problem: Cannot select classes in audience

• Solution:
  • Ensure academic year is configured for your institute
  • Classes must exist in the system
  • Try refreshing the page

Problem: Announcement not sent with holiday

• Solution:
  • Verify “Send Announcement” checkbox was checked
  • Check Communication → Announcements
  • Contact administrator if issue persists

Problem: Holiday showing on wrong date

• Solution:
  • May be a timezone issue
  • Verify the date in edit mode
  • Contact support if date appears incorrect

Error Messages

Permissions Reference

Contact your administrator to request permission changes.

Related Documentation

• Operations Overview - All operations features
• Gate Pass - Managing campus entry/exit
• Announcements - Sending notifications
• Academic Year Configuration - Setting up academic years

Quick Reference

Holiday Type Summary

Audience Options

Creating a Holiday Checklist

• Enter clear, descriptive title
• Select the correct date
• Add helpful description (optional)
• Choose appropriate holiday type
• Configure audience targeting
• Enable announcement if needed
• Review and save

Quick Links

• View holidays calendar
• Operations dashboard
• Announcements
• Help & Support

Last updated: 30 November 2025