Repository navigation
Releases
v1.2.0
Cohort Membership 1.2.0
Category managers can now use the plugin for their own course category, without site-level rights.
New: category-level entry point
- Open a course category, then More → Cohort Membership (next to core's "Cohorts"). Same page as the site-level one: CSV upload, dry-run, report and CSV download.
- Available to users holding
local/cohortmembership:manageandmoodle/cohort:assignin the category. By default that is the Manager role assigned at category level. - Only cohorts in that category or its subcategories are visible. Cohorts elsewhere (system level, other categories) are reported as "Cohort not found", so the report reveals nothing about them. An idnumber reused in another category no longer makes the in-scope cohort ambiguous.
moodle/cohort:assignis checked in each cohort's own context, so a prohibit on a subcategory is honoured (new status: "You may not assign members to this cohort").- For
sync, cohorts outside the category never join the file universe: a sync run from a category can never remove a membership outside it. - Hidden categories are only reachable for users who may see them.
The site-level admin page and the CLI are unchanged and unrestricted.
Changed
- Requires Moodle 5.0. Supported: Moodle 5.0 to 5.3 LTS, PHP 8.2 to 8.4. Sites on Moodle 4.5 LTS stay on 1.1.0.
- The capability
local/cohortmembership:manageis now defined at course category level (was system level). Existing role definitions are kept. - The upload form now has a Cancel button.
- A download request without a matching report now shows a notice instead of an empty form.
- The release ZIP no longer contains repository tooling (
.github,.camp,.gitattributes,.gitignore).
Verified
- CI green on 14 combinations: Moodle 5.0, 5.1, 5.2 and 5.3 LTS, PHP 8.2 to 8.4, MariaDB and PostgreSQL. 47/47 PHPUnit tests, including 9 new ones for the category scope.
- Category entry point tested manually on Moodle 5.2.4 with a category manager account.
The attached ZIP is ready for installation via Site administration → Plugins → Install plugins.
Full Changelog: v1.1.0...v1.2.0
v1.1.0
Cohort Membership 1.1.0
Official support for Moodle 5.3 LTS.
Verified
- Installed against the official Moodle 5.3 release (Build 20261005): clean upgrade, 48/48 PHPUnit tests, live CLI smoke test (
add/del, dry-run and live) with real database changes confirmed. - No plugin code changes were needed.
Changed
version.phpnow declares$plugin->supported = [405, 503]— the plugin supports Moodle 4.5 LTS through 5.3 LTS. (Previously undeclared, so registries listed only 4.5.)- CI now tests against
MOODLE_503_STABLEon PHP 8.3 and 8.4, MariaDB 11.4 and PostgreSQL 17 (Moodle 5.3's own minimums). - README compatibility section updated.
The attached ZIP is ready for installation via Site administration → Plugins → Install plugins, or for upload to the Moodle Marketplace.
Full Changelog: v1.0.8...v1.1.0
v1.0.8
Cohort Membership 1.0.8
Fixes the camp-registry release workflow, which failed for v1.0.7 with ImportError: cannot import name 'branch_names' from 'camp.moodleversions'.
Fixed
camp-release.ymlwas pinned tocamp-tools@v0.2.35, badly stale against the currentv0.2.66(same failure mode previously fixed for v1.0.4 in b3ec27a). Bumped the pin.
Camp-registry release verified working end to end for this tag: PR #368 opened successfully. Moodle Plugin CI verified green before this release was cut.
No functional/behavioural changes to the plugin itself.
Full Changelog: v1.0.7...v1.0.8
v1.0.7
Cohort Membership 1.0.7
Fixes the Moodle 5.3dev CI matrix entries added in 1.0.5/1.0.6, which were silently failing (masked by continue-on-error) rather than actually testing anything.
Fixed
- MariaDB service never reported healthy:
--health-cmd="mysqladmin ping"uses a binary MariaDB 11 dropped (themysql*-compat symlinks are gone in 11.x). Switched tomariadb-admin ping, which works across both the 10.x and 11.4 images in the matrix. - The PostgreSQL leg failed Moodle's own environment check (
[System] version 17 is required and you are running 16.15) — Moodle 5.3dev raised its PostgreSQL floor. Added a matrix-scoped override (17 for the 5.3dev entry only, 16 elsewhere), matching the existing MariaDB-version pattern.
Both main/5.3dev CI jobs are now verified green end to end before this release was cut.
No functional/behavioural changes to the plugin itself.
Full Changelog: v1.0.6...v1.0.7
v1.0.6
Cohort Membership 1.0.6
CI hardening following up on 1.0.5's Moodle 5.3 verification.
Fixed
- The MariaDB 11.4 requirement (needed by Moodle 5.3dev) was scoped to only the
main/5.3dev CI matrix entry instead of applying to all 18 matrix legs, including the Moodle 4.5 LTS ones that were never validated against it. - The
main/5.3dev CI matrix entries are now markedcontinue-on-error, so an unrelated Moodle core regression onmaincan no longer redden the whole CI run — matching the entry's intended role as an early-warning, best-effort check.
No functional/behavioural changes to the plugin itself.
Full Changelog: v1.0.5...v1.0.6
v1.0.5
Cohort Membership 1.0.5
Verifies compatibility with Moodle 5.3 (dev/alpha, pre-release; stable release targeted 2026-10-05).
Verified
- Installed against a real Moodle 5.3dev checkout (build 20260911): clean install/upgrade, 48/48 PHPUnit tests passing, live CLI smoke test (
add/del) with real database writes confirmed. cohort_add_member()/cohort_remove_member()are not deprecated in 5.3 — no plugin code changes were needed.
Changed
- CI matrix now also runs against Moodle core's
mainbranch (currently 5.3dev) to catch regressions early; there's noMOODLE_503_STABLEbranch to pin to yet. - CI's MariaDB service bumped to 11.4, which Moodle 5.3dev requires.
- README compatibility table and install requirements updated for 5.3.
No functional/behavioural changes to the plugin itself.
Full Changelog: v1.0.4...v1.0.5
v1.0.3
Cohort Membership 1.0.3
Adds a plugin icon.
Added
pix/icon.svg— reduced hub-and-spoke glyph (no background, single colour), sized for Moodle's admin-tree icon convention..github/logo.svg— full-colour 200x200 version, now shown at the top of the README.
No functional/behavioural changes.
Full Changelog: v1.0.1...v1.0.3
v1.0.1
Cohort Membership 1.0.1
Patch release: fixes a fatal error introduced in v1.0.0.
Fix
index.phpcalledadmin_externalpage_setup()without requiringlib/adminlib.phpfirst, which is not autoloaded byconfig.php. Every page load crashed withError: Call to undefined function admin_externalpage_setup(). Fixed by adding the missingrequire_once.
v1.0.0 should not be used — install v1.0.1 or later instead.
Full Changelog: v1.0.0...v1.0.1
v1.0.0
⚠️ Broken — do not use. This release crashes on every page load
(Call to undefined function admin_externalpage_setup()). Use
v1.0.1
or later instead.
Cohort Membership 1.0.0
First stable release. Submitted to Moodle Marketplace as local_cohortmembership, version 2026072100 / MATURITY_STABLE.
Highlights since v1.0.0-RC2
- Report storage moved from
$SESSIONto a per-session temp file, so large runs don't bloat the session store. - CSV export hardened against formula injection via
core\dataformat::escape_spreadsheet_formula(). - Addressed the critical and recommended findings from an independent GitHub Copilot code review.
- Expanded README install/compatibility documentation.
- No further functional changes: version bumped to
1.0.0/MATURITY_STABLEfor submission.
Commits since v1.0.0-RC2
Full Changelog: v1.0.0-RC2...v1.0.0
v1.0.0-RC2
Cohort Membership 1.0.0-RC2
Incorporates fixes from an independent code review by David Pesce of RC1 - thank you, David, for the thorough review. Four High-severity findings, nine Medium, and sixteen Low findings across correctness, security hardening, i18n, and test coverage.
Highlights
- Dry-run now actually defaults to checked (the only safeguard against sync's implicit removals on a first live run - every doc already claimed this was the default, but the code didn't set it).
- Fixed a broken CSV download (HTML was being emitted before the download's own headers).
- A cohort
idnumbershared by cohorts in different contexts is now reported asstatus_cohortambiguousinstead of silently resolving to an arbitrary cohort. cli/unenrol.phpnow refuses CSVs with anoperationcolumn instead of silently reinterpreting add/sync rows as deletions.- Added Post/Redirect/Get to the upload page, admin breadcrumb integration, CSV formula-injection hardening, and 11 new regression tests (34/34 passing).
See the full commit history below for the complete list.
Commits since v1.0.0-RC1
Full Changelog: v1.0.0-RC1...v1.0.0-RC2