> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleverschool.systems/llms.txt
> Use this file to discover all available pages before exploring further.

# School Calendars

> Tutorials & Practical Guides

## Practical Guides

Step-by-step walkthroughs to help school business managers, calendar coordinators, department heads, and teachers operate the School Calendars module with maximum efficiency.

***

### Guide 1: Setting Up Academic Years and Term Dates

`Calendar Managers` and `Administrators` establish the structural timeline for school scheduling:

**1. Navigate to Academic Years**

From the main **Calendar List**, click **Administration** at the top right and select **Years** (or navigate to `/calendar/admin/years`).

**2. Add a New Academic Year**

Click **New Academic Year** in the top right.

* **Name**: Enter the academic year label (e.g. `2026/2027`).
* **Start Date & End Date**: Enter the start and end dates (e.g. `01/09/2026` to `31/08/2027`).

> [!TIP]
>
> Always align academic years to the start and end of calendar months (e.g. 1st September to 31st August). Using irregular dates can cause unexpected day alignments when rolling events forward into future years.

**3. Configure Terms & Half-Term Blocks**

Click the row action menu on your newly created year and select **Edit**.

* Add your school's term dates (e.g. *Autumn 1*, *Autumn 2*, *Spring 1*, *Spring 2*, *Summer 1*, *Summer 2*).
* Terms default into six-week blocks. Adjust the start and end dates to match your local authority or trust term dates.

> [!WARNING]
>
> Academic years cannot overlap each other, and term dates cannot overlap one another or extend outside their parent academic year boundaries.

***

### Guide 2: Creating Calendars & Organising Calendar Groups

Segment your school's activities into discrete, manageable calendars and combine them into composite groups:

> [accordion] Creating a New Calendar
>
> 1. On the main **Calendar List** page (`/calendar`), click **New Calendar**.
> 2. Enter a **Name** (e.g. *Key Stage 4 Assessments* or *Music & Drama*).
> 3. Enter an optional **Description** explaining the scope of the calendar.
> 4. Select an **Owner** (`Calendar Owner`) responsible for managing dates on this calendar.
> 5. Choose a **Colour Code** to visually distinguish event cards on the calendar grid.
> 6. Click **Save** to create the calendar.

> [accordion] Reordering Calendars
>
> * `Calendar Managers` can customise the display order on the main list. Simply click and hold the drag handle on the left of any calendar row and move it to your desired position.

> [accordion] Creating a Composite Calendar Group
>
> 1. On the main **Calendar List**, click **New Calendar Group** in the upper groups section.
> 2. Enter the group name (e.g. *Parent Calendar* or *Whole Staff Feed*) and description.
> 3. Save the group, then click the **Manage Group** link or navigate to **Administration** > **Group**.
> 4. Check the boxes next to each individual calendar you wish to include in this composite group.
> 5. Any user subscribing to this group will receive a combined live feed of all included calendars.

***

### Guide 3: Adding & Scheduling Events

`Calendar Owners` and `Managers` can add events using either the visual grid or tabular list:

> [tab] Visual Grid Scheduling
>
> 1. Open the target calendar and select the desired academic year (e.g. `/calendar/{calendar}/{year}`).
> 2. Toggle between **Working week** (Monday–Friday) and **Full week** (including weekends).
> 3. Click directly on any day cell within the academic week where the event should occur.
> 4. In the pop-up modal:
>    * **Name**: Enter the event title (e.g. *Year 10 Parents Evening* or *Duke of Edinburgh Expedition*).
>    * **Start & End Time**: For timed events, set the specific hours (e.g. `16:30` to `19:30`).
>    * **Multi-Day Length**: For all-day or multi-day events, specify the duration in days (e.g. `1 day` or `3 days`).
> 5. Click **Save**. The event is anchored to that date and calculated relative to the academic year's start week and day.

> [tab] Tabular List Scheduling
>
> 1. Switch to the list view by clicking **List View** at the top right of the grid (or navigate to `/calendar/list/{calendar}/{year}`).
> 2. Click **Add Event** in the table header.
> 3. Enter the event details, timings, and duration.
> 4. Click **Save** to record the event into the table.

***

### Guide 4: Annual Rollover & Future Year Planning

The module simplifies the transition between academic years by calculating events relative to the start of the school year:

**1. Select the Future Academic Year**

From the main **Calendar List**, locate your calendar and select the upcoming academic year (e.g. `2027/2028`) using the year dropdown.

**2. Switch to Event List View**

Click **List View** to open the full event register for that calendar.

**3. Enable Recurring Events**

All events previously created on this calendar appear in the list:

* **Single Rollover**: Use the row action dropdown on any event to select **Enable Year**. The system automatically assigns the corresponding date in the new school year on the exact same day of the week and academic week number.
* **Bulk Rollover**: Select multiple events using the table checkboxes, click **Bulk Actions**, and select **Enable for this Year**.

**4. Adjust Specific Dates If Needed**

If an event needs to move to an alternative week or day in the new year, edit the event date directly.

> [!WARNING]
>
> **Disabling vs. Deleting Events**:
>
> * **Disabling an event** removes it only from the selected academic year while preserving its definition for future years.
> * **Deleting an event** permanently purges the event from all academic years. Always prefer disabling over deleting when managing annual schedules.

***

### Guide 5: Publishing Calendars & External Device Integration

Control when dates become visible to external subscribers and integrate feeds into personal calendars:

**1. Draft Planning Phase**

When planning dates for a future academic year, ensure the calendar year status is **Unpublished**. Staff can view and edit events internally, but dates will not appear in external calendars.

**2. Publish the Calendar Year**

Once leadership confirms the schedule, open the calendar's list view and click **Publish this year's calendar**. A green *Published* badge confirms the dates are live.

**3. Subscribe from Apple Calendar / iOS**

Click the **Add** link on the calendar or group row on the main dashboard. Your device will prompt to open the `webcal://` link and add the subscribed calendar directly.

**4. Subscribe from Google Calendar / Microsoft Outlook**

1. Click **Link** on the calendar or group row to copy the secure iCal URL to your clipboard.
2. In Google Calendar, click the **+** next to *Other calendars* and select **From URL**. Paste the link.
3. In Microsoft Outlook, select **Add calendar** > **Subscribe from web**, paste the URL, and save.

> [!TIP]
>
> The module automatically caches and refreshes calendar feeds every 15 minutes, ensuring external devices stay synchronised with date adjustments.

***

### Guide 6: Subscribing to Weekly Email Digests & Reviewing Dates

Staff and governors can receive automated weekly reminders without configuring external calendar apps:

**1. Subscribe to Email Alerts**

On the main **Calendar List** (`/calendar`), click **Subscribe** on any individual calendar or composite calendar group.

**2. Automated Weekly Delivery**

Every Monday morning at 08:00, you will receive an automated email digest summarising:

* All events scheduled for **Next Week** (next 7 days).
* All events scheduled for the **Week After Next** (7 to 14 days ahead).
* Any relevant central Multi-Academy Trust events.

**3. Inspect Subscribed Dates Anytime**

Click **Review Actions** at the top of the main Calendar List (or navigate to `/calendar/dates`) to view your personal upcoming schedule filterable by *Due soon*, *All future events*, or *Past events*.

***

### Guide 7: Bulk Importing Events via CSV Spreadsheet

Rapidly populate calendars from external schedules or annual planning spreadsheets:

**1. Open Import Dialogue**

In the event list view (`/calendar/list/{calendar}/{year}`), click **Import Events** in the table header.

**2. Download Standard Template**

Click **Download Template** to obtain the official CSV layout containing required column headings (`name`, `date`, `length`).

**3. Populate Your Spreadsheet**

* `name`: The event title (e.g. `Year 7 Induction Morning`).
* `date`: The scheduled date formatted as `YYYY-MM-DD` or `DD/MM/YYYY`.
* `length`: Duration in days (`1` for single-day, `5` for multi-day, or `0` for timed events).

**4. Upload & Validate**

Choose your completed CSV file and click **Import**. The module validates the rows, anchors each event relative to the academic year, and immediately populates the calendar grid.

***

### Guide 8: Multi-Academy Trust (MAT) Synchronisation & Unsynced Events

For schools operating within a Multi-Academy Trust or local federation:

> [accordion] Cloning Central Trust Calendars
>
> 1. In MAT environments, centrally published trust calendars appear in a dedicated section on the **Calendar List**.
> 2. Schools can subscribe directly to the central feed or create a local copy synchronised to the central master.

> [accordion] Monitoring Unsynced Date Deviations
>
> * If a school adjusts the date of a centrally cloned event (or if trust leaders modify the central date), an alert indicator appears next to the event.
> * `Calendar Managers` can navigate to **Unsynced Events** (`/calendar/unsynced`) to review all divergent dates across the school.

> [accordion] Resolving Unsynced Discrepancies
>
> * **To re-synchronise with the Trust**: Disable then re-enable the event in the calendar list to pull down the updated central date.
> * **To keep a local school variation**: If your school intentionally holds the event on a different day, create a dedicated local event and disable the central copy. This ensures the unsynced monitor only highlights unintentional differences.

***

### Guide 9: Generating Print-Ready PDF Schedules

Produce professional PDF wall charts, committee briefing packs, and staff handbooks:

> [tab] Calendar Visual Grid PDF
>
> From the visual grid view (`/calendar/{calendar}/{year}`), select **Working week** or **Full week** layout, then click the **Print** icon at the top right. The module renders a clean, landscape PDF wall planner with term holiday shading.

> [tab] Upcoming Dates Agenda PDF
>
> From the **Upcoming Dates** page (`/calendar/dates`), click the **Print** button to export a chronological agenda of upcoming events for briefing meetings or pastoral notices.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.