Changelog

All notable changes to the Progress Analytics Block will be documented in this file.

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

[Unreleased]

Planned Features

• Additional chart types (histogram, scatter plots)
• Export functionality for analytics data
• Email notifications for milestone achievements
• Integration with course completion tracking
• Advanced filtering options
• Teacher dashboard with class overview
• Historical trend analysis
• Custom date range selection

[1.0.2] - 2024-09-22

Added

• Documented AMD build process, localisation coverage, and privacy/caching details in the README.
• Introduced a dedicated styles.css and namespaced classes for all block styling.
• Captured release notes in a maintained changelog file.

Changed

• Localised numeric admin settings so options display translated labels.
• Regenerated AMD builds after source updates and ensured matching .map files.
• Converted chart containers to <canvas> elements to keep Chart.js compatible.

Fixed

• Resolved layout issues caused by inline styles and ensured Moodle coding-style compliance across touched files.

[1.0.1] - 2024-09-18

Added

• Comprehensive GPL headers and docblocks across PHP and AMD source files.
• Language strings for cache definitions to describe stored analytics data.

Changed

• Renamed the distribution directory to block_progressanalytics to match the declared component.
• Replaced hard-coded UI text in PHP, Mustache, and AMD modules with Moodle language strings.

[1.0.0] - 2024-09-10

Added

• Initial release of Progress Analytics Block
• Quiz progress tracking with doughnut chart visualization
• Individual quiz results display with line/bar charts
• Course comparison analytics with percentile ranking
• Responsive design with mobile optimization
• Dark mode support respecting user preferences
• Accessibility features (ARIA labels, screen reader support)
• Multi-language support (English and Spanish)
• Configurable caching system for performance optimization
• Privacy-compliant implementation following GDPR standards
• Global settings for administrators
• Block instance configuration options
• Comprehensive help documentation
• Error handling and graceful degradation

Features

• Progress Chart: Shows completion percentage of course quizzes
• Results Chart: Displays chronological quiz performance
• Comparison Chart: Compares student average with course metrics
• Smart Caching: User-level and course-level cache optimization
• Permission System: Capability-based access control
• Anonymized Data: Course comparisons without exposing individual data

Technical Details

• Compatible with Moodle 4.1+ and PHP 8.1+
• Uses Chart.js for modern, responsive visualizations
• AMD JavaScript modules for optimal performance
• Mustache templating for clean separation of concerns
• External API service for AJAX data loading
• Comprehensive unit test coverage ready
• Follows Moodle coding standards and best practices

Supported Metrics

• Quiz completion progress (attempted vs total)
• Normalized grade calculations (0-100 scale)
• Course-wide statistical comparisons
• Percentile ranking within enrolled students
• Configurable minimum participant thresholds

Configuration Options

• Include/exclude hidden quizzes
• Adjustable cache intervals (1-60 minutes)
• Minimum participants for comparison (3-20)
• Chart type selection (line/bar for results)
• Percentile display toggle
• Per-instance chart visibility controls