Connect Moodle
For LMS administrators
This guide is for Moodle administrators connecting their institution to Odea. Setup takes about ten minutes. We then approve your institution by hand, usually within a working day.
Before you start
Section titled “Before you start”- Moodle 4.5 (LTS) through 5.3, and permission to install a plugin.
- A site reachable from the internet over HTTPS, at the root of its address:
https://moodle.your-university.nlworks,https://your-university.nl/moodledoes not yet.
Step 1: Install the plugin
Section titled “Step 1: Install the plugin”Download local_odea-<version>.zip from the
latest release.
The plugin is free and open source (GPL v3).
Go to Site administration → Plugins → Install plugins, upload the ZIP, and follow the upgrade screens.
Step 2: Connect
Section titled “Step 2: Connect”-
Go to Site administration → Plugins → Local plugins → Odea.
-
Fill in Your name and Your work email. Use your institutional address: we use its domain to recognise your staff and students, and to contact you.
-
Click Connect.
That click sets up everything Odea needs on your site: the web service Odea reads courses through, a service account with read-only access, and Odea as an LTI 1.3 (Learning Tools Interoperability) tool in the activity chooser. The plugin README lists every setting it changes.
Step 3: Wait for approval
Section titled “Step 3: Wait for approval”The page now says Almost there. We check every new institution by hand, usually within a working day, and email you at the address you entered once your institution is approved.
Odea is already in the activity chooser, but opening it shows an error until we have approved your institution. After that it works. You do not need to do anything else in Moodle.
To see whether you have been approved, click Check status on the Odea connection page. Once approved, the page says Connected. Odea is active for your institution.
Limit Odea to some courses
Section titled “Limit Odea to some courses”Every course on your site can use Odea. To run a pilot, limit it to one or more course categories:
-
Go to Site administration → Plugins → Activity modules → External tool → Manage tools.
-
Click the pencil icon on the Odea card.
-
Under Restrict to category, tick the categories that hold your pilot courses.
-
Click Save changes.
What educators and students see
Section titled “What educators and students see”The first educator to open Odea from a course links the Moodle course to Odea and chooses which materials the AI may use. This takes a few minutes, once per course.
A student who opens a course the educator has not set up yet sees a page saying the course is not ready and asking them to check back.
A copied or restored course counts as a new course, so the educator sets it up again. It never shows the previous term’s materials.
Troubleshooting
Section titled “Troubleshooting”When a launch fails, the user sees a page naming the problem and an error code to quote to you.
Opening Odea shows an error right after connecting. We have not approved your institution yet. See Step 3.
Educators cannot find Odea when adding an activity. On the Odea tool page, Tool configuration usage must be Show in activity chooser and as a preconfigured tool, and the tool’s card on Manage tools must be Active.
Odea is missing from some courses only. Restrict to category is ticked for a category those courses are not in. See Limit Odea to some courses.
The tool opens a blank frame. Default launch container must be New window.
Launches work but no course materials appear. Click Reconnect on the Odea connection page, and email us if materials still do not appear.
For problems common to every LMS, see Troubleshooting LTI launches.
Data and privacy
Section titled “Data and privacy”- Received per launch: issuer, a stable user identifier, email address, LTI role, and course context.
- Received via the web service: course content, materials, and enrolment lists, through six read-only functions.
- Hosting: processed and stored in the EU on Google Cloud. Encrypted in transit (TLS 1.2 and above) and at rest (AES-256).
Full detail is in the Trust Center and the privacy policy.