From: nicolasconnault <nicolasconnault>
Date: Fri, 8 May 2009 06:30:46 +0000 (+0000)
Subject: MDL-16416 Created a new help file including explanations of extra credit for both... 
X-Git-Url: http://git.mjollnir.org/gw?a=commitdiff_plain;h=e3efd04c1e0471b17af9f1b2d6128f0a6928c604;p=moodle.git

MDL-16416 Created a new help file including explanations of extra credit for both "Sum of Grades" and "Mean with extra credit" aggregation types. This is used on the "Edit categories and items" page. Merging from MOODLE_19_STABLE
---

diff --git a/grade/edit/tree/lib.php b/grade/edit/tree/lib.php
index 4f453b527b..b86f0fa7ee 100755
--- a/grade/edit/tree/lib.php
+++ b/grade/edit/tree/lib.php
@@ -593,7 +593,7 @@ class grade_edit_tree_column_aggregation extends grade_edit_tree_column_category
 class grade_edit_tree_column_extracredit extends grade_edit_tree_column {
 
     public function get_header_cell() {
-        return '<th class="header" scope="col">'.get_string('extracredit', 'grades').helpbutton('aggregationcoefextra', 'aggregationcoefextra', 'grade', true, false, '', true).'</th>';
+        return '<th class="header" scope="col">'.get_string('extracredit', 'grades').helpbutton('aggregationcoefcombo', 'aggregationcoefcombo', 'grade', true, false, '', true).'</th>';
     }
 
     public function get_category_cell($category, $levelclass, $params) {
diff --git a/lang/en_utf8/help/grade/aggregationcoefcombo.html b/lang/en_utf8/help/grade/aggregationcoefcombo.html
new file mode 100644
index 0000000000..51deddbb76
--- /dev/null
+++ b/lang/en_utf8/help/grade/aggregationcoefcombo.html
@@ -0,0 +1,25 @@
+<h1>Extra credit</h1>
+<h2>For Sum of Grades aggregation</h2>
+<p>When the "Sum of grades" aggregation strategy is used, a grade item can act as Extra credit for the category. This means that the grade item's maximum grade will not be added to the category total's maximum grade, but the item's grade will. Following is an example:</p>
+
+<ul>
+    <li>Item 1 is graded 0-100</li>
+    <li>Item 2 is graded 0-75</li>
+    <li>Item 1 has the "Act as extra credit" checkbox ticked, Item 2 doesn't.</li>
+    <li>Both items belong to Category 1, which has "Sum of grades" as its aggregation strategy</li>
+    <li>Category 1's total will be graded 0-75</li>
+    <li>A student gets graded 20 on Item 1 and 70 on Item 2</li>
+    <li>The student's total for Category 1 will be 75/75 (20+70 = 90 but Item 1 only acts as extra credit, so it brings the total to its maximum)</li>
+</ul>
+<h2>For Weighted Mean of Grades (extra credit)</h2>
+<p>A value greater than 0 treats this grade item's grades as Extra credit during aggregation. The number is a factor by which the grade value will be multiplied before it is added to the sum of all grades, but the item itself will not be counted in the division. For example:</p>
+
+<ul>
+    <li>Item 1 is graded 0-100 and its "Extra credit" value is set to 2</li>
+    <li>Item 2 is graded 0-100 and its "Extra credit" value is left at 0.0000</li>
+    <li>Item 3 is graded 0-100 and its "Extra credit" value is left at 0.0000</li>
+    <li>All 3 items belong to Category 1, which has "Mean of grades (with extra credits)" as its aggregation strategy</li>
+    <li>A student gets graded 20 on Item 1, 40 on Item 2 and 70 on Item 3</li>
+    <li>The student's total for Category 1 will be 95/100 since 20*2 + (40 + 70)/2 = 95</li>
+</ul>
+