/mod/assignment/type/upload/assignment.class.php
PHP | 1227 lines | 927 code | 217 blank | 83 comment | 178 complexity | 8490c7069a01d17a51f60a213b240c64 MD5 | raw file
Possible License(s): MIT, AGPL-3.0, MPL-2.0-no-copyleft-exception, LGPL-3.0, GPL-3.0, Apache-2.0, LGPL-2.1, BSD-3-Clause
Large files files are truncated, but you can click here to view the full file
- <?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/>.
- /**
- * Assignment upload type implementation
- *
- * @package mod-assignment
- * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
- */
- require_once(dirname(__FILE__).'/upload_form.php');
- require_once($CFG->libdir . '/portfoliolib.php');
- require_once($CFG->dirroot . '/mod/assignment/lib.php');
- define('ASSIGNMENT_STATUS_SUBMITTED', 'submitted'); // student thinks it is finished
- define('ASSIGNMENT_STATUS_CLOSED', 'closed'); // teacher prevents more submissions
- /**
- * Extend the base assignment class for assignments where you upload a single file
- *
- */
- class assignment_upload extends assignment_base {
- function assignment_upload($cmid='staticonly', $assignment=NULL, $cm=NULL, $course=NULL) {
- parent::assignment_base($cmid, $assignment, $cm, $course);
- $this->type = 'upload';
- }
- function view() {
- global $USER, $OUTPUT;
- require_capability('mod/assignment:view', $this->context);
- $cansubmit = has_capability('mod/assignment:submit', $this->context);
- add_to_log($this->course->id, 'assignment', 'view', "view.php?id={$this->cm->id}", $this->assignment->id, $this->cm->id);
- $this->view_header();
- if ($this->assignment->timeavailable > time()
- and !has_capability('mod/assignment:grade', $this->context) // grading user can see it anytime
- and $this->assignment->var3) { // force hiding before available date
- echo $OUTPUT->box_start('generalbox boxaligncenter', 'intro');
- print_string('notavailableyet', 'assignment');
- echo $OUTPUT->box_end();
- } else {
- $this->view_intro();
- }
- $this->view_dates();
- if (is_enrolled($this->context, $USER)) {
- if ($submission = $this->get_submission($USER->id)) {
- $filecount = $this->count_user_files($submission->id);
- } else {
- $filecount = 0;
- }
- if ($cansubmit or !empty($filecount)) { //if a user has submitted files using a previous role we should still show the files
- $this->view_feedback();
- if (!$this->drafts_tracked() or !$this->isopen() or $this->is_finalized($submission)) {
- echo $OUTPUT->heading(get_string('submission', 'assignment'), 3);
- } else {
- echo $OUTPUT->heading(get_string('submissiondraft', 'assignment'), 3);
- }
- if ($filecount and $submission) {
- echo $OUTPUT->box($this->print_user_files($USER->id, true), 'generalbox boxaligncenter', 'userfiles');
- } else {
- if (!$this->isopen() or $this->is_finalized($submission)) {
- echo $OUTPUT->box(get_string('nofiles', 'assignment'), 'generalbox boxaligncenter nofiles', 'userfiles');
- } else {
- echo $OUTPUT->box(get_string('nofilesyet', 'assignment'), 'generalbox boxaligncenter nofiles', 'userfiles');
- }
- }
- $this->view_upload_form();
- if ($this->notes_allowed()) {
- echo $OUTPUT->heading(get_string('notes', 'assignment'), 3);
- $this->view_notes();
- }
- $this->view_final_submission();
- }
- }
- $this->view_footer();
- }
- function view_feedback($submission=NULL) {
- global $USER, $CFG, $DB, $OUTPUT, $PAGE;
- require_once($CFG->libdir.'/gradelib.php');
- require_once("$CFG->dirroot/grade/grading/lib.php");
- if (!$submission) { /// Get submission for this assignment
- $userid = $USER->id;
- $submission = $this->get_submission($userid);
- } else {
- $userid = $submission->userid;
- }
- if (empty($submission->timemarked)) { /// Nothing to show, so print nothing
- return;
- }
- // Check the user can submit
- $canviewfeedback = ($userid == $USER->id && has_capability('mod/assignment:submit', $this->context, $USER->id, false));
- // If not then check if the user still has the view cap and has a previous submission
- $canviewfeedback = $canviewfeedback || (!empty($submission) && $submission->userid == $USER->id && has_capability('mod/assignment:view', $this->context));
- // Or if user can grade (is a teacher or admin)
- $canviewfeedback = $canviewfeedback || has_capability('mod/assignment:grade', $this->context);
- if (!$canviewfeedback) {
- // can not view or submit assignments -> no feedback
- return;
- }
- $grading_info = grade_get_grades($this->course->id, 'mod', 'assignment', $this->assignment->id, $userid);
- $item = $grading_info->items[0];
- $grade = $item->grades[$userid];
- if ($grade->hidden or $grade->grade === false) { // hidden or error
- return;
- }
- if ($grade->grade === null and empty($grade->str_feedback)) { // No grade to show yet
- if ($this->count_responsefiles($userid)) { // but possibly response files are present
- echo $OUTPUT->heading(get_string('responsefiles', 'assignment'), 3);
- $responsefiles = $this->print_responsefiles($userid, true);
- echo $OUTPUT->box($responsefiles, 'generalbox boxaligncenter');
- }
- return;
- }
- $graded_date = $grade->dategraded;
- $graded_by = $grade->usermodified;
- /// We need the teacher info
- if (!$teacher = $DB->get_record('user', array('id'=>$graded_by))) {
- print_error('cannotfindteacher');
- }
- /// Print the feedback
- echo $OUTPUT->heading(get_string('submissionfeedback', 'assignment'), 3);
- echo '<table cellspacing="0" class="feedback">';
- echo '<tr>';
- echo '<td class="left picture">';
- echo $OUTPUT->user_picture($teacher);
- echo '</td>';
- echo '<td class="topic">';
- echo '<div class="from">';
- echo '<div class="fullname">'.fullname($teacher).'</div>';
- echo '<div class="time">'.userdate($graded_date).'</div>';
- echo '</div>';
- echo '</td>';
- echo '</tr>';
- echo '<tr>';
- echo '<td class="left side"> </td>';
- echo '<td class="content">';
- $gradestr = '<div class="grade">'. get_string("grade").': '.$grade->str_long_grade. '</div>';
- if (!empty($submission) && $controller = get_grading_manager($this->context, 'mod_assignment', 'submission')->get_active_controller()) {
- $controller->set_grade_range(make_grades_menu($this->assignment->grade));
- echo $controller->render_grade($PAGE, $submission->id, $item, $gradestr, has_capability('mod/assignment:grade', $this->context));
- } else {
- echo $gradestr;
- }
- echo '<div class="clearer"></div>';
- echo '<div class="comment">';
- echo $grade->str_feedback;
- echo '</div>';
- echo '</tr>';
- echo '<tr>';
- echo '<td class="left side"> </td>';
- echo '<td class="content">';
- echo $this->print_responsefiles($userid, true);
- echo '</tr>';
- echo '</table>';
- }
- function view_upload_form() {
- global $CFG, $USER, $OUTPUT;
- $submission = $this->get_submission($USER->id);
- if ($this->is_finalized($submission)) {
- // no uploading
- return;
- }
- if ($this->can_upload_file($submission)) {
- $fs = get_file_storage();
- // edit files in another page
- if ($submission) {
- if ($files = $fs->get_area_files($this->context->id, 'mod_assignment', 'submission', $submission->id, "timemodified", false)) {
- $str = get_string('editthesefiles', 'assignment');
- } else {
- $str = get_string('uploadfiles', 'assignment');
- }
- } else {
- $str = get_string('uploadfiles', 'assignment');
- }
- echo $OUTPUT->single_button(new moodle_url('/mod/assignment/type/upload/upload.php', array('contextid'=>$this->context->id, 'userid'=>$USER->id)), $str, 'get');
- }
- }
- function view_notes() {
- global $USER, $OUTPUT;
- if ($submission = $this->get_submission($USER->id)
- and !empty($submission->data1)) {
- echo $OUTPUT->box(format_text($submission->data1, FORMAT_HTML, array('overflowdiv'=>true)), 'generalbox boxaligncenter boxwidthwide');
- } else {
- echo $OUTPUT->box(get_string('notesempty', 'assignment'), 'generalbox boxaligncenter');
- }
- if ($this->can_update_notes($submission)) {
- $options = array ('id'=>$this->cm->id, 'action'=>'editnotes');
- echo '<div style="text-align:center">';
- echo $OUTPUT->single_button(new moodle_url('upload.php', $options), get_string('edit'));
- echo '</div>';
- }
- }
- function view_final_submission() {
- global $CFG, $USER, $OUTPUT;
- $submission = $this->get_submission($USER->id);
- if ($this->isopen() and $this->can_finalize($submission)) {
- //print final submit button
- echo $OUTPUT->heading(get_string('submitformarking','assignment'), 3);
- echo '<div style="text-align:center">';
- echo '<form method="post" action="upload.php">';
- echo '<fieldset class="invisiblefieldset">';
- echo '<input type="hidden" name="id" value="'.$this->cm->id.'" />';
- echo '<input type="hidden" name="sesskey" value="'.sesskey().'" />';
- echo '<input type="hidden" name="action" value="finalize" />';
- echo '<input type="submit" name="formarking" value="'.get_string('sendformarking', 'assignment').'" />';
- echo '</fieldset>';
- echo '</form>';
- echo '</div>';
- } else if (!$this->isopen()) {
- echo $OUTPUT->heading(get_string('nomoresubmissions','assignment'), 3);
- } else if ($this->drafts_tracked() and $state = $this->is_finalized($submission)) {
- if ($state == ASSIGNMENT_STATUS_SUBMITTED) {
- echo $OUTPUT->heading(get_string('submitedformarking','assignment'), 3);
- } else {
- echo $OUTPUT->heading(get_string('nomoresubmissions','assignment'), 3);
- }
- } else {
- //no submission yet
- }
- }
- /**
- * Return true if var3 == hide description till available day
- *
- *@return boolean
- */
- function description_is_hidden() {
- return ($this->assignment->var3 && (time() <= $this->assignment->timeavailable));
- }
- function print_student_answer($userid, $return=false){
- global $CFG, $OUTPUT, $PAGE;
- $submission = $this->get_submission($userid);
- $output = '';
- if ($this->drafts_tracked() and $this->isopen() and !$this->is_finalized($submission)) {
- $output .= '<strong>'.get_string('draft', 'assignment').':</strong> ';
- }
- if ($this->notes_allowed() and !empty($submission->data1)) {
- $link = new moodle_url("/mod/assignment/type/upload/notes.php", array('id'=>$this->cm->id, 'userid'=>$userid));
- $action = new popup_action('click', $link, 'notes', array('height' => 500, 'width' => 780));
- $output .= $OUTPUT->action_link($link, get_string('notes', 'assignment'), $action, array('title'=>get_string('notes', 'assignment')));
- $output .= ' ';
- }
- $renderer = $PAGE->get_renderer('mod_assignment');
- $output = $OUTPUT->box_start('files').$output;
- $output .= $renderer->assignment_files($this->context, $submission->id);
- $output .= $OUTPUT->box_end();
- return $output;
- }
- /**
- * Produces a list of links to the files uploaded by a user
- *
- * @param $userid int optional id of the user. If 0 then $USER->id is used.
- * @param $return boolean optional defaults to false. If true the list is returned rather than printed
- * @return string optional
- */
- function print_user_files($userid=0, $return=false) {
- global $CFG, $USER, $OUTPUT, $PAGE;
- $mode = optional_param('mode', '', PARAM_ALPHA);
- $offset = optional_param('offset', 0, PARAM_INT);
- if (!$userid) {
- if (!isloggedin()) {
- return '';
- }
- $userid = $USER->id;
- }
- $output = $OUTPUT->box_start('files');
- $submission = $this->get_submission($userid);
- // only during grading
- if ($this->drafts_tracked() and $this->isopen() and !$this->is_finalized($submission) and !empty($mode)) {
- $output .= '<strong>'.get_string('draft', 'assignment').':</strong><br />';
- }
- if ($this->notes_allowed() and !empty($submission->data1) and !empty($mode)) { // only during grading
- $npurl = $CFG->wwwroot."/mod/assignment/type/upload/notes.php?id={$this->cm->id}&userid=$userid&offset=$offset&mode=single";
- $output .= '<a href="'.$npurl.'">'.get_string('notes', 'assignment').'</a><br />';
- }
- if ($this->drafts_tracked() and $this->isopen() and has_capability('mod/assignment:grade', $this->context) and $mode != '') { // we do not want it on view.php page
- if ($this->can_unfinalize($submission)) {
- //$options = array ('id'=>$this->cm->id, 'userid'=>$userid, 'action'=>'unfinalize', 'mode'=>$mode, 'offset'=>$offset);
- $output .= '<br /><input type="submit" name="unfinalize" value="'.get_string('unfinalize', 'assignment').'" />';
- $output .= $OUTPUT->help_icon('unfinalize', 'assignment');
- } else if ($this->can_finalize($submission)) {
- //$options = array ('id'=>$this->cm->id, 'userid'=>$userid, 'action'=>'finalizeclose', 'mode'=>$mode, 'offset'=>$offset);
- $output .= '<br /><input type="submit" name="finalize" value="'.get_string('finalize', 'assignment').'" />';
- }
- }
- if ($submission) {
- $renderer = $PAGE->get_renderer('mod_assignment');
- $output .= $renderer->assignment_files($this->context, $submission->id);
- }
- $output .= $OUTPUT->box_end();
- if ($return) {
- return $output;
- }
- echo $output;
- }
- function submissions($mode) {
- // redirects out of form to process (un)finalizing.
- $unfinalize = optional_param('unfinalize', FALSE, PARAM_TEXT);
- $finalize = optional_param('finalize', FALSE, PARAM_TEXT);
- if ($unfinalize) {
- $this->unfinalize('single');
- } else if ($finalize) {
- $this->finalize('single');
- }
- if ($unfinalize || $finalize) {
- $mode = 'singlenosave';
- }
- parent::submissions($mode);
- }
- function process_feedback() {
- if (!$feedback = data_submitted() or !confirm_sesskey()) { // No incoming data?
- return false;
- }
- $userid = required_param('userid', PARAM_INT);
- $offset = required_param('offset', PARAM_INT);
- $mform = $this->display_submission($offset, $userid, false);
- parent::process_feedback($mform);
- }
- function print_responsefiles($userid, $return=false) {
- global $CFG, $USER, $OUTPUT, $PAGE;
- $mode = optional_param('mode', '', PARAM_ALPHA);
- $offset = optional_param('offset', 0, PARAM_INT);
- $output = $OUTPUT->box_start('responsefiles');
- $candelete = $this->can_manage_responsefiles();
- $strdelete = get_string('delete');
- $fs = get_file_storage();
- $browser = get_file_browser();
- if ($submission = $this->get_submission($userid)) {
- $renderer = $PAGE->get_renderer('mod_assignment');
- $output .= $renderer->assignment_files($this->context, $submission->id, 'response');
- }
- $output .= $OUTPUT->box_end();
- if ($return) {
- return $output;
- }
- echo $output;
- }
- /**
- * Upload files
- * upload_file function requires moodle form instance and file manager options
- * @param object $mform
- * @param array $options
- */
- function upload($mform = null, $filemanager_options = null) {
- $action = required_param('action', PARAM_ALPHA);
- switch ($action) {
- case 'finalize':
- $this->finalize();
- break;
- case 'finalizeclose':
- $this->finalizeclose();
- break;
- case 'unfinalize':
- $this->unfinalize();
- break;
- case 'uploadresponse':
- $this->upload_responsefile($mform, $filemanager_options);
- break;
- case 'uploadfile':
- $this->upload_file($mform, $filemanager_options);
- case 'savenotes':
- case 'editnotes':
- $this->upload_notes();
- default:
- print_error('unknowuploadaction', '', '', $action);
- }
- }
- function upload_notes() {
- global $CFG, $USER, $OUTPUT, $DB;
- $action = required_param('action', PARAM_ALPHA);
- $returnurl = new moodle_url('/mod/assignment/view.php', array('id'=>$this->cm->id));
- $mform = new mod_assignment_upload_notes_form();
- $defaults = new stdClass();
- $defaults->id = $this->cm->id;
- if ($submission = $this->get_submission($USER->id)) {
- $defaults->text = clean_text($submission->data1);
- } else {
- $defaults->text = '';
- }
- $mform->set_data($defaults);
- if ($mform->is_cancelled()) {
- $returnurl = new moodle_url('/mod/assignment/view.php', array('id'=>$this->cm->id));
- redirect($returnurl);
- }
- if (!$this->can_update_notes($submission)) {
- $this->view_header(get_string('upload'));
- echo $OUTPUT->notification(get_string('uploaderror', 'assignment'));
- echo $OUTPUT->continue_button($returnurl);
- $this->view_footer();
- die;
- }
- if ($data = $mform->get_data() and $action == 'savenotes') {
- $submission = $this->get_submission($USER->id, true); // get or create submission
- $updated = new stdClass();
- $updated->id = $submission->id;
- $updated->timemodified = time();
- $updated->data1 = $data->text;
- $DB->update_record('assignment_submissions', $updated);
- add_to_log($this->course->id, 'assignment', 'upload', 'view.php?a='.$this->assignment->id, $this->assignment->id, $this->cm->id);
- redirect($returnurl);
- $submission = $this->get_submission($USER->id);
- $this->update_grade($submission);
- }
- /// show notes edit form
- $this->view_header(get_string('notes', 'assignment'));
- echo $OUTPUT->heading(get_string('notes', 'assignment'));
- $mform->display();
- $this->view_footer();
- die;
- }
- function upload_responsefile($mform, $options) {
- global $CFG, $USER, $OUTPUT, $PAGE;
- $userid = required_param('userid', PARAM_INT);
- $mode = required_param('mode', PARAM_ALPHA);
- $offset = required_param('offset', PARAM_INT);
- $returnurl = new moodle_url("submissions.php", array('id'=>$this->cm->id,'userid'=>$userid,'mode'=>$mode,'offset'=>$offset)); //not xhtml, just url.
- if ($formdata = $mform->get_data() and $this->can_manage_responsefiles()) {
- $fs = get_file_storage();
- $submission = $this->get_submission($userid, true, true);
- if ($formdata = file_postupdate_standard_filemanager($formdata, 'files', $options, $this->context, 'mod_assignment', 'response', $submission->id)) {
- $returnurl = new moodle_url("/mod/assignment/submissions.php", array('id'=>$this->cm->id,'userid'=>$formdata->userid,'mode'=>$formdata->mode,'offset'=>$formdata->offset));
- redirect($returnurl->out(false));
- }
- }
- $PAGE->set_title(get_string('upload'));
- echo $OUTPUT->header();
- echo $OUTPUT->notification(get_string('uploaderror', 'assignment'));
- echo $OUTPUT->continue_button($returnurl->out(true));
- echo $OUTPUT->footer();
- die;
- }
- function upload_file($mform, $options) {
- global $CFG, $USER, $DB, $OUTPUT;
- $returnurl = new moodle_url('/mod/assignment/view.php', array('id'=>$this->cm->id));
- $submission = $this->get_submission($USER->id);
- if (!$this->can_upload_file($submission)) {
- $this->view_header(get_string('upload'));
- echo $OUTPUT->notification(get_string('uploaderror', 'assignment'));
- echo $OUTPUT->continue_button($returnurl);
- $this->view_footer();
- die;
- }
- if ($formdata = $mform->get_data()) {
- $fs = get_file_storage();
- $submission = $this->get_submission($USER->id, true); //create new submission if needed
- $fs->delete_area_files($this->context->id, 'mod_assignment', 'submission', $submission->id);
- $formdata = file_postupdate_standard_filemanager($formdata, 'files', $options, $this->context, 'mod_assignment', 'submission', $submission->id);
- $updates = new stdClass();
- $updates->id = $submission->id;
- $updates->timemodified = time();
- $DB->update_record('assignment_submissions', $updates);
- add_to_log($this->course->id, 'assignment', 'upload',
- 'view.php?a='.$this->assignment->id, $this->assignment->id, $this->cm->id);
- $this->update_grade($submission);
- if (!$this->drafts_tracked()) {
- $this->email_teachers($submission);
- }
- // send files to event system
- $files = $fs->get_area_files($this->context->id, 'mod_assignment', 'submission', $submission->id);
- // Let Moodle know that assessable files were uploaded (eg for plagiarism detection)
- $eventdata = new stdClass();
- $eventdata->modulename = 'assignment';
- $eventdata->cmid = $this->cm->id;
- $eventdata->itemid = $submission->id;
- $eventdata->courseid = $this->course->id;
- $eventdata->userid = $USER->id;
- if ($files) {
- $eventdata->files = $files;
- }
- events_trigger('assessable_file_uploaded', $eventdata);
- $returnurl = new moodle_url('/mod/assignment/view.php', array('id'=>$this->cm->id));
- redirect($returnurl);
- }
- $this->view_header(get_string('upload'));
- echo $OUTPUT->notification(get_string('uploaderror', 'assignment'));
- echo $OUTPUT->continue_button($returnurl);
- $this->view_footer();
- die;
- }
- function send_file($filearea, $args) {
- global $CFG, $DB, $USER;
- require_once($CFG->libdir.'/filelib.php');
- require_login($this->course, false, $this->cm);
- if ($filearea === 'submission') {
- $submissionid = (int)array_shift($args);
- if (!$submission = $DB->get_record('assignment_submissions', array('assignment'=>$this->assignment->id, 'id'=>$submissionid))) {
- return false;
- }
- if ($USER->id != $submission->userid and !has_capability('mod/assignment:grade', $this->context)) {
- return false;
- }
- $relativepath = implode('/', $args);
- $fullpath = "/{$this->context->id}/mod_assignment/submission/$submission->id/$relativepath";
- $fs = get_file_storage();
- if (!$file = $fs->get_file_by_hash(sha1($fullpath)) or $file->is_directory()) {
- return false;
- }
- send_stored_file($file, 0, 0, true); // download MUST be forced - security!
- } else if ($filearea === 'response') {
- $submissionid = (int)array_shift($args);
- if (!$submission = $DB->get_record('assignment_submissions', array('assignment'=>$this->assignment->id, 'id'=>$submissionid))) {
- return false;
- }
- if ($USER->id != $submission->userid and !has_capability('mod/assignment:grade', $this->context)) {
- return false;
- }
- $relativepath = implode('/', $args);
- $fullpath = "/{$this->context->id}/mod_assignment/response/$submission->id/$relativepath";
- $fs = get_file_storage();
- if (!$file = $fs->get_file_by_hash(sha1($fullpath)) or $file->is_directory()) {
- return false;
- }
- send_stored_file($file, 0, 0, true);
- }
- return false;
- }
- function finalize($forcemode=null) {
- global $USER, $DB, $OUTPUT;
- $userid = optional_param('userid', $USER->id, PARAM_INT);
- $offset = optional_param('offset', 0, PARAM_INT);
- $confirm = optional_param('confirm', 0, PARAM_BOOL);
- $returnurl = new moodle_url('/mod/assignment/view.php', array('id'=>$this->cm->id));
- $submission = $this->get_submission($userid);
- if ($forcemode!=null) {
- $returnurl = new moodle_url('/mod/assignment/submissions.php',
- array('id'=>$this->cm->id,
- 'userid'=>$userid,
- 'mode'=>$forcemode,
- 'offset'=>$offset
- ));
- }
- if (!$this->can_finalize($submission)) {
- redirect($returnurl->out(false)); // probably already graded, redirect to assignment page, the reason should be obvious
- }
- if ($forcemode==null) {
- if (!data_submitted() or !$confirm or !confirm_sesskey()) {
- $optionsno = array('id'=>$this->cm->id);
- $optionsyes = array ('id'=>$this->cm->id, 'confirm'=>1, 'action'=>'finalize', 'sesskey'=>sesskey());
- $this->view_header(get_string('submitformarking', 'assignment'));
- echo $OUTPUT->heading(get_string('submitformarking', 'assignment'));
- echo $OUTPUT->confirm(get_string('onceassignmentsent', 'assignment'), new moodle_url('upload.php', $optionsyes),new moodle_url( 'view.php', $optionsno));
- $this->view_footer();
- die;
- }
- }
- $updated = new stdClass();
- $updated->id = $submission->id;
- $updated->data2 = ASSIGNMENT_STATUS_SUBMITTED;
- $updated->timemodified = time();
- $DB->update_record('assignment_submissions', $updated);
- add_to_log($this->course->id, 'assignment', 'upload', //TODO: add finalize action to log
- 'view.php?a='.$this->assignment->id, $this->assignment->id, $this->cm->id);
- $submission = $this->get_submission($userid);
- $this->update_grade($submission);
- $this->email_teachers($submission);
- // Trigger assessable_files_done event to show files are complete
- $eventdata = new stdClass();
- $eventdata->modulename = 'assignment';
- $eventdata->cmid = $this->cm->id;
- $eventdata->itemid = $submission->id;
- $eventdata->courseid = $this->course->id;
- $eventdata->userid = $userid;
- events_trigger('assessable_files_done', $eventdata);
- if ($forcemode==null) {
- redirect($returnurl->out(false));
- }
- }
- function finalizeclose() {
- global $DB;
- $userid = optional_param('userid', 0, PARAM_INT);
- $mode = required_param('mode', PARAM_ALPHA);
- $offset = required_param('offset', PARAM_INT);
- $returnurl = new moodle_url('/mod/assignment/submissions.php', array('id'=>$this->cm->id, 'userid'=>$userid, 'mode'=>$mode, 'offset'=>$offset, 'forcerefresh'=>1));
- // create but do not add student submission date
- $submission = $this->get_submission($userid, true, true);
- if (!data_submitted() or !$this->can_finalize($submission) or !confirm_sesskey()) {
- redirect($returnurl); // probably closed already
- }
- $updated = new stdClass();
- $updated->id = $submission->id;
- $updated->data2 = ASSIGNMENT_STATUS_CLOSED;
- $DB->update_record('assignment_submissions', $updated);
- add_to_log($this->course->id, 'assignment', 'upload', //TODO: add finalize action to log
- 'view.php?a='.$this->assignment->id, $this->assignment->id, $this->cm->id);
- $submission = $this->get_submission($userid, false, true);
- $this->update_grade($submission);
- redirect($returnurl);
- }
- function unfinalize($forcemode=null) {
- global $DB;
- $userid = required_param('userid', PARAM_INT);
- $mode = required_param('mode', PARAM_ALPHA);
- $offset = required_param('offset', PARAM_INT);
- if ($forcemode!=null) {
- $mode=$forcemode;
- }
- $returnurl = new moodle_url('/mod/assignment/submissions.php', array('id'=>$this->cm->id, 'userid'=>$userid, 'mode'=>$mode, 'offset'=>$offset, 'forcerefresh'=>1) );
- if (data_submitted()
- and $submission = $this->get_submission($userid)
- and $this->can_unfinalize($submission)
- and confirm_sesskey()) {
- $updated = new stdClass();
- $updated->id = $submission->id;
- $updated->data2 = '';
- $DB->update_record('assignment_submissions', $updated);
- //TODO: add unfinalize action to log
- add_to_log($this->course->id, 'assignment', 'view submission', 'submissions.php?id='.$this->cm->id.'&userid='.$userid.'&mode='.$mode.'&offset='.$offset, $this->assignment->id, $this->cm->id);
- $submission = $this->get_submission($userid);
- $this->update_grade($submission);
- }
- if ($forcemode==null) {
- redirect($returnurl);
- }
- }
- function delete() {
- $action = optional_param('action', '', PARAM_ALPHA);
- switch ($action) {
- case 'response':
- $this->delete_responsefile();
- break;
- default:
- $this->delete_file();
- }
- die;
- }
- function delete_responsefile() {
- global $CFG, $OUTPUT,$PAGE;
- $file = required_param('file', PARAM_FILE);
- $userid = required_param('userid', PARAM_INT);
- $mode = required_param('mode', PARAM_ALPHA);
- $offset = required_param('offset', PARAM_INT);
- $confirm = optional_param('confirm', 0, PARAM_BOOL);
- $returnurl = new moodle_url('/mod/assignment/submissions.php', array('id'=>$this->cm->id, 'userid'=>$userid, 'mode'=>$mode, 'offset'=>$offset));
- if (!$this->can_manage_responsefiles()) {
- redirect($returnurl);
- }
- $urlreturn = 'submissions.php';
- $optionsreturn = array('id'=>$this->cm->id, 'offset'=>$offset, 'mode'=>$mode, 'userid'=>$userid);
- if (!data_submitted() or !$confirm or !confirm_sesskey()) {
- $optionsyes = array ('id'=>$this->cm->id, 'file'=>$file, 'userid'=>$userid, 'confirm'=>1, 'action'=>'response', 'mode'=>$mode, 'offset'=>$offset, 'sesskey'=>sesskey());
- $PAGE->set_title(get_string('delete'));
- echo $OUTPUT->header();
- echo $OUTPUT->heading(get_string('delete'));
- echo $OUTPUT->confirm(get_string('confirmdeletefile', 'assignment', $file), new moodle_url('delete.php', $optionsyes), new moodle_url($urlreturn, $optionsreturn));
- echo $OUTPUT->footer();
- die;
- }
- if ($submission = $this->get_submission($userid)) {
- $fs = get_file_storage();
- if ($file = $fs->get_file($this->context->id, 'mod_assignment', 'response', $submission->id, '/', $file)) {
- $file->delete();
- }
- }
- redirect($returnurl);
- }
- function delete_file() {
- global $CFG, $DB, $OUTPUT, $PAGE;
- $file = required_param('file', PARAM_FILE);
- $userid = required_param('userid', PARAM_INT);
- $confirm = optional_param('confirm', 0, PARAM_BOOL);
- $mode = optional_param('mode', '', PARAM_ALPHA);
- $offset = optional_param('offset', 0, PARAM_INT);
- require_login($this->course->id, false, $this->cm);
- if (empty($mode)) {
- $urlreturn = 'view.php';
- $optionsreturn = array('id'=>$this->cm->id);
- $returnurl = new moodle_url('/mod/assignment/view.php', array('id'=>$this->cm->id));
- } else {
- $urlreturn = 'submissions.php';
- $optionsreturn = array('id'=>$this->cm->id, 'offset'=>$offset, 'mode'=>$mode, 'userid'=>$userid);
- $returnurl = new moodle_url('/mod/assignment/submissions.php', array('id'=>$this->cm->id, 'offset'=>$offset, 'userid'=>$userid));
- }
- if (!$submission = $this->get_submission($userid) // incorrect submission
- or !$this->can_delete_files($submission)) { // can not delete
- $this->view_header(get_string('delete'));
- echo $OUTPUT->notification(get_string('cannotdeletefiles', 'assignment'));
- echo $OUTPUT->continue_button($returnurl);
- $this->view_footer();
- die;
- }
- if (!data_submitted() or !$confirm or !confirm_sesskey()) {
- $optionsyes = array ('id'=>$this->cm->id, 'file'=>$file, 'userid'=>$userid, 'confirm'=>1, 'sesskey'=>sesskey(), 'mode'=>$mode, 'offset'=>$offset, 'sesskey'=>sesskey());
- if (empty($mode)) {
- $this->view_header(get_string('delete'));
- } else {
- $PAGE->set_title(get_string('delete'));
- echo $OUTPUT->header();
- }
- echo $OUTPUT->heading(get_string('delete'));
- echo $OUTPUT->confirm(get_string('confirmdeletefile', 'assignment', $file), new moodle_url('delete.php', $optionsyes), new moodle_url($urlreturn, $optionsreturn));
- if (empty($mode)) {
- $this->view_footer();
- } else {
- echo $OUTPUT->footer();
- }
- die;
- }
- $fs = get_file_storage();
- if ($file = $fs->get_file($this->context->id, 'mod_assignment', 'submission', $submission->id, '/', $file)) {
- $file->delete();
- $submission->timemodified = time();
- $DB->update_record('assignment_submissions', $submission);
- add_to_log($this->course->id, 'assignment', 'upload', //TODO: add delete action to log
- 'view.php?a='.$this->assignment->id, $this->assignment->id, $this->cm->id);
- $this->update_grade($submission);
- }
- redirect($returnurl);
- }
- function can_upload_file($submission) {
- global $USER;
- if (is_enrolled($this->context, $USER, 'mod/assignment:submit')
- and $this->isopen() // assignment not closed yet
- and (empty($submission) or ($submission->userid == $USER->id)) // his/her own submission
- and !$this->is_finalized($submission)) { // no uploading after final submission
- return true;
- } else {
- return false;
- }
- }
- function can_manage_responsefiles() {
- if (has_capability('mod/assignment:grade', $this->context)) {
- return true;
- } else {
- return false;
- }
- }
- function can_delete_files($submission) {
- global $USER;
- if (has_capability('mod/assignment:grade', $this->context)) {
- return true;
- }
- if (is_enrolled($this->context, $USER, 'mod/assignment:submit')
- and $this->isopen() // assignment not closed yet
- and $this->assignment->resubmit // deleting allowed
- and $USER->id == $submission->userid // his/her own submission
- and !$this->is_finalized($submission)) { // no deleting after final submission
- return true;
- } else {
- return false;
- }
- }
- function drafts_tracked() {
- return !empty($this->assignment->var4);
- }
- /**
- * Returns submission status
- * @param object $submission - may be empty
- * @return string submission state - empty, ASSIGNMENT_STATUS_SUBMITTED or ASSIGNMENT_STATUS_CLOSED
- */
- function is_finalized($submission) {
- if (!$this->drafts_tracked()) {
- return '';
- } else if (empty($submission)) {
- return '';
- } else if ($submission->data2 == ASSIGNMENT_STATUS_SUBMITTED or $submission->data2 == ASSIGNMENT_STATUS_CLOSED) {
- return $submission->data2;
- } else {
- return '';
- }
- }
- function can_unfinalize($submission) {
- if(is_bool($submission)) {
- return false;
- }
- if (!$this->drafts_tracked()) {
- return false;
- }
- if (has_capability('mod/assignment:grade', $this->context)
- and $this->isopen()
- and $this->is_finalized($submission)) {
- return true;
- } else {
- return false;
- }
- }
- function can_finalize($submission) {
- global $USER;
- if(is_bool($submission)) {
- return false;
- }
- if (!$this->drafts_tracked()) {
- return false;
- }
- if ($this->is_finalized($submission)) {
- return false;
- }
- if (has_capability('mod/assignment:grade', $this->context)) {
- return true;
- } else if (is_enrolled($this->context, $USER, 'mod/assignment:submit')
- and $this->isopen() // assignment not closed yet
- and !empty($submission) // submission must exist
- and $submission->userid == $USER->id // his/her own submission
- and ($this->count_user_files($submission->id)
- or ($this->notes_allowed() and !empty($submission->data1)))) { // something must be submitted
- return true;
- } else {
- return false;
- }
- }
- function can_update_notes($submission) {
- global $USER;
- if (is_enrolled($this->context, $USER, 'mod/assignment:submit')
- and $this->notes_allowed() // notesd must be allowed
- and $this->isopen() // assignment not closed yet
- and (empty($submission) or $USER->id == $submission->userid) // his/her own submission
- and !$this->is_finalized($submission)) { // no updateingafter final submission
- return true;
- } else {
- return false;
- }
- }
- function notes_allowed() {
- return (boolean)$this->assignment->var2;
- }
- function count_responsefiles($userid) {
- if ($submission = $this->get_submission($userid)) {
- $fs = get_file_storage();
- $files = $fs->get_area_files($this->context->id, 'mod_assignment', 'response', $submission->id, "id", false);
- return count($files);
- } else {
- return 0;
- }
- }
- function setup_elements(&$mform) {
- global $CFG, $COURSE;
- $ynoptions = array( 0 => get_string('no'), 1 => get_string('yes'));
- $choices = get_max_upload_sizes($CFG->maxbytes, $COURSE->maxbytes);
- $choices[0] = get_string('courseuploadlimit') . ' ('.display_size($COURSE->maxbytes).')';
- $mform->addElement('select', 'maxbytes', get_string('maximumsize', 'assignment'), $choices);
- $mform->setDefault('maxbytes', $CFG->assignment_maxbytes);
- $mform->addElement('select', 'resubmit', get_string('allowdeleting', 'assignment'), $ynoptions);
- $mform->addHelpButton('resubmit', 'allowdeleting', 'assignment');
- $mform->setDefault('resubmit', 1);
- $options = array();
- for($i = 1; $i <= 20; $i++) {
- $options[$i] = $i;
- }
- $mform->addElement('select', 'var1', get_string('allowmaxfiles', 'assignment'), $options);
- $mform->addHelpButton('var1', 'allowmaxfiles', 'assignment');
- $mform->setDefault('var1', 3);
- $mform->addElement('select', 'var2', get_string('allownotes', 'assignment'), $ynoptions);
- $mform->addHelpButton('var2', 'allownotes', 'assignment');
- $mform->setDefault('var2', 0);
- $mform->addElement('select', 'var3', get_string('hideintro', 'assignment'), $ynoptions);
- $mform->addHelpButton('var3', 'hideintro', 'assignment');
- $mform->setDefault('var3', 0);
- $mform->addElement('select', 'emailteachers', get_string('emailteachers', 'assignment'), $ynoptions);
- $mform->addHelpButton('emailteachers', 'emailteachers', 'assignment');
- $mform->setDefault('emailteachers', 0);
- $mform->addElement('select', 'var4', get_string('trackdrafts', 'assignment'), $ynoptions);
- $mform->addHelpButton('var4', 'trackdrafts', 'assignment');
- $mform->setDefault('var4', 1);
- $course_context = get_context_instance(CONTEXT_COURSE, $COURSE->id);
- plagiarism_get_form_elements_module($mform, $course_context);
- }
- function portfolio_exportable() {
- return true;
- }
- function extend_settings_navigation($node) {
- global $CFG, $USER, $OUTPUT;
- // get users submission if there is one
- $submission = $this->get_submission();
- if (is_enrolled($this->context, $USER, 'mod/assignment:submit')) {
- $editable = $this->isopen() && (!$submission || $this->assignment->resubmit || !$submission->timemarked);
- } else {
- $editable = false;
- }
- // If the user has submitted something add some related links and data
- if (isset($submission->data2) AND $submission->data2 == 'submitted') {
- // Add a view link to the settings nav
- $link = new moodle_url('/mod/assignment/view.php', array('id'=>$this->cm->id));
- $node->add(get_string('viewmysubmission', 'assignment'), $link, navigation_node::TYPE_SETTING);
- if (!empty($submission->timemodified)) {
- $submittednode = $node->add(get_string('submitted', 'assignment') . ' ' . userdate($submission->timemodified));
- $submittednode->text = preg_replace('#([^,])\s#', '$1 ', $submittednode->text);
- $submittednode->add_class('note');
- if ($submission->timemodified <= $this->assignment->timedue || empty($this->assignment->timedue)) {
- $submittednode->add_class('early');
- } else {
- $submittednode->add_class('late');
- }
- }
- }
- // Check if the user has uploaded any files, if so we can add some more stuff to the settings nav
- if ($submission && is_enrolled($this->context, $USER, 'mod/assignment:submit') && $this->count_user_files($submission->id)) {
- $fs = get_file_storage();
- if ($files = $fs->get_area_files($this->context->id, 'mod_assignment', 'submission', $submission->id, "timemodified", false)) {
- if (!$this->drafts_tracked() or !$this->isopen() or $this->is_finalized($submission)) {
- $filenode = $node->add(get_string('submission', 'assignment'));
- } else {
- $filenode = $node->add(get_string('submissiondraft', 'assignment'));
- }
- foreach ($files as $file) {
- $filename = $file->get_filename();
- $mimetype = $file->get_mimetype();
- $link = file_encode_url($CFG->wwwroot.'/pluginfile.php', '/'.$this->context->id.'/mod_assignment/submission/'.$submission->id.'/'.$filename);
- $filenode->add($filename, $link, navigation_node::TYPE_SETTING, null, null, new pix_icon(file_mimetype_icon($mimetype),''));
- }
- }
- }
- // Show a notes link if they are enabled
- if ($this->notes_allowed()) {
- $link = new moodle_url('/mod/assignment/upload.php', array('id'=>$this->cm->id, 'action'=>'editnotes', 'sesskey'=>sesskey()));
- $node->add(get_string('notes', 'assignment'), $link);
- }
- }
- /**
- * creates a zip of all assignment submissions and sends a zip to the browser
- */
- public function download_submissions() {
- global $CFG,$DB;
- require_once($CFG->libdir.'/filelib.php');
- $submissions = $this->get_submissions('','');
- if (empty($submissions)) {
- print_error('errornosubmissions', 'assignment');
- }
- $filesforzipping = array();
- $fs = get_file_storage();
- $groupmode = groups_get_activity_groupmode($this->cm);
- $groupid = 0; // All users
- $groupname = '';
- if ($groupmode) {
- $groupid = groups_get_activity_group($this->cm, true);
- $groupname = groups_get_group_name($groupid).'-';
- }
- $filename = str_replace(' ', '_', clean_filename($this->course->shortname.'-'.$this->assignment->name.'-'.$groupname.$this->assignment->id.".zip")); //name of new zip file.
- foreach ($submissions as $submission) {
- $a_userid = $submission->userid; //get userid
- if ((groups_is_member($groupid,$a_userid)or !$groupmode or !$groupid)) {
- $a_assignid = $submission->assignment; //get name of this assignment for use in the file names.
- $a_user = $DB->get_record("user", array("id"=>$a_userid),'id,username,firstname,lastname'); //get user firstname/lastname
- $files = $fs->get_area_files($this->context->id, 'mod_assignment', 'submission', $submission->id, "timemodified", false);
- foreach ($files as $file) {
- //get files new name.
- $fileext = strstr($file->get_filename(), '.');
- $fileoriginal = str_replace($fileext, '', $file->get_filename());
- $fileforzipname = clean_filename(fullname($a_user) . "_" . $fileoriginal."_".$a_userid.$fileext);
- //save file name to array for zipping.
- $filesforzipping[$fileforzipname] = $file;
- }
- }
- } // end of foreach loop
- if ($zipfile = assignment_pack_files($filesforzipping)) {
- send_temp_file($zipfile, $filename); //send file and delete after sending.
- }
- }
- }
- class mod_assignment_upload_notes_form extends moodleform {
- function get_data() {
- $data = parent::get_data();
- if ($data) {
- $data->format = $data->text['format'];
- $data->text = $data->text['text'];
- }
- return $data;
- }
- function set_data($data) {
- if (!isset($data->format)) {
- $data->format = FORMAT_HTML;
- }
- if (isset($data->text)) {
- $data->text = array('text'=>$data->text, 'format'=>$data->format);
- }
- parent::set_data($data);
- }
- function definition() {
- $mform = $this->_form;
- // visible elements
- $mform->addElement('editor', 'text', get_string('notes', 'assignment'), null, null);
- $mform->setType('text', PARAM_RAW); // to be cleaned before display
- // hidden params
- $mform->addElement('hidden', 'id', 0);
- $mform->setType('id', PARAM_INT);
- $mform->addElement('hidden', 'action', 'savenotes');
- $mform->setType('action', PARAM_ALPHA);
- // buttons
- $this->add_action_buttons();
- }
- }
- class mod_assignment_upload_response_form extends moodleform {
- function definition() {
- $mform = $this->_form;
- $instance = $this->_customdata;
- // visible elements
- $mform->addElement('filemanager', 'files_filemanager', get_string('uploadafile'), null, $instance->options);
- // hidden params
- $mform->addElement('hidden', 'id', $instance->cm->id);
- $mform->setType('id', PARAM_INT);
- $mform->addElement('hidden', 'contextid', $instance->contextid);
- $mform->setType('contextid', PARAM_INT);
- $mform->addElement('hidden', 'action', 'uploadresponse');
- $mform->setType('action', PARAM_ALPHA);
- $mform->addElement('hidden', 'mode', $instance->mode);
- $mform->setType('mode', PARAM_ALPHA);
- $mform->addElement('hidden', 'offset', $instance->offset);
- $mform->setType('offset', PARAM_INT);
- $mf…
Large files files are truncated, but you can click here to view the full file