Advanced Gradebook Bridge

The Moodle Gradebook Bridge (openeducat_moodle_gradebook_bridge) carries grades pulled from Moodle into the OpenEduCat Advanced Gradebook, so that Moodle activity feeds the same grading, approval and publication workflow as marks entered by hand.

The module installs itself automatically once the Moodle integration, the gradebook core and the grade connector are all present — no separate activation is required.

How It Works

1. A Moodle grade pull imports grades and records the operation in the sync log.

2. The bridge notices the completed pull and routes the imported exam, assignment and quiz grades to the grade connector.

3. The connector finds or creates the student’s gradebook and adds the grades as gradebook lines, flagged as automatically synchronized.

4. Depending on the publish mode, the gradebook then waits for approval, is approved automatically, or is published outright.

Moodle activity types are matched to the assessment categories of the gradebook — an assignment activity becomes an assignment line, a quiz becomes a quiz line — so the weights configured in the grade template apply to Moodle grades exactly as they do to manual ones.

Configuration

Open the Moodle instance and go to the Advance Gradebook tab.

Field	Description
Auto Sync Advance Gradebook	Runs the gradebook sync automatically after each Moodle grade pull. Enabled by default.
Auto Create Grade Mappings	Creates the grade source mappings for the exam types found in the Moodle data, so new activity types do not have to be mapped by hand. Enabled by default.
Grade Publish Mode	How far Moodle grades travel through the approval chain — see below.
Default Grade Scale	The scale used for gradebooks created automatically when the program has no scale of its own.
Push Reviewed Grades to Moodle	After a gradebook is published in OpenEduCat, writes the final grades back to Moodle. Disabled by default.

Grade Publish Mode

Mode	Behaviour
Manual	Grades stay In Progress until a head of department or administrator approves and publishes them. This is the default and the safest choice.
Auto-Approve	Grades move straight to Approved, bypassing review. An administrator still decides when to publish.
Auto-Publish	Grades are published as soon as they arrive. Use it only where Moodle is genuinely the authoritative source and institutional policy allows grades to reach students without review.

A warning banner is shown on the tab whenever a mode other than Manual is selected, because both alternatives skip the human check between Moodle and the student portal.

Setting Up Grade Mappings

The Setup Grade Mappings button on the tab creates the grade source mappings for the instance in one step. Run it after the first successful grade pull, once the Moodle activity types in use are known. It asks for confirmation, and existing mappings are left untouched.

Bulk Approve and Publish

At the end of a term, approving each Moodle-fed gradebook individually is impractical. The bulk wizard handles them together.

Open it from Bulk Approve & Publish Moodle Grades on the Advance Gradebook tab, or from Moodle Integration ‣ Manual Sync ‣ Bulk Approve & Publish (Moodle).

1. Filters :- Narrow the selection by Moodle instance, program, batch, academic year and a grade sync date range.

2. Action :- Approve Only, which moves the gradebooks to the approved state, or Approve & Publish, which completes the workflow.

3. Preview Matches :- Reports how many gradebooks the filters select, before anything is changed.

4. Execute :- Applies the action. A confirmation is requested first.

Only gradebooks containing at least one automatically synchronized line are included, so manually maintained gradebooks are never touched by this wizard.

Warning

Publishing is final and cannot be undone — published grades become visible to students. Always run Preview Matches and check the count before executing.

Pushing Grades Back to Moodle

When Push Reviewed Grades to Moodle is enabled, publishing a gradebook in OpenEduCat writes the final marks back to the Moodle gradebook. This is what you want when moderation, scaling or an appeal has changed a grade after it left Moodle, and students should see the corrected value on both systems.

Leave it disabled where Moodle is the sole grade source — otherwise grades make a round trip for no benefit.

Scheduled Action

The bridge adds a Moodle → Advance Gradebook Sync job that runs every three hours and catches anything the automatic trigger missed, for example grades imported while the gradebook modules were being configured.