lib.php

<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
 * Library callbacks for local_spaceit.
 *
 * Injects the teacher consent controls (spec §13) into the activity settings
 * form and persists them. Currently scoped to mod_quiz, the fully wired grade
 * source.
 *
 * @package    local_spaceit
 * @copyright  2026 Fynn Scharpey
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

defined('MOODLE_INTERNAL') || die();

use local_spaceit\repository\consent_repository;

/** Module types that show the SpaceIt consent controls. */
const LOCAL_SPACEIT_CONSENT_MODNAMES = ['quiz'];

/**
 * Add the SpaceIt consent fields to the activity settings form.
 *
 * @param \moodleform_mod $formwrapper The activity settings form wrapper.
 * @param \MoodleQuickForm $mform The raw form being built.
 * @return void
 */
function local_spaceit_coursemodule_standard_elements($formwrapper, $mform): void {
    $modname = $formwrapper->get_current()->modulename ?? '';
    if (!in_array($modname, LOCAL_SPACEIT_CONSENT_MODNAMES, true)) {
        return;
    }

    $mform->addElement('header', 'spaceit_consent', get_string('consent:header', 'local_spaceit'));

    $mform->addElement('advcheckbox', 'spaceit_allowed', get_string('consent:spaceitallowed', 'local_spaceit'));
    $mform->addHelpButton('spaceit_allowed', 'consent:spaceitallowed', 'local_spaceit');
    $mform->setDefault('spaceit_allowed', 0);

    $mform->addElement('advcheckbox', 'llm_allowed', get_string('consent:llmallowed', 'local_spaceit'));
    $mform->addHelpButton('llm_allowed', 'consent:llmallowed', 'local_spaceit');
    $mform->setDefault('llm_allowed', 0);
    // LLM grading is only meaningful when SpaceIt tracking is enabled.
    $mform->disabledIf('llm_allowed', 'spaceit_allowed', 'notchecked');

    // Pre-fill from the stored consent when editing an existing activity.
    if ($cm = $formwrapper->get_coursemodule()) {
        $consent = (new consent_repository())->get_for_cm((int) $cm->id);
        if ($consent !== null) {
            $mform->setDefault('spaceit_allowed', $consent->spaceit_allowed);
            $mform->setDefault('llm_allowed', $consent->llm_allowed);
        }
    }
}

/**
 * Persist the SpaceIt consent after the activity has been saved.
 *
 * @param \stdClass $moduleinfo The saved module info (incl. our submitted fields).
 * @param \stdClass $course The course.
 * @return \stdClass The (unmodified) module info.
 */
function local_spaceit_coursemodule_edit_post_actions($moduleinfo, $course): \stdClass {
    global $USER;

    if (!in_array($moduleinfo->modulename ?? '', LOCAL_SPACEIT_CONSENT_MODNAMES, true)) {
        return $moduleinfo;
    }
    // Only act when our fields were actually part of the submitted form.
    if (!property_exists($moduleinfo, 'spaceit_allowed')) {
        return $moduleinfo;
    }

    (new consent_repository())->set(
        (int) $moduleinfo->coursemodule,
        (bool) $moduleinfo->spaceit_allowed,
        (bool) ($moduleinfo->llm_allowed ?? 0),
        (int) $USER->id,
    );

    return $moduleinfo;
}