Skip to Content

Student Management

by
Odoo
v 18.0 Third Party 1
Download for v 18.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 570
Technical Name student_management
LicenseLGPL-3
You bought this module and need support? Click here!
Student Management Icon

Student Management

A complete educational module for Odoo 18 — manage students, teachers, courses, and staff from a single, clean interface.

Odoo 18 Education v18.0.1.0.0 LGPL-3

Features

🎓

Student Records

Full student profiles with date-of-birth validation. Only ages 18–60 are accepted, enforced automatically.

👨‍🏫

Teacher Management

Dedicated teacher model with personal details and easy linking to courses they teach.

📚

Course Assignments

Assign students and teachers to courses. Average student age is computed automatically.

🏢

Staff Management

Administrative and support staff records kept separate from academic personnel.

💬

Chatter Notifications

Automatic log messages posted to the chatter whenever a student is enrolled in a course.

🔍

Unified Search

One wizard to search across students, teachers, and staff simultaneously by keyword.

What Is Inside the Module?

Understanding the module's structure helps you customise or extend it later. Here is what each folder and key file does:

PathWhat it does
__manifest__.py The module's identity card. Odoo reads this first. It declares the name, version, dependencies (base, mail), and the list of XML data files to load.
__init__.py Tells Python that this folder is a package and imports the models sub-package.
models/student.py Defines the student.student model with age validation.
models/teacher.py Defines the student.teacher model.
models/course.py Defines student.course with many2many relationships and a computed average-age field.
models/staff.py Defines the student.staff model.
models/base_person.py Abstract base model shared by Student, Teacher, and Staff.
models/search_service.py Business logic for the unified search feature.
wizard/search_wizard.py Transient model (wizard) that drives the search dialog.
views/*.xml Form, list, and search views for every model, plus the top-level menu.
security/ir.model.access.csv Access control rules — who can read / write / create / delete each model.
static/description/ icon.png shown in the Apps list; this index.html shown as the module's description page.
tests/ Unit tests that run with --test-enable.

How to Upload & Install This Module on Odoo

Follow the steps below from start to finish. Each step is explained in plain language so even a first-time Odoo user can succeed.

Before You Start — What You Need

  • A running Odoo 18 instance (local, Docker, or cloud).
  • Administrator access to that Odoo database.
  • The student_management folder (or a .zip of it) on your computer.

Method A — Copy to the addons Folder (Recommended for Developers)

  1. Locate your Odoo add-ons directory

    This is the folder Odoo watches for custom modules. Common paths:

    • Local install: /opt/odoo/odoo18/custom_addons/
    • Docker: inside the container at the path set in odoo.conf → addons_path
    • Odoo.sh: the addons/ folder in your git repo.
  2. Copy the module folder

    Place the entire student_management folder (not just its contents) inside custom_addons/. The result should look like:

    custom_addons/student_management/__manifest__.py

  3. Verify addons_path in odoo.conf

    Open /etc/odoo/odoo.conf (or wherever your config lives) and make sure the path to custom_addons is listed:

    addons_path = /opt/odoo/odoo18/odoo/addons,/opt/odoo/odoo18/custom_addons

    Paths are comma-separated. The custom folder must appear in this list or Odoo will never see the module.
  4. Restart the Odoo service

    So Odoo picks up the new path:

    sudo systemctl restart odoo

    Or, if running manually:

    python odoo-bin -c /etc/odoo/odoo.conf

  5. Enable Developer Mode in Odoo

    Go to Settings → General Settings → Developer Tools and click "Activate the developer mode". This unlocks the Update App List button.

    You can also enable it by adding ?debug=1 to any Odoo URL in your browser.
  6. Update the App List

    Go to Apps (top menu) → click "Update App List" (visible only in developer mode). Confirm the dialog that appears.

    🖼️ Apps menu → Update App List button
  7. Find and install the module

    In the Apps search bar type Student Management. Remove the "Apps" filter if the module does not appear. Click Install.

    🖼️ Search result card with Install button
    Installation may take a few seconds. Odoo will reload the page when it is done.

Method B — Upload a .zip File via the Odoo Interface

Use this method when you cannot access the server's file system directly.

  1. Create a .zip archive of the module

    On your computer, right-click the student_management folder → Compress / Send to → Zip. The zip must contain the folder itself, so the structure inside is:

    student_management/__manifest__.py

    Do NOT zip the contents directly — the __manifest__.py must NOT be at the root of the zip. It must be one level deep, inside the named folder.
  2. Enable Developer Mode

    Settings → General Settings → Developer Tools → Activate the developer mode (same as step 5 in Method A above).

  3. Open Apps and click "Upload Module"

    Go to the Apps menu. In developer mode a new button "Upload Module" appears in the top-left area of the Apps page. Click it.

    🖼️ Apps page → Upload Module button (top-left)
  4. Select your .zip file

    A file-upload dialog opens. Click Choose File, navigate to your student_management.zip, and confirm.

  5. Click "Upload"

    Odoo extracts the zip, copies the module to its add-ons folder, and automatically refreshes the App List. You will see a success message.

  6. Search and Install

    Search for Student Management in the Apps list and click Install — identical to Step 7 of Method A.

What Happens During Installation?

When you click Install, Odoo does the following automatically — you do not have to do any of this manually:

StepWhat Odoo Does
1. Dependency check Reads depends in __manifest__.py (base, mail) and installs them first if not already present.
2. Database migration Runs CREATE TABLE statements for every model (student_student, student_teacher, etc.) with all their columns.
3. Security rules Loads security/ir.model.access.csv to create access-control records for every group.
4. Views & menus Loads all XML files listed under data in the manifest: form views, list views, search views, and the top-level menu items.
5. UI refresh Odoo reloads your browser so the new Student Management menu appears immediately.

First Use After Installation

  1. Open the Student Management app

    Click the Student Management icon on the Home screen, or navigate to the top menu bar. You will see a menu with entries: Students, Teachers, Courses, Staff, Search.

  2. Create a Course

    Go to Courses → New. Give it a name (e.g. "Mathematics 101") and save. A course must exist before students can be enrolled.

  3. Add Students

    Go to Students → New. Fill in name, date of birth (must result in age 18–60), and assign a course. Save the record — the chatter will log the enrolment automatically.

  4. Add Teachers and Staff

    Same flow: go to Teachers → New or Staff → New and fill in the details.

  5. Use Unified Search

    Click Search in the menu, type a keyword, and the wizard will return matching students, teachers, and staff all in one results dialog.

Upgrading the Module

When you release a new version:

  1. Replace the folder

    Copy the updated student_management folder to your custom_addons directory, overwriting the old one.

  2. Restart Odoo

    sudo systemctl restart odoo

  3. Upgrade from the Apps list

    Find Student Management in the Apps list and click the ⋮ → Upgrade button. Odoo will apply any new columns, views, or data files.

    Alternatively run from the command line:
    python odoo-bin -u student_management -d <your_db>

Uninstalling the Module

Uninstalling deletes all data created by this module (students, teachers, courses, staff) from the database. Always back up your database first.

In the Apps list, find Student Management and click ⋮ → Uninstall. Confirm the warning dialog.

Technical Requirements

RequirementValue
Odoo version18.0
Python3.10 +
Dependenciesbase, mail
LicenseLGPL-3
DatabasePostgreSQL (handled by Odoo)
External librariesNone — pure Odoo ORM

Author & Support

Developed by Basem Walid. For questions, bug reports, or feature requests please open an issue in the project repository or contact the author directly.

Student Management v18.0.1.0.0  |  Odoo 18  |  LGPL-3  |  Author: Basem Walid

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.