Proyectos de Subversion Moodle

<?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/>.

/**

 * Form for grader report preferences

 *

 * @package    gradereport_grader

 * @copyright  2009 Nicolas Connault

 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 */

if (!defined('MOODLE_INTERNAL')) {

    die('Direct access to this script is forbidden.');    ///  It must be included from a Moodle page

}

require_once($CFG->libdir.'/formslib.php');

/**

 * First implementation of the preferences in the form of a moodleform.

 * TODO add "reset to site defaults" button

 */

class grader_report_preferences_form extends moodleform {

    function definition() {

        global $USER, $CFG;

        $mform    =& $this->_form;

        $course   = $this->_customdata['course'];

        $context = context_course::instance($course->id);

        $canviewhidden = has_capability('moodle/grade:viewhidden', $context);

        $checkbox_default = array(GRADE_REPORT_PREFERENCE_DEFAULT => '*default*', 0 => get_string('no'), 1 => get_string('yes'));

        $advanced = array();

/// form definition with preferences defaults

//--------------------------------------------------------------------------------

        $preferences = array();

        // Initialise the preferences arrays with grade:manage capabilities

        if (has_capability('moodle/grade:manage', $context)) {

            $preferences['prefshow'] = array();

            if ($canviewhidden) {

                $preferences['prefshow']['showaverages']  = $checkbox_default;

            }

            $preferences['prefrows'] = array(

                        'rangesdisplaytype'      => array(GRADE_REPORT_PREFERENCE_DEFAULT => '*default*',

                                                          GRADE_REPORT_PREFERENCE_INHERIT => get_string('inherit', 'grades'),

                                                          GRADE_DISPLAY_TYPE_REAL => get_string('real', 'grades'),

                                                          GRADE_DISPLAY_TYPE_PERCENTAGE => get_string('percentage', 'grades'),

                                                          GRADE_DISPLAY_TYPE_LETTER => get_string('letter', 'grades')),

                        'rangesdecimalpoints'    => array(GRADE_REPORT_PREFERENCE_DEFAULT => '*default*',

                                                          GRADE_REPORT_PREFERENCE_INHERIT => get_string('inherit', 'grades'),

                                                          0=>0, 1=>1, 2=>2, 3=>3, 4=>4, 5=>5));

            $advanced = array_merge($advanced, array('rangesdisplaytype', 'rangesdecimalpoints'));

            if ($canviewhidden) {

                $preferences['prefrows']['averagesdisplaytype'] = array(GRADE_REPORT_PREFERENCE_DEFAULT => '*default*',

                                                                        GRADE_REPORT_PREFERENCE_INHERIT => get_string('inherit', 'grades'),

                                                                        GRADE_DISPLAY_TYPE_REAL => get_string('real', 'grades'),

                                                                        GRADE_DISPLAY_TYPE_PERCENTAGE => get_string('percentage', 'grades'),

                                                                        GRADE_DISPLAY_TYPE_LETTER => get_string('letter', 'grades'));

                $preferences['prefrows']['averagesdecimalpoints'] = array(GRADE_REPORT_PREFERENCE_DEFAULT => '*default*',

                                                                          GRADE_REPORT_PREFERENCE_INHERIT => get_string('inherit', 'grades'),

                                                                          0=>0, 1=>1, 2=>2, 3=>3, 4=>4, 5=>5);

                $preferences['prefrows']['meanselection']  = array(GRADE_REPORT_PREFERENCE_DEFAULT => '*default*',

                                                                   GRADE_REPORT_MEAN_ALL => get_string('meanall', 'grades'),

                                                                   GRADE_REPORT_MEAN_GRADED => get_string('meangraded', 'grades'));

                $advanced = array_merge($advanced, array('averagesdisplaytype', 'averagesdecimalpoints'));

            }

        }

        // Quickgrading use conditional on grade:edit capability.

        if (has_capability('moodle/grade:edit', $context)) {

            $preferences['prefgeneral']['quickgrading'] = $checkbox_default;

        }

        // View capability is the lowest permission. Users with grade:manage or grade:edit must also have grader:view

        if (has_capability('gradereport/grader:view', $context)) {

            if (has_capability('moodle/course:viewsuspendedusers', $context)) {

                $preferences['prefgeneral']['showonlyactiveenrol'] = $checkbox_default;

            }

            $preferences['prefgeneral']['aggregationposition'] = array(GRADE_REPORT_PREFERENCE_DEFAULT => '*default*',

                                                                       GRADE_REPORT_AGGREGATION_POSITION_FIRST => get_string('positionfirst', 'grades'),

                                                                       GRADE_REPORT_AGGREGATION_POSITION_LAST => get_string('positionlast', 'grades'));

            $preferences['prefshow']['showuserimage'] = $checkbox_default;

            $preferences['prefshow']['showranges'] = $checkbox_default;

            if ($canviewhidden) {

                $preferences['prefrows']['shownumberofgrades'] = $checkbox_default;

            }

        }

        foreach ($preferences as $group => $prefs) {

            $mform->addElement('header', $group, get_string($group, 'grades'));

            $mform->setExpanded($group);

            foreach ($prefs as $pref => $type) {

                // Detect and process dynamically numbered preferences

                if (preg_match('/([^[0-9]+)([0-9]+)/', $pref, $matches)) {

                    $lang_string = $matches[1];

                    $number = ' ' . $matches[2];

                } else {

                    $lang_string = $pref;

                    $number = null;

                }

                $full_pref  = 'grade_report_' . $pref;

                $pref_value = get_user_preferences($full_pref);

                $options = null;

                if (is_array($type)) {

                    $options = $type;

                    $type = 'select';

                    // MDL-11478

                    // get default aggregationposition from grade_settings

                    $course_value = null;

                    if (!empty($CFG->{$full_pref})) {

                        $course_value = grade_get_setting($course->id, $pref, $CFG->{$full_pref});

                    }

                    if ($pref == 'aggregationposition') {

                        if (!empty($options[$course_value])) {

                            $default = $options[$course_value];

                        } else {

                            $default = $options[$CFG->grade_aggregationposition];

                        }

                    } elseif (isset($options[$CFG->{$full_pref}])) {

                        $default = $options[$CFG->{$full_pref}];

                    } else {

                        $default = '';

                    }

                } else {

                    $default = $CFG->$full_pref;

                }

                // Replace the '*default*' value with the site default language string - 'default' might collide with custom language packs

                if (!is_null($options) AND isset($options[GRADE_REPORT_PREFERENCE_DEFAULT]) && $options[GRADE_REPORT_PREFERENCE_DEFAULT] == '*default*') {

                    $options[GRADE_REPORT_PREFERENCE_DEFAULT] = get_string('reportdefault', 'grades', $default);

                }

                $label = get_string($lang_string, 'grades') . $number;

                $mform->addElement($type, $full_pref, $label, $options);

                if ($lang_string != 'showuserimage') {

                    $mform->addHelpButton($full_pref, $lang_string, 'grades');

                }

                $mform->setDefault($full_pref, $pref_value);

                $mform->setType($full_pref, PARAM_ALPHANUM);

            }

        }

        foreach($advanced as $name) {

            $mform->setAdvanced('grade_report_'.$name);

        }

        $mform->addElement('hidden', 'id');

        $mform->setType('id', PARAM_INT);

        $mform->setDefault('id', $course->id);

        $this->add_action_buttons(false);

    }

/// perform some extra moodle validation

    function validation($data, $files) {

        return parent::validation($data, $files);

    }

}