add grade pass functionality

This commits adds the ability to set a passing grade for a moodleoverflow that can be checked in the activity completions

Author: TamaroWalter

db/install.xml

@@ -24,6 +24,7 @@
         <FIELD NAME="allownegativereputation" TYPE="int" LENGTH="1" NOTNULL="true" DEFAULT="0" SEQUENCE="false"/>
         <FIELD NAME="grademaxgrade" TYPE="int" LENGTH="10" NOTNULL="false" SEQUENCE="false"/>
         <FIELD NAME="gradescalefactor" TYPE="int" LENGTH="10" NOTNULL="false" SEQUENCE="false"/>
+        <FIELD NAME="gradepass" TYPE="int" LENGTH="10" NOTNULL="false" SEQUENCE="false" COMMENT="grade needed to pass the grading"/>
         <FIELD NAME="gradecat" TYPE="int" LENGTH="10" NOTNULL="false" SEQUENCE="false"/>
         <FIELD NAME="anonymous" TYPE="int" LENGTH="2" NOTNULL="true" DEFAULT="0" SEQUENCE="false"/>
         <FIELD NAME="needsreview" TYPE="int" LENGTH="2" NOTNULL="true" DEFAULT="0" SEQUENCE="false"/>

db/upgrade.php

@@ -314,5 +314,17 @@ function xmldb_moodleoverflow_upgrade($oldversion) {
         upgrade_mod_savepoint(true, 2025031200, 'moodleoverflow');
     }
 
+    if ($oldversion < 2025112701) {
+        // Define table moodleoverflow to be edited.
+        $table = new xmldb_table('moodleoverflow');
+
+        // Create the field for the passing grade.
+        $field = new xmldb_field('gradepass', XMLDB_TYPE_INTEGER, '10', null, null, null, 0, 'gradescalefactor');
+        if (!$dbman->field_exists($table, $field)) {
+            $dbman->add_field($table, $field);
+        }
+
+        upgrade_mod_savepoint(true, 2025112701, 'moodleoverflow');
+    }
     return true;
 }

lang/en/moodleoverflow.php

@@ -165,6 +165,8 @@
 $string['give_a_reason'] = 'Give a reason (optional)';
 $string['gotoindex'] = 'Manage preferences';
 $string['grademaxgradeerror'] = 'Maximum grade must be a positive integer different than 0';
+$string['gradepasserror'] = 'Grade pass must be a positive integer';
+$string['gradepassvalidationerror'] = 'Grade pass can not be greater than the max grade';
 $string['gradesreport'] = 'Grades report';
 $string['gradesupdated'] = 'Grades updated';
 $string['helpamountofactivity'] = 'Help icon for activity';

mod_form.php

@@ -175,12 +175,17 @@ public function definition() {
 
         $mform->addElement('text', 'grademaxgrade', get_string('modgrademaxgrade', 'grades'));
         $mform->setType('grademaxgrade', PARAM_INT);
-        $mform->addRule('grademaxgrade', get_string('grademaxgradeerror', 'moodleoverflow'), 'regex', '/^[0-9]+$/', 'client');
+        $mform->addRule('grademaxgrade', get_string('grademaxgradeerror', 'moodleoverflow'), 'regex', '/^[1-9][0-9]*$/', 'client');
 
         $mform->addElement('text', 'gradescalefactor', get_string('scalefactor', 'moodleoverflow'));
         $mform->addHelpButton('gradescalefactor', 'scalefactor', 'moodleoverflow');
         $mform->setType('gradescalefactor', PARAM_INT);
-        $mform->addRule('gradescalefactor', get_string('scalefactorerror', 'moodleoverflow'), 'regex', '/^[0-9]+$/', 'client');
+        $mform->addRule('gradescalefactor', get_string('scalefactorerror', 'moodleoverflow'), 'regex', '/^[1-9][0-9]*$/', 'client');
+
+        $mform->addElement('text', 'gradepass', get_string('gradepass', 'grades'));
+        $mform->addHelpButton('gradepass', 'gradepass', 'grades');
+        $mform->setType('gradepass', PARAM_INT);
+        $mform->addRule('gradepass', get_string('gradepasserror', 'moodleoverflow'), 'regex', '/^(0|[1-9][0-9]*)$/', 'client');
 
         if ($this->_features->gradecat) {
             $mform->addElement(
@@ -299,6 +304,18 @@ public function data_postprocessing($data) {
         }
     }
 
+    /**
+     * Handles data preprocessing.
+     * @param array $defaultvalues
+     * @return void
+     */
+    public function data_preprocessing(&$defaultvalues) {
+        parent::data_preprocessing($defaultvalues);
+        if (isset($defaultvalues['gradepass'])) {
+            $defaultvalues['gradepass'] = (int)$defaultvalues['gradepass'];
+        }
+    }
+
     /**
      * Validates set data in mod_form
      * @param array $data
@@ -309,6 +326,11 @@ public function data_postprocessing($data) {
     public function validation($data, $files): array {
         $errors = parent::validation($data, $files);
 
+        // Validate the grade settings.
+        if (isset($data['gradepass']) && isset($data['grademaxgrade']) && $data['gradepass'] > $data['grademaxgrade']) {
+            $errors['gradepass'] = get_string('gradepassvalidationerror', 'moodleoverflow');
+        }
+
         // Validate that the limited answer settings.
         $currenttime = time();
         $isstarttime = !empty($data['la_starttime']);

version.php

@@ -26,7 +26,7 @@
 
 defined('MOODLE_INTERNAL') || die();
 
-$plugin->version = 2025112700;
+$plugin->version = 2025112701;
 $plugin->requires = 2024100700.00; // Require Moodle 4.5.
 $plugin->supported = [405, 501];
 $plugin->component = 'mod_moodleoverflow';