#This is part of the 5.2.0 release of the Microsoft 365 Moodle plugin suite for Moodle 5.2, version v20260707_m502#
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20260707_m502

This is the initial release of the local_onenote plugin for Moodle 5.2.
The release is based on 5.1.2 release.

This is part of the 5.1.2 release of the Microsoft 365 Moodle plugin suite for Moodle 5.1, version v20260521_m501

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20260521_m501

Changes in this release:

• Use \core\context* classes to replace context_* classes, as per changes in core Moodle.


• Use \core\url class to replace moodle_url class.


• Update README, SECURITY and CODE_OF_CONDUCT files.

This is part of the 5.0.6 release of the Microsoft 365 Moodle plugin suite for Moodle 5.0, version v20260521_m500

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20260521_m500

Changes in this release:

• Use \core\context* classes to replace context_* classes, as per changes in core Moodle.


• Use \core\url class to replace moodle_url class.


• Update README, SECURITY and CODE_OF_CONDUCT files.

This is part of the 4.5.7 release of the Microsoft 365 Moodle plugin suite for Moodle 4.5, version v20260521_m405

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20260521_m405

Changes in this release:

• Use \core\context* classes to replace context_* classes, as per changes in core Moodle.


• Use \core\url class to replace moodle_url class.


• Update README, SECURITY and CODE_OF_CONDUCT files.

This is part of the 5.1.1 release of the Microsoft 365 Moodle plugin suite for Moodle 5.1, version v20260423_m501

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20260423_m501

Changes in this release:

• Various improvements in OneNote submission.

This is part of the 5.0.5 release of the Microsoft 365 Moodle plugin suite for Moodle 5.0, version v20260423_m500

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20260423_m500

Changes in this release:

• Various improvements in OneNote submission.

This is part of the 4.5.6 release of the Microsoft 365 Moodle plugin suite for Moodle 4.5, version v20260423_m405

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20260423_m405

Changes in this release:

• Various improvements in OneNote submission.

#This is part of the 5.1.0 release of the Microsoft 365 Moodle plugin suite for Moodle 5.1, version v20260210_m501#
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20260210_m501

This is the initial release of the local_onenote plugin for Moodle 5.1.
The release is based on 5.0.4 release.

This is part of the 5.0.4 release of the Microsoft 365 Moodle plugin suite for Moodle 5.0, version v20251223_m500#

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20251223_m500

Changes included in this release:

• Fix Moodle CI integration reported errors.

This is part of the 4.5.5 release of the Microsoft 365 Moodle plugin suite for Moodle 4.5, version v20251223_m405#

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20251223_m405

Changes included in this release:

• Fix Moodle CI integration reported errors.

#This is part of the 5.0.0 release of the Microsoft 365 Moodle plugin suite for Moodle 5.0, version v20250929_m500#
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20250929_m500

This is the initial release of the local_onenote plugin for Moodle 5.0.
The release is based on 4.5.1 release.

This is part of the 4.5.1 release of the Microsoft 365 Moodle plugin suite for Moodle 4.5, version v20250226_m405#

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20250226_m405

Changes included in this release:

• Fix Moodle plugin CI warnings and errors.


• Add GitHub and GitLab Moodle plugin CI integration to individual plugin repos.


• Handle empty binding username claim configuration.

This is part of the 4.4.2 release of the Microsoft 365 Moodle plugin suite for Moodle 4.4, version v20250226_m404#

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20250226_m404

Changes included in this release:

• Fix Moodle plugin CI warnings and errors.


• Add GitHub and GitLab Moodle plugin CI integration to individual plugin repos.


• Handle empty binding username claim configuration.

This is part of the 4.3.7 release of the Microsoft 365 Moodle plugin suite for Moodle 4.3, version v20250226_m403#

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20250226_m403

Changes included in this release:

• Fix Moodle plugin CI warnings and errors.


• Add GitHub and GitLab Moodle plugin CI integration to individual plugin repos.


• Handle empty binding username claim configuration.

This is part of the 4.1.10 release of the Microsoft 365 Moodle plugin suite for Moodle 4.1, version v20250226_m401#

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20250226_m401

Changes included in this release:

• Fix Moodle plugin CI warnings and errors.


• Add GitHub and GitLab Moodle plugin CI integration to individual plugin repos.


• Handle empty binding username claim configuration.

#This is part of the 4.5.0 release of the Microsoft 365 Moodle plugin suite for Moodle 4.5, version v20241125_m405#
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20241125_m405

This is the initial release of the local_onenote plugin for Moodle 4.5.
The release is based on 4.4.0 release.

#This is part of the 4.4.0 release of the Microsoft 365 Moodle plugin suite for Moodle 4.4, version v20240722_m404#
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20240722_m404

This is the initial release of the local_onenote plugin for Moodle 4.4.
The release is based on 4.3.1 release.

#This is part of the 4.3.1 release of the Microsoft 365 Moodle plugin suite for Moodle 4.3, version v20240311_m403.#
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20240311_m403

Changes in the local_onenote plugin in this release are:

• Clean up and unify exceptions usage across the plugins.

#This is part of the 4.2.3 release of the Microsoft 365 Moodle plugin suite for Moodle 4.2, version v20240311_m402.#
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20240311_m402

Changes in the local_onenote plugin in this release are:

• Clean up and unify exceptions usage across the plugins.

#This is part of the 4.1.4 release of the Microsoft 365 Moodle plugin suite for Moodle 4.1, version v20240311_m401.#
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20240311_m401

Changes in the local_onenote plugin in this release are:

• Clean up and unify exceptions usage across the plugins.

This is part of the 4.3.0 release of the Microsoft 365 Moodle plugin suite for Moodle 4.3, version v20231218_m403.
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20231218_m403

This is the initial release of the plugin for Moodle 4.3.

This is part of the 4.2.0 release of the Microsoft 365 Moodle plugin suite for Moodle 4.2, version v20230525_m402.
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20230525_m402

This is part of the 4.1.0 release of the Microsoft 365 Moodle plugin suite for Moodle 4.1, version v20221128_m41.
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20221128_m41

This is part of the 4.0.2 release of the Microsoft 365 Moodle plugin suite for Moodle 4.0, version v20221012_m40.

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20221012_m40

Changes in the local_onenote plugin in this release include:

• Remove use of legacy APIs.


• Add Microsoft SECURITY.MD.

This is part of the 3.11.5 release of the Microsoft 365 Moodle plugin suite for Moodle 3.11, version v20221012_m311.

Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20221012_m311

Changes in the local_onenote plugin in this release include:

• Remove use of legacy APIs.


• Add Microsoft SECURITY.MD.

This is part of the 4.0.0 release of the Microsoft 365 Moodle plugin suite for Moodle 4.0, version v20220512_m40.
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20220512_m40

This is part of the 3.11.3 release of the Microsoft 365 Moodle plugin suite for Moodle 3.11, version v20220411_m311.
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20220411_m311

Changes in the local_onenote plugin in this release include:

• Fix inconsistency in database field type in local_onenote.

This is part of the 3.10.6 release of the Microsoft 365 Moodle plugin suite for Moodle 3.10, version v20220411_m310.
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20220411_m310

Changes in the local_onenote plugin in this release include:

• Fix inconsistency in database field type in local_onenote.

This is part of the 3.9.9 release of the Microsoft 365 Moodle plugin suite for Moodle 3.9, version v20220411_m39.
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20220411_m39

Changes in the local_onenote plugin in this release include:

• Fix inconsistency in database field type in local_onenote.

This is part of the 3.11.2 release of the Microsoft 365 Moodle plugin suite for Moodle 3.11, version v20211207_m311.
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20211207_m311

Changes in local_onenote plugin in this release include:

• Fix Graph API calls to OneNote endpoint to get user files.


• Fix broken unit tests.


• General cleanup.

This is part of the 3.10.5 release of the Microsoft 365 Moodle plugin suite for Moodle 3.10, version v20211207_m310.
Complete Release Note: https://github.com/microsoft/o365-moodle/releases/tag/v20211207_m310

Changes in local_onenote plugin in this release include:

• Fix Graph API calls to OneNote endpoint to get user files.


• Fix broken unit tests.


• General cleanup.

This is the final feature and general bug release for the plugin for Moodle 3.9.
Bug fixes for security issues for Moodle 3.9 versions will continue until 8 May 2023.

This is part of the 3.9.8 release of the Microsoft 365 Moodle plugin suite for Moodle 3.9, version v20211207_m39.
Complete Release Note

Changes in local_onenote plugin in this release include:

• Fix Graph API calls to OneNote endpoint to get user files.


• Fix broken unit tests.


• General cleanup.

This is part of the 3.11.1 release of the Microsoft 365 Moodle plugin suite for Moodle 3.11, version v20211026_m311.
Complete Release Note

Changes in this release include:

• Fix a bug in which OneNote assignment submission cannot be deleted.


• Fix a bug in which OneNote assignment feedback cannot be deleted.


• When using "application access" connection method, remove the requirements of delegated permissions in Graph API calls.

This is part of the 3.10.4 release of the Microsoft 365 Moodle plugin suite for Moodle 3.10, version v20211026_m310.
Complete Release Note

Changes in this release include:

• Fix a bug in which OneNote assignment submission cannot be deleted.


• Fix a bug in which OneNote assignment feedback cannot be deleted.


• When using "application access" connection method, remove the requirements of delegated permissions in Graph API calls.

This is the final feature and general bug release for the plugin for Moodle 3.9.
Bug fixes for security issues for Moodle 3.9 versions will continue until 8 May 2023.

This is part of the 3.9.7 release of the Microsoft 365 Moodle plugin suite for Moodle 3.9, version v20211026_m39.
Complete Release Note

Changes in this release include:

• Fix a bug in which OneNote assignment submission cannot be deleted.


• Fix a bug in which OneNote assignment feedback cannot be deleted.


• When using "application access" connection method, remove the requirements of delegated permissions in Graph API calls.

This release is part of the Office 365 Moodle plugin suite for Moodle 3.11, version v20210901_m311
Complete Release Note

This release is part of the Office 365 Moodle plugin suite for Moodle 3.10, version v20210326_m310
Complete Release Note

This is the final feature and general bug release for the plugin for Moodle 3.9.
Bug fixes for security issues for Moodle 3.9 versions will continue until 8 May 2023.

This release is part of the Office 365 Moodle plugin suite for Moodle 3.9, version v20210326_m39
Complete Release Note

This release is part of the Office 365 Moodle plugin suite for Moodle 3.10, version v20210128_m310
Complete Release Note

This release is part of the Office 365 Moodle plugin suite for Moodle 3.9, version v20210128_m39
Complete Release Note

Moodle Plugins for Microsoft Services

including Office 365 and other Microsoft services

Microsoft OneNote Online API Local Plugin

This plugin provides a common client API for various other Moodle plugins that allow Moodle users to take advantage of Microsoft OneNote Online. This includes operations such as browsing your notebooks, sections, and pages; students doing assignments in OneNote and teachers providing feedback on those assignments in OneNote. It uses the Microsoft Account local plugin for authentication and using the OneNote Oneline REST API.

Usage

Instantiation:
$onenoteapi = \local_onenote\api\base::getinstance();

Logging the user in:
$onenoteapi->is_logged_in();

Making a REST API call:
$notebooks = $onenoteapi->get_items_list('');

Design details

There are several parts that make up the Microsoft OneNote Online API Local plugin.

Configuration

None. This plugin depends upon the Microsoft Account local plugin to be configured for accessing the appropriate Microsoft Live application.

\local_onenote\api\base class

This is a singleton class that provides simple wrappers for various authentication and the OneNote online REST API. Some of the functionality provided includes:

• render_signin_widget: Returns the HTML for displaying the signin widget for Microsoft OneNote.


• get_items_list: Used for drilling down the hierarchy of OneNote notebooks, sections, and pages.


• get_item_name: Returns the name of a notebook, section, or page.


• download_page: Downloads the contents of a OneNote page, including the HTML and any images; saves them in a folder and creates a .zip file out of it.


• render_action_button: Returns the HTML for displaying action buttons that allow students to view or work on OneNote assignments and teachers to provide feedback on them.


• get_page: Gets (or creates) the student submission page or teacher feedback page in OneNote for the given student assignment. Performs all actions such as determining if a page already exists and returning that; or determining if this is the first time a student is accessing the assignment and creating the page from the assignment title / prompt etc; or determining if a downloaded zipped page already exists and thawing the OneNote page from that.

onenote_actions.php file

This file processes form submissions from all the OneNote-related submit buttons in the Moodle API that help students work on their assignments and help teachers provide feedback on those assignments in OneNote.

Additional notes about the OneNote integration

When a user (student or teacher) clicks on the "Work on this" or "View Submission" or "View Feedback" buttons, the following actions may happen if needed:

• A notebook is created called "Moodle Notebook" in the OneNote account of the user


• Sections are created in that notebook with the names of all the courses the user is currently enrolled into.


• A page is created inside that section corresponding to the submission or feedback as necessary.


• The title of the submission / feedback page is the name of the assignment, prefixed by "Submission: " / "Feedback: ", and postfixed by "[firstname lastname]" of the student.


• Note that these actions take place in a lazy manner and only when necessary i.e. when the corresponding notebook, section, or page does not exist.


• These actions will also occur if the user subsequently goes into OneNote and deletes the notebook, section, or page.


• The connection between Moodle and the OneNote section or page is via the unique id of the section or page. This connection is loose i.e. if the user deletes the section or page, a new one will be created in its place and the appropriate ID maintained in the related Moodle database is updated.

Each submission for each student will have a Submission page and a Feedback page in the student's OneNote account. Also, for each assignment, there is a submission and feedback page for each student in the teacher's account. This is also done lazily i.e. only when teacher clicks on the above buttons. Correspondingly, each such page, when it gets saved inside Moodle, has a copy of the HTML and any associates images, all zipped up in a zip file.

If any of these submission or feedback pages get deleted in OneNote for some reason, they will get recreated when needed from their saved copy in Moodle. So the "master" is always with Moodle and the OneNote pages associated with the master are loosely connected to it.

This is part of the suite of Microsoft Services plugins for Moodle.

This repository is updated with stable releases. To follow active development, see: https://github.com/Microsoft/o365-moodle

Installation

1. Unpack the plugin into /local/onenote within your Moodle install.


2. From the Moodle Administration block, expand Site Administration and click "Notifications".


3. Follow the on-screen instuctions to install the plugin.

For more documentation, visit https://docs.moodle.org/34/en/Office365

For more information including support and instructions on how to contribute, please see: https://github.com/Microsoft/o365-moodle/blob/master/README.md

Copyright

© Microsoft, Inc. Code for this plugin is licensed under the GPLv3 license.

Any Microsoft trademarks and logos included in these plugins are property of Microsoft and should not be reused, redistributed, modified, repurposed, or otherwise altered or used outside of this plugin.

This release is part of the Office 365 Moodle plugin suite for Moodle 3.9, version v20200716_m39
Complete Release Note