From 8c20f75c7956a07c0995d2083a0134e46353cc42 Mon Sep 17 00:00:00 2001
From: Artem Andreev <andreev.artem@gmail.com>
Date: Thu, 10 May 2012 15:09:06 +0400
Subject: [PATCH] Added grades explanation

---
 lang/en/attforblock.php | 4 ++++
 lang/ru/attforblock.php | 5 +++++
 renderhelpers.php       | 4 +++-
 3 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/lang/en/attforblock.php b/lang/en/attforblock.php
index 33a1ad7..608e500 100644
--- a/lang/en/attforblock.php
+++ b/lang/en/attforblock.php
@@ -82,6 +82,10 @@ $string['enrolmentsuspended'] = 'Enrolment suspended';
 $string['errorgroupsnotselected'] = 'Select one or more groups';
 $string['errorinaddingsession'] = 'Error in adding session';
 $string['erroringeneratingsessions'] = 'Error in generating sessions ';
+$string['gradebookexplanation'] = 'Grade in gradebook';
+$string['gradebookexplanation_help'] = 'The Attendance module displays your current attendance grade based on the number of points you have earned to date and the number of points that could have been earned to date; it does not include class periods in the future. In the gradebook, your attendance grade is based on your current attendance percentage and the number of points that can be earned over the entire duration of the course, including future class periods. As such, your attendance grades displayed in the Attendance module and in the gradebook may not be the same number of points but they are the same percentage.
+
+For example, if you have earned 8 of 10 points to date (80% attendance) and attendance for the entire course is worth 50 points, the Attendance module will display 8/10 and the gradebook will display 40/50. You have not yet earned 40 points but 40 is the equivalent point value to your current attendance percentage of 80%. The point value you have earned in the Attendance module can never decrease, as it is based only on attendance to date; however, the attendance point value shown in the gradebook may increase or decrease depending on your future attendance, as it is based on attendance for the entire course.';
 $string['gridcolumns'] = 'Grid columns';
 $string['groupsession'] = 'Group';
 $string['hiddensessions'] = 'Hidden sessions';
diff --git a/lang/ru/attforblock.php b/lang/ru/attforblock.php
index 96ee81b..9e541aa 100644
--- a/lang/ru/attforblock.php
+++ b/lang/ru/attforblock.php
@@ -69,6 +69,11 @@ $string['enrolmentsuspended'] = 'Подписка на курс приостан
 $string['errorgroupsnotselected'] = 'Выберите одну или более групп';
 $string['errorinaddingsession'] = 'Ошибка при добавлении занятия';
 $string['erroringeneratingsessions'] = 'Ошибка при создании занятий';
+$string['gradebookexplanation'] = 'Оценка в журнале оценок';
+$string['gradebookexplanation_help'] = 'Ваша оценка в модуле «Посещаемость» рассчитывается как отношение количества баллов, полученных за посещаемость, к максимальному количеству баллов, которые вы могли получить за посещаемость к текущей дате. В журнале оценок ваша оценка основывается на проценте баллов, полученных за посещаемость, и максимальном количестве баллов, которые вы можете получить за посещаемость в журнале оценок. Таким образом, оценки, отображаемые в модуле «Посещаемость» и в журнале оценок могут различаться.
+    
+Например, если вы на текущий момент заработали 8 баллов из 10 (80% посещаемости) и максимальный балл за посещаемость в журнале оценок – 50, то в модуле «Посещаемость» отобразится оценка «8/10», а в журнале оценок «40/50». Вы еще не заработали 40 баллов, но на данный момент ваш процент посещаемости соответствует этим баллам. Ваши баллы в модуле «Посещаемость» никогда не могут уменьшаться, т.к. они зависят только от посещаемости на текущую дату. Но оценка в журнале оценок может увеличиваться и уменьшаться, в зависимости от вашей будущей успеваемости, т.к. эта оценка зависит от посещаемости во всем курсе.
+';
 $string['groupsession'] = 'Групповое';
 $string['hiddensessions'] = 'Скрытых занятий';
 $string['hiddensessions_help'] = '
diff --git a/renderhelpers.php b/renderhelpers.php
index 4fa0dc2..3616365 100644
--- a/renderhelpers.php
+++ b/renderhelpers.php
@@ -174,6 +174,8 @@ function construct_session_full_date_time($datetime, $duration) {
 }
 
 function construct_user_data_stat($stat, $statuses, $gradable, $grade, $maxgrade, $decimalpoints) {
+    global $OUTPUT;
+    
     $stattable = new html_table();
     $stattable->attributes['class'] = 'attlist';
     $row = new html_table_row();
@@ -191,7 +193,7 @@ function construct_user_data_stat($stat, $statuses, $gradable, $grade, $maxgrade
 
     if ($gradable) {
         $row = new html_table_row();
-        $row->cells[] = get_string('attendancegrade','attforblock') . ':';
+        $row->cells[] = get_string('attendancegrade','attforblock') . $OUTPUT->help_icon('gradebookexplanation', 'attforblock') . ':';
         $row->cells[] = $grade . ' / ' . $maxgrade;
         $stattable->data[] = $row;