WebSVN – Moodle – Diff – /mod/feedback/lib.php

  * @package mod_feedback
  * @copyright Andreas Grabs
  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  */
+use mod_feedback\manager;
 defined('MOODLE_INTERNAL') || die();
 function feedback_cron () {
     return true;
+}
-/**
- * @deprecated since Moodle 3.8
- */
-function feedback_scale_used() {
-    throw new coding_exception('feedback_scale_used() can not be used anymore. Plugins can implement ' .
-        '<modname>_scale_used_anywhere, all implementations of <modname>_scale_used are now ignored');
-}
 /**
  * Checks if scale is being used by any instance of feedback
+ *
  * This is used to find out if scale used anywhere
  * @param $scaleid int
  * @return array status array
  */
 function feedback_reset_userdata($data) {
     global $CFG, $DB;
-    $resetfeedbacks = array();
+    $resetfeedbacks = [];
-    $dropfeedbacks = array();
+    $dropfeedbacks = [];
-    $status = array();
+    $status = [];
     $componentstr = get_string('modulenameplural', 'feedback');
-    //get the relevant entries from $data
+    // Get the relevant entries from $data.
     foreach ($data as $key => $value) {
         switch(true) {
             case substr($key, 0, strlen(FEEDBACK_RESETFORM_RESET)) == FEEDBACK_RESETFORM_RESET:
+                }
             break;
+        }
+    }
-    //reset the selected feedbacks
+    // Reset the selected feedbacks.
     foreach ($resetfeedbacks as $id) {
-        $feedback = $DB->get_record('feedback', array('id'=>$id));
+        $feedback = $DB->get_record('feedback', ['id' => $id]);
+        feedback_delete_all_completeds($feedback);
-        feedback_delete_all_completeds($feedback);
+        $status[] = [
-        $status[] = array('component'=>$componentstr.':'.$feedback->name,
+            'component' => $componentstr.':'.$feedback->name,
-                        'item'=>get_string('resetting_data', 'feedback'),
+            'item' => get_string('resetting_data', 'feedback'),
+            'error' => false,
-                        'error'=>false);
+        ];
+    }
     // Updating dates - shift may be negative too.
     if ($data->timeshift) {
         // Any changes to the list of dates that needs to be rolled should be same during course restore and course reset.
+        // See MDL-9367.
+        $shifterror = !shift_course_mod_dates('feedback', ['timeopen', 'timeclose'], $data->timeshift, $data->courseid);
-        // See MDL-9367.
+        $status[] = [
+            'component' => $componentstr,
+            'item' => get_string('date'),
-        $shifterror = !shift_course_mod_dates('feedback', array('timeopen', 'timeclose'), $data->timeshift, $data->courseid);
+            'error' => $shifterror,
-        $status[] = array('component' => $componentstr, 'item' => get_string('datechanged'), 'error' => $shifterror);
+        ];
+    }
     if (!$feedbacks = $DB->get_records('feedback', array('course'=>$COURSE->id), 'name')) {
         return;
     }
-    $mform->addElement('static', 'hint', get_string('resetting_data', 'feedback'));
+    $mform->addElement('static', 'hint', get_string('resetting_delete', 'feedback'));
     foreach ($feedbacks as $feedback) {
         $mform->addElement('checkbox', FEEDBACK_RESETFORM_RESET.$feedback->id, $feedback->name);
  */
 function feedback_reset_course_form($course) {
     global $DB, $OUTPUT;
     echo get_string('resetting_feedbacks', 'feedback'); echo ':<br />';
-    if (!$feedbacks = $DB->get_records('feedback', array('course'=>$course->id), 'name')) {
+    if (!$feedbacks = $DB->get_records('feedback', ['course' => $course->id], 'name')) {
         return;
+    }
 ////////////////////////////////////////////////
 //functions to handle capabilities
 ////////////////////////////////////////////////
-/**
- * @deprecated since 3.1
- */
-function feedback_get_context() {
-    throw new coding_exception('feedback_get_context() can not be used anymore.');
-}
-/**
- *  returns true if the current role is faked by switching role feature
- *
- * @global object
- * @return boolean
- */
-function feedback_check_is_switchrole() {
-    global $USER;
-    if (isset($USER->switchrole) AND
-            is_array($USER->switchrole) AND
-            count($USER->switchrole) > 0) {
-        return true;
-    }
-    return false;
-}
 /**
  * count users which have not completed the feedback
+ *
  * @global object
  * @uses CONTEXT_MODULE
                                             '',
                                             '',
                                             $group,
                                             '',
                                             true)) {
-        return false;
+        return [];
+    }
     // Filter users that are not in the correct group/grouping.
     $info = new \core_availability\info_module($cm);
     $allusersrecords = $info->filter_user_list($allusers);
  * @return object the userrecords
  */
 function feedback_get_complete_users($cm,
                                      $group = false,
                                      $where = '',
-                                     array $params = null,
+                                     ?array $params = null,
                                      $sort = '',
                                      $startpage = false,
                                      $pagecount = false) {
  * get users which have the receivemail-capability
+ *
  * @uses CONTEXT_MODULE
  * @param int $cmid
  * @param mixed $groups single groupid or array of groupids - group(s) user is in
- * @return object the userrecords
+ * @return stdClass[] the userrecords
  */
 function feedback_get_receivemail_users($cmid, $groups = false) {
     $context = context_module::instance($cmid);
-    //description of the call below:
-    //get_users_by_capability($context, $capability, $fields='', $sort='', $limitfrom='',
-    //                          $limitnum='', $groups='', $exceptions='', $doanything=true)
-    return get_users_by_capability($context,
+    $allusers = get_users_by_capability($context,
                             'mod/feedback:receivemail',
                             '',
                             'lastname',
                             '',
                             '',
                             $groups,
                             '',
+                            false);
+    if (empty($groups)) {
+        // Here the user that has submitted the feedback is not in any group.
+        [$course, $cm]  = get_course_and_cm_from_cmid($cmid);
+        $groupmode = groups_get_activity_groupmode($cm, $course);
+        if ($groupmode == SEPARATEGROUPS) {
+            // In separate group mode, only the user who can see all groups can see the feedback, so
+            // in turn can receive the notification.
+            $viewallgroupsusers = get_users_by_capability(
+                $context,
+                'moodle/site:accessallgroups',
+                'u.id, u.id'
+            );
+            // Remove users cannot access all groups.
+            $allusers = array_intersect_key($allusers, $viewallgroupsusers);
+        }
+    }
-                            false);
+    return $allusers;
+}
 ////////////////////////////////////////////////
+    }
     return $dependitems;
+}
-/**
- * @deprecated since 3.1
- */
-function feedback_create_item() {
-    throw new coding_exception('feedback_create_item() can not be used anymore.');
-}
 /**
  * save the changes of a given item.
+ *
  * @global object
  * @param object $item
+    }
     return false;
+}
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_print_item_preview() {
-    throw new coding_exception('feedback_print_item_preview() can not be used anymore. '
-            . 'Items must implement complete_form_element().');
-}
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_print_item_complete() {
-    throw new coding_exception('feedback_print_item_complete() can not be used anymore. '
-        . 'Items must implement complete_form_element().');
-}
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_print_item_show_value() {
-    throw new coding_exception('feedback_print_item_show_value() can not be used anymore. '
-        . 'Items must implement complete_form_element().');
-}
 /**
  * if the user completes a feedback and there is a pagebreak so the values are saved temporary.
  * the values are not saved permanently until the user click on save button
+ *
  * @global object
     $event->trigger();
     return $feedbackcompleted->id;
-}
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_delete_completedtmp() {
-    throw new coding_exception('feedback_delete_completedtmp() can not be used anymore.');
+}
 ////////////////////////////////////////////////
 ////////////////////////////////////////////////
 ////////////////////////////////////////////////
  * @return int|false false if there already is a pagebreak on last position or the id of the pagebreak-item
  */
 function feedback_create_pagebreak($feedbackid) {
     global $DB;
-    //check if there already is a pagebreak on the last position
+    // Disallow pagebreak if there's already one present in last position, or the feedback has no items.
     $lastposition = $DB->count_records('feedback_item', array('feedback'=>$feedbackid));
     if ($lastposition == feedback_get_last_break_position($feedbackid)) {
         return false;
         return false;
+    }
     return $allbreaks[count($allbreaks) - 1];
+}
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_get_page_to_continue() {
-    throw new coding_exception('feedback_get_page_to_continue() can not be used anymore.');
-}
 ////////////////////////////////////////////////
 ////////////////////////////////////////////////
 ////////////////////////////////////////////////
 //functions to handle the values
-////////////////////////////////////////////////
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_clean_input_value() {
-    throw new coding_exception('feedback_clean_input_value() can not be used anymore. '
-        . 'Items must implement complete_form_element().');
-}
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_save_values() {
-    throw new coding_exception('feedback_save_values() can not be used anymore.');
-}
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_save_guest_values() {
-    throw new coding_exception('feedback_save_guest_values() can not be used anymore.');
+////////////////////////////////////////////////
 /**
     $itemobj = feedback_get_item_class($item->typ);
     return $itemobj->compare_value($item, $dbvalue, $dependvalue); //true or false
+}
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_check_values() {
-    throw new coding_exception('feedback_check_values() can not be used anymore. '
-        . 'Items must implement complete_form_element().');
-}
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_create_values() {
-    throw new coding_exception('feedback_create_values() can not be used anymore.');
-}
-/**
- * @deprecated since Moodle 3.1
- */
-function feedback_update_values() {
-    throw new coding_exception('feedback_update_values() can not be used anymore.');
-}
 /**
  * get the values of an item depending on the given groupid.
  * if the feedback is anonymous so the values are shuffled
+ *
  * @global object
+    }
     return $DB->record_exists('feedback_completed', $params);
+}
-/**
- * @deprecated since Moodle 3.1. Use feedback_get_current_completed_tmp() or feedback_get_last_completed.
- */
-function feedback_get_current_completed() {
-    throw new coding_exception('feedback_get_current_completed() can not be used anymore. Please ' .
-            'use either feedback_get_current_completed_tmp() or feedback_get_last_completed()');
-}
 /**
  * get the completeds depending on the given groupid.
+ *
  * @global object
  * @global object
 ////////////////////////////////////////////////
 //functions to handle sitecourse mapping
 ////////////////////////////////////////////////
-/**
- * @deprecated since 3.1
- */
-function feedback_is_course_in_sitecourse_map() {
-    throw new coding_exception('feedback_is_course_in_sitecourse_map() can not be used anymore.');
-}
-/**
- * @deprecated since 3.1
- */
-function feedback_is_feedback_in_sitecourse_map() {
-    throw new coding_exception('feedback_is_feedback_in_sitecourse_map() can not be used anymore.');
-}
 /**
  * gets the feedbacks from table feedback_sitecourse_map.
  * this is used to show the global feedbacks on the feedback block
  * all feedbacks with the following criteria will be selected:<br />
+ *
         $DB->delete_records('feedback_sitecourse_map', array('feedbackid' => $feedback->id, 'courseid' => $courseid));
+    }
     // TODO MDL-53574 add events.
+}
-/**
- * @deprecated since 3.1
- */
-function feedback_clean_up_sitecourse_map() {
-    throw new coding_exception('feedback_clean_up_sitecourse_map() can not be used anymore.');
-}
 ////////////////////////////////////////////////
 ////////////////////////////////////////////////
 ////////////////////////////////////////////////
 //not relatable functions
-////////////////////////////////////////////////
-/**
- * @deprecated since 3.1
- */
-function feedback_print_numeric_option_list() {
-    throw new coding_exception('feedback_print_numeric_option_list() can not be used anymore.');
+////////////////////////////////////////////////
 /**
     if (!$context = context_module::instance($settings->get_page()->cm->id, IGNORE_MISSING)) {
         throw new \moodle_exception('badcontext');
+    }
     if (has_capability('mod/feedback:edititems', $context)) {
+        $feedbacknode->add(get_string('questions', 'feedback'),
-        $questionnode = $feedbacknode->add(get_string('questions', 'feedback'), null,
+            new moodle_url('/mod/feedback/edit.php', ['id' => $settings->get_page()->cm->id]),
-            navigation_node::TYPE_CUSTOM, null, 'questionnode');
-        $questionnode->add(get_string('edit_items', 'feedback'),
-            new moodle_url('/mod/feedback/edit.php', ['id' => $settings->get_page()->cm->id]));
-        $questionnode->add(get_string('export_questions', 'feedback'),
-            new moodle_url('/mod/feedback/export.php', ['id' => $settings->get_page()->cm->id, 'action' => 'exportfile']));
-        $questionnode->add(get_string('import_questions', 'feedback'),
-            new moodle_url('/mod/feedback/import.php', ['id' => $settings->get_page()->cm->id]));
+            navigation_node::TYPE_CUSTOM, null, 'questionnode');
         $feedbacknode->add(get_string('templates', 'feedback'),
-            new moodle_url('/mod/feedback/manage_templates.php', ['id' => $settings->get_page()->cm->id, 'mode' => 'manage']),
+            new moodle_url('/mod/feedback/manage_templates.php', ['id' => $settings->get_page()->cm->id]),
             navigation_node::TYPE_CUSTOM, null, 'templatenode');
+    }
             new moodle_url('/mod/feedback/analysis.php', ['id' => $settings->get_page()->cm->id]),
             navigation_node::TYPE_CUSTOM, null, 'feedbackanalysis');
+    }
+    if (has_capability('mod/feedback:viewreports', $context)) {
-    if (has_capability('mod/feedback:viewreports', $context)) {
+        if (manager::can_see_others_in_groups($settings->get_page()->cm)) {
-        $feedbacknode->add_node($analysisnode);
+            $feedbacknode->add_node($analysisnode);
-        $feedbacknode->add(get_string(($hassecondary ? 'responses' : 'show_entries'), 'feedback'),
+            $feedbacknode->add(get_string(($hassecondary ? 'responses' : 'show_entries'), 'feedback'),
-            new moodle_url('/mod/feedback/show_entries.php', ['id' => $settings->get_page()->cm->id]),
+                new moodle_url('/mod/feedback/show_entries.php', ['id' => $settings->get_page()->cm->id]),
+                navigation_node::TYPE_CUSTOM, null, 'responses');
             navigation_node::TYPE_CUSTOM, null, 'responses');
     } else {
         $feedbackcompletion = new mod_feedback_completion($feedback, $context, $settings->get_page()->course->id);
         if ($feedbackcompletion->can_view_analysis()) {
             $feedbacknode->add_node($analysisnode);
     return $module_pagetype;
+}
 /**
  * Move save the items of the given $feedback in the order of $itemlist.
- * @param string $itemlist a comma separated list with item ids
+ * @param array $itemlist a list with item ids
  * @param stdClass $feedback
  * @return bool true if success
  */
 function feedback_ajax_saveitemorder($itemlist, $feedback) {
 /**
  * Get icon mapping for font-awesome.
  */
 function mod_feedback_get_fontawesome_icon_map() {
     return [
-        'mod_feedback:required' => 'fa-exclamation-circle',
+        'mod_feedback:notrequired' => 'fa-circle-question',
-        'mod_feedback:notrequired' => 'fa-question-circle-o',
+        'mod_feedback:required' => 'fa-circle-exclamation',
     ];
+}
 /**

Proyectos de Subversion Moodle

(root)/mod/feedback/lib.php – Rev 1 → 1441