Changelog

All notable changes to the MoodleConnect plugin will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[5.4.0] - 2026-03-23

Changed

• External Services migration: Replaced legacy browser AJAX endpoints (connect.php, ajax_save.php, sync_schema.php) with Moodle External Services (classes/external/* + db/services.php). JS now uses core/ajax instead of raw fetch(). Improves security, validation, and compatibility with Moodle standards.


• GPL boilerplate: Added missing GPL license headers to all AMD JavaScript source files

Added

• 7 new external function classes: connect_init, save_settings, get_connection_status, sync_events, sync_all_events, bulk_sync_count, bulk_sync_fire

Removed

• connect.php, ajax_save.php (replaced by External Services)


• AJAX action handlers in sync_schema.php (standalone page UI retained)


• URL/sesskey plumbing from templates, renderables, and admin setting classes

Fixed

• Course sync no longer fires a redundant HTTP call when the primary schema sync fails


• Connection status error now includes the actual curl error message instead of a generic string

[5.3.0] - 2026-03-12

Added

• Password Reset Requested Event: Custom event \local_mc_plugin\event\password_reset_requested fires when a user submits the forgot-password form
  
  
  
  • Includes reset token and reset URL in event payload for use in SendGrid or other email automations
  
  
  • Uses Moodle's post_forgot_password_requests plugin callback (Moodle 3.8+)
  
  
  • Automatically discovered in the event selector UI under "Local: MoodleConnect"
  
  
  • User data enriched by dynamic inspector (name, email, profile images)
  
  
  
  


• Schema sync other fields: Custom events can now declare other payload fields via get_other_mapping(), making them available as mappable variables in MoodleConnect automations

Fixed

• Event discovery: Custom plugin events now bypass stale autoloader classmap, ensuring newly added events are discovered immediately after plugin upgrade


• Schema discovery: Fixed other data extraction silently failing for all events when object fields were encountered


• Dynamic inspector: Avoid debugging() call in get_other_mapping fallback to prevent noise in production logs


• Action handlers: Refactored error handling to use class constants instead of magic strings for error codes


• i18n: Hardcoded English strings in limit warning banner now use get_string()


• i18n: Fixed lang string ordering violations for Moodle coding standards compliance


• Bulk sync JS: Module-level container reference prevents duplicate click listeners if init() is called more than once on the same page


• Bulk sync JS: Progress text now uses core/str lang string instead of hardcoded separator


• CLI cleanup tool: Output now reads "Submitted for deletion" instead of "Deleted claims" to accurately reflect batch delete semantics

[5.2.4] - 2026-03-06

Added

• Bulk User Sync (Experimental): Fire user_updated events for all active users to backfill data after creating a new automation
  
  
  
  • Preflight check validates connection status, monitored events, and quota usage
  
  
  • Batched processing (25 users per request) with progress bar
  
  
  • Confirmation dialog with quota impact warnings
  
  
  • Located under new "Experimental Features" section in plugin settings
  
  
  
  


• Manual CI Trigger: Added workflow_dispatch to CI workflow for on-demand runs

[5.2.3] - 2026-03-03

Changed

• Profile Image Sizes: Event payloads now include all three Moodle profile image sizes instead of just the 100x100 icon
  
  
  
  • profileimageurl_512x512 (f3) — largest available
  
  
  • profileimageurl_100x100 (f1) — standard icon
  
  
  • profileimageurl_35x35 (f2) — small thumbnail
  
  
  • Breaking: Replaces the previous single profileimageurl field
  
  
  
  

[5.2.2] - 2026-03-03

Fixed

• Profile Image URL Compatibility: Build URL directly via pluginfile.php instead of relying on Moodle's page renderer, which is not always initialized during event processing

[5.2.1] - 2026-03-02

Added

• Profile Image URL: User profile image URL is now included in event payloads (profileimageurl field)

[5.2.0] - 2026-02-21

Added

• Local Moodle Actions: MoodleConnect can now dispatch actions back to Moodle for inline execution
  
  
  
  • Supported actions: issue certificate, award badge, send message, enroll user, suspend enrolment, add to group, add to cohort
  
  
  • Claim-based idempotency prevents duplicate side effects
  
  
  • Structured error codes with retryable vs permanent classification
  
  
  
  


• Metadata Providers: Moodle site metadata (courses, roles, groups, cohorts, badges, certificates) exposed via API for UI dropdowns


• Manual Pending Claim Recovery CLI: local/mc_plugin/cli/cleanup_pending_claims.php
  
  
  
  • Lists orphaned pending claims with age and filters
  
  
  • Deletes matched claims only with explicit --delete --yes confirmation
  
  
  
  

Fixed

• Local Action Idempotency: Removed automatic stale-claim reclaim in inline action executor
  
  
  
  • Pending __pending__ claims are no longer auto-deleted by elapsed time
  
  
  • Prevents duplicate side effects when the original request is still executing
  
  
  
  


• Issue Certificate Config Fidelity: send_email action config is now honored
  
  
  
  • Uses customcert issue_certificate email argument when supported
  
  
  • Keeps compatibility with older customcert signatures
  
  
  
  

[5.1.1] - 2026-02-13

Fixed

• Connection Flow: Always show a fallback link when connecting to MoodleConnect
  
  
  
  • Previously relied on popup blocker detection which is unreliable across browsers
  
  
  • Now always displays "If a new tab didn't open, click here to open MoodleConnect" below the waiting status
  
  
  • Polling starts immediately regardless, so the connection completes automatically once authorized
  
  
  
  

[5.1.0] - 2026-01-26

Added

• Analytics Dashboard: New analytics page showing Moodle event activity
  
  
  
  • Summary KPIs: total events, unique users, active courses
  
  
  • Event type distribution (donut chart)
  
  
  • Top courses by activity (progress bars)
  
  
  • Top users by activity (with avatars)
  
  
  • Activity timeline (bar chart)
  
  
  • Date range filtering (7d, 30d, 90d)
  
  
  • Accessible from plugin settings page
  
  
  
  

Changed

• Documentation: Updated README with destinations terminology and event processing details

[5.0.1] - 2025-12-28

Added

• Health Check Sync: The health check endpoint now supports optional sync_events and sync_courses parameters
  
  
  
  • MoodleConnect can request event/course sync during health checks
  
  
  • Enables automatic data sync when users first connect their site
  
  
  • Eliminates the need for users to manually refresh after initial connection
  
  
  
  

Changed

• Improved initial connection experience - events and courses sync automatically

[5.0.0] - 2025-12-28

⚠️ BREAKING CHANGE

This version is required for continued event processing. The MoodleConnect backend now requires plugin version 5.0.0 or higher. Sites running older plugin versions will have events rejected with an "upgrade required" message.

Added

• Event Limit Blocking: Plugin now respects monthly event limits pushed from MoodleConnect
  
  
  
  • Events are automatically blocked when limit is exceeded
  
  
  • Admin warning banner displays in plugin settings when blocked
  
  
  • Events resume automatically when the new month begins
  
  
  
  


• Health Check Endpoint: New /api.php?action=health endpoint for connectivity verification
  
  
  
  • Returns Moodle version, plugin version, and monitored event count
  
  
  • Used by MoodleConnect to verify plugin compatibility
  
  
  
  


• Course-Level Filtering: Events can now be filtered by course at the Moodle level
  
  
  
  • MoodleConnect pushes course filters when triggers are configured
  
  
  • Reduces unnecessary event transmission for course-specific triggers
  
  
  
  


• Reverse Event Sync: MoodleConnect automatically updates monitored events when triggers change
  
  
  
  • No manual "Sync Events" needed after creating triggers
  
  
  • Plugin receives event list updates via API
  
  
  
  


• Automatic Course Sync: Courses are synced to MoodleConnect automatically
  
  
  
  • Initial sync on plugin connection
  
  
  • Incremental sync when courses are created, updated, or deleted
  
  
  
  

Changed

• Minimum Backend Compatibility: Requires MoodleConnect backend with health check support


• Event Processing: Events from unverified plugin versions are now rejected

Fixed

• Various code quality improvements and language string reorganization

[4.5.0] - 2025-12-24

Added

• Course Filter Sync: Course filters configured in MoodleConnect triggers are now pushed to Moodle


• Plugin filters events at source based on course include/exclude rules

[4.2.2] - 2025-12-22

Changed

• Build System: Removed local Gruntfile in favor of Moodle's grunt for AMD builds


• CI Compatibility: AMD build output now matches CI expectations exactly

Removed

• Local Gruntfile.js, package.json, node_modules/, husky pre-commit hooks


• These caused "uncommitted changes detected" errors in CI due to different minification output

[4.2.1] - 2025-12-22

Added

• Local Grunt Build System: Added Gruntfile.js with grunt-terser for AMD module minification


• Pre-commit Hook: Added husky + lint-staged to auto-rebuild AMD modules on commit


• No-op Stylelint Task: Added compatibility task for Moodle CI grunt checks

Changed

• Build Process: AMD modules can now be built locally without requiring Moodle container


• Maturity: Promoted from RC to STABLE

[4.2.1-rc1] - 2025-12-21

First official release candidate for Moodle Plugin Directory submission.

Fixed

• Moodle curl wrapper: Replaced direct curl_init() calls with Moodle's \curl class in connect.php and moodleconnect_client.php. This ensures proper proxy configuration support for organizations behind web proxies. (Fixes #1)


• Language strings: Moved hard-coded rate limit error message to language file using get_string(). (Fixes #2)


• Private IP detection: Added automatic detection of private IPs for local development, only bypassing URL security checks when necessary.

Changed

• Code consistency: Unified curl wrapper usage pattern across all API client files (connect.php, sync_schema.php, moodleconnect_client.php).

[4.1.0] - 2025-12-15

Changed

• Native Save Button: Removed custom "Save and Sync Events" button in favor of Moodle's native "Save changes" button.


• Auto-Sync on Page Load: Events are now automatically synced when the settings page loads (if connected).


• Simplified UI: Cleaner admin interface with fewer custom buttons.

Fixed

• CI Grunt Check: Fixed Grunt stale file detection with NVM support for correct Node.js version.


• Moodle 5.x Support: Added support for Moodle 5.x public directory structure in CI.


• PHPUnit Compatibility: Replaced assertObjectHasProperty() with property_exists() for older PHPUnit versions.


• AMD Module Builds: Rebuilt all AMD modules with correct Node.js/npm versions to match CI environment.

[4.0.3] - 2025-12-15

Fixed

• ESLint Complexity: Further refactored connect.js init function by extracting getConfigValue() and buildConfig() helpers.


• PHPCS Lang Ordering: Fixed alphabetical ordering of language strings in lang/en/local_mc_plugin.php.

[4.0.2] - 2025-12-15

Fixed

• ESLint Complexity: Refactored connect.js to reduce cyclomatic complexity below threshold.


• Stylelint: Removed all !important declarations from styles.css.


• PHPUnit Compatibility: Replaced assertObjectHasProperty with assertTrue(property_exists(...)) for Moodle 4.0/PHPUnit 9 compatibility.

[4.0.1] - 2025-12-15

Fixed

• Linting Issues: Resolved ESLint warnings in AMD modules (camelCase variables).


• PHPCS: Fixed language string ordering in lang/en/local_mc_plugin.php.

[4.0.0] - 2025-12-15

Added

• Output API Implementation: Complete refactor of the admin interface to use Moodle's Output API (Renderers, Renderables, Templates).


• Mustache Templates: Modern, responsive UI components for:
  
  
  
  • Event Selector (with search, filtering, and bulk actions)
  
  
  • Connection Status (dynamic updates via AJAX)
  
  
  • Action Buttons (loading states and feedback)
  
  
  
  


• AMD Modules: Full migration of JavaScript logic to modular, dependency-managed AMD files.


• Client-Side Rendering: Dynamic UI updates using core/templates for better performance and user experience.

Changed

• Admin Settings: Replaced legacy admin_setting_configtext with custom setting classes that delegate to the Output API.


• JavaScript Architecture: Removed all inline JavaScript; logic is now encapsulated in amd/src/local/admin/*.js.


• Styling: Cleaned up CSS and leveraged Bootstrap utility classes for consistent design.


• Code Structure: Improved separation of concerns between logic (PHP classes), presentation (Mustache), and behavior (JS).

Removed

• Legacy inline HTML generation in admin settings.


• Unused CSS styles and redundant code.

[3.2.0] - 2025-12-14

Added

• Comprehensive PHPUnit test suite with full coverage


• GitHub Actions CI workflow with matrix testing
  
  
  
  • Moodle 4.0, 4.5 (LTS), and 5.0 support
  
  
  • PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 compatibility
  
  
  • PostgreSQL and MariaDB database testing
  
  
  
  


• Input validation and CSRF protection for all plugin endpoints


• Privacy API implementation for GDPR compliance


• PHPDoc comments for all functions and classes


• GPL license headers on all PHP files


• Plugin icon for Moodle marketplace

Changed

• Improved code quality to meet Moodle Plugin Directory standards


• Enhanced error handling and logging


• Moved all hardcoded strings to language files


• Reorganized README with expanded documentation links


• Achieved full Moodle coding standards compliance - all 200+ phpcs violations fixed
  
  
  
  • Fixed variable naming conventions (snake_case to camelcase)
  
  
  • Fixed inline comment formatting (proper capitalization and punctuation)
  
  
  • Added documentation to empty catch blocks
  
  
  • Removed trailing whitespace from string literals
  
  
  • Fixed line length violations (132 and 180 character limits)
  
  
  • Removed unnecessary MOODLE_INTERNAL checks
  
  
  • Added missing class-level documentation
  
  
  • Replaced forbidden functions with Moodle-approved alternatives
  
  
  • Fixed interface ordering in privacy provider class
  
  
  • Fixed language string ordering (alphabetical)
  
  
  
  

Fixed

• Moodle 4.0 compatibility issues with event validation


• Test file locations and namespace handling


• AMD module builds using Moodle's Rollup system


• All phpcs errors and warnings resolved (zero violations)


• Debug warning suppression and MOODLE_INTERNAL checks

Security

• Added CSRF token validation for AJAX endpoints


• Input sanitization for all user-provided data

[3.1.0] - 2025-12-03

Added

• OAuth-style connection flow for simplified site linking


• One-click "Connect to MoodleConnect" button in plugin settings


• Automatic site key and secret exchange during connection


• Secure redirect handling between Moodle and MoodleConnect service


• Connection status indicator in admin interface


• Disconnect functionality to unlink sites

Changed

• Simplified initial setup process (no manual site key entry required)


• Improved user experience for site connection workflow


• Enhanced security with automatic credential exchange

Fixed

• Connection reliability improvements


• Better error messages during setup process

[3.0.0] - 2025-11-XX

Added

• Event observer system for capturing Moodle events


• Selective event monitoring via admin interface


• Event schema discovery and synchronization


• HMAC-based authentication for secure API communication


• Debug mode with detailed logging


• Sc

Changelog

All notable changes to the MoodleConnect plugin will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[5.4.0] - 2026-03-23

Changed

• External Services migration: Replaced legacy browser AJAX endpoints (connect.php, ajax_save.php, sync_schema.php) with Moodle External Services (classes/external/* + db/services.php). JS now uses core/ajax instead of raw fetch(). Improves security, validation, and compatibility with Moodle standards.


• GPL boilerplate: Added missing GPL license headers to all AMD JavaScript source files

Added

• 7 new external function classes: connect_init, save_settings, get_connection_status, sync_events, sync_all_events, bulk_sync_count, bulk_sync_fire

Removed

• connect.php, ajax_save.php (replaced by External Services)


• AJAX action handlers in sync_schema.php (standalone page UI retained)


• URL/sesskey plumbing from templates, renderables, and admin setting classes

Fixed

• Course sync no longer fires a redundant HTTP call when the primary schema sync fails


• Connection status error now includes the actual curl error message instead of a generic string

[5.3.0] - 2026-03-12

Added

• Password Reset Requested Event: Custom event \local_mc_plugin\event\password_reset_requested fires when a user submits the forgot-password form
  
  
  
  • Includes reset token and reset URL in event payload for use in SendGrid or other email automations
  
  
  • Uses Moodle's post_forgot_password_requests plugin callback (Moodle 3.8+)
  
  
  • Automatically discovered in the event selector UI under "Local: MoodleConnect"
  
  
  • User data enriched by dynamic inspector (name, email, profile images)
  
  
  
  


• Schema sync other fields: Custom events can now declare other payload fields via get_other_mapping(), making them available as mappable variables in MoodleConnect automations

Fixed

• Event discovery: Custom plugin events now bypass stale autoloader classmap, ensuring newly added events are discovered immediately after plugin upgrade


• Schema discovery: Fixed other data extraction silently failing for all events when object fields were encountered


• Dynamic inspector: Avoid debugging() call in get_other_mapping fallback to prevent noise in production logs


• Action handlers: Refactored error handling to use class constants instead of magic strings for error codes


• i18n: Hardcoded English strings in limit warning banner now use get_string()


• i18n: Fixed lang string ordering violations for Moodle coding standards compliance


• Bulk sync JS: Module-level container reference prevents duplicate click listeners if init() is called more than once on the same page


• Bulk sync JS: Progress text now uses core/str lang string instead of hardcoded separator


• CLI cleanup tool: Output now reads "Submitted for deletion" instead of "Deleted claims" to accurately reflect batch delete semantics

[5.2.4] - 2026-03-06

Added

• Bulk User Sync (Experimental): Fire user_updated events for all active users to backfill data after creating a new automation
  
  
  
  • Preflight check validates connection status, monitored events, and quota usage
  
  
  • Batched processing (25 users per request) with progress bar
  
  
  • Confirmation dialog with quota impact warnings
  
  
  • Located under new "Experimental Features" section in plugin settings
  
  
  
  


• Manual CI Trigger: Added workflow_dispatch to CI workflow for on-demand runs

[5.2.3] - 2026-03-03

Changed

• Profile Image Sizes: Event payloads now include all three Moodle profile image sizes instead of just the 100x100 icon
  
  
  
  • profileimageurl_512x512 (f3) — largest available
  
  
  • profileimageurl_100x100 (f1) — standard icon
  
  
  • profileimageurl_35x35 (f2) — small thumbnail
  
  
  • Breaking: Replaces the previous single profileimageurl field
  
  
  
  

[5.2.2] - 2026-03-03

Fixed

• Profile Image URL Compatibility: Build URL directly via pluginfile.php instead of relying on Moodle's page renderer, which is not always initialized during event processing

[5.2.1] - 2026-03-02

Added

• Profile Image URL: User profile image URL is now included in event payloads (profileimageurl field)

[5.2.0] - 2026-02-21

Added

• Local Moodle Actions: MoodleConnect can now dispatch actions back to Moodle for inline execution
  
  
  
  • Supported actions: issue certificate, award badge, send message, enroll user, suspend enrolment, add to group, add to cohort
  
  
  • Claim-based idempotency prevents duplicate side effects
  
  
  • Structured error codes with retryable vs permanent classification
  
  
  
  


• Metadata Providers: Moodle site metadata (courses, roles, groups, cohorts, badges, certificates) exposed via API for UI dropdowns


• Manual Pending Claim Recovery CLI: local/mc_plugin/cli/cleanup_pending_claims.php
  
  
  
  • Lists orphaned pending claims with age and filters
  
  
  • Deletes matched claims only with explicit --delete --yes confirmation
  
  
  
  

Fixed

• Local Action Idempotency: Removed automatic stale-claim reclaim in inline action executor
  
  
  
  • Pending __pending__ claims are no longer auto-deleted by elapsed time
  
  
  • Prevents duplicate side effects when the original request is still executing
  
  
  
  


• Issue Certificate Config Fidelity: send_email action config is now honored
  
  
  
  • Uses customcert issue_certificate email argument when supported
  
  
  • Keeps compatibility with older customcert signatures
  
  
  
  

[5.1.1] - 2026-02-13

Fixed

• Connection Flow: Always show a fallback link when connecting to MoodleConnect
  
  
  
  • Previously relied on popup blocker detection which is unreliable across browsers
  
  
  • Now always displays "If a new tab didn't open, click here to open MoodleConnect" below the waiting status
  
  
  • Polling starts immediately regardless, so the connection completes automatically once authorized
  
  
  
  

[5.1.0] - 2026-01-26

Added

• Analytics Dashboard: New analytics page showing Moodle event activity
  
  
  
  • Summary KPIs: total events, unique users, active courses
  
  
  • Event type distribution (donut chart)
  
  
  • Top courses by activity (progress bars)
  
  
  • Top users by activity (with avatars)
  
  
  • Activity timeline (bar chart)
  
  
  • Date range filtering (7d, 30d, 90d)
  
  
  • Accessible from plugin settings page
  
  
  
  

Changed

• Documentation: Updated README with destinations terminology and event processing details

[5.0.1] - 2025-12-28

Added

• Health Check Sync: The health check endpoint now supports optional sync_events and sync_courses parameters
  
  
  
  • MoodleConnect can request event/course sync during health checks
  
  
  • Enables automatic data sync when users first connect their site
  
  
  • Eliminates the need for users to manually refresh after initial connection
  
  
  
  

Changed

• Improved initial connection experience - events and courses sync automatically

[5.0.0] - 2025-12-28

⚠️ BREAKING CHANGE

This version is required for continued event processing. The MoodleConnect backend now requires plugin version 5.0.0 or higher. Sites running older plugin versions will have events rejected with an "upgrade required" message.

Added

• Event Limit Blocking: Plugin now respects monthly event limits pushed from MoodleConnect
  
  
  
  • Events are automatically blocked when limit is exceeded
  
  
  • Admin warning banner displays in plugin settings when blocked
  
  
  • Events resume automatically when the new month begins
  
  
  
  


• Health Check Endpoint: New /api.php?action=health endpoint for connectivity verification
  
  
  
  • Returns Moodle version, plugin version, and monitored event count
  
  
  • Used by MoodleConnect to verify plugin compatibility
  
  
  
  


• Course-Level Filtering: Events can now be filtered by course at the Moodle level
  
  
  
  • MoodleConnect pushes course filters when triggers are configured
  
  
  • Reduces unnecessary event transmission for course-specific triggers
  
  
  
  


• Reverse Event Sync: MoodleConnect automatically updates monitored events when triggers change
  
  
  
  • No manual "Sync Events" needed after creating triggers
  
  
  • Plugin receives event list updates via API
  
  
  
  


• Automatic Course Sync: Courses are synced to MoodleConnect automatically
  
  
  
  • Initial sync on plugin connection
  
  
  • Incremental sync when courses are created, updated, or deleted
  
  
  
  

Changed

• Minimum Backend Compatibility: Requires MoodleConnect backend with health check support


• Event Processing: Events from unverified plugin versions are now rejected

Fixed

• Various code quality improvements and language string reorganization

[4.5.0] - 2025-12-24

Added

• Course Filter Sync: Course filters configured in MoodleConnect triggers are now pushed to Moodle


• Plugin filters events at source based on course include/exclude rules

[4.2.2] - 2025-12-22

Changed

• Build System: Removed local Gruntfile in favor of Moodle's grunt for AMD builds


• CI Compatibility: AMD build output now matches CI expectations exactly

Removed

• Local Gruntfile.js, package.json, node_modules/, husky pre-commit hooks


• These caused "uncommitted changes detected" errors in CI due to different minification output

[4.2.1] - 2025-12-22

Added

• Local Grunt Build System: Added Gruntfile.js with grunt-terser for AMD module minification


• Pre-commit Hook: Added husky + lint-staged to auto-rebuild AMD modules on commit


• No-op Stylelint Task: Added compatibility task for Moodle CI grunt checks

Changed

• Build Process: AMD modules can now be built locally without requiring Moodle container


• Maturity: Promoted from RC to STABLE

[4.2.1-rc1] - 2025-12-21

First official release candidate for Moodle Plugin Directory submission.

Fixed

• Moodle curl wrapper: Replaced direct curl_init() calls with Moodle's \curl class in connect.php and moodleconnect_client.php. This ensures proper proxy configuration support for organizations behind web proxies. (Fixes #1)


• Language strings: Moved hard-coded rate limit error message to language file using get_string(). (Fixes #2)


• Private IP detection: Added automatic detection of private IPs for local development, only bypassing URL security checks when necessary.

Changed

• Code consistency: Unified curl wrapper usage pattern across all API client files (connect.php, sync_schema.php, moodleconnect_client.php).

[4.1.0] - 2025-12-15

Changed

• Native Save Button: Removed custom "Save and Sync Events" button in favor of Moodle's native "Save changes" button.


• Auto-Sync on Page Load: Events are now automatically synced when the settings page loads (if connected).


• Simplified UI: Cleaner admin interface with fewer custom buttons.

Fixed

• CI Grunt Check: Fixed Grunt stale file detection with NVM support for correct Node.js version.


• Moodle 5.x Support: Added support for Moodle 5.x public directory structure in CI.


• PHPUnit Compatibility: Replaced assertObjectHasProperty() with property_exists() for older PHPUnit versions.


• AMD Module Builds: Rebuilt all AMD modules with correct Node.js/npm versions to match CI environment.

[4.0.3] - 2025-12-15

Fixed

• ESLint Complexity: Further refactored connect.js init function by extracting getConfigValue() and buildConfig() helpers.


• PHPCS Lang Ordering: Fixed alphabetical ordering of language strings in lang/en/local_mc_plugin.php.

[4.0.2] - 2025-12-15

Fixed

• ESLint Complexity: Refactored connect.js to reduce cyclomatic complexity below threshold.


• Stylelint: Removed all !important declarations from styles.css.


• PHPUnit Compatibility: Replaced assertObjectHasProperty with assertTrue(property_exists(...)) for Moodle 4.0/PHPUnit 9 compatibility.

[4.0.1] - 2025-12-15

Fixed

• Linting Issues: Resolved ESLint warnings in AMD modules (camelCase variables).


• PHPCS: Fixed language string ordering in lang/en/local_mc_plugin.php.

[4.0.0] - 2025-12-15

Added

• Output API Implementation: Complete refactor of the admin interface to use Moodle's Output API (Renderers, Renderables, Templates).


• Mustache Templates: Modern, responsive UI components for:
  
  
  
  • Event Selector (with search, filtering, and bulk actions)
  
  
  • Connection Status (dynamic updates via AJAX)
  
  
  • Action Buttons (loading states and feedback)
  
  
  
  


• AMD Modules: Full migration of JavaScript logic to modular, dependency-managed AMD files.


• Client-Side Rendering: Dynamic UI updates using core/templates for better performance and user experience.

Changed

• Admin Settings: Replaced legacy admin_setting_configtext with custom setting classes that delegate to the Output API.


• JavaScript Architecture: Removed all inline JavaScript; logic is now encapsulated in amd/src/local/admin/*.js.


• Styling: Cleaned up CSS and leveraged Bootstrap utility classes for consistent design.


• Code Structure: Improved separation of concerns between logic (PHP classes), presentation (Mustache), and behavior (JS).

Removed

• Legacy inline HTML generation in admin settings.


• Unused CSS styles and redundant code.

[3.2.0] - 2025-12-14

Added

• Comprehensive PHPUnit test suite with full coverage


• GitHub Actions CI workflow with matrix testing
  
  
  
  • Moodle 4.0, 4.5 (LTS), and 5.0 support
  
  
  • PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 compatibility
  
  
  • PostgreSQL and MariaDB database testing
  
  
  
  


• Input validation and CSRF protection for all plugin endpoints


• Privacy API implementation for GDPR compliance


• PHPDoc comments for all functions and classes


• GPL license headers on all PHP files


• Plugin icon for Moodle marketplace

Changed

• Improved code quality to meet Moodle Plugin Directory standards


• Enhanced error handling and logging


• Moved all hardcoded strings to language files


• Reorganized README with expanded documentation links


• Achieved full Moodle coding standards compliance - all 200+ phpcs violations fixed
  
  
  
  • Fixed variable naming conventions (snake_case to camelcase)
  
  
  • Fixed inline comment formatting (proper capitalization and punctuation)
  
  
  • Added documentation to empty catch blocks
  
  
  • Removed trailing whitespace from string literals
  
  
  • Fixed line length violations (132 and 180 character limits)
  
  
  • Removed unnecessary MOODLE_INTERNAL checks
  
  
  • Added missing class-level documentation
  
  
  • Replaced forbidden functions with Moodle-approved alternatives
  
  
  • Fixed interface ordering in privacy provider class
  
  
  • Fixed language string ordering (alphabetical)
  
  
  
  

Fixed

• Moodle 4.0 compatibility issues with event validation


• Test file locations and namespace handling


• AMD module builds using Moodle's Rollup system


• All phpcs errors and warnings resolved (zero violations)


• Debug warning suppression and MOODLE_INTERNAL checks

Security

• Added CSRF token validation for AJAX endpoints


• Input sanitization for all user-provided data

[3.1.0] - 2025-12-03

Added

• OAuth-style connection flow for simplified site linking


• One-click "Connect to MoodleConnect" button in plugin settings


• Automatic site key and secret exchange during connection


• Secure redirect handling between Moodle and MoodleConnect service


• Connection status indicator in admin interface


• Disconnect functionality to unlink sites

Changed

• Simplified initial setup process (no manual site key entry required)


• Improved user experience for site connection workflow


• Enhanced security with automatic credential exchange

Fixed

• Connection reliability improvements


• Better error messages during setup process

[3.0.0] - 2025-11-XX

Added

• Event observer system for capturing Moodle events


• Selective event monitoring via admin interface


• Event schema discovery and synchronization


• HMAC-based authentication for secure API communication


• Debug mode with detailed logging


• Sc

Changelog

All notable changes to the MoodleConnect plugin will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[5.3.0] - 2026-03-12

Added

• Password Reset Requested Event: Custom event \local_mc_plugin\event\password_reset_requested fires when a user submits the forgot-password form
  
  
  
  • Includes reset token and reset URL in event payload for use in SendGrid or other email automations
  
  
  • Uses Moodle's post_forgot_password_requests plugin callback (Moodle 3.8+)
  
  
  • Automatically discovered in the event selector UI under "Local: MoodleConnect"
  
  
  • User data enriched by dynamic inspector (name, email, profile images)
  
  
  
  


• Schema sync other fields: Custom events can now declare other payload fields via get_other_mapping(), making them available as mappable variables in MoodleConnect automations

Fixed

• Event discovery: Custom plugin events now bypass stale autoloader classmap, ensuring newly added events are discovered immediately after plugin upgrade


• Schema discovery: Fixed other data extraction silently failing for all events when object fields were encountered


• Dynamic inspector: Avoid debugging() call in get_other_mapping fallback to prevent noise in production logs


• Action handlers: Refactored error handling to use class constants instead of magic strings for error codes


• i18n: Hardcoded English strings in limit warning banner now use get_string()


• i18n: Fixed lang string ordering violations for Moodle coding standards compliance


• Bulk sync JS: Module-level container reference prevents duplicate click listeners if init() is called more than once on the same page


• Bulk sync JS: Progress text now uses core/str lang string instead of hardcoded separator


• CLI cleanup tool: Output now reads "Submitted for deletion" instead of "Deleted claims" to accurately reflect batch delete semantics

[5.2.4] - 2026-03-06

Added

• Bulk User Sync (Experimental): Fire user_updated events for all active users to backfill data after creating a new automation
  
  
  
  • Preflight check validates connection status, monitored events, and quota usage
  
  
  • Batched processing (25 users per request) with progress bar
  
  
  • Confirmation dialog with quota impact warnings
  
  
  • Located under new "Experimental Features" section in plugin settings
  
  
  
  


• Manual CI Trigger: Added workflow_dispatch to CI workflow for on-demand runs

[5.2.3] - 2026-03-03

Changed

• Profile Image Sizes: Event payloads now include all three Moodle profile image sizes instead of just the 100x100 icon
  
  
  
  • profileimageurl_512x512 (f3) — largest available
  
  
  • profileimageurl_100x100 (f1) — standard icon
  
  
  • profileimageurl_35x35 (f2) — small thumbnail
  
  
  • Breaking: Replaces the previous single profileimageurl field
  
  
  
  

[5.2.2] - 2026-03-03

Fixed

• Profile Image URL Compatibility: Build URL directly via pluginfile.php instead of relying on Moodle's page renderer, which is not always initialized during event processing

[5.2.1] - 2026-03-02

Added

• Profile Image URL: User profile image URL is now included in event payloads (profileimageurl field)

[5.2.0] - 2026-02-21

Added

• Local Moodle Actions: MoodleConnect can now dispatch actions back to Moodle for inline execution
  
  
  
  • Supported actions: issue certificate, award badge, send message, enroll user, suspend enrolment, add to group, add to cohort
  
  
  • Claim-based idempotency prevents duplicate side effects
  
  
  • Structured error codes with retryable vs permanent classification
  
  
  
  


• Metadata Providers: Moodle site metadata (courses, roles, groups, cohorts, badges, certificates) exposed via API for UI dropdowns


• Manual Pending Claim Recovery CLI: local/mc_plugin/cli/cleanup_pending_claims.php
  
  
  
  • Lists orphaned pending claims with age and filters
  
  
  • Deletes matched claims only with explicit --delete --yes confirmation
  
  
  
  

Fixed

• Local Action Idempotency: Removed automatic stale-claim reclaim in inline action executor
  
  
  
  • Pending __pending__ claims are no longer auto-deleted by elapsed time
  
  
  • Prevents duplicate side effects when the original request is still executing
  
  
  
  


• Issue Certificate Config Fidelity: send_email action config is now honored
  
  
  
  • Uses customcert issue_certificate email argument when supported
  
  
  • Keeps compatibility with older customcert signatures
  
  
  
  

[5.1.1] - 2026-02-13

Fixed

• Connection Flow: Always show a fallback link when connecting to MoodleConnect
  
  
  
  • Previously relied on popup blocker detection which is unreliable across browsers
  
  
  • Now always displays "If a new tab didn't open, click here to open MoodleConnect" below the waiting status
  
  
  • Polling starts immediately regardless, so the connection completes automatically once authorized
  
  
  
  

[5.1.0] - 2026-01-26

Added

• Analytics Dashboard: New analytics page showing Moodle event activity
  
  
  
  • Summary KPIs: total events, unique users, active courses
  
  
  • Event type distribution (donut chart)
  
  
  • Top courses by activity (progress bars)
  
  
  • Top users by activity (with avatars)
  
  
  • Activity timeline (bar chart)
  
  
  • Date range filtering (7d, 30d, 90d)
  
  
  • Accessible from plugin settings page
  
  
  
  

Changed

• Documentation: Updated README with destinations terminology and event processing details

[5.0.1] - 2025-12-28

Added

• Health Check Sync: The health check endpoint now supports optional sync_events and sync_courses parameters
  
  
  
  • MoodleConnect can request event/course sync during health checks
  
  
  • Enables automatic data sync when users first connect their site
  
  
  • Eliminates the need for users to manually refresh after initial connection
  
  
  
  

Changed

• Improved initial connection experience - events and courses sync automatically

[5.0.0] - 2025-12-28

⚠️ BREAKING CHANGE

This version is required for continued event processing. The MoodleConnect backend now requires plugin version 5.0.0 or higher. Sites running older plugin versions will have events rejected with an "upgrade required" message.

Added

• Event Limit Blocking: Plugin now respects monthly event limits pushed from MoodleConnect
  
  
  
  • Events are automatically blocked when limit is exceeded
  
  
  • Admin warning banner displays in plugin settings when blocked
  
  
  • Events resume automatically when the new month begins
  
  
  
  


• Health Check Endpoint: New /api.php?action=health endpoint for connectivity verification
  
  
  
  • Returns Moodle version, plugin version, and monitored event count
  
  
  • Used by MoodleConnect to verify plugin compatibility
  
  
  
  


• Course-Level Filtering: Events can now be filtered by course at the Moodle level
  
  
  
  • MoodleConnect pushes course filters when triggers are configured
  
  
  • Reduces unnecessary event transmission for course-specific triggers
  
  
  
  


• Reverse Event Sync: MoodleConnect automatically updates monitored events when triggers change
  
  
  
  • No manual "Sync Events" needed after creating triggers
  
  
  • Plugin receives event list updates via API
  
  
  
  


• Automatic Course Sync: Courses are synced to MoodleConnect automatically
  
  
  
  • Initial sync on plugin connection
  
  
  • Incremental sync when courses are created, updated, or deleted
  
  
  
  

Changed

• Minimum Backend Compatibility: Requires MoodleConnect backend with health check support


• Event Processing: Events from unverified plugin versions are now rejected

Fixed

• Various code quality improvements and language string reorganization

[4.5.0] - 2025-12-24

Added

• Course Filter Sync: Course filters configured in MoodleConnect triggers are now pushed to Moodle


• Plugin filters events at source based on course include/exclude rules

[4.2.2] - 2025-12-22

Changed

• Build System: Removed local Gruntfile in favor of Moodle's grunt for AMD builds


• CI Compatibility: AMD build output now matches CI expectations exactly

Removed

• Local Gruntfile.js, package.json, node_modules/, husky pre-commit hooks


• These caused "uncommitted changes detected" errors in CI due to different minification output

[4.2.1] - 2025-12-22

Added

• Local Grunt Build System: Added Gruntfile.js with grunt-terser for AMD module minification


• Pre-commit Hook: Added husky + lint-staged to auto-rebuild AMD modules on commit


• No-op Stylelint Task: Added compatibility task for Moodle CI grunt checks

Changed

• Build Process: AMD modules can now be built locally without requiring Moodle container


• Maturity: Promoted from RC to STABLE

[4.2.1-rc1] - 2025-12-21

First official release candidate for Moodle Plugin Directory submission.

Fixed

• Moodle curl wrapper: Replaced direct curl_init() calls with Moodle's \curl class in connect.php and moodleconnect_client.php. This ensures proper proxy configuration support for organizations behind web proxies. (Fixes #1)


• Language strings: Moved hard-coded rate limit error message to language file using get_string(). (Fixes #2)


• Private IP detection: Added automatic detection of private IPs for local development, only bypassing URL security checks when necessary.

Changed

• Code consistency: Unified curl wrapper usage pattern across all API client files (connect.php, sync_schema.php, moodleconnect_client.php).

[4.1.0] - 2025-12-15

Changed

• Native Save Button: Removed custom "Save and Sync Events" button in favor of Moodle's native "Save changes" button.


• Auto-Sync on Page Load: Events are now automatically synced when the settings page loads (if connected).


• Simplified UI: Cleaner admin interface with fewer custom buttons.

Fixed

• CI Grunt Check: Fixed Grunt stale file detection with NVM support for correct Node.js version.


• Moodle 5.x Support: Added support for Moodle 5.x public directory structure in CI.


• PHPUnit Compatibility: Replaced assertObjectHasProperty() with property_exists() for older PHPUnit versions.


• AMD Module Builds: Rebuilt all AMD modules with correct Node.js/npm versions to match CI environment.

[4.0.3] - 2025-12-15

Fixed

• ESLint Complexity: Further refactored connect.js init function by extracting getConfigValue() and buildConfig() helpers.


• PHPCS Lang Ordering: Fixed alphabetical ordering of language strings in lang/en/local_mc_plugin.php.

[4.0.2] - 2025-12-15

Fixed

• ESLint Complexity: Refactored connect.js to reduce cyclomatic complexity below threshold.


• Stylelint: Removed all !important declarations from styles.css.


• PHPUnit Compatibility: Replaced assertObjectHasProperty with assertTrue(property_exists(...)) for Moodle 4.0/PHPUnit 9 compatibility.

[4.0.1] - 2025-12-15

Fixed

• Linting Issues: Resolved ESLint warnings in AMD modules (camelCase variables).


• PHPCS: Fixed language string ordering in lang/en/local_mc_plugin.php.

[4.0.0] - 2025-12-15

Added

• Output API Implementation: Complete refactor of the admin interface to use Moodle's Output API (Renderers, Renderables, Templates).


• Mustache Templates: Modern, responsive UI components for:
  
  
  
  • Event Selector (with search, filtering, and bulk actions)
  
  
  • Connection Status (dynamic updates via AJAX)
  
  
  • Action Buttons (loading states and feedback)
  
  
  
  


• AMD Modules: Full migration of JavaScript logic to modular, dependency-managed AMD files.


• Client-Side Rendering: Dynamic UI updates using core/templates for better performance and user experience.

Changed

• Admin Settings: Replaced legacy admin_setting_configtext with custom setting classes that delegate to the Output API.


• JavaScript Architecture: Removed all inline JavaScript; logic is now encapsulated in amd/src/local/admin/*.js.


• Styling: Cleaned up CSS and leveraged Bootstrap utility classes for consistent design.


• Code Structure: Improved separation of concerns between logic (PHP classes), presentation (Mustache), and behavior (JS).

Removed

• Legacy inline HTML generation in admin settings.


• Unused CSS styles and redundant code.

[3.2.0] - 2025-12-14

Added

• Comprehensive PHPUnit test suite with full coverage


• GitHub Actions CI workflow with matrix testing
  
  
  
  • Moodle 4.0, 4.5 (LTS), and 5.0 support
  
  
  • PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 compatibility
  
  
  • PostgreSQL and MariaDB database testing
  
  
  
  


• Input validation and CSRF protection for all plugin endpoints


• Privacy API implementation for GDPR compliance


• PHPDoc comments for all functions and classes


• GPL license headers on all PHP files


• Plugin icon for Moodle marketplace

Changed

• Improved code quality to meet Moodle Plugin Directory standards


• Enhanced error handling and logging


• Moved all hardcoded strings to language files


• Reorganized README with expanded documentation links


• Achieved full Moodle coding standards compliance - all 200+ phpcs violations fixed
  
  
  
  • Fixed variable naming conventions (snake_case to camelcase)
  
  
  • Fixed inline comment formatting (proper capitalization and punctuation)
  
  
  • Added documentation to empty catch blocks
  
  
  • Removed trailing whitespace from string literals
  
  
  • Fixed line length violations (132 and 180 character limits)
  
  
  • Removed unnecessary MOODLE_INTERNAL checks
  
  
  • Added missing class-level documentation
  
  
  • Replaced forbidden functions with Moodle-approved alternatives
  
  
  • Fixed interface ordering in privacy provider class
  
  
  • Fixed language string ordering (alphabetical)
  
  
  
  

Fixed

• Moodle 4.0 compatibility issues with event validation


• Test file locations and namespace handling


• AMD module builds using Moodle's Rollup system


• All phpcs errors and warnings resolved (zero violations)


• Debug warning suppression and MOODLE_INTERNAL checks

Security

• Added CSRF token validation for AJAX endpoints


• Input sanitization for all user-provided data

[3.1.0] - 2025-12-03

Added

• OAuth-style connection flow for simplified site linking


• One-click "Connect to MoodleConnect" button in plugin settings


• Automatic site key and secret exchange during connection


• Secure redirect handling between Moodle and MoodleConnect service


• Connection status indicator in admin interface


• Disconnect functionality to unlink sites

Changed

• Simplified initial setup process (no manual site key entry required)


• Improved user experience for site connection workflow


• Enhanced security with automatic credential exchange

Fixed

• Connection reliability improvements


• Better error messages during setup process

[3.0.0] - 2025-11-XX

Added

• Event observer system for capturing Moodle events


• Selective event monitoring via admin interface


• Event schema discovery and synchronization


• HMAC-based authentication for secure API communication


• Debug mode with detailed logging


• Schema sync page with AJAX-based UI


• Support for dynamic event field inspection


• Configurable MoodleConnect API endpoint

Changed

• Initial stable release for production use

Security

• Implemented HMAC signature verification for all API requests


• Secure storage of site credentials


• HTTPS-only communication with MoodleConnect service

[2.0.0] - 2025-10-XX

Added

• Beta release with core functionality


• Basic event capture and transmission


• Admin settings interface

[1.0.0] - 2025-09-XX

Added

• Initial alpha release


• Proof of concept implementation

Version Numbering

This plugin follows Moodle's version numbering scheme:

• version: YYYYMMDDXX format (e.g., 2025120301)


• release: Semantic versioning (e.g., v3.1.0)

Upgrade Notes

Upgrading to 3.1.0

If you're upgrading from 3.0.0:

1. The plugin will automatically migrate your existing site key and secret


2. You'll see a new "Connect to MoodleConnect" interface


3. If already connected, your connection will remain active


4. No action required - existing triggers and configurations are preserved

Changelog

All notable changes to the MoodleConnect plugin will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[5.3.0] - 2026-03-12

Added

• Password Reset Requested Event: Custom event \local_mc_plugin\event\password_reset_requested fires when a user submits the forgot-password form
  
  
  
  • Includes reset token and reset URL in event payload for use in SendGrid or other email automations
  
  
  • Uses Moodle's post_forgot_password_requests plugin callback (Moodle 3.8+)
  
  
  • Automatically discovered in the event selector UI under "Local: MoodleConnect"
  
  
  • User data enriched by dynamic inspector (name, email, profile images)
  
  
  
  


• Schema sync other fields: Custom events can now declare other payload fields via get_other_mapping(), making them available as mappable variables in MoodleConnect automations

Fixed

• Event discovery: Custom plugin events now bypass stale autoloader classmap, ensuring newly added events are discovered immediately after plugin upgrade


• Schema discovery: Fixed other data extraction silently failing for all events when object fields were encountered


• Dynamic inspector: Avoid debugging() call in get_other_mapping fallback to prevent noise in production logs


• Action handlers: Refactored error handling to use class constants instead of magic strings for error codes


• i18n: Hardcoded English strings in limit warning banner now use get_string()


• i18n: Fixed lang string ordering violations for Moodle coding standards compliance


• Bulk sync JS: Module-level container reference prevents duplicate click listeners if init() is called more than once on the same page


• Bulk sync JS: Progress text now uses core/str lang string instead of hardcoded separator


• CLI cleanup tool: Output now reads "Submitted for deletion" instead of "Deleted claims" to accurately reflect batch delete semantics

[5.2.4] - 2026-03-06

Added

• Bulk User Sync (Experimental): Fire user_updated events for all active users to backfill data after creating a new automation
  
  
  
  • Preflight check validates connection status, monitored events, and quota usage
  
  
  • Batched processing (25 users per request) with progress bar
  
  
  • Confirmation dialog with quota impact warnings
  
  
  • Located under new "Experimental Features" section in plugin settings
  
  
  
  


• Manual CI Trigger: Added workflow_dispatch to CI workflow for on-demand runs

[5.2.3] - 2026-03-03

Changed

• Profile Image Sizes: Event payloads now include all three Moodle profile image sizes instead of just the 100x100 icon
  
  
  
  • profileimageurl_512x512 (f3) — largest available
  
  
  • profileimageurl_100x100 (f1) — standard icon
  
  
  • profileimageurl_35x35 (f2) — small thumbnail
  
  
  • Breaking: Replaces the previous single profileimageurl field
  
  
  
  

[5.2.2] - 2026-03-03

Fixed

• Profile Image URL Compatibility: Build URL directly via pluginfile.php instead of relying on Moodle's page renderer, which is not always initialized during event processing

[5.2.1] - 2026-03-02

Added

• Profile Image URL: User profile image URL is now included in event payloads (profileimageurl field)

[5.2.0] - 2026-02-21

Added

• Local Moodle Actions: MoodleConnect can now dispatch actions back to Moodle for inline execution
  
  
  
  • Supported actions: issue certificate, award badge, send message, enroll user, suspend enrolment, add to group, add to cohort
  
  
  • Claim-based idempotency prevents duplicate side effects
  
  
  • Structured error codes with retryable vs permanent classification
  
  
  
  


• Metadata Providers: Moodle site metadata (courses, roles, groups, cohorts, badges, certificates) exposed via API for UI dropdowns


• Manual Pending Claim Recovery CLI: local/mc_plugin/cli/cleanup_pending_claims.php
  
  
  
  • Lists orphaned pending claims with age and filters
  
  
  • Deletes matched claims only with explicit --delete --yes confirmation
  
  
  
  

Fixed

• Local Action Idempotency: Removed automatic stale-claim reclaim in inline action executor
  
  
  
  • Pending __pending__ claims are no longer auto-deleted by elapsed time
  
  
  • Prevents duplicate side effects when the original request is still executing
  
  
  
  


• Issue Certificate Config Fidelity: send_email action config is now honored
  
  
  
  • Uses customcert issue_certificate email argument when supported
  
  
  • Keeps compatibility with older customcert signatures
  
  
  
  

[5.1.1] - 2026-02-13

Fixed

• Connection Flow: Always show a fallback link when connecting to MoodleConnect
  
  
  
  • Previously relied on popup blocker detection which is unreliable across browsers
  
  
  • Now always displays "If a new tab didn't open, click here to open MoodleConnect" below the waiting status
  
  
  • Polling starts immediately regardless, so the connection completes automatically once authorized
  
  
  
  

[5.1.0] - 2026-01-26

Added

• Analytics Dashboard: New analytics page showing Moodle event activity
  
  
  
  • Summary KPIs: total events, unique users, active courses
  
  
  • Event type distribution (donut chart)
  
  
  • Top courses by activity (progress bars)
  
  
  • Top users by activity (with avatars)
  
  
  • Activity timeline (bar chart)
  
  
  • Date range filtering (7d, 30d, 90d)
  
  
  • Accessible from plugin settings page
  
  
  
  

Changed

• Documentation: Updated README with destinations terminology and event processing details

[5.0.1] - 2025-12-28

Added

• Health Check Sync: The health check endpoint now supports optional sync_events and sync_courses parameters
  
  
  
  • MoodleConnect can request event/course sync during health checks
  
  
  • Enables automatic data sync when users first connect their site
  
  
  • Eliminates the need for users to manually refresh after initial connection
  
  
  
  

Changed

• Improved initial connection experience - events and courses sync automatically

[5.0.0] - 2025-12-28

⚠️ BREAKING CHANGE

This version is required for continued event processing. The MoodleConnect backend now requires plugin version 5.0.0 or higher. Sites running older plugin versions will have events rejected with an "upgrade required" message.

Added

• Event Limit Blocking: Plugin now respects monthly event limits pushed from MoodleConnect
  
  
  
  • Events are automatically blocked when limit is exceeded
  
  
  • Admin warning banner displays in plugin settings when blocked
  
  
  • Events resume automatically when the new month begins
  
  
  
  


• Health Check Endpoint: New /api.php?action=health endpoint for connectivity verification
  
  
  
  • Returns Moodle version, plugin version, and monitored event count
  
  
  • Used by MoodleConnect to verify plugin compatibility
  
  
  
  


• Course-Level Filtering: Events can now be filtered by course at the Moodle level
  
  
  
  • MoodleConnect pushes course filters when triggers are configured
  
  
  • Reduces unnecessary event transmission for course-specific triggers
  
  
  
  


• Reverse Event Sync: MoodleConnect automatically updates monitored events when triggers change
  
  
  
  • No manual "Sync Events" needed after creating triggers
  
  
  • Plugin receives event list updates via API
  
  
  
  


• Automatic Course Sync: Courses are synced to MoodleConnect automatically
  
  
  
  • Initial sync on plugin connection
  
  
  • Incremental sync when courses are created, updated, or deleted
  
  
  
  

Changed

• Minimum Backend Compatibility: Requires MoodleConnect backend with health check support


• Event Processing: Events from unverified plugin versions are now rejected

Fixed

• Various code quality improvements and language string reorganization

[4.5.0] - 2025-12-24

Added

• Course Filter Sync: Course filters configured in MoodleConnect triggers are now pushed to Moodle


• Plugin filters events at source based on course include/exclude rules

[4.2.2] - 2025-12-22

Changed

• Build System: Removed local Gruntfile in favor of Moodle's grunt for AMD builds


• CI Compatibility: AMD build output now matches CI expectations exactly

Removed

• Local Gruntfile.js, package.json, node_modules/, husky pre-commit hooks


• These caused "uncommitted changes detected" errors in CI due to different minification output

[4.2.1] - 2025-12-22

Added

• Local Grunt Build System: Added Gruntfile.js with grunt-terser for AMD module minification


• Pre-commit Hook: Added husky + lint-staged to auto-rebuild AMD modules on commit


• No-op Stylelint Task: Added compatibility task for Moodle CI grunt checks

Changed

• Build Process: AMD modules can now be built locally without requiring Moodle container


• Maturity: Promoted from RC to STABLE

[4.2.1-rc1] - 2025-12-21

First official release candidate for Moodle Plugin Directory submission.

Fixed

• Moodle curl wrapper: Replaced direct curl_init() calls with Moodle's \curl class in connect.php and moodleconnect_client.php. This ensures proper proxy configuration support for organizations behind web proxies. (Fixes #1)


• Language strings: Moved hard-coded rate limit error message to language file using get_string(). (Fixes #2)


• Private IP detection: Added automatic detection of private IPs for local development, only bypassing URL security checks when necessary.

Changed

• Code consistency: Unified curl wrapper usage pattern across all API client files (connect.php, sync_schema.php, moodleconnect_client.php).

[4.1.0] - 2025-12-15

Changed

• Native Save Button: Removed custom "Save and Sync Events" button in favor of Moodle's native "Save changes" button.


• Auto-Sync on Page Load: Events are now automatically synced when the settings page loads (if connected).


• Simplified UI: Cleaner admin interface with fewer custom buttons.

Fixed

• CI Grunt Check: Fixed Grunt stale file detection with NVM support for correct Node.js version.


• Moodle 5.x Support: Added support for Moodle 5.x public directory structure in CI.


• PHPUnit Compatibility: Replaced assertObjectHasProperty() with property_exists() for older PHPUnit versions.


• AMD Module Builds: Rebuilt all AMD modules with correct Node.js/npm versions to match CI environment.

[4.0.3] - 2025-12-15

Fixed

• ESLint Complexity: Further refactored connect.js init function by extracting getConfigValue() and buildConfig() helpers.


• PHPCS Lang Ordering: Fixed alphabetical ordering of language strings in lang/en/local_mc_plugin.php.

[4.0.2] - 2025-12-15

Fixed

• ESLint Complexity: Refactored connect.js to reduce cyclomatic complexity below threshold.


• Stylelint: Removed all !important declarations from styles.css.


• PHPUnit Compatibility: Replaced assertObjectHasProperty with assertTrue(property_exists(...)) for Moodle 4.0/PHPUnit 9 compatibility.

[4.0.1] - 2025-12-15

Fixed

• Linting Issues: Resolved ESLint warnings in AMD modules (camelCase variables).


• PHPCS: Fixed language string ordering in lang/en/local_mc_plugin.php.

[4.0.0] - 2025-12-15

Added

• Output API Implementation: Complete refactor of the admin interface to use Moodle's Output API (Renderers, Renderables, Templates).


• Mustache Templates: Modern, responsive UI components for:
  
  
  
  • Event Selector (with search, filtering, and bulk actions)
  
  
  • Connection Status (dynamic updates via AJAX)
  
  
  • Action Buttons (loading states and feedback)
  
  
  
  


• AMD Modules: Full migration of JavaScript logic to modular, dependency-managed AMD files.


• Client-Side Rendering: Dynamic UI updates using core/templates for better performance and user experience.

Changed

• Admin Settings: Replaced legacy admin_setting_configtext with custom setting classes that delegate to the Output API.


• JavaScript Architecture: Removed all inline JavaScript; logic is now encapsulated in amd/src/local/admin/*.js.


• Styling: Cleaned up CSS and leveraged Bootstrap utility classes for consistent design.


• Code Structure: Improved separation of concerns between logic (PHP classes), presentation (Mustache), and behavior (JS).

Removed

• Legacy inline HTML generation in admin settings.


• Unused CSS styles and redundant code.

[3.2.0] - 2025-12-14

Added

• Comprehensive PHPUnit test suite with full coverage


• GitHub Actions CI workflow with matrix testing
  
  
  
  • Moodle 4.0, 4.5 (LTS), and 5.0 support
  
  
  • PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 compatibility
  
  
  • PostgreSQL and MariaDB database testing
  
  
  
  


• Input validation and CSRF protection for all plugin endpoints


• Privacy API implementation for GDPR compliance


• PHPDoc comments for all functions and classes


• GPL license headers on all PHP files


• Plugin icon for Moodle marketplace

Changed

• Improved code quality to meet Moodle Plugin Directory standards


• Enhanced error handling and logging


• Moved all hardcoded strings to language files


• Reorganized README with expanded documentation links


• Achieved full Moodle coding standards compliance - all 200+ phpcs violations fixed
  
  
  
  • Fixed variable naming conventions (snake_case to camelcase)
  
  
  • Fixed inline comment formatting (proper capitalization and punctuation)
  
  
  • Added documentation to empty catch blocks
  
  
  • Removed trailing whitespace from string literals
  
  
  • Fixed line length violations (132 and 180 character limits)
  
  
  • Removed unnecessary MOODLE_INTERNAL checks
  
  
  • Added missing class-level documentation
  
  
  • Replaced forbidden functions with Moodle-approved alternatives
  
  
  • Fixed interface ordering in privacy provider class
  
  
  • Fixed language string ordering (alphabetical)
  
  
  
  

Fixed

• Moodle 4.0 compatibility issues with event validation


• Test file locations and namespace handling


• AMD module builds using Moodle's Rollup system


• All phpcs errors and warnings resolved (zero violations)


• Debug warning suppression and MOODLE_INTERNAL checks

Security

• Added CSRF token validation for AJAX endpoints


• Input sanitization for all user-provided data

[3.1.0] - 2025-12-03

Added

• OAuth-style connection flow for simplified site linking


• One-click "Connect to MoodleConnect" button in plugin settings


• Automatic site key and secret exchange during connection


• Secure redirect handling between Moodle and MoodleConnect service


• Connection status indicator in admin interface


• Disconnect functionality to unlink sites

Changed

• Simplified initial setup process (no manual site key entry required)


• Improved user experience for site connection workflow


• Enhanced security with automatic credential exchange

Fixed

• Connection reliability improvements


• Better error messages during setup process

[3.0.0] - 2025-11-XX

Added

• Event observer system for capturing Moodle events


• Selective event monitoring via admin interface


• Event schema discovery and synchronization


• HMAC-based authentication for secure API communication


• Debug mode with detailed logging


• Schema sync page with AJAX-based UI


• Support for dynamic event field inspection


• Configurable MoodleConnect API endpoint

Changed

• Initial stable release for production use

Security

• Implemented HMAC signature verification for all API requests


• Secure storage of site credentials


• HTTPS-only communication with MoodleConnect service

[2.0.0] - 2025-10-XX

Added

• Beta release with core functionality


• Basic event capture and transmission


• Admin settings interface

[1.0.0] - 2025-09-XX

Added

• Initial alpha release


• Proof of concept implementation

Version Numbering

This plugin follows Moodle's version numbering scheme:

• version: YYYYMMDDXX format (e.g., 2025120301)


• release: Semantic versioning (e.g., v3.1.0)

Upgrade Notes

Upgrading to 3.1.0

If you're upgrading from 3.0.0:

1. The plugin will automatically migrate your existing site key and secret


2. You'll see a new "Connect to MoodleConnect" interface


3. If already connected, your connection will remain active


4. No action required - existing triggers and configurations are preserved

Changelog

All notable changes to the MoodleConnect plugin will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[5.2.4] - 2026-03-06

Added

• Bulk User Sync (Experimental): Fire user_updated events for all active users to backfill data after creating a new automation
  
  
  
  • Preflight check validates connection status, monitored events, and quota usage
  
  
  • Batched processing (25 users per request) with progress bar
  
  
  • Confirmation dialog with quota impact warnings
  
  
  • Located under new "Experimental Features" section in plugin settings
  
  
  
  


• Manual CI Trigger: Added workflow_dispatch to CI workflow for on-demand runs

[5.2.3] - 2026-03-03

Changed

• Profile Image Sizes: Event payloads now include all three Moodle profile image sizes instead of just the 100x100 icon
  
  
  
  • profileimageurl_512x512 (f3) — largest available
  
  
  • profileimageurl_100x100 (f1) — standard icon
  
  
  • profileimageurl_35x35 (f2) — small thumbnail
  
  
  • Breaking: Replaces the previous single profileimageurl field
  
  
  
  

[5.2.2] - 2026-03-03

Fixed

• Profile Image URL Compatibility: Build URL directly via pluginfile.php instead of relying on Moodle's page renderer, which is not always initialized during event processing

[5.2.1] - 2026-03-02

Added

• Profile Image URL: User profile image URL is now included in event payloads (profileimageurl field)

[5.2.0] - 2026-02-21

Added

• Local Moodle Actions: MoodleConnect can now dispatch actions back to Moodle for inline execution
  
  
  
  • Supported actions: issue certificate, award badge, send message, enroll user, suspend enrolment, add to group, add to cohort
  
  
  • Claim-based idempotency prevents duplicate side effects
  
  
  • Structured error codes with retryable vs permanent classification
  
  
  
  


• Metadata Providers: Moodle site metadata (courses, roles, groups, cohorts, badges, certificates) exposed via API for UI dropdowns


• Manual Pending Claim Recovery CLI: local/mc_plugin/cli/cleanup_pending_claims.php
  
  
  
  • Lists orphaned pending claims with age and filters
  
  
  • Deletes matched claims only with explicit --delete --yes confirmation
  
  
  
  

Fixed

• Local Action Idempotency: Removed automatic stale-claim reclaim in inline action executor
  
  
  
  • Pending __pending__ claims are no longer auto-deleted by elapsed time
  
  
  • Prevents duplicate side effects when the original request is still executing
  
  
  
  


• Issue Certificate Config Fidelity: send_email action config is now honored
  
  
  
  • Uses customcert issue_certificate email argument when supported
  
  
  • Keeps compatibility with older customcert signatures
  
  
  
  

[5.1.1] - 2026-02-13

Fixed

• Connection Flow: Always show a fallback link when connecting to MoodleConnect
  
  
  
  • Previously relied on popup blocker detection which is unreliable across browsers
  
  
  • Now always displays "If a new tab didn't open, click here to open MoodleConnect" below the waiting status
  
  
  • Polling starts immediately regardless, so the connection completes automatically once authorized
  
  
  
  

[5.1.0] - 2026-01-26

Added

• Analytics Dashboard: New analytics page showing Moodle event activity
  
  
  
  • Summary KPIs: total events, unique users, active courses
  
  
  • Event type distribution (donut chart)
  
  
  • Top courses by activity (progress bars)
  
  
  • Top users by activity (with avatars)
  
  
  • Activity timeline (bar chart)
  
  
  • Date range filtering (7d, 30d, 90d)
  
  
  • Accessible from plugin settings page
  
  
  
  

Changed

• Documentation: Updated README with destinations terminology and event processing details

[5.0.1] - 2025-12-28

Added

• Health Check Sync: The health check endpoint now supports optional sync_events and sync_courses parameters
  
  
  
  • MoodleConnect can request event/course sync during health checks
  
  
  • Enables automatic data sync when users first connect their site
  
  
  • Eliminates the need for users to manually refresh after initial connection
  
  
  
  

Changed

• Improved initial connection experience - events and courses sync automatically

[5.0.0] - 2025-12-28

⚠️ BREAKING CHANGE

This version is required for continued event processing. The MoodleConnect backend now requires plugin version 5.0.0 or higher. Sites running older plugin versions will have events rejected with an "upgrade required" message.

Added

• Event Limit Blocking: Plugin now respects monthly event limits pushed from MoodleConnect
  
  
  
  • Events are automatically blocked when limit is exceeded
  
  
  • Admin warning banner displays in plugin settings when blocked
  
  
  • Events resume automatically when the new month begins
  
  
  
  


• Health Check Endpoint: New /api.php?action=health endpoint for connectivity verification
  
  
  
  • Returns Moodle version, plugin version, and monitored event count
  
  
  • Used by MoodleConnect to verify plugin compatibility
  
  
  
  


• Course-Level Filtering: Events can now be filtered by course at the Moodle level
  
  
  
  • MoodleConnect pushes course filters when triggers are configured
  
  
  • Reduces unnecessary event transmission for course-specific triggers
  
  
  
  


• Reverse Event Sync: MoodleConnect automatically updates monitored events when triggers change
  
  
  
  • No manual "Sync Events" needed after creating triggers
  
  
  • Plugin receives event list updates via API
  
  
  
  


• Automatic Course Sync: Courses are synced to MoodleConnect automatically
  
  
  
  • Initial sync on plugin connection
  
  
  • Incremental sync when courses are created, updated, or deleted
  
  
  
  

Changed

• Minimum Backend Compatibility: Requires MoodleConnect backend with health check support


• Event Processing: Events from unverified plugin versions are now rejected

Fixed

• Various code quality improvements and language string reorganization

[4.5.0] - 2025-12-24

Added

• Course Filter Sync: Course filters configured in MoodleConnect triggers are now pushed to Moodle


• Plugin filters events at source based on course include/exclude rules

[4.2.2] - 2025-12-22

Changed

• Build System: Removed local Gruntfile in favor of Moodle's grunt for AMD builds


• CI Compatibility: AMD build output now matches CI expectations exactly

Removed

• Local Gruntfile.js, package.json, node_modules/, husky pre-commit hooks


• These caused "uncommitted changes detected" errors in CI due to different minification output

[4.2.1] - 2025-12-22

Added

• Local Grunt Build System: Added Gruntfile.js with grunt-terser for AMD module minification


• Pre-commit Hook: Added husky + lint-staged to auto-rebuild AMD modules on commit


• No-op Stylelint Task: Added compatibility task for Moodle CI grunt checks

Changed

• Build Process: AMD modules can now be built locally without requiring Moodle container


• Maturity: Promoted from RC to STABLE

[4.2.1-rc1] - 2025-12-21

First official release candidate for Moodle Plugin Directory submission.

Fixed

• Moodle curl wrapper: Replaced direct curl_init() calls with Moodle's \curl class in connect.php and moodleconnect_client.php. This ensures proper proxy configuration support for organizations behind web proxies. (Fixes #1)


• Language strings: Moved hard-coded rate limit error message to language file using get_string(). (Fixes #2)


• Private IP detection: Added automatic detection of private IPs for local development, only bypassing URL security checks when necessary.

Changed

• Code consistency: Unified curl wrapper usage pattern across all API client files (connect.php, sync_schema.php, moodleconnect_client.php).

[4.1.0] - 2025-12-15

Changed

• Native Save Button: Removed custom "Save and Sync Events" button in favor of Moodle's native "Save changes" button.


• Auto-Sync on Page Load: Events are now automatically synced when the settings page loads (if connected).


• Simplified UI: Cleaner admin interface with fewer custom buttons.

Fixed

• CI Grunt Check: Fixed Grunt stale file detection with NVM support for correct Node.js version.


• Moodle 5.x Support: Added support for Moodle 5.x public directory structure in CI.


• PHPUnit Compatibility: Replaced assertObjectHasProperty() with property_exists() for older PHPUnit versions.


• AMD Module Builds: Rebuilt all AMD modules with correct Node.js/npm versions to match CI environment.

[4.0.3] - 2025-12-15

Fixed

• ESLint Complexity: Further refactored connect.js init function by extracting getConfigValue() and buildConfig() helpers.


• PHPCS Lang Ordering: Fixed alphabetical ordering of language strings in lang/en/local_mc_plugin.php.

[4.0.2] - 2025-12-15

Fixed

• ESLint Complexity: Refactored connect.js to reduce cyclomatic complexity below threshold.


• Stylelint: Removed all !important declarations from styles.css.


• PHPUnit Compatibility: Replaced assertObjectHasProperty with assertTrue(property_exists(...)) for Moodle 4.0/PHPUnit 9 compatibility.

[4.0.1] - 2025-12-15

Fixed

• Linting Issues: Resolved ESLint warnings in AMD modules (camelCase variables).


• PHPCS: Fixed language string ordering in lang/en/local_mc_plugin.php.

[4.0.0] - 2025-12-15

Added

• Output API Implementation: Complete refactor of the admin interface to use Moodle's Output API (Renderers, Renderables, Templates).


• Mustache Templates: Modern, responsive UI components for:
  
  
  
  • Event Selector (with search, filtering, and bulk actions)
  
  
  • Connection Status (dynamic updates via AJAX)
  
  
  • Action Buttons (loading states and feedback)
  
  
  
  


• AMD Modules: Full migration of JavaScript logic to modular, dependency-managed AMD files.


• Client-Side Rendering: Dynamic UI updates using core/templates for better performance and user experience.

Changed

• Admin Settings: Replaced legacy admin_setting_configtext with custom setting classes that delegate to the Output API.


• JavaScript Architecture: Removed all inline JavaScript; logic is now encapsulated in amd/src/local/admin/*.js.


• Styling: Cleaned up CSS and leveraged Bootstrap utility classes for consistent design.


• Code Structure: Improved separation of concerns between logic (PHP classes), presentation (Mustache), and behavior (JS).

Removed

• Legacy inline HTML generation in admin settings.


• Unused CSS styles and redundant code.

[3.2.0] - 2025-12-14

Added

• Comprehensive PHPUnit test suite with full coverage


• GitHub Actions CI workflow with matrix testing
  
  
  
  • Moodle 4.0, 4.5 (LTS), and 5.0 support
  
  
  • PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 compatibility
  
  
  • PostgreSQL and MariaDB database testing
  
  
  
  


• Input validation and CSRF protection for all plugin endpoints


• Privacy API implementation for GDPR compliance


• PHPDoc comments for all functions and classes


• GPL license headers on all PHP files


• Plugin icon for Moodle marketplace

Changed

• Improved code quality to meet Moodle Plugin Directory standards


• Enhanced error handling and logging


• Moved all hardcoded strings to language files


• Reorganized README with expanded documentation links


• Achieved full Moodle coding standards compliance - all 200+ phpcs violations fixed
  
  
  
  • Fixed variable naming conventions (snake_case to camelcase)
  
  
  • Fixed inline comment formatting (proper capitalization and punctuation)
  
  
  • Added documentation to empty catch blocks
  
  
  • Removed trailing whitespace from string literals
  
  
  • Fixed line length violations (132 and 180 character limits)
  
  
  • Removed unnecessary MOODLE_INTERNAL checks
  
  
  • Added missing class-level documentation
  
  
  • Replaced forbidden functions with Moodle-approved alternatives
  
  
  • Fixed interface ordering in privacy provider class
  
  
  • Fixed language string ordering (alphabetical)
  
  
  
  

Fixed

• Moodle 4.0 compatibility issues with event validation


• Test file locations and namespace handling


• AMD module builds using Moodle's Rollup system


• All phpcs errors and warnings resolved (zero violations)


• Debug warning suppression and MOODLE_INTERNAL checks

Security

• Added CSRF token validation for AJAX endpoints


• Input sanitization for all user-provided data

[3.1.0] - 2025-12-03

Added

• OAuth-style connection flow for simplified site linking


• One-click "Connect to MoodleConnect" button in plugin settings


• Automatic site key and secret exchange during connection


• Secure redirect handling between Moodle and MoodleConnect service


• Connection status indicator in admin interface


• Disconnect functionality to unlink sites

Changed

• Simplified initial setup process (no manual site key entry required)


• Improved user experience for site connection workflow


• Enhanced security with automatic credential exchange

Fixed

• Connection reliability improvements


• Better error messages during setup process

[3.0.0] - 2025-11-XX

Added

• Event observer system for capturing Moodle events


• Selective event monitoring via admin interface


• Event schema discovery and synchronization


• HMAC-based authentication for secure API communication


• Debug mode with detailed logging


• Schema sync page with AJAX-based UI


• Support for dynamic event field inspection


• Configurable MoodleConnect API endpoint

Changed

• Initial stable release for production use

Security

• Implemented HMAC signature verification for all API requests


• Secure storage of site credentials


• HTTPS-only communication with MoodleConnect service

[2.0.0] - 2025-10-XX

Added

• Beta release with core functionality


• Basic event capture and transmission


• Admin settings interface

[1.0.0] - 2025-09-XX

Added

• Initial alpha release


• Proof of concept implementation

Version Numbering

This plugin follows Moodle's version numbering scheme:

• version: YYYYMMDDXX format (e.g., 2025120301)


• release: Semantic versioning (e.g., v3.1.0)

Upgrade Notes

Upgrading to 3.1.0

If you're upgrading from 3.0.0:

1. The plugin will automatically migrate your existing site key and secret


2. You'll see a new "Connect to MoodleConnect" interface


3. If already connected, your connection will remain active


4. No action required - existing triggers and configurations are preserved

Upgrading to 3.0.0

First stable release - no upgrade path from earlier versions.

Support

For issues, questions, or feature requests:

• GitHub Issues: https://github.com/kcanakdag/moodle-local_mc_plugin/issues


• Email: support@moodleconnect.com


• Documentation: https://moodleconnect.com/docs

Changelog

All notable changes to the MoodleConnect plugin will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[5.2.3] - 2026-03-03

Changed

• Profile Image Sizes: Event payloads now include all three Moodle profile image sizes instead of just the 100x100 icon
  
  
  
  • profileimageurl_512x512 (f3) — largest available
  
  
  • profileimageurl_100x100 (f1) — standard icon
  
  
  • profileimageurl_35x35 (f2) — small thumbnail
  
  
  • Breaking: Replaces the previous single profileimageurl field
  
  
  
  

[5.2.2] - 2026-03-03

Fixed

• Profile Image URL Compatibility: Build URL directly via pluginfile.php instead of relying on Moodle's page renderer, which is not always initialized during event processing

[5.2.1] - 2026-03-02

Added

• Profile Image URL: User profile image URL is now included in event payloads (profileimageurl field)

[5.2.0] - 2026-02-21

Added

• Local Moodle Actions: MoodleConnect can now dispatch actions back to Moodle for inline execution
  
  
  
  • Supported actions: issue certificate, award badge, send message, enroll user, suspend enrolment, add to group, add to cohort
  
  
  • Claim-based idempotency prevents duplicate side effects
  
  
  • Structured error codes with retryable vs permanent classification
  
  
  
  


• Metadata Providers: Moodle site metadata (courses, roles, groups, cohorts, badges, certificates) exposed via API for UI dropdowns


• Manual Pending Claim Recovery CLI: local/mc_plugin/cli/cleanup_pending_claims.php
  
  
  
  • Lists orphaned pending claims with age and filters
  
  
  • Deletes matched claims only with explicit --delete --yes confirmation
  
  
  
  

Fixed

• Local Action Idempotency: Removed automatic stale-claim reclaim in inline action executor
  
  
  
  • Pending __pending__ claims are no longer auto-deleted by elapsed time
  
  
  • Prevents duplicate side effects when the original request is still executing
  
  
  
  


• Issue Certificate Config Fidelity: send_email action config is now honored
  
  
  
  • Uses customcert issue_certificate email argument when supported
  
  
  • Keeps compatibility with older customcert signatures
  
  
  
  

[5.1.1] - 2026-02-13

Fixed

• Connection Flow: Always show a fallback link when connecting to MoodleConnect
  
  
  
  • Previously relied on popup blocker detection which is unreliable across browsers
  
  
  • Now always displays "If a new tab didn't open, click here to open MoodleConnect" below the waiting status
  
  
  • Polling starts immediately regardless, so the connection completes automatically once authorized
  
  
  
  

[5.1.0] - 2026-01-26

Added

• Analytics Dashboard: New analytics page showing Moodle event activity
  
  
  
  • Summary KPIs: total events, unique users, active courses
  
  
  • Event type distribution (donut chart)
  
  
  • Top courses by activity (progress bars)
  
  
  • Top users by activity (with avatars)
  
  
  • Activity timeline (bar chart)
  
  
  • Date range filtering (7d, 30d, 90d)
  
  
  • Accessible from plugin settings page
  
  
  
  

Changed

• Documentation: Updated README with destinations terminology and event processing details

[5.0.1] - 2025-12-28

Added

• Health Check Sync: The health check endpoint now supports optional sync_events and sync_courses parameters
  
  
  
  • MoodleConnect can request event/course sync during health checks
  
  
  • Enables automatic data sync when users first connect their site
  
  
  • Eliminates the need for users to manually refresh after initial connection
  
  
  
  

Changed

• Improved initial connection experience - events and courses sync automatically

[5.0.0] - 2025-12-28

⚠️ BREAKING CHANGE

This version is required for continued event processing. The MoodleConnect backend now requires plugin version 5.0.0 or higher. Sites running older plugin versions will have events rejected with an "upgrade required" message.

Added

• Event Limit Blocking: Plugin now respects monthly event limits pushed from MoodleConnect
  
  
  
  • Events are automatically blocked when limit is exceeded
  
  
  • Admin warning banner displays in plugin settings when blocked
  
  
  • Events resume automatically when the new month begins
  
  
  
  


• Health Check Endpoint: New /api.php?action=health endpoint for connectivity verification
  
  
  
  • Returns Moodle version, plugin version, and monitored event count
  
  
  • Used by MoodleConnect to verify plugin compatibility
  
  
  
  


• Course-Level Filtering: Events can now be filtered by course at the Moodle level
  
  
  
  • MoodleConnect pushes course filters when triggers are configured
  
  
  • Reduces unnecessary event transmission for course-specific triggers
  
  
  
  


• Reverse Event Sync: MoodleConnect automatically updates monitored events when triggers change
  
  
  
  • No manual "Sync Events" needed after creating triggers
  
  
  • Plugin receives event list updates via API
  
  
  
  


• Automatic Course Sync: Courses are synced to MoodleConnect automatically
  
  
  
  • Initial sync on plugin connection
  
  
  • Incremental sync when courses are created, updated, or deleted
  
  
  
  

Changed

• Minimum Backend Compatibility: Requires MoodleConnect backend with health check support


• Event Processing: Events from unverified plugin versions are now rejected

Fixed

• Various code quality improvements and language string reorganization

[4.5.0] - 2025-12-24

Added

• Course Filter Sync: Course filters configured in MoodleConnect triggers are now pushed to Moodle


• Plugin filters events at source based on course include/exclude rules

[4.2.2] - 2025-12-22

Changed

• Build System: Removed local Gruntfile in favor of Moodle's grunt for AMD builds


• CI Compatibility: AMD build output now matches CI expectations exactly

Removed

• Local Gruntfile.js, package.json, node_modules/, husky pre-commit hooks


• These caused "uncommitted changes detected" errors in CI due to different minification output

[4.2.1] - 2025-12-22

Added

• Local Grunt Build System: Added Gruntfile.js with grunt-terser for AMD module minification


• Pre-commit Hook: Added husky + lint-staged to auto-rebuild AMD modules on commit


• No-op Stylelint Task: Added compatibility task for Moodle CI grunt checks

Changed

• Build Process: AMD modules can now be built locally without requiring Moodle container


• Maturity: Promoted from RC to STABLE

[4.2.1-rc1] - 2025-12-21

First official release candidate for Moodle Plugin Directory submission.

Fixed

• Moodle curl wrapper: Replaced direct curl_init() calls with Moodle's \curl class in connect.php and moodleconnect_client.php. This ensures proper proxy configuration support for organizations behind web proxies. (Fixes #1)


• Language strings: Moved hard-coded rate limit error message to language file using get_string(). (Fixes #2)


• Private IP detection: Added automatic detection of private IPs for local development, only bypassing URL security checks when necessary.

Changed

• Code consistency: Unified curl wrapper usage pattern across all API client files (connect.php, sync_schema.php, moodleconnect_client.php).

[4.1.0] - 2025-12-15

Changed

• Native Save Button: Removed custom "Save and Sync Events" button in favor of Moodle's native "Save changes" button.


• Auto-Sync on Page Load: Events are now automatically synced when the settings page loads (if connected).


• Simplified UI: Cleaner admin interface with fewer custom buttons.

Fixed

• CI Grunt Check: Fixed Grunt stale file detection with NVM support for correct Node.js version.


• Moodle 5.x Support: Added support for Moodle 5.x public directory structure in CI.


• PHPUnit Compatibility: Replaced assertObjectHasProperty() with property_exists() for older PHPUnit versions.


• AMD Module Builds: Rebuilt all AMD modules with correct Node.js/npm versions to match CI environment.

[4.0.3] - 2025-12-15

Fixed

• ESLint Complexity: Further refactored connect.js init function by extracting getConfigValue() and buildConfig() helpers.


• PHPCS Lang Ordering: Fixed alphabetical ordering of language strings in lang/en/local_mc_plugin.php.

[4.0.2] - 2025-12-15

Fixed

• ESLint Complexity: Refactored connect.js to reduce cyclomatic complexity below threshold.


• Stylelint: Removed all !important declarations from styles.css.


• PHPUnit Compatibility: Replaced assertObjectHasProperty with assertTrue(property_exists(...)) for Moodle 4.0/PHPUnit 9 compatibility.

[4.0.1] - 2025-12-15

Fixed

• Linting Issues: Resolved ESLint warnings in AMD modules (camelCase variables).


• PHPCS: Fixed language string ordering in lang/en/local_mc_plugin.php.

[4.0.0] - 2025-12-15

Added

• Output API Implementation: Complete refactor of the admin interface to use Moodle's Output API (Renderers, Renderables, Templates).


• Mustache Templates: Modern, responsive UI components for:
  
  
  
  • Event Selector (with search, filtering, and bulk actions)
  
  
  • Connection Status (dynamic updates via AJAX)
  
  
  • Action Buttons (loading states and feedback)
  
  
  
  


• AMD Modules: Full migration of JavaScript logic to modular, dependency-managed AMD files.


• Client-Side Rendering: Dynamic UI updates using core/templates for better performance and user experience.

Changed

• Admin Settings: Replaced legacy admin_setting_configtext with custom setting classes that delegate to the Output API.


• JavaScript Architecture: Removed all inline JavaScript; logic is now encapsulated in amd/src/local/admin/*.js.


• Styling: Cleaned up CSS and leveraged Bootstrap utility classes for consistent design.


• Code Structure: Improved separation of concerns between logic (PHP classes), presentation (Mustache), and behavior (JS).

Removed

• Legacy inline HTML generation in admin settings.


• Unused CSS styles and redundant code.

[3.2.0] - 2025-12-14

Added

• Comprehensive PHPUnit test suite with full coverage


• GitHub Actions CI workflow with matrix testing
  
  
  
  • Moodle 4.0, 4.5 (LTS), and 5.0 support
  
  
  • PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 compatibility
  
  
  • PostgreSQL and MariaDB database testing
  
  
  
  


• Input validation and CSRF protection for all plugin endpoints


• Privacy API implementation for GDPR compliance


• PHPDoc comments for all functions and classes


• GPL license headers on all PHP files


• Plugin icon for Moodle marketplace

Changed

• Improved code quality to meet Moodle Plugin Directory standards


• Enhanced error handling and logging


• Moved all hardcoded strings to language files


• Reorganized README with expanded documentation links


• Achieved full Moodle coding standards compliance - all 200+ phpcs violations fixed
  
  
  
  • Fixed variable naming conventions (snake_case to camelcase)
  
  
  • Fixed inline comment formatting (proper capitalization and punctuation)
  
  
  • Added documentation to empty catch blocks
  
  
  • Removed trailing whitespace from string literals
  
  
  • Fixed line length violations (132 and 180 character limits)
  
  
  • Removed unnecessary MOODLE_INTERNAL checks
  
  
  • Added missing class-level documentation
  
  
  • Replaced forbidden functions with Moodle-approved alternatives
  
  
  • Fixed interface ordering in privacy provider class
  
  
  • Fixed language string ordering (alphabetical)
  
  
  
  

Fixed

• Moodle 4.0 compatibility issues with event validation


• Test file locations and namespace handling


• AMD module builds using Moodle's Rollup system


• All phpcs errors and warnings resolved (zero violations)


• Debug warning suppression and MOODLE_INTERNAL checks

Security

• Added CSRF token validation for AJAX endpoints


• Input sanitization for all user-provided data

[3.1.0] - 2025-12-03

Added

• OAuth-style connection flow for simplified site linking


• One-click "Connect to MoodleConnect" button in plugin settings


• Automatic site key and secret exchange during connection


• Secure redirect handling between Moodle and MoodleConnect service


• Connection status indicator in admin interface


• Disconnect functionality to unlink sites

Changed

• Simplified initial setup process (no manual site key entry required)


• Improved user experience for site connection workflow


• Enhanced security with automatic credential exchange

Fixed

• Connection reliability improvements


• Better error messages during setup process

[3.0.0] - 2025-11-XX

Added

• Event observer system for capturing Moodle events


• Selective event monitoring via admin interface


• Event schema discovery and synchronization


• HMAC-based authentication for secure API communication


• Debug mode with detailed logging


• Schema sync page with AJAX-based UI


• Support for dynamic event field inspection


• Configurable MoodleConnect API endpoint

Changed

• Initial stable release for production use

Security

• Implemented HMAC signature verification for all API requests


• Secure storage of site credentials


• HTTPS-only communication with MoodleConnect service

[2.0.0] - 2025-10-XX

Added

• Beta release with core functionality


• Basic event capture and transmission


• Admin settings interface

[1.0.0] - 2025-09-XX

Added

• Initial alpha release


• Proof of concept implementation

Version Numbering

This plugin follows Moodle's version numbering scheme:

• version: YYYYMMDDXX format (e.g., 2025120301)


• release: Semantic versioning (e.g., v3.1.0)

Upgrade Notes

Upgrading to 3.1.0

If you're upgrading from 3.0.0:

1. The plugin will automatically migrate your existing site key and secret


2. You'll see a new "Connect to MoodleConnect" interface


3. If already connected, your connection will remain active


4. No action required - existing triggers and configurations are preserved

Upgrading to 3.0.0

First stable release - no upgrade path from earlier versions.

Support

For issues, questions, or feature requests:

• GitHub Issues: https://github.com/kcanakdag/moodle-local_mc_plugin/issues


• Email: support@moodleconnect.com


• Documentation: https://moodleconnect.com/docs

Changelog

All notable changes to the MoodleConnect plugin will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[5.2.2] - 2026-03-03

Fixed

• Profile Image URL Compatibility: Build URL directly via pluginfile.php instead of relying on Moodle's page renderer, which is not always initialized during event processing

[5.2.1] - 2026-03-02

Added

• Profile Image URL: User profile image URL is now included in event payloads (profileimageurl field)

[5.2.0] - 2026-02-21

Added

• Local Moodle Actions: MoodleConnect can now dispatch actions back to Moodle for inline execution
  
  
  
  • Supported actions: issue certificate, award badge, send message, enroll user, suspend enrolment, add to group, add to cohort
  
  
  • Claim-based idempotency prevents duplicate side effects
  
  
  • Structured error codes with retryable vs permanent classification
  
  
  
  


• Metadata Providers: Moodle site metadata (courses, roles, groups, cohorts, badges, certificates) exposed via API for UI dropdowns


• Manual Pending Claim Recovery CLI: local/mc_plugin/cli/cleanup_pending_claims.php
  
  
  
  • Lists orphaned pending claims with age and filters
  
  
  • Deletes matched claims only with explicit --delete --yes confirmation
  
  
  
  

Fixed

• Local Action Idempotency: Removed automatic stale-claim reclaim in inline action executor
  
  
  
  • Pending __pending__ claims are no longer auto-deleted by elapsed time
  
  
  • Prevents duplicate side effects when the original request is still executing
  
  
  
  


• Issue Certificate Config Fidelity: send_email action config is now honored
  
  
  
  • Uses customcert issue_certificate email argument when supported
  
  
  • Keeps compatibility with older customcert signatures
  
  
  
  

[5.1.1] - 2026-02-13

Fixed

• Connection Flow: Always show a fallback link when connecting to MoodleConnect
  
  
  
  • Previously relied on popup blocker detection which is unreliable across browsers
  
  
  • Now always displays "If a new tab didn't open, click here to open MoodleConnect" below the waiting status
  
  
  • Polling starts immediately regardless, so the connection completes automatically once authorized
  
  
  
  

[5.1.0] - 2026-01-26

Added

• Analytics Dashboard: New analytics page showing Moodle event activity
  
  
  
  • Summary KPIs: total events, unique users, active courses
  
  
  • Event type distribution (donut chart)
  
  
  • Top courses by activity (progress bars)
  
  
  • Top users by activity (with avatars)
  
  
  • Activity timeline (bar chart)
  
  
  • Date range filtering (7d, 30d, 90d)
  
  
  • Accessible from plugin settings page
  
  
  
  

Changed

• Documentation: Updated README with destinations terminology and event processing details

[5.0.1] - 2025-12-28

Added

• Health Check Sync: The health check endpoint now supports optional sync_events and sync_courses parameters
  
  
  
  • MoodleConnect can request event/course sync during health checks
  
  
  • Enables automatic data sync when users first connect their site
  
  
  • Eliminates the need for users to manually refresh after initial connection
  
  
  
  

Changed

• Improved initial connection experience - events and courses sync automatically

[5.0.0] - 2025-12-28

⚠️ BREAKING CHANGE

This version is required for continued event processing. The MoodleConnect backend now requires plugin version 5.0.0 or higher. Sites running older plugin versions will have events rejected with an "upgrade required" message.

Added

• Event Limit Blocking: Plugin now respects monthly event limits pushed from MoodleConnect
  
  
  
  • Events are automatically blocked when limit is exceeded
  
  
  • Admin warning banner displays in plugin settings when blocked
  
  
  • Events resume automatically when the new month begins
  
  
  
  


• Health Check Endpoint: New /api.php?action=health endpoint for connectivity verification
  
  
  
  • Returns Moodle version, plugin version, and monitored event count
  
  
  • Used by MoodleConnect to verify plugin compatibility
  
  
  
  


• Course-Level Filtering: Events can now be filtered by course at the Moodle level
  
  
  
  • MoodleConnect pushes course filters when triggers are configured
  
  
  • Reduces unnecessary event transmission for course-specific triggers
  
  
  
  


• Reverse Event Sync: MoodleConnect automatically updates monitored events when triggers change
  
  
  
  • No manual "Sync Events" needed after creating triggers
  
  
  • Plugin receives event list updates via API
  
  
  
  


• Automatic Course Sync: Courses are synced to MoodleConnect automatically
  
  
  
  • Initial sync on plugin connection
  
  
  • Incremental sync when courses are created, updated, or deleted
  
  
  
  

Changed

• Minimum Backend Compatibility: Requires MoodleConnect backend with health check support


• Event Processing: Events from unverified plugin versions are now rejected

Fixed

• Various code quality improvements and language string reorganization

[4.5.0] - 2025-12-24

Added

• Course Filter Sync: Course filters configured in MoodleConnect triggers are now pushed to Moodle


• Plugin filters events at source based on course include/exclude rules

[4.2.2] - 2025-12-22

Changed

• Build System: Removed local Gruntfile in favor of Moodle's grunt for AMD builds


• CI Compatibility: AMD build output now matches CI expectations exactly

Removed

• Local Gruntfile.js, package.json, node_modules/, husky pre-commit hooks


• These caused "uncommitted changes detected" errors in CI due to different minification output

[4.2.1] - 2025-12-22

Added

• Local Grunt Build System: Added Gruntfile.js with grunt-terser for AMD module minification


• Pre-commit Hook: Added husky + lint-staged to auto-rebuild AMD modules on commit


• No-op Stylelint Task: Added compatibility task for Moodle CI grunt checks

Changed

• Build Process: AMD modules can now be built locally without requiring Moodle container


• Maturity: Promoted from RC to STABLE

[4.2.1-rc1] - 2025-12-21

First official release candidate for Moodle Plugin Directory submission.

Fixed

• Moodle curl wrapper: Replaced direct curl_init() calls with Moodle's \curl class in connect.php and moodleconnect_client.php. This ensures proper proxy configuration support for organizations behind web proxies. (Fixes #1)


• Language strings: Moved hard-coded rate limit error message to language file using get_string(). (Fixes #2)


• Private IP detection: Added automatic detection of private IPs for local development, only bypassing URL security checks when necessary.

Changed

• Code consistency: Unified curl wrapper usage pattern across all API client files (connect.php, sync_schema.php, moodleconnect_client.php).

[4.1.0] - 2025-12-15

Changed

• Native Save Button: Removed custom "Save and Sync Events" button in favor of Moodle's native "Save changes" button.


• Auto-Sync on Page Load: Events are now automatically synced when the settings page loads (if connected).


• Simplified UI: Cleaner admin interface with fewer custom buttons.

Fixed

• CI Grunt Check: Fixed Grunt stale file detection with NVM support for correct Node.js version.


• Moodle 5.x Support: Added support for Moodle 5.x public directory structure in CI.


• PHPUnit Compatibility: Replaced assertObjectHasProperty() with property_exists() for older PHPUnit versions.


• AMD Module Builds: Rebuilt all AMD modules with correct Node.js/npm versions to match CI environment.

[4.0.3] - 2025-12-15

Fixed

• ESLint Complexity: Further refactored connect.js init function by extracting getConfigValue() and buildConfig() helpers.


• PHPCS Lang Ordering: Fixed alphabetical ordering of language strings in lang/en/local_mc_plugin.php.

[4.0.2] - 2025-12-15

Fixed

• ESLint Complexity: Refactored connect.js to reduce cyclomatic complexity below threshold.


• Stylelint: Removed all !important declarations from styles.css.


• PHPUnit Compatibility: Replaced assertObjectHasProperty with assertTrue(property_exists(...)) for Moodle 4.0/PHPUnit 9 compatibility.

[4.0.1] - 2025-12-15

Fixed

• Linting Issues: Resolved ESLint warnings in AMD modules (camelCase variables).


• PHPCS: Fixed language string ordering in lang/en/local_mc_plugin.php.

[4.0.0] - 2025-12-15

Added

• Output API Implementation: Complete refactor of the admin interface to use Moodle's Output API (Renderers, Renderables, Templates).


• Mustache Templates: Modern, responsive UI components for:
  
  
  
  • Event Selector (with search, filtering, and bulk actions)
  
  
  • Connection Status (dynamic updates via AJAX)
  
  
  • Action Buttons (loading states and feedback)
  
  
  
  


• AMD Modules: Full migration of JavaScript logic to modular, dependency-managed AMD files.


• Client-Side Rendering: Dynamic UI updates using core/templates for better performance and user experience.

Changed

• Admin Settings: Replaced legacy admin_setting_configtext with custom setting classes that delegate to the Output API.


• JavaScript Architecture: Removed all inline JavaScript; logic is now encapsulated in amd/src/local/admin/*.js.


• Styling: Cleaned up CSS and leveraged Bootstrap utility classes for consistent design.


• Code Structure: Improved separation of concerns between logic (PHP classes), presentation (Mustache), and behavior (JS).

Removed

• Legacy inline HTML generation in admin settings.


• Unused CSS styles and redundant code.

[3.2.0] - 2025-12-14

Added

• Comprehensive PHPUnit test suite with full coverage


• GitHub Actions CI workflow with matrix testing
  
  
  
  • Moodle 4.0, 4.5 (LTS), and 5.0 support
  
  
  • PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 compatibility
  
  
  • PostgreSQL and MariaDB database testing
  
  
  
  


• Input validation and CSRF protection for all plugin endpoints


• Privacy API implementation for GDPR compliance


• PHPDoc comments for all functions and classes


• GPL license headers on all PHP files


• Plugin icon for Moodle marketplace

Changed

• Improved code quality to meet Moodle Plugin Directory standards


• Enhanced error handling and logging


• Moved all hardcoded strings to language files


• Reorganized README with expanded documentation links


• Achieved full Moodle coding standards compliance - all 200+ phpcs violations fixed
  
  
  
  • Fixed variable naming conventions (snake_case to camelcase)
  
  
  • Fixed inline comment formatting (proper capitalization and punctuation)
  
  
  • Added documentation to empty catch blocks
  
  
  • Removed trailing whitespace from string literals
  
  
  • Fixed line length violations (132 and 180 character limits)
  
  
  • Removed unnecessary MOODLE_INTERNAL checks
  
  
  • Added missing class-level documentation
  
  
  • Replaced forbidden functions with Moodle-approved alternatives
  
  
  • Fixed interface ordering in privacy provider class
  
  
  • Fixed language string ordering (alphabetical)
  
  
  
  

Fixed

• Moodle 4.0 compatibility issues with event validation


• Test file locations and namespace handling


• AMD module builds using Moodle's Rollup system


• All phpcs errors and warnings resolved (zero violations)


• Debug warning suppression and MOODLE_INTERNAL checks

Security

• Added CSRF token validation for AJAX endpoints


• Input sanitization for all user-provided data

[3.1.0] - 2025-12-03

Added

• OAuth-style connection flow for simplified site linking


• One-click "Connect to MoodleConnect" button in plugin settings


• Automatic site key and secret exchange during connection


• Secure redirect handling between Moodle and MoodleConnect service


• Connection status indicator in admin interface


• Disconnect functionality to unlink sites

Changed

• Simplified initial setup process (no manual site key entry required)


• Improved user experience for site connection workflow


• Enhanced security with automatic credential exchange

Fixed

• Connection reliability improvements


• Better error messages during setup process

[3.0.0] - 2025-11-XX

Added

• Event observer system for capturing Moodle events


• Selective event monitoring via admin interface


• Event schema discovery and synchronization


• HMAC-based authentication for secure API communication


• Debug mode with detailed logging


• Schema sync page with AJAX-based UI


• Support for dynamic event field inspection


• Configurable MoodleConnect API endpoint

Changed

• Initial stable release for production use

Security

• Implemented HMAC signature verification for all API requests


• Secure storage of site credentials


• HTTPS-only communication with MoodleConnect service

[2.0.0] - 2025-10-XX

Added

• Beta release with core functionality


• Basic event capture and transmission


• Admin settings interface

[1.0.0] - 2025-09-XX

Added

• Initial alpha release


• Proof of concept implementation

Version Numbering

This plugin follows Moodle's version numbering scheme:

• version: YYYYMMDDXX format (e.g., 2025120301)


• release: Semantic versioning (e.g., v3.1.0)

Upgrade Notes

Upgrading to 3.1.0

If you're upgrading from 3.0.0:

1. The plugin will automatically migrate your existing site key and secret


2. You'll see a new "Connect to MoodleConnect" interface


3. If already connected, your connection will remain active


4. No action required - existing triggers and configurations are preserved

Upgrading to 3.0.0

First stable release - no upgrade path from earlier versions.

Support

For issues, questions, or feature requests:

• GitHub Issues: https://github.com/kcanakdag/moodle-local_mc_plugin/issues


• Email: support@moodleconnect.com


• Documentation: https://moodleconnect.com/docs

Changelog

All notable changes to the MoodleConnect plugin will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[5.2.1] - 2026-03-02

Added

• Profile Image URL: User profile image URL is now included in event payloads (profileimageurl field)

[5.2.0] - 2026-02-21

Added

• Local Moodle Actions: MoodleConnect can now dispatch actions back to Moodle for inline execution
  
  
  
  • Supported actions: issue certificate, award badge, send message, enroll user, suspend enrolment, add to group, add to cohort
  
  
  • Claim-based idempotency prevents duplicate side effects
  
  
  • Structured error codes with retryable vs permanent classification
  
  
  
  


• Metadata Providers: Moodle site metadata (courses, roles, groups, cohorts, badges, certificates) exposed via API for UI dropdowns


• Manual Pending Claim Recovery CLI: local/mc_plugin/cli/cleanup_pending_claims.php
  
  
  
  • Lists orphaned pending claims with age and filters
  
  
  • Deletes matched claims only with explicit --delete --yes confirmation
  
  
  
  

Fixed

• Local Action Idempotency: Removed automatic stale-claim reclaim in inline action executor
  
  
  
  • Pending __pending__ claims are no longer auto-deleted by elapsed time
  
  
  • Prevents duplicate side effects when the original request is still executing
  
  
  
  


• Issue Certificate Config Fidelity: send_email action config is now honored
  
  
  
  • Uses customcert issue_certificate email argument when supported
  
  
  • Keeps compatibility with older customcert signatures
  
  
  
  

[5.1.1] - 2026-02-13

Fixed

• Connection Flow: Always show a fallback link when connecting to MoodleConnect
  
  
  
  • Previously relied on popup blocker detection which is unreliable across browsers
  
  
  • Now always displays "If a new tab didn't open, click here to open MoodleConnect" below the waiting status
  
  
  • Polling starts immediately regardless, so the connection completes automatically once authorized
  
  
  
  

[5.1.0] - 2026-01-26

Added

• Analytics Dashboard: New analytics page showing Moodle event activity
  
  
  
  • Summary KPIs: total events, unique users, active courses
  
  
  • Event type distribution (donut chart)
  
  
  • Top courses by activity (progress bars)
  
  
  • Top users by activity (with avatars)
  
  
  • Activity timeline (bar chart)
  
  
  • Date range filtering (7d, 30d, 90d)
  
  
  • Accessible from plugin settings page
  
  
  
  

Changed

• Documentation: Updated README with destinations terminology and event processing details

[5.0.1] - 2025-12-28

Added

• Health Check Sync: The health check endpoint now supports optional sync_events and sync_courses parameters
  
  
  
  • MoodleConnect can request event/course sync during health checks
  
  
  • Enables automatic data sync when users first connect their site
  
  
  • Eliminates the need for users to manually refresh after initial connection
  
  
  
  

Changed

• Improved initial connection experience - events and courses sync automatically

[5.0.0] - 2025-12-28

⚠️ BREAKING CHANGE

This version is required for continued event processing. The MoodleConnect backend now requires plugin version 5.0.0 or higher. Sites running older plugin versions will have events rejected with an "upgrade required" message.

Added

• Event Limit Blocking: Plugin now respects monthly event limits pushed from MoodleConnect
  
  
  
  • Events are automatically blocked when limit is exceeded
  
  
  • Admin warning banner displays in plugin settings when blocked
  
  
  • Events resume automatically when the new month begins
  
  
  
  


• Health Check Endpoint: New /api.php?action=health endpoint for connectivity verification
  
  
  
  • Returns Moodle version, plugin version, and monitored event count
  
  
  • Used by MoodleConnect to verify plugin compatibility
  
  
  
  


• Course-Level Filtering: Events can now be filtered by course at the Moodle level
  
  
  
  • MoodleConnect pushes course filters when triggers are configured
  
  
  • Reduces unnecessary event transmission for course-specific triggers
  
  
  
  


• Reverse Event Sync: MoodleConnect automatically updates monitored events when triggers change
  
  
  
  • No manual "Sync Events" needed after creating triggers
  
  
  • Plugin receives event list updates via API
  
  
  
  


• Automatic Course Sync: Courses are synced to MoodleConnect automatically
  
  
  
  • Initial sync on plugin connection
  
  
  • Incremental sync when courses are created, updated, or deleted
  
  
  
  

Changed

• Minimum Backend Compatibility: Requires MoodleConnect backend with health check support


• Event Processing: Events from unverified plugin versions are now rejected

Fixed

• Various code quality improvements and language string reorganization

[4.5.0] - 2025-12-24

Added

• Course Filter Sync: Course filters configured in MoodleConnect triggers are now pushed to Moodle


• Plugin filters events at source based on course include/exclude rules

[4.2.2] - 2025-12-22

Changed

• Build System: Removed local Gruntfile in favor of Moodle's grunt for AMD builds


• CI Compatibility: AMD build output now matches CI expectations exactly

Removed

• Local Gruntfile.js, package.json, node_modules/, husky pre-commit hooks


• These caused "uncommitted changes detected" errors in CI due to different minification output

[4.2.1] - 2025-12-22

Added

• Local Grunt Build System: Added Gruntfile.js with grunt-terser for AMD module minification


• Pre-commit Hook: Added husky + lint-staged to auto-rebuild AMD modules on commit


• No-op Stylelint Task: Added compatibility task for Moodle CI grunt checks

Changed

• Build Process: AMD modules can now be built locally without requiring Moodle container


• Maturity: Promoted from RC to STABLE

[4.2.1-rc1] - 2025-12-21

First official release candidate for Moodle Plugin Directory submission.

Fixed

• Moodle curl wrapper: Replaced direct curl_init() calls with Moodle's \curl class in connect.php and moodleconnect_client.php. This ensures proper proxy configuration support for organizations behind web proxies. (Fixes #1)


• Language strings: Moved hard-coded rate limit error message to language file using get_string(). (Fixes #2)


• Private IP detection: Added automatic detection of private IPs for local development, only bypassing URL security checks when necessary.

Changed

• Code consistency: Unified curl wrapper usage pattern across all API client files (connect.php, sync_schema.php, moodleconnect_client.php).

[4.1.0] - 2025-12-15

Changed

• Native Save Button: Removed custom "Save and Sync Events" button in favor of Moodle's native "Save changes" button.


• Auto-Sync on Page Load: Events are now automatically synced when the settings page loads (if connected).


• Simplified UI: Cleaner admin interface with fewer custom buttons.

Fixed

• CI Grunt Check: Fixed Grunt stale file detection with NVM support for correct Node.js version.


• Moodle 5.x Support: Added support for Moodle 5.x public directory structure in CI.


• PHPUnit Compatibility: Replaced assertObjectHasProperty() with property_exists() for older PHPUnit versions.


• AMD Module Builds: Rebuilt all AMD modules with correct Node.js/npm versions to match CI environment.

[4.0.3] - 2025-12-15

Fixed

• ESLint Complexity: Further refactored connect.js init function by extracting getConfigValue() and buildConfig() helpers.


• PHPCS Lang Ordering: Fixed alphabetical ordering of language strings in lang/en/local_mc_plugin.php.

[4.0.2] - 2025-12-15

Fixed

• ESLint Complexity: Refactored connect.js to reduce cyclomatic complexity below threshold.


• Stylelint: Removed all !important declarations from styles.css.


• PHPUnit Compatibility: Replaced assertObjectHasProperty with assertTrue(property_exists(...)) for Moodle 4.0/PHPUnit 9 compatibility.

[4.0.1] - 2025-12-15

Fixed

• Linting Issues: Resolved ESLint warnings in AMD modules (camelCase variables).


• PHPCS: Fixed language string ordering in lang/en/local_mc_plugin.php.

[4.0.0] - 2025-12-15

Added

• Output API Implementation: Complete refactor of the admin interface to use Moodle's Output API (Renderers, Renderables, Templates).


• Mustache Templates: Modern, responsive UI components for:
  
  
  
  • Event Selector (with search, filtering, and bulk actions)
  
  
  • Connection Status (dynamic updates via AJAX)
  
  
  • Action Buttons (loading states and feedback)
  
  
  
  


• AMD Modules: Full migration of JavaScript logic to modular, dependency-managed AMD files.


• Client-Side Rendering: Dynamic UI updates using core/templates for better performance and user experience.

Changed

• Admin Settings: Replaced legacy admin_setting_configtext with custom setting classes that delegate to the Output API.


• JavaScript Architecture: Removed all inline JavaScript; logic is now encapsulated in amd/src/local/admin/*.js.


• Styling: Cleaned up CSS and leveraged Bootstrap utility classes for consistent design.


• Code Structure: Improved separation of concerns between logic (PHP classes), presentation (Mustache), and behavior (JS).

Removed

• Legacy inline HTML generation in admin settings.


• Unused CSS styles and redundant code.

[3.2.0] - 2025-12-14

Added

• Comprehensive PHPUnit test suite with full coverage


• GitHub Actions CI workflow with matrix testing
  
  
  
  • Moodle 4.0, 4.5 (LTS), and 5.0 support
  
  
  • PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 compatibility
  
  
  • PostgreSQL and MariaDB database testing
  
  
  
  


• Input validation and CSRF protection for all plugin endpoints


• Privacy API implementation for GDPR compliance


• PHPDoc comments for all functions and classes


• GPL license headers on all PHP files


• Plugin icon for Moodle marketplace

Changed

• Improved code quality to meet Moodle Plugin Directory standards


• Enhanced error handling and logging


• Moved all hardcoded strings to language files


• Reorganized README with expanded documentation links


• Achieved full Moodle coding standards compliance - all 200+ phpcs violations fixed
  
  
  
  • Fixed variable naming conventions (snake_case to camelcase)
  
  
  • Fixed inline comment formatting (proper capitalization and punctuation)
  
  
  • Added documentation to empty catch blocks
  
  
  • Removed trailing whitespace from string literals
  
  
  • Fixed line length violations (132 and 180 character limits)
  
  
  • Removed unnecessary MOODLE_INTERNAL checks
  
  
  • Added missing class-level documentation
  
  
  • Replaced forbidden functions with Moodle-approved alternatives
  
  
  • Fixed interface ordering in privacy provider class
  
  
  • Fixed language string ordering (alphabetical)
  
  
  
  

Fixed

• Moodle 4.0 compatibility issues with event validation


• Test file locations and namespace handling


• AMD module builds using Moodle's Rollup system


• All phpcs errors and warnings resolved (zero violations)


• Debug warning suppression and MOODLE_INTERNAL checks

Security

• Added CSRF token validation for AJAX endpoints


• Input sanitization for all user-provided data

[3.1.0] - 2025-12-03

Added

• OAuth-style connection flow for simplified site linking


• One-click "Connect to MoodleConnect" button in plugin settings


• Automatic site key and secret exchange during connection


• Secure redirect handling between Moodle and MoodleConnect service


• Connection status indicator in admin interface


• Disconnect functionality to unlink sites

Changed

• Simplified initial setup process (no manual site key entry required)


• Improved user experience for site connection workflow


• Enhanced security with automatic credential exchange

Fixed

• Connection reliability improvements


• Better error messages during setup process

[3.0.0] - 2025-11-XX

Added

• Event observer system for capturing Moodle events


• Selective event monitoring via admin interface


• Event schema discovery and synchronization


• HMAC-based authentication for secure API communication


• Debug mode with detailed logging


• Schema sync page with AJAX-based UI


• Support for dynamic event field inspection


• Configurable MoodleConnect API endpoint

Changed

• Initial stable release for production use

Security

• Implemented HMAC signature verification for all API requests


• Secure storage of site credentials


• HTTPS-only communication with MoodleConnect service

[2.0.0] - 2025-10-XX

Added

• Beta release with core functionality


• Basic event capture and transmission


• Admin settings interface

[1.0.0] - 2025-09-XX

Added

• Initial alpha release


• Proof of concept implementation

Version Numbering

This plugin follows Moodle's version numbering scheme:

• version: YYYYMMDDXX format (e.g., 2025120301)


• release: Semantic versioning (e.g., v3.1.0)

Upgrade Notes

Upgrading to 3.1.0

If you're upgrading from 3.0.0:

1. The plugin will automatically migrate your existing site key and secret


2. You'll see a new "Connect to MoodleConnect" interface


3. If already connected, your connection will remain active


4. No action required - existing triggers and configurations are preserved

Upgrading to 3.0.0

First stable release - no upgrade path from earlier versions.

Support

For issues, questions, or feature requests:

• GitHub Issues: https://github.com/kcanakdag/moodle-local_mc_plugin/issues


• Email: support@moodleconnect.com


• Documentation: https://moodleconnect.com/docs

Changelog

All notable changes to the MoodleConnect plugin will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[5.2.0] - 2026-02-21

Added

• Local Moodle Actions: MoodleConnect can now dispatch actions back to Moodle for inline execution
  
  
  
  • Supported actions: issue certificate, award badge, send message, enroll user, suspend enrolment, add to group, add to cohort
  
  
  • Claim-based idempotency prevents duplicate side effects
  
  
  • Structured error codes with retryable vs permanent classification
  
  
  
  


• Metadata Providers: Moodle site metadata (courses, roles, groups, cohorts, badges, certificates) exposed via API for UI dropdowns


• Manual Pending Claim Recovery CLI: local/mc_plugin/cli/cleanup_pending_claims.php
  
  
  
  • Lists orphaned pending claims with age and filters
  
  
  • Deletes matched claims only with explicit --delete --yes confirmation
  
  
  
  

Fixed

• Local Action Idempotency: Removed automatic stale-claim reclaim in inline action executor
  
  
  
  • Pending __pending__ claims are no longer auto-deleted by elapsed time
  
  
  • Prevents duplicate side effects when the original request is still executing
  
  
  
  


• Issue Certificate Config Fidelity: send_email action config is now honored
  
  
  
  • Uses customcert issue_certificate email argument when supported
  
  
  • Keeps compatibility with older customcert signatures
  
  
  
  

[5.1.1] - 2026-02-13

Fixed

• Connection Flow: Always show a fallback link when connecting to MoodleConnect
  
  
  
  • Previously relied on popup blocker detection which is unreliable across browsers
  
  
  • Now always displays "If a new tab didn't open, click here to open MoodleConnect" below the waiting status
  
  
  • Polling starts immediately regardless, so the connection completes automatically once authorized
  
  
  
  

[5.1.0] - 2026-01-26

Added

• Analytics Dashboard: New analytics page showing Moodle event activity
  
  
  
  • Summary KPIs: total events, unique users, active courses
  
  
  • Event type distribution (donut chart)
  
  
  • Top courses by activity (progress bars)
  
  
  • Top users by activity (with avatars)
  
  
  • Activity timeline (bar chart)
  
  
  • Date range filtering (7d, 30d, 90d)
  
  
  • Accessible from plugin settings page
  
  
  
  

Changed

• Documentation: Updated README with destinations terminology and event processing details

[5.0.1] - 2025-12-28

Added

• Health Check Sync: The health check endpoint now supports optional sync_events and sync_courses parameters
  
  
  
  • MoodleConnect can request event/course sync during health checks
  
  
  • Enables automatic data sync when users first connect their site
  
  
  • Eliminates the need for users to manually refresh after initial connection
  
  
  
  

Changed

• Improved initial connection experience - events and courses sync automatically

[5.0.0] - 2025-12-28

⚠️ BREAKING CHANGE

This version is required for continued event processing. The MoodleConnect backend now requires plugin version 5.0.0 or higher. Sites running older plugin versions will have events rejected with an "upgrade required" message.

Added

• Event Limit Blocking: Plugin now respects monthly event limits pushed from MoodleConnect
  
  
  
  • Events are automatically blocked when limit is exceeded
  
  
  • Admin warning banner displays in plugin settings when blocked
  
  
  • Events resume automatically when the new month begins
  
  
  
  


• Health Check Endpoint: New /api.php?action=health endpoint for connectivity verification
  
  
  
  • Returns Moodle version, plugin version, and monitored event count
  
  
  • Used by MoodleConnect to verify plugin compatibility
  
  
  
  


• Course-Level Filtering: Events can now be filtered by course at the Moodle level
  
  
  
  • MoodleConnect pushes course filters when triggers are configured
  
  
  • Reduces unnecessary event transmission for course-specific triggers
  
  
  
  


• Reverse Event Sync: MoodleConnect automatically updates monitored events when triggers change
  
  
  
  • No manual "Sync Events" needed after creating triggers
  
  
  • Plugin receives event list updates via API
  
  
  
  


• Automatic Course Sync: Courses are synced to MoodleConnect automatically
  
  
  
  • Initial sync on plugin connection
  
  
  • Incremental sync when courses are created, updated, or deleted
  
  
  
  

Changed

• Minimum Backend Compatibility: Requires MoodleConnect backend with health check support


• Event Processing: Events from unverified plugin versions are now rejected

Fixed

• Various code quality improvements and language string reorganization

[4.5.0] - 2025-12-24

Added

• Course Filter Sync: Course filters configured in MoodleConnect triggers are now pushed to Moodle


• Plugin filters events at source based on course include/exclude rules

[4.2.2] - 2025-12-22

Changed

• Build System: Removed local Gruntfile in favor of Moodle's grunt for AMD builds


• CI Compatibility: AMD build output now matches CI expectations exactly

Removed

• Local Gruntfile.js, package.json, node_modules/, husky pre-commit hooks


• These caused "uncommitted changes detected" errors in CI due to different minification output

[4.2.1] - 2025-12-22

Added

• Local Grunt Build System: Added Gruntfile.js with grunt-terser for AMD module minification


• Pre-commit Hook: Added husky + lint-staged to auto-rebuild AMD modules on commit


• No-op Stylelint Task: Added compatibility task for Moodle CI grunt checks

Changed

• Build Process: AMD modules can now be built locally without requiring Moodle container


• Maturity: Promoted from RC to STABLE

[4.2.1-rc1] - 2025-12-21

First official release candidate for Moodle Plugin Directory submission.

Fixed

• Moodle curl wrapper: Replaced direct curl_init() calls with Moodle's \curl class in connect.php and moodleconnect_client.php. This ensures proper proxy configuration support for organizations behind web proxies. (Fixes #1)


• Language strings: Moved hard-coded rate limit error message to language file using get_string(). (Fixes #2)


• Private IP detection: Added automatic detection of private IPs for local development, only bypassing URL security checks when necessary.

Changed

• Code consistency: Unified curl wrapper usage pattern across all API client files (connect.php, sync_schema.php, moodleconnect_client.php).

[4.1.0] - 2025-12-15

Changed

• Native Save Button: Removed custom "Save and Sync Events" button in favor of Moodle's native "Save changes" button.


• Auto-Sync on Page Load: Events are now automatically synced when the settings page loads (if connected).


• Simplified UI: Cleaner admin interface with fewer custom buttons.

Fixed

• CI Grunt Check: Fixed Grunt stale file detection with NVM support for correct Node.js version.


• Moodle 5.x Support: Added support for Moodle 5.x public directory structure in CI.


• PHPUnit Compatibility: Replaced assertObjectHasProperty() with property_exists() for older PHPUnit versions.


• AMD Module Builds: Rebuilt all AMD modules with correct Node.js/npm versions to match CI environment.

[4.0.3] - 2025-12-15

Fixed

• ESLint Complexity: Further refactored connect.js init function by extracting getConfigValue() and buildConfig() helpers.


• PHPCS Lang Ordering: Fixed alphabetical ordering of language strings in lang/en/local_mc_plugin.php.

[4.0.2] - 2025-12-15

Fixed

• ESLint Complexity: Refactored connect.js to reduce cyclomatic complexity below threshold.


• Stylelint: Removed all !important declarations from styles.css.


• PHPUnit Compatibility: Replaced assertObjectHasProperty with assertTrue(property_exists(...)) for Moodle 4.0/PHPUnit 9 compatibility.

[4.0.1] - 2025-12-15

Fixed

• Linting Issues: Resolved ESLint warnings in AMD modules (camelCase variables).


• PHPCS: Fixed language string ordering in lang/en/local_mc_plugin.php.

[4.0.0] - 2025-12-15

Added

• Output API Implementation: Complete refactor of the admin interface to use Moodle's Output API (Renderers, Renderables, Templates).


• Mustache Templates: Modern, responsive UI components for:
  
  
  
  • Event Selector (with search, filtering, and bulk actions)
  
  
  • Connection Status (dynamic updates via AJAX)
  
  
  • Action Buttons (loading states and feedback)
  
  
  
  


• AMD Modules: Full migration of JavaScript logic to modular, dependency-managed AMD files.


• Client-Side Rendering: Dynamic UI updates using core/templates for better performance and user experience.

Changed

• Admin Settings: Replaced legacy admin_setting_configtext with custom setting classes that delegate to the Output API.


• JavaScript Architecture: Removed all inline JavaScript; logic is now encapsulated in amd/src/local/admin/*.js.


• Styling: Cleaned up CSS and leveraged Bootstrap utility classes for consistent design.


• Code Structure: Improved separation of concerns between logic (PHP classes), presentation (Mustache), and behavior (JS).

Removed

• Legacy inline HTML generation in admin settings.


• Unused CSS styles and redundant code.

[3.2.0] - 2025-12-14

Added

• Comprehensive PHPUnit test suite with full coverage


• GitHub Actions CI workflow with matrix testing
  
  
  
  • Moodle 4.0, 4.5 (LTS), and 5.0 support
  
  
  • PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 compatibility
  
  
  • PostgreSQL and MariaDB database testing
  
  
  
  


• Input validation and CSRF protection for all plugin endpoints


• Privacy API implementation for GDPR compliance


• PHPDoc comments for all functions and classes


• GPL license headers on all PHP files


• Plugin icon for Moodle marketplace

Changed

• Improved code quality to meet Moodle Plugin Directory standards


• Enhanced error handling and logging


• Moved all hardcoded strings to language files


• Reorganized README with expanded documentation links


• Achieved full Moodle coding standards compliance - all 200+ phpcs violations fixed
  
  
  
  • Fixed variable naming conventions (snake_case to camelcase)
  
  
  • Fixed inline comment formatting (proper capitalization and punctuation)
  
  
  • Added documentation to empty catch blocks
  
  
  • Removed trailing whitespace from string literals
  
  
  • Fixed line length violations (132 and 180 character limits)
  
  
  • Removed unnecessary MOODLE_INTERNAL checks
  
  
  • Added missing class-level documentation
  
  
  • Replaced forbidden functions with Moodle-approved alternatives
  
  
  • Fixed interface ordering in privacy provider class
  
  
  • Fixed language string ordering (alphabetical)
  
  
  
  

Fixed

• Moodle 4.0 compatibility issues with event validation


• Test file locations and namespace handling


• AMD module builds using Moodle's Rollup system


• All phpcs errors and warnings resolved (zero violations)


• Debug warning suppression and MOODLE_INTERNAL checks

Security

• Added CSRF token validation for AJAX endpoints


• Input sanitization for all user-provided data

[3.1.0] - 2025-12-03

Added

• OAuth-style connection flow for simplified site linking


• One-click "Connect to MoodleConnect" button in plugin settings


• Automatic site key and secret exchange during connection


• Secure redirect handling between Moodle and MoodleConnect service


• Connection status indicator in admin interface


• Disconnect functionality to unlink sites

Changed

• Simplified initial setup process (no manual site key entry required)


• Improved user experience for site connection workflow


• Enhanced security with automatic credential exchange

Fixed

• Connection reliability improvements


• Better error messages during setup process

[3.0.0] - 2025-11-XX

Added

• Event observer system for capturing Moodle events


• Selective event monitoring via admin interface


• Event schema discovery and synchronization


• HMAC-based authentication for secure API communication


• Debug mode with detailed logging


• Schema sync page with AJAX-based UI


• Support for dynamic event field inspection


• Configurable MoodleConnect API endpoint

Changed

• Initial stable release for production use

Security

• Implemented HMAC signature verification for all API requests


• Secure storage of site credentials


• HTTPS-only communication with MoodleConnect service

[2.0.0] - 2025-10-XX

Added

• Beta release with core functionality


• Basic event capture and transmission


• Admin settings interface

[1.0.0] - 2025-09-XX

Added

• Initial alpha release


• Proof of concept implementation

Version Numbering

This plugin follows Moodle's version numbering scheme:

• version: YYYYMMDDXX format (e.g., 2025120301)


• release: Semantic versioning (e.g., v3.1.0)

Upgrade Notes

Upgrading to 3.1.0

If you're upgrading from 3.0.0:

1. The plugin will automatically migrate your existing site key and secret


2. You'll see a new "Connect to MoodleConnect" interface


3. If already connected, your connection will remain active


4. No action required - existing triggers and configurations are preserved

Upgrading to 3.0.0

First stable release - no upgrade path from earlier versions.

Support

For issues, questions, or feature requests:

• GitHub Issues: https://github.com/kcanakdag/moodle-local_mc_plugin/issues


• Email: support@moodleconnect.com


• Documentation: https://moodleconnect.com/docs

Changelog

All notable changes to the MoodleConnect plugin will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[5.1.1] - 2026-02-13

Fixed

• Connection Flow: Always show a fallback link when connecting to MoodleConnect
  
  
  
  • Previously relied on popup blocker detection which is unreliable across browsers
  
  
  • Now always displays "If a new tab didn't open, click here to open MoodleConnect" below the waiting status
  
  
  • Polling starts immediately regardless, so the connection completes automatically once authorized
  
  
  
  

[5.1.0] - 2026-01-26

Added

• Analytics Dashboard: New analytics page showing Moodle event activity
  
  
  
  • Summary KPIs: total events, unique users, active courses
  
  
  • Event type distribution (donut chart)
  
  
  • Top courses by activity (progress bars)
  
  
  • Top users by activity (with avatars)
  
  
  • Activity timeline (bar chart)
  
  
  • Date range filtering (7d, 30d, 90d)
  
  
  • Accessible from plugin settings page
  
  
  
  

Changed

• Documentation: Updated README with destinations terminology and event processing details

[5.0.1] - 2025-12-28

Added

• Health Check Sync: The health check endpoint now supports optional sync_events and sync_courses parameters
  
  
  
  • MoodleConnect can request event/course sync during health checks
  
  
  • Enables automatic data sync when users first connect their site
  
  
  • Eliminates the need for users to manually refresh after initial connection