Attendance: #add option to show official code in attendance table, pdf and xls export - refs BT#22320

Author: NicoDucou

main/attendance/attendance_controller.php

@@ -649,7 +649,12 @@ public function attendance_sheet_export_to_pdf(
 
         // Get data table
         $data_table = [];
-        $head_table = ['#', get_lang('Name')];
+        $addOfficialCode = api_get_configuration_value('attendance_add_official_code');
+        if ($addOfficialCode) {
+            $head_table = ['#', get_lang('OfficialCode'), get_lang('Name')];
+        } else {
+            $head_table = ['#', get_lang('Name')];
+        }
         foreach ($data_array['attendant_calendar'] as $class_day) {
             $labelDuration = !empty($class_day['duration']) ? get_lang('Duration').' : '.$class_day['duration'] : '';
             $head_table[] =
@@ -667,6 +672,9 @@ public function attendance_sheet_export_to_pdf(
                 $cols = 1;
                 $result = [];
                 $result['count'] = $count;
+                if ($addOfficialCode) {
+                    $result['official_code'] = $user['official_code'];
+                }
                 $result['full_name'] = api_get_person_name($user['firstname'], $user['lastname']);
                 foreach ($data_array['attendant_calendar'] as $class_day) {
                     if ($class_day['done_attendance'] == 1) {

main/attendance/attendance_sheet.php

@@ -210,6 +210,12 @@ function UpdateTableHeaders() {
             });
         </script>
 
+        <?php $addOfficialCode = api_get_configuration_value('attendance_add_official_code');
+        $headerOfficialCode = '';
+        if ($addOfficialCode) {
+            $headerOfficialCode = '<th width="100px">'. get_lang('OfficialCode') . '</th>';
+        }
+        ?>
         <form method="post" action="index.php?action=attendance_sheet_add&<?php echo api_get_cidreq().$param_filter; ?>&attendance_id=<?php echo $attendance_id; ?>" >
             <div class="attendance-sheet-content" style="width:100%;background-color:#E1E1E1;margin-top:20px;">
                 <div class="divTableWithFloatingHeader attendance-users-table" style="width:45%;float:left;margin:0px;padding:0px;">
@@ -218,13 +224,15 @@ function UpdateTableHeaders() {
                         <tr class="tableFloatingHeader" style="position: absolute; top: 0px; left: 0px; visibility: hidden; margin:0px;padding:0px" >
                             <th width="10px"><?php echo '#'; ?></th>
                             <th width="10px"><?php echo get_lang('Photo'); ?></th>
+                            <?php echo $headerOfficialCode ?>
                             <th width="100px"><?php echo get_lang('LastName'); ?></th>
                             <th width="100px"><?php echo get_lang('FirstName'); ?></th>
                             <th width="100px"><?php echo get_lang('AttendancesFaults'); ?></th>
                         </tr>
                         <tr class="tableFloatingHeaderOriginal" >
                             <th width="10px"><?php echo '#'; ?></th>
                             <th width="10px"><?php echo get_lang('Photo'); ?></th>
+                            <?php echo $headerOfficialCode ?>
                             <th width="150px"><?php echo get_lang('LastName'); ?></th>
                             <th width="140px"><?php echo get_lang('FirstName'); ?></th>
                             <th width="100px"><?php echo get_lang('AttendancesFaults'); ?></th>
@@ -248,6 +256,9 @@ function UpdateTableHeaders() {
                             <tr class="<?php echo $class; ?>">
                                 <td><center><?php echo $i; ?></center></td>
                                 <td><?php echo $data['photo']; ?></td>
+                                <?php if ($addOfficialCode) {
+                                    echo '<td>' . $data['official_code'] . '</td>';
+                                } ?>
                                 <td><span title="<?php echo $username; ?>"><?php echo $data['lastname']; ?></span></td>
                                 <td><?php echo $data['firstname']; ?></td>
                                 <td>

main/inc/lib/attendance.lib.php

@@ -776,6 +776,10 @@ public function get_users_rel_course($attendanceId = 0, $groupId = 0)
             );
 
             $value['photo'] = $photo;
+            $addOfficialCode = api_get_configuration_value('attendance_add_official_code');
+            if ($addOfficialCode) {
+                $value['official_code'] = $user_data['official_code'];
+            }
             $value['firstname'] = $user_data['firstname'];
             $value['lastname'] = $user_data['lastname'];
             $value['username'] = $user_data['username'];
@@ -2723,7 +2727,12 @@ public function exportAttendanceSheetToXls(
 
         // Get data table
         $dataTable = [];
-        $headTable = ['#', get_lang('Name')];
+        $addOfficialCode = api_get_configuration_value('attendance_add_official_code');
+        if ($addOfficialCode) {
+            $headTable = ['#', get_lang('OfficialCode'), get_lang('Name')];
+        } else {
+            $headTable = ['#', get_lang('Name')];
+        }
         foreach ($calendar as $classDay) {
             $labelDuration = !empty($classDay['duration']) ? get_lang('Duration').' : '.$classDay['duration'] : '';
             $headTable[] =
@@ -2740,6 +2749,9 @@ public function exportAttendanceSheetToXls(
                 $cols = 1;
                 $result = [];
                 $result['count'] = $count;
+                if ($addOfficialCode) {
+                    $result['official_code'] = $user['official_code'];
+                }
                 $result['full_name'] = api_get_person_name($user['firstname'], $user['lastname']);
                 foreach ($calendar as $classDay) {
                     $commentInfo = $this->getComment($user['user_id'], $classDay['id']);

main/install/configuration.dist.php

@@ -2507,6 +2507,9 @@
 // Then add the "@" symbol to CAttendanceResultComment class in the ORM\Entity() line.
 //$_configuration['attendance_allow_comments'] = false;
 
+// Add the official code of students in the attendance table, pdf and xls export
+//$_configuration['attendance_add_official_code'] = false;
+
 // Enable categories in Wiki tool.
 // 1. Run the following DB changes:
 /*