From b2c3a39589a39669a2960a530bd0b3a29aded094 Mon Sep 17 00:00:00 2001 From: Aaron Wells Date: Fri, 14 Aug 2026 12:44:18 +1200 Subject: [PATCH] Clarify the difference between calendar "events" and event-handler events I recently encountered some confusion around the fact that Moodle has two types of entities it calls "events": 1. calendar events, used by the Calendar API and stored in the `mdl_event` table 2. events used by the Events API, for logging and event-handlers / observers --- docs/apis/core/calendar/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/apis/core/calendar/index.md b/docs/apis/core/calendar/index.md index 03ca98f0f..e00d5a0aa 100644 --- a/docs/apis/core/calendar/index.md +++ b/docs/apis/core/calendar/index.md @@ -3,7 +3,9 @@ title: Calendar API tags: [] --- -This page documents the Calendar API as it is in Moodle 3.3 and later. For the API in older versions of Moodle, see [Calendar API old](https://docs.moodle.org/dev/Calendar_API_old). +_This article is about **calendar events**, meant for conveying time-related information to users. For the unrelated concept of events used by **event handlers** / **observers** and **logging**, see **[Events API](https://moodledev.io/docs/5.3/apis#events-api-event)**._ + +_This page documents the Calendar API as it is in Moodle 3.3 and later. For the API in older versions of Moodle, see [Calendar API old](https://docs.moodle.org/dev/Calendar_API_old)._ The Calendar API allows you to add, modify and delete events in the calendar for user, groups, courses and the site. As of 3.3 it also allows you to provide actions for these events so that they are then displayed on block_myoverview, which by default is shown on users' dashboard.