[Summary view] [Print] [Text view]

   1  <?php
   2  // This file is part of Moodle - http://moodle.org/
   3  //
   4  // Moodle is free software: you can redistribute it and/or modify
   5  // it under the terms of the GNU General Public License as published by
   6  // the Free Software Foundation, either version 3 of the License, or
   7  // (at your option) any later version.
   8  //
   9  // Moodle is distributed in the hope that it will be useful,
  10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  // GNU General Public License for more details.
  13  //
  14  // You should have received a copy of the GNU General Public License
  15  // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16  
  17  /**
  18   * This file contains the function for feedback_plugin abstract class
  19   *
  20   * @package   mod_assign
  21   * @copyright 2012 NetSpot {@link http://www.netspot.com.au}
  22   * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23   */
  24  
  25  defined('MOODLE_INTERNAL') || die();
  26  
  27  require_once($CFG->dirroot.'/mod/assign/assignmentplugin.php');
  28  
  29  /**
  30   * Abstract class for feedback_plugin inherited from assign_plugin abstract class.
  31   *
  32   * @package   mod_assign
  33   * @copyright 2012 NetSpot {@link http://www.netspot.com.au}
  34   * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  35   */
  36  abstract class assign_feedback_plugin extends assign_plugin {
  37  
  38      /**
  39       * Return subtype name of the plugin.
  40       *
  41       * @return string
  42       */
  43      public function get_subtype() {
  44          return 'assignfeedback';
  45      }
  46  
  47      /**
  48       * If this plugin adds to the gradebook comments field, it must specify the format
  49       * of the comment.
  50       *
  51       * (From weblib.php)
  52       * define('FORMAT_MOODLE',   '0');   // Does all sorts of transformations and filtering
  53       * define('FORMAT_HTML',     '1');   // Plain HTML (with some tags stripped)
  54       * define('FORMAT_PLAIN',    '2');   // Plain text (even tags are printed in full)
  55       * define('FORMAT_WIKI',     '3');   // Wiki-formatted text
  56       * define('FORMAT_MARKDOWN', '4');   // Markdown-formatted
  57       *
  58       * Only one feedback plugin can push comments to the gradebook and that is chosen by the assignment
  59       * settings page.
  60       *
  61       * @param stdClass $grade The grade
  62       * @return int
  63       */
  64      public function format_for_gradebook(stdClass $grade) {
  65          return FORMAT_MOODLE;
  66      }
  67  
  68      /**
  69       * If this plugin adds to the gradebook comments field, it must format the text
  70       * of the comment.
  71       *
  72       * Only one feedback plugin can push comments to the gradebook and that is chosen by the assignment
  73       * settings page.
  74       *
  75       * @param stdClass $grade The grade
  76       * @return string
  77       */
  78      public function text_for_gradebook(stdClass $grade) {
  79          return '';
  80      }
  81  
  82      /**
  83       * Override to indicate a plugin supports quickgrading.
  84       *
  85       * @return boolean - True if the plugin supports quickgrading
  86       */
  87      public function supports_quickgrading() {
  88          return false;
  89      }
  90  
  91      /**
  92       * Get quickgrading form elements as html.
  93       *
  94       * @param int $userid The user id in the table this quickgrading element relates to
  95       * @param mixed $grade grade or null - The grade data.
  96       *                     May be null if there are no grades for this user (yet)
  97       * @return mixed - A html string containing the html form elements required for
  98       *                 quickgrading or false to indicate this plugin does not support quickgrading
  99       */
 100      public function get_quickgrading_html($userid, $grade) {
 101          return false;
 102      }
 103  
 104      /**
 105       * Has the plugin quickgrading form element been modified in the current form submission?
 106       *
 107       * @param int $userid The user id in the table this quickgrading element relates to
 108       * @param stdClass $grade The grade
 109       * @return boolean - true if the quickgrading form element has been modified
 110       */
 111      public function is_quickgrading_modified($userid, $grade) {
 112          return false;
 113      }
 114  
 115      /**
 116       * Save quickgrading changes.
 117       *
 118       * @param int $userid The user id in the table this quickgrading element relates to
 119       * @param stdClass $grade The grade
 120       * @return boolean - true if the grade changes were saved correctly
 121       */
 122      public function save_quickgrading_changes($userid, $grade) {
 123          return false;
 124      }
 125  
 126      /**
 127       * Return a list of the batch grading operations supported by this plugin.
 128       *
 129       * @return array - An array of action and description strings.
 130       *                 The action will be passed to grading_batch_operation.
 131       */
 132      public function get_grading_batch_operations() {
 133          return array();
 134      }
 135  
 136      /**
 137       * Return a list of the grading actions supported by this plugin.
 138       *
 139       * A grading action is a page that is not specific to a user but to the whole assignment.
 140       * @return array - An array of action and description strings.
 141       *                 The action will be passed to grading_action.
 142       */
 143      public function get_grading_actions() {
 144          return array();
 145      }
 146  
 147      /**
 148       * Show a grading action form
 149       *
 150       * @param string $gradingaction The action chosen from the grading actions menu
 151       * @return string The page containing the form
 152       */
 153      public function grading_action($gradingaction) {
 154          return '';
 155      }
 156  
 157      /**
 158       * Show a batch operations form
 159       *
 160       * @param string $action The action chosen from the batch operations menu
 161       * @param array $users The list of selected userids
 162       * @return string The page containing the form
 163       */
 164      public function grading_batch_operation($action, $users) {
 165          return '';
 166      }
 167  }