WebSVN – Moodle – Diff – /grade/lib.php

 require_once($CFG->libdir . '/gradelib.php');
 require_once($CFG->dirroot . '/grade/export/lib.php');
 use \core_grades\output\action_bar;
+use \core_grades\output\general_action_bar;
-use \core_grades\output\general_action_bar;
+use \core\output\single_select;
 /**
  * This class iterates over all users that are graded in a course.
  * @param int    $userid   id of the currently selected user (or 'all' if they are all selected)
  * @param int    $groupid id of requested group, 0 means all
  * @param int    $includeall bool include all option
  * @param bool   $return If true, will return the HTML, otherwise, will print directly
  * @return null
+ * @todo Final deprecation on Moodle 6.0. See MDL-84680.
  */
+#[\core\attribute\deprecated('grade_get_graded_users_select()', since: '5.0', mdl: 'MDL-84673')]
 function print_graded_users_selector($course, $actionpage, $userid=0, $groupid=0, $includeall=true, $return=false) {
+    \core\deprecation::emit_deprecation(__FUNCTION__);
-    global $CFG, $USER, $OUTPUT;
+    global $OUTPUT;
     return $OUTPUT->render(grade_get_graded_users_select(substr($actionpage, 0, strpos($actionpage, '/')), $course, $userid, $groupid, $includeall));
+}
+/**
+ * Return a selection popup form of the graded users in a course.
+ *
+ * @param string $report name of the report
+ * @param int    $course id of the course
+ * @param int    $userid id of the currently selected user (or 'all' if they are all selected)
+ * @param int    $groupid id of requested group, 0 means all
+ * @param bool   $includeall bool include all option
+ * @return single_select
  */
 function grade_get_graded_users_select($report, $course, $userid, $groupid, $includeall) {
     global $USER, $CFG;
         $output = $renderer->user_heading($user, $courseid, $showuserbuttons);
     } else if (!empty($heading)) {
         $output = $OUTPUT->heading($heading);
+    }
+    // If any grade penalty plugins are enabled, notify the user that grade penalties will not be applied to imported grades.
+    if ($active_type === 'import') {
+        foreach (core_plugin_manager::instance()->get_plugins_of_type('gradepenalty') as $plugin) {
+            if ($plugin->is_enabled()) {
+                $output .= $OUTPUT->notification(
+                    get_string('gradepenalties', 'gradeimport_csv'),
+                    \core\output\notification::NOTIFY_INFO,
+                    false,
+                );
+                break;
+            }
+        }
+    }
     if ($return) {
         $returnval .= $output;
     } else {
         echo $output;
      * 1D array of grade items only
      */
     public $items;
-    /**
-     * Returns icon of element
-     *
-     * @param array &$element An array representing an element in the grade_tree
-     * @param bool  $spacerifnone return spacer if no icon found
-     *
-     * @return string icon or spacer
+    /**
-     * @deprecated since Moodle 4.4 - please use {@see grade_helper::get_element_icon()}
-     * @todo MDL-79907 This will be deleted in Moodle 4.8.
+     * @deprecated since Moodle 4.4 - please use {@see grade_helper::get_element_icon()}
-     */
-    public function get_element_icon(&$element, $spacerifnone=false) {
+     */
-        debugging('The function get_element_icon() is deprecated, please use grade_helper::get_element_icon() instead.',
+    #[\core\attribute\deprecated('grade_helper::get_element_icon', since: '4.4', mdl: 'MDL-77326', final: true)]
-            DEBUG_DEVELOPER);
+    public function get_element_icon(): void {
-        return grade_helper::get_element_icon($element, $spacerifnone);
+        \core\deprecation::emit_deprecation([self::class, __FUNCTION__]);
+    }
-    /**
-     * Returns the string that describes the type of the element.
-     *
      * @param array $element An array representing an element in the grade_tree
-     * @return string The string that describes the type of the grade element
-     * @deprecated since Moodle 4.4 - please use {@see grade_helper::get_element_type_string()}
+    /**
-     * @todo MDL-79907 This will be deleted in Moodle 4.8.
+     * @deprecated since Moodle 4.4 - please use {@see grade_helper::get_element_type_string()}
      */
-    public function get_element_type_string(array $element): string {
-        debugging('The function get_element_type_string() is deprecated,' .
-            ' please use grade_helper::get_element_type_string() instead.',
+    #[\core\attribute\deprecated('grade_helper::get_element_type_string', since: '4.4', mdl: 'MDL-77326', final: true)]
-            DEBUG_DEVELOPER);
+    public function get_element_type_string(): void {
-        return grade_helper::get_element_type_string($element);
+        \core\deprecation::emit_deprecation([self::class, __FUNCTION__]);
-    }
-    /**
-     * Returns name of element optionally with icon and link
-     *
-     * @param array &$element An array representing an element in the grade_tree
-     * @param bool  $withlink Whether or not this header has a link
-     * @param bool  $icon Whether or not to display an icon with this header
-     * @param bool  $spacerifnone return spacer if no icon found
-     * @param bool  $withdescription Show description if defined by this item.
-     * @param bool  $fulltotal If the item is a category total, returns $categoryname."total"
-     *                         instead of "Category total" or "Course total"
      * @param moodle_url|null $sortlink Link to sort column.
-     *
      * @return string header
-     * @deprecated since Moodle 4.4 - please use {@see grade_helper::get_element_header()}
+    /**
-     * @todo MDL-79907 This will be deleted in Moodle 4.8.
-     */
+     * @deprecated since Moodle 4.4 - please use {@see grade_helper::get_element_header()}
-    public function get_element_header(array &$element, bool $withlink = false, bool $icon = true,
-            bool $spacerifnone = false, bool $withdescription = false, bool $fulltotal = false,
-            ?moodle_url $sortlink = null) {
+     */
-        debugging('The function get_element_header() is deprecated, please use grade_helper::get_element_header() instead.',
-            DEBUG_DEVELOPER);
+    #[\core\attribute\deprecated('grade_helper::get_element_header', since: '4.4', mdl: 'MDL-77326', final: true)]
-        return grade_helper::get_element_header($element, $withlink, $icon, $spacerifnone, $withdescription,
+    public function get_element_header(): void {
-            $fulltotal, $sortlink);
+        \core\deprecation::emit_deprecation([self::class, __FUNCTION__]);
-    }
+    }
     /**
-     * @deprecated since Moodle 4.4 - please use {@see grade_helper::get_activity_link()}
-     * @todo MDL-79907 This will be deleted in Moodle 4.8.
-     */
+     * @deprecated since Moodle 4.4 - please use {@see grade_helper::get_activity_link()}
-    private function get_activity_link($element) {
+     */
-        debugging('The function get_activity_link() is deprecated, please use grade_helper::get_activity_link() instead.',
+    #[\core\attribute\deprecated('grade_helper::get_activity_link', since: '4.4', mdl: 'MDL-77326', final: true)]
-            DEBUG_DEVELOPER);
+    private function get_activity_link(): void {
-        return grade_helper::get_activity_link($element);
+        \core\deprecation::emit_deprecation([self::class, __FUNCTION__]);
+        }
         if ($menuitems) {
             $menu = new action_menu($menuitems);
             $icon = $OUTPUT->pix_icon('i/moremenu', get_string('actions'));
-            $extraclasses = 'btn btn-link btn-icon icon-size-3 d-flex align-items-center justify-content-center no-caret';
+            $extraclasses = 'btn btn-link btn-icon d-flex no-caret';
             $menu->set_menu_trigger($icon, $extraclasses);
             $menu->set_menu_left();
         global $USER, $CFG, $COURSE, $DB;
         $this->courseid   = $courseid;
         $this->levels     = array();
+        $this->context    = context_course::instance($courseid);
-        $this->context    = context_course::instance($courseid);
+        $this->items      = [];
         if (!empty($COURSE->id) && $COURSE->id == $this->courseid) {
             $course = $COURSE;
      * @var array
      */
     protected static $aggregationstrings = null;
-    /**
-     * Cached grade tree plugin strings
-     * @var array
-     */
-    protected static $langstrings = [];
-    /**
-     * First checks the cached language strings, then returns match if found, or uses get_string()
-     * to get it from the DB, caches it then returns it.
     /**
-     * @deprecated since 4.3
-     * @todo MDL-78780 This will be deleted in Moodle 4.7.
-     * @param string $strcode
-     * @param string|null $section Optional language section
-     * @return string
+     * @deprecated since 4.3
      */
-    public static function get_lang_string(string $strcode, ?string $section = null): string {
-        debugging('grade_helper::get_lang_string() is deprecated, please use' .
-            ' get_string() instead.', DEBUG_DEVELOPER);
+    #[\core\attribute\deprecated('get_string', since: '4.3', mdl: 'MDL-78561', final: true)]
-        if (empty(self::$langstrings[$strcode])) {
+    public static function get_lang_string(): void {
-            self::$langstrings[$strcode] = get_string($strcode, $section);
-        }
-        return self::$langstrings[$strcode];
+        \core\deprecation::emit_deprecation([self::class, __FUNCTION__]);
+    }
     /**

Proyectos de Subversion Moodle

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