Changelog — MS Graph API Mailer

All notable changes to this plugin are documented here.
Format follows Keep a Changelog.

[1.1.9] — 2026-06-10 (version 2026061000)

Fixed

• "Email could not be sent" on the Contact Site Support form (hosts without /bin/true) — after delivering via Graph, the plugin suppressed the duplicate SMTP send by calling clearAllRecipients() on any host lacking /bin/true (Windows, minimal containers). That made PHPMailer::preSend() throw "no recipients", so $mail->send() — and therefore email_to_user() — returned false. Most callers ignore that return value, but user/contactsitesupport.php checks it and showed the "could not be sent, use the registered support address" notice (and fired a spurious email_failed event) even though the message was delivered. The duplicate-prevention path now points PHPMailer's sendmail mode at an OS-appropriate no-op (/bin/true/true on Unix, the cmd.exe built-in rem on Windows) and leaves recipients intact, so send() returns true on every platform. New helper local_msgraph_api_mailer_noop_sendmail() in lib.php


• Mustache "Example context JSON is unparsable" prechecker errors — in all three templates (changelog.mustache, email_log.mustache, test_validate.mustache) the @package/@copyright/@license tags followed the Example context (json): block inside the same {{! }} comment. The linter extracts everything after the marker to the end of the docblock and JSON-decodes it, so those trailing tag lines broke parsing. The docblocks were reordered so the example-context JSON is the last element before }} (tags moved above it), matching Moodle core templates. A Context variables required for this template: section was also added to each

[1.1.8] — 2026-04-08 (version 2026040800)

Fixed

• Mustache docblock format — merged the two separate {{! }} comment blocks (license + @template) into one in all three templates (changelog.mustache, email_log.mustache, test_validate.mustache) to resolve prechecker "Example context JSON is unparsable" errors


• AMD build files rebuilt — amd/build/index.min.js and amd/build/tester.min.js (+ source maps) regenerated from source to clear "uncommitted change detected" prechecker errors

[1.1.7] — 2026-04-07 (version 2026040700)

Fixed

• Array spacing in settings.php — corrected missing/extra spaces around => and after commas in the $statusmap array (lines 53–57) to comply with Moodle coding standard (phpcs)

[1.1.0] — 2026-03-14 (version 2026031400)

Added

• Send Test with Attachment button on settings page — sends a real .xlsx file to verify the full attachment pipeline end-to-end


• Connection status badge — live green/red indicator on the settings page, auto-checked on page load without requiring a button click


• Large attachment support (up to 150 MB) — attachments ≥ 3 MB are now uploaded via the Microsoft Graph upload session API (chunked PUT requests) instead of inline base64, bypassing the sendMail 3 MB payload limit


• Attachment column in Email Log — table and CSV export now show a paperclip indicator / "Yes"/"No" for emails that had attachments


• Changelog page (/local/msgraph_api_mailer/changelog.php) — version history accessible from the settings page


• CHANGES.md — this file

Fixed

• Attachment filename was temp name (tempup_XYZ) — lib.php was using $attach[1] (PHPMailer's basename($path)) instead of $attach[2] (the display name passed to addAttachment)


• Attachment had no extension — MIME type detection now reads magic bytes from the already-loaded in-memory content instead of reopening the temp file (which Moodle may delete between reads). Correct extension is appended automatically for xlsx, docx, pptx, xls, pdf, and other formats


• Uninstall error (Call to undefined function local_msgraph_api_mailer_remove_phpmailer_patch) — db/uninstall.php now require_onces lib.php before calling patch-removal functions; Moodle does not auto-include lib.php before uninstall hooks

Changed

• graph_client::format_attachments() renamed internally to split_attachments() returning [$small, $large] to support the two-path send flow


• Settings page link bar now includes Changelog button alongside Test Page and Email Log buttons

[1.0.0] — 2026-03-13 (version 2026031302)

Added

• Initial stable release


• Route all Moodle outgoing emails through Microsoft Graph API (replaces SMTP)


• OAuth2 client credentials flow with token caching (5-minute expiry buffer)


• Intercepts emails via phpmailer_init hook in lib.php; patches moodle_phpmailer.php on install to restore the hook removed in Moodle 5.x


• Patch auto-verified and re-applied via core\hook\after_config callback after Moodle upgrades


• Respects Moodle's $CFG->divertallemailsto email diverting setting


• SMTP fallback — optional automatic fallback to PHPMailer/SMTP on Graph API failure


• Email log viewer (emaillog.php) — searchable by recipient, subject, status, date range; CSV export; pagination


• Test & Validate page (index.php) — configuration status badges, Check Permissions, Send Test Email


• Inline AJAX test buttons on the settings page


• Mandatory field validation — cannot enable plugin without all Azure credentials filled in


• db/install.xml — creates local_msgraph_api_mailer_log table


• db/install.php / db/uninstall.php — apply/remove the phpmailer patch


• CLI test tool (cli/test_send.php) with --status, --test, --to, --subject, --body options

Release Notes — MS Graph API Mailer v1.1.8

Release Date: 08 April 2026
Plugin: local_msgraph_api_mailer
Moodle Compatibility: 5.1+
PHP Compatibility: 8.3+

Bug Fixes

Mustache template docblock — JSON parse error resolved

All three Mustache templates had their GPL license header and @template docblock
written as two separate {{! }} comment blocks. The Moodle prechecker extracts
the example context JSON from the first {{! }} block it encounters — when split,
it was reading the license text as JSON, producing:

Mustache syntax exception: Example context JSON is unparsable, fails with: Syntax error

for changelog.mustache, email_log.mustache, and test_validate.mustache.

All three templates now use a single {{! }} block that contains both the license
header and the @template docblock, which is the required Moodle standard format.

AMD build files rebuilt

amd/build/index.min.js and amd/build/tester.min.js (plus their .map files) were
stale relative to their sources in amd/src/, triggering:

Uncommitted change detected.

on all four build artefacts. Both files have been rebuilt from source.

Array spacing in settings.php (v1.1.7 carry-forward)

The $statusmap array in settings.php had a missing space before => on the 'ok'
key and extra spaces after commas inside the inner sub-arrays. Fixed to comply with the
Moodle phpcs coding standard.

Upgrade Notes

• Upgrading from any previous version: Drop-in replacement — no admin action required
  after upgrading through Moodle's standard plugin upgrade flow.


• Database: No schema changes. All existing log records are preserved.


• No cache purge required.

Files Changed

| File | Change |
|------|--------|
| version.php | Bumped to 1.1.8 / 2026040800 |
| db/upgrade.php | Added 2026040800 savepoint |
| templates/changelog.mustache | Merged split {{! }} comment blocks into one |
| templates/email_log.mustache | Merged split {{! }} comment blocks into one |
| templates/test_validate.mustache | Merged split {{! }} comment blocks into one |
| amd/build/index.min.js + .map | Rebuilt from amd/src/index.js |
| amd/build/tester.min.js + .map | Rebuilt from amd/src/tester.js |
| settings.php | Fixed phpcs array spacing in $statusmap |

Release date: 2026-04-07
Type: Prechecker Compliance Fix

What changed
Fixed array spacing violations in settings.php that were flagged by the Moodle Plugin Directory prechecker (phpcs — Moodle standard):

Missing space before => on the 'ok' key in $statusmap
Extra spaces after commas inside the inner arrays on keys failed_readonly, failed_anchor, failed_unknown, not_readable, and unknown
No functional changes. No database schema changes. No new features.

Upgrade notes
Drop-in replacement for v1.1.6 — no admin action required after upgrading
No database migration steps