Proyectos de Subversion Moodle

Rev

| Ultima modificación | Ver Log |

Rev Autor Línea Nro. Línea
1 efrain 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 
 * Course completion critieria - student self marked
19 
 *
20 
 * @package core_completion
21 
 * @category completion
22 
 * @copyright 2009 Catalyst IT Ltd
23 
 * @author Aaron Barnes <aaronb@catalyst.net.nz>
24 
 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
25 
 */
26 
 
27 
defined('MOODLE_INTERNAL') || die();
28 
 
29 
/**
30 
 * Course completion critieria - student self marked
31 
 *
32 
 * @package core_completion
33 
 * @category completion
34 
 * @copyright 2009 Catalyst IT Ltd
35 
 * @author Aaron Barnes <aaronb@catalyst.net.nz>
36 
 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
37 
 */
38 
class completion_criteria_self extends completion_criteria {
39 
 
40 
    /* @var int Criteria type constant [COMPLETION_CRITERIA_TYPE_SELF] */
41 
    public $criteriatype = COMPLETION_CRITERIA_TYPE_SELF;
42 
 
43 
    /**
44 
     * Finds and returns a data_object instance based on params.
45 
     *
46 
     * @param array $params associative arrays varname=>value
47 
     * @return data_object data_object instance or false if none found.
48 
     */
49 
    public static function fetch($params) {
50 
        $params['criteriatype'] = COMPLETION_CRITERIA_TYPE_SELF;
51 
        return self::fetch_helper('course_completion_criteria', __CLASS__, $params);
52 
    }
53 
 
54 
    /**
55 
     * Add appropriate form elements to the critieria form
56 
     *
57 
     * @param moodleform $mform  Moodle forms object
58 
     * @param stdClass $data Form data
59 
     */
60 
    public function config_form_display(&$mform, $data = null) {
61 
        $mform->addElement('checkbox', 'criteria_self', get_string('enable'));
62 
 
63 
        if ($this->id ) {
64 
           $mform->setDefault('criteria_self', 1);
65 
        }
66 
    }
67 
 
68 
    /**
69 
     * Update the criteria information stored in the database
70 
     *
71 
     * @param stdClass $data Form data
72 
     */
73 
    public function update_config(&$data) {
74 
        if (!empty($data->criteria_self)) {
75 
            $this->course = $data->id;
76 
            $this->insert();
77 
        }
78 
    }
79 
 
80 
    /**
81 
     * Mark this criteria as complete
82 
     *
83 
     * @param completion_completion $completion The user's completion record
84 
     */
85 
    public function complete($completion) {
86 
        $this->review($completion, true, true);
87 
    }
88 
 
89 
    /**
90 
     * Review this criteria and decide if the user has completed
91 
     *
92 
     * @param completion_completion $completion     The user's completion record
93 
     * @param bool $mark Optionally set false to not save changes to database
94 
     * @param bool $is_complete set true to mark activity complete.
95 
     * @return bool
96 
     */
97 
    public function review($completion, $mark = true, $is_complete = false) {
98 
        // If we are marking this as complete
99 
        if ($is_complete && $mark) {
100 
            $completion->completedself = 1;
101 
            $completion->mark_complete();
102 
 
103 
            return true;
104 
        }
105 
 
106 
        return $completion->is_complete();
107 
    }
108 
 
109 
    /**
110 
     * Return criteria title for display in reports
111 
     *
112 
     * @return string
113 
     */
114 
    public function get_title() {
115 
        return get_string('selfcompletion', 'completion');
116 
    }
117 
 
118 
    /**
119 
     * Return a more detailed criteria title for display in reports
120 
     *
121 
     * @return string
122 
     */
123 
    public function get_title_detailed() {
124 
        return $this->get_title();
125 
    }
126 
 
127 
    /**
128 
     * Return criteria type title for display in reports
129 
     *
130 
     * @return string
131 
     */
132 
    public function get_type_title() {
133 
        return get_string('self', 'completion');
134 
    }
135 
 
136 
    /**
137 
     * Return criteria progress details for display in reports
138 
     *
139 
     * @param completion_completion $completion The user's completion record
140 
     * @return array An array with the following keys:
141 
     *     type, criteria, requirement, status
142 
     */
143 
    public function get_details($completion) {
144 
        $details = array();
145 
        $details['type'] = $this->get_title();
146 
        $details['criteria'] = $this->get_title();
147 
        $details['requirement'] = get_string('markingyourselfcomplete', 'completion');
148 
        $details['status'] = '';
149 
 
150 
        return $details;
151 
    }
152 
 
153 
    /**
154 
     * Return pix_icon for display in reports.
155 
     *
156 
     * @param string $alt The alt text to use for the icon
157 
     * @param array $attributes html attributes
158 
     * @return pix_icon
159 
     */
160 
    public function get_icon($alt, array $attributes = null) {
161 
        return new pix_icon('i/completion_self', $alt, 'moodle', $attributes);
162 
    }
163 
}