// swad_attendance.c: control of attendance /* SWAD (Shared Workspace At a Distance), is a web platform developed at the University of Granada (Spain), and used to support university teaching. This file is part of SWAD core. Copyright (C) 1999-2017 Antonio Caņas Vargas This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see . */ /*****************************************************************************/ /********************************** Headers **********************************/ /*****************************************************************************/ #include // For PATH_MAX #include // For NULL #include // To access MySQL databases #include // For calloc #include // For string functions #include "swad_attendance.h" #include "swad_database.h" #include "swad_global.h" #include "swad_group.h" #include "swad_ID.h" #include "swad_pagination.h" #include "swad_parameter.h" #include "swad_photo.h" #include "swad_QR.h" /*****************************************************************************/ /*************** External global variables from others modules ***************/ /*****************************************************************************/ extern struct Globals Gbl; /*****************************************************************************/ /****************************** Private constants ****************************/ /*****************************************************************************/ /*****************************************************************************/ /******************************** Private types ******************************/ /*****************************************************************************/ typedef enum { Att_NORMAL_VIEW_ONLY_ME, Att_NORMAL_VIEW_STUDENTS, Att_PRINT_VIEW, } Att_TypeOfView_t; /*****************************************************************************/ /****************************** Private variables ****************************/ /*****************************************************************************/ /*****************************************************************************/ /****************************** Private prototypes ***************************/ /*****************************************************************************/ static void Att_ShowAllAttEvents (void); static void Att_PutFormToSelectWhichGroupsToShow (void); static void Att_ParamsWhichGroupsToShow (void); static void Att_PutIconToCreateNewAttEvent (void); static void Att_PutButtonToCreateNewAttEvent (void); static void Att_PutParamsToCreateNewAttEvent (void); static void Att_ShowOneAttEvent (struct AttendanceEvent *Att,bool ShowOnlyThisAttEventComplete); static void Att_WriteAttEventAuthor (struct AttendanceEvent *Att); static void Att_GetParamAttOrder (void); static void Att_PutFormToListMyAttendance (void); static void Att_PutFormToListStdsAttendance (void); static void Att_PutFormToListStdsParams (void); static void Att_PutFormsToRemEditOneAttEvent (long AttCod,bool Hidden); static void Att_PutParams (void); static void Att_GetListAttEvents (Att_OrderTime_t Order); static void Att_GetDataOfAttEventByCodAndCheckCrs (struct AttendanceEvent *Att); static void Att_ResetAttendanceEvent (struct AttendanceEvent *Att); static void Att_GetAttEventTxtFromDB (long AttCod,char Txt[Cns_MAX_BYTES_TEXT + 1]); static bool Att_CheckIfSimilarAttEventExists (const char *Field,const char *Value,long AttCod); static void Att_ShowLstGrpsToEditAttEvent (long AttCod); static void Att_RemoveAllTheGrpsAssociatedToAnAttEvent (long AttCod); static void Att_CreateGrps (long AttCod); static void Att_GetAndWriteNamesOfGrpsAssociatedToAttEvent (struct AttendanceEvent *Att); static void Att_RemoveAllUsrsFromAnAttEvent (long AttCod); static void Att_RemoveAttEventFromCurrentCrs (long AttCod); static void Att_ListAttOnlyMeAsStudent (struct AttendanceEvent *Att); static void Att_ListAttStudents (struct AttendanceEvent *Att); static void Att_WriteRowStdToCallTheRoll (unsigned NumStd,struct UsrData *UsrDat,struct AttendanceEvent *Att); static void Att_PutParamsCodGrps (long AttCod); static void Att_GetNumStdsTotalWhoAreInAttEvent (struct AttendanceEvent *Att); static unsigned Att_GetNumStdsFromAListWhoAreInAttEvent (long AttCod,long LstSelectedUsrCods[],unsigned NumStdsInList); static bool Att_CheckIfUsrIsInTableAttUsr (long AttCod,long UsrCod,bool *Present); static bool Att_CheckIfUsrIsPresentInAttEvent (long AttCod,long UsrCod); static bool Att_CheckIfUsrIsPresentInAttEventAndGetComments (long AttCod,long UsrCod, char CommentStd[Cns_MAX_BYTES_TEXT + 1], char CommentTch[Cns_MAX_BYTES_TEXT + 1]); static void Att_RegUsrInAttEventChangingComments (long AttCod,long UsrCod,bool Present, const char *CommentStd,const char *CommentTch); static void Att_RemoveUsrFromAttEvent (long AttCod,long UsrCod); static void Usr_ListOrPrintMyAttendanceCrs (Att_TypeOfView_t TypeOfView); static void Usr_ListOrPrintStdsAttendanceCrs (Att_TypeOfView_t TypeOfView); static void Att_GetListSelectedUsrCods (unsigned NumStdsInList,long **LstSelectedUsrCods); static void Att_GetListSelectedAttCods (char **StrAttCodsSelected); static void Att_PutIconToPrintMyList (void); static void Att_PutFormToPrintMyListParams (void); static void Att_PutIconToPrintStdsList (void); static void Att_PutParamsToPrintStdsList (void); static void Att_PutButtonToShowDetails (void); static void Att_ListEventsToSelect (Att_TypeOfView_t TypeOfView); static void Att_ListStdsAttendanceTable (Att_TypeOfView_t TypeOfView, unsigned NumStdsInList, long *LstSelectedUsrCods); static void Att_WriteTableHeadSeveralAttEvents (void); static void Att_WriteRowStdSeveralAttEvents (unsigned NumStd,struct UsrData *UsrDat); static void Att_ListStdsWithAttEventsDetails (Att_TypeOfView_t TypeOfView, unsigned NumStdsInList, long *LstSelectedUsrCods); static void Att_ListAttEventsForAStd (unsigned NumStd,struct UsrData *UsrDat); /*****************************************************************************/ /********************** List all the attendance events ***********************/ /*****************************************************************************/ void Att_SeeAttEvents (void) { extern const char *Txt_QR_code; /***** Get parameters *****/ Att_GetParamAttOrder (); Grp_GetParamWhichGrps (); Gbl.AttEvents.CurrentPage = Pag_GetParamPagNum (Pag_ATT_EVENTS); /***** Get list of attendance events *****/ Att_GetListAttEvents (Att_NEWEST_FIRST); /***** Show contextual menu *****/ if (Gbl.AttEvents.Num || Gbl.Usrs.Me.UsrDat.Nickname[0]) { fprintf (Gbl.F.Out,"
"); /* Put link to show list of attendance */ if (Gbl.AttEvents.Num) switch (Gbl.Usrs.Me.LoggedRole) { case Rol_STUDENT: Att_PutFormToListMyAttendance (); break; case Rol_TEACHER: case Rol_SYS_ADM: Att_PutFormToListStdsAttendance (); break; default: break; } /* Put link to my QR code */ Lay_PutContextualLink (ActPrnUsrQR,NULL,Usr_PutParamMyUsrCodEncrypted, "qr64x64.gif", Txt_QR_code,Txt_QR_code, NULL); fprintf (Gbl.F.Out,"
"); } /***** Show all the attendance events *****/ Att_ShowAllAttEvents (); } /*****************************************************************************/ /********************** Show all the attendance events ***********************/ /*****************************************************************************/ static void Att_ShowAllAttEvents (void) { extern const char *Hlp_USERS_Attendance; extern const char *Txt_Events; extern const char *Txt_START_END_TIME_HELP[Dat_NUM_START_END_TIME]; extern const char *Txt_START_END_TIME[Dat_NUM_START_END_TIME]; extern const char *Txt_Event; extern const char *Txt_ROLES_PLURAL_Abc[Rol_NUM_ROLES][Usr_NUM_SEXS]; extern const char *Txt_No_events; Dat_StartEndTime_t Order; struct Pagination Pagination; unsigned NumAttEvent; bool ICanEdit = (Gbl.Usrs.Me.LoggedRole == Rol_TEACHER || Gbl.Usrs.Me.LoggedRole == Rol_SYS_ADM); /***** Compute variables related to pagination *****/ Pagination.NumItems = Gbl.AttEvents.Num; Pagination.CurrentPage = (int) Gbl.AttEvents.CurrentPage; Pag_CalculatePagination (&Pagination); Gbl.AttEvents.CurrentPage = (unsigned) Pagination.CurrentPage; /***** Write links to pages *****/ if (Pagination.MoreThanOnePage) Pag_WriteLinksToPagesCentered (Pag_ATT_EVENTS, 0, &Pagination); /***** Start frame *****/ Lay_StartRoundFrame ("100%",Txt_Events, ICanEdit ? Att_PutIconToCreateNewAttEvent : NULL, Hlp_USERS_Attendance); /***** Select whether show only my groups or all groups *****/ if (Gbl.CurrentCrs.Grps.NumGrps) Att_PutFormToSelectWhichGroupsToShow (); if (Gbl.AttEvents.Num) { /***** Table head *****/ Lay_StartTableWideMargin (2); fprintf (Gbl.F.Out,"" ""); // Column for contextual icons for (Order = Dat_START_TIME; Order <= Dat_END_TIME; Order++) { fprintf (Gbl.F.Out,""); Act_FormStart (ActSeeAtt); Grp_PutParamWhichGrps (); Pag_PutHiddenParamPagNum (Pag_ATT_EVENTS,Gbl.AttEvents.CurrentPage); Par_PutHiddenParamUnsigned ("Order",(unsigned) Order); Act_LinkFormSubmit (Txt_START_END_TIME_HELP[Order],"TIT_TBL",NULL); if (Order == Gbl.AttEvents.SelectedOrder) fprintf (Gbl.F.Out,""); fprintf (Gbl.F.Out,"%s",Txt_START_END_TIME[Order]); if (Order == Gbl.AttEvents.SelectedOrder) fprintf (Gbl.F.Out,""); fprintf (Gbl.F.Out,""); Act_FormEnd (); fprintf (Gbl.F.Out,""); } fprintf (Gbl.F.Out,"" "%s" "" "" "%s" "" "", Txt_Event, Txt_ROLES_PLURAL_Abc[Rol_STUDENT][Usr_SEX_UNKNOWN]); /***** Write all the attendance events *****/ for (NumAttEvent = Pagination.FirstItemVisible, Gbl.RowEvenOdd = 0; NumAttEvent <= Pagination.LastItemVisible; NumAttEvent++) Att_ShowOneAttEvent (&Gbl.AttEvents.Lst[NumAttEvent - 1],false); /***** End table *****/ Lay_EndTable (); } else // No events created Ale_ShowAlert (Ale_INFO,Txt_No_events); /***** Button to create a new attendance event *****/ if (ICanEdit) Att_PutButtonToCreateNewAttEvent (); /***** End frame *****/ Lay_EndRoundFrame (); /***** Write again links to pages *****/ if (Pagination.MoreThanOnePage) Pag_WriteLinksToPagesCentered (Pag_ATT_EVENTS, 0, &Pagination); /***** Free list of attendance events *****/ Att_FreeListAttEvents (); } /*****************************************************************************/ /***************** Put form to select which groups to show *******************/ /*****************************************************************************/ static void Att_PutFormToSelectWhichGroupsToShow (void) { fprintf (Gbl.F.Out,"
"); Grp_ShowFormToSelWhichGrps (ActSeeAtt,Att_ParamsWhichGroupsToShow); fprintf (Gbl.F.Out,"
"); } static void Att_ParamsWhichGroupsToShow (void) { Att_PutHiddenParamAttOrder (); Pag_PutHiddenParamPagNum (Pag_ATT_EVENTS,Gbl.AttEvents.CurrentPage); } /*****************************************************************************/ /**************** Put icon to create a new attendance event ******************/ /*****************************************************************************/ static void Att_PutIconToCreateNewAttEvent (void) { extern const char *Txt_New_event; /***** Put form to create a new attendance event *****/ Lay_PutContextualLink (ActFrmNewAtt,NULL,Att_PutParamsToCreateNewAttEvent, "plus64x64.png", Txt_New_event,NULL, NULL); } /*****************************************************************************/ /**************** Put button to create a new attendance event ****************/ /*****************************************************************************/ static void Att_PutButtonToCreateNewAttEvent (void) { extern const char *Txt_New_event; Act_FormStart (ActFrmNewAtt); Att_PutParamsToCreateNewAttEvent (); Lay_PutConfirmButton (Txt_New_event); Act_FormEnd (); } /*****************************************************************************/ /************** Put parameters to create a new attendance event **************/ /*****************************************************************************/ static void Att_PutParamsToCreateNewAttEvent (void) { Att_PutHiddenParamAttOrder (); Grp_PutParamWhichGrps (); Pag_PutHiddenParamPagNum (Pag_ATT_EVENTS,Gbl.AttEvents.CurrentPage); } /*****************************************************************************/ /************************* Show one attendance event *************************/ /*****************************************************************************/ // Only Att->AttCod must be filled static void Att_ShowOneAttEvent (struct AttendanceEvent *Att,bool ShowOnlyThisAttEventComplete) { extern const char *Txt_Today; extern const char *Txt_View_event; static unsigned UniqueId = 0; char Txt[Cns_MAX_BYTES_TEXT + 1]; /***** Get data of this attendance event *****/ Att_GetDataOfAttEventByCodAndCheckCrs (Att); Att_GetNumStdsTotalWhoAreInAttEvent (Att); /***** Write first row of data of this attendance event *****/ /* Forms to remove/edit this attendance event */ fprintf (Gbl.F.Out,"" "", Gbl.RowEvenOdd); switch (Gbl.Usrs.Me.LoggedRole) { case Rol_TEACHER: case Rol_SYS_ADM: Att_PutFormsToRemEditOneAttEvent (Att->AttCod,Att->Hidden); break; default: break; } fprintf (Gbl.F.Out,""); /* Start date/time */ UniqueId++; fprintf (Gbl.F.Out,"Hidden ? (Att->Open ? "DATE_GREEN_LIGHT" : "DATE_RED_LIGHT") : (Att->Open ? "DATE_GREEN" : "DATE_RED")); if (!ShowOnlyThisAttEventComplete) fprintf (Gbl.F.Out," COLOR%u",Gbl.RowEvenOdd); fprintf (Gbl.F.Out,"\">" "" "", UniqueId,Att->TimeUTC[Att_START_TIME], (unsigned) Gbl.Prefs.DateFormat,Txt_Today); /* End date/time */ fprintf (Gbl.F.Out,"Hidden ? (Att->Open ? "DATE_GREEN_LIGHT" : "DATE_RED_LIGHT") : (Att->Open ? "DATE_GREEN" : "DATE_RED")); if (!ShowOnlyThisAttEventComplete) fprintf (Gbl.F.Out," COLOR%u",Gbl.RowEvenOdd); fprintf (Gbl.F.Out,"\">" "" "", UniqueId,Att->TimeUTC[Att_END_TIME], (unsigned) Gbl.Prefs.DateFormat,Txt_Today); /* Attendance event title */ fprintf (Gbl.F.Out,""); /* Put form to view attendance event */ Act_FormStart (ActSeeOneAtt); Att_PutParamAttCod (Att->AttCod); Att_PutParamsCodGrps (Att->AttCod); Act_LinkFormSubmit (Txt_View_event,Att->Hidden ? "ASG_TITLE_LIGHT" : "ASG_TITLE",NULL); fprintf (Gbl.F.Out,"%s",Att->Title); Act_FormEnd (); fprintf (Gbl.F.Out,""); /* Number of students in this event */ fprintf (Gbl.F.Out,"Hidden ? "ASG_TITLE_LIGHT" : "ASG_TITLE"); if (!ShowOnlyThisAttEventComplete) fprintf (Gbl.F.Out," COLOR%u",Gbl.RowEvenOdd); fprintf (Gbl.F.Out,"\">" "%u" "" "", Att->NumStdsTotal); /***** Write second row of data of this attendance event *****/ fprintf (Gbl.F.Out,"" "", Gbl.RowEvenOdd); /* Author of the attendance event */ Att_WriteAttEventAuthor (Att); fprintf (Gbl.F.Out,""); /* Text of the attendance event */ Att_GetAttEventTxtFromDB (Att->AttCod,Txt); Str_ChangeFormat (Str_FROM_HTML,Str_TO_RIGOROUS_HTML, Txt,Cns_MAX_BYTES_TEXT,false); // Convert from HTML to recpectful HTML Str_InsertLinks (Txt,Cns_MAX_BYTES_TEXT,60); // Insert links fprintf (Gbl.F.Out,"", Gbl.RowEvenOdd); if (Gbl.CurrentCrs.Grps.NumGrps) Att_GetAndWriteNamesOfGrpsAssociatedToAttEvent (Att); fprintf (Gbl.F.Out,"
%s
", Att->Hidden ? "DAT_LIGHT" : "DAT", Txt); fprintf (Gbl.F.Out,"" ""); Gbl.RowEvenOdd = 1 - Gbl.RowEvenOdd; } /*****************************************************************************/ /****************** Write the author of an attendance event ******************/ /*****************************************************************************/ static void Att_WriteAttEventAuthor (struct AttendanceEvent *Att) { Usr_WriteAuthor1Line (Att->UsrCod,Att->Hidden); } /*****************************************************************************/ /**** Get parameter with the type or order in list of attendance events ******/ /*****************************************************************************/ static void Att_GetParamAttOrder (void) { Gbl.AttEvents.SelectedOrder = (Dat_StartEndTime_t) Par_GetParToUnsignedLong ("Order", 0, Dat_NUM_START_END_TIME - 1, (unsigned long) Att_ORDER_DEFAULT); } /*****************************************************************************/ /*** Put a hidden parameter with the type of order in list of att. events ****/ /*****************************************************************************/ void Att_PutHiddenParamAttOrder (void) { Par_PutHiddenParamUnsigned ("Order",(unsigned) Gbl.AttEvents.SelectedOrder); } /*****************************************************************************/ /**** Put a link (form) to list assistance of students to several events *****/ /*****************************************************************************/ static void Att_PutFormToListMyAttendance (void) { extern const char *Txt_Attendance_list; Lay_PutContextualLink (ActSeeLstMyAtt,NULL,NULL, "list64x64.gif", Txt_Attendance_list,Txt_Attendance_list, NULL); } /*****************************************************************************/ /** Put a link (form) to list my assistance (as student) to several events ***/ /*****************************************************************************/ static void Att_PutFormToListStdsAttendance (void) { extern const char *Txt_Attendance_list; Lay_PutContextualLink (ActReqLstStdAtt,NULL,Att_PutFormToListStdsParams, "list64x64.gif", Txt_Attendance_list,Txt_Attendance_list, NULL); } static void Att_PutFormToListStdsParams (void) { Att_PutHiddenParamAttOrder (); Grp_PutParamWhichGrps (); Pag_PutHiddenParamPagNum (Pag_ATT_EVENTS,Gbl.AttEvents.CurrentPage); } /*****************************************************************************/ /************** Put a link (form) to edit one attendance event ***************/ /*****************************************************************************/ static void Att_PutFormsToRemEditOneAttEvent (long AttCod,bool Hidden) { Gbl.AttEvents.AttCodToEdit = AttCod; // Used as parameters in contextual links /***** Put form to remove attendance event *****/ Lay_PutContextualIconToRemove (ActReqRemAtt,Att_PutParams); /***** Put form to hide/show attendance event *****/ if (Hidden) Lay_PutContextualIconToUnhide (ActShoAtt,Att_PutParams); else Lay_PutContextualIconToHide (ActHidAtt,Att_PutParams); /***** Put form to edit attendance event *****/ Lay_PutContextualIconToEdit (ActEdiOneAtt,Att_PutParams); } /*****************************************************************************/ /***************** Params used to edit an attendance event *******************/ /*****************************************************************************/ static void Att_PutParams (void) { Att_PutParamAttCod (Gbl.AttEvents.AttCodToEdit); Att_PutHiddenParamAttOrder (); Grp_PutParamWhichGrps (); Pag_PutHiddenParamPagNum (Pag_ATT_EVENTS,Gbl.AttEvents.CurrentPage); } /*****************************************************************************/ /********************* List all the attendance events ************************/ /*****************************************************************************/ static void Att_GetListAttEvents (Att_OrderTime_t Order) { char HiddenSubQuery[256]; char OrderBySubQuery[256]; char Query[2048]; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned long NumRows; unsigned NumAttEvent; if (Gbl.AttEvents.LstIsRead) Att_FreeListAttEvents (); /***** Get list of attendance events from database *****/ switch (Gbl.Usrs.Me.LoggedRole) { case Rol_TEACHER: case Rol_SYS_ADM: HiddenSubQuery[0] = '\0'; break; default: sprintf (HiddenSubQuery," AND Hidden='N'"); break; } switch (Gbl.AttEvents.SelectedOrder) { case Dat_START_TIME: if (Order == Att_NEWEST_FIRST) sprintf (OrderBySubQuery,"StartTime DESC,EndTime DESC,Title DESC"); else sprintf (OrderBySubQuery,"StartTime,EndTime,Title"); break; case Dat_END_TIME: if (Order == Att_NEWEST_FIRST) sprintf (OrderBySubQuery,"EndTime DESC,StartTime DESC,Title DESC"); else sprintf (OrderBySubQuery,"EndTime,StartTime,Title"); break; } if (Gbl.CurrentCrs.Grps.WhichGrps == Grp_ONLY_MY_GROUPS) sprintf (Query,"SELECT AttCod" " FROM att_events" " WHERE CrsCod=%ld%s" " AND (AttCod NOT IN (SELECT AttCod FROM att_grp) OR" " AttCod IN (SELECT att_grp.AttCod FROM att_grp,crs_grp_usr" " WHERE crs_grp_usr.UsrCod=%ld" " AND att_grp.GrpCod=crs_grp_usr.GrpCod))" " ORDER BY %s", Gbl.CurrentCrs.Crs.CrsCod,HiddenSubQuery, Gbl.Usrs.Me.UsrDat.UsrCod,OrderBySubQuery); else // Gbl.CurrentCrs.Grps.WhichGrps == Grp_ALL_GROUPS sprintf (Query,"SELECT AttCod" " FROM att_events" " WHERE CrsCod=%ld%s" " ORDER BY %s", Gbl.CurrentCrs.Crs.CrsCod,HiddenSubQuery,OrderBySubQuery); if ((NumRows = DB_QuerySELECT (Query,&mysql_res,"can not get attendance events"))) // Attendance events found... { Gbl.AttEvents.Num = (unsigned) NumRows; /***** Create list of attendance events *****/ if ((Gbl.AttEvents.Lst = (struct AttendanceEvent *) calloc (NumRows,sizeof (struct AttendanceEvent))) == NULL) Lay_ShowErrorAndExit ("Not enough memory to store list of attendance events."); /***** Get the attendance events codes *****/ for (NumAttEvent = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++) { /* Get next attendance event code */ row = mysql_fetch_row (mysql_res); if ((Gbl.AttEvents.Lst[NumAttEvent].AttCod = Str_ConvertStrCodToLongCod (row[0])) < 0) Lay_ShowErrorAndExit ("Error: wrong attendance event code."); } } else Gbl.AttEvents.Num = 0; /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); Gbl.AttEvents.LstIsRead = true; } /*****************************************************************************/ /********* Get attendance event data using its code and check course *********/ /*****************************************************************************/ static void Att_GetDataOfAttEventByCodAndCheckCrs (struct AttendanceEvent *Att) { if (Att_GetDataOfAttEventByCod (Att)) { if (Att->CrsCod != Gbl.CurrentCrs.Crs.CrsCod) Lay_ShowErrorAndExit ("Attendance event does not belong to current course."); } else // Attendance event not found Lay_ShowErrorAndExit ("Error when getting attendance event."); } /*****************************************************************************/ /**************** Get attendance event data using its code *******************/ /*****************************************************************************/ // Returns true if attendance event exists // This function can be called from web service, so do not display messages bool Att_GetDataOfAttEventByCod (struct AttendanceEvent *Att) { char Query[1024]; MYSQL_RES *mysql_res; MYSQL_ROW row; bool Found = false; /***** Reset attendance event data *****/ Att_ResetAttendanceEvent (Att); if (Att->AttCod > 0) { /***** Build query *****/ sprintf (Query,"SELECT AttCod,CrsCod,Hidden,UsrCod," "UNIX_TIMESTAMP(StartTime)," "UNIX_TIMESTAMP(EndTime)," "NOW() BETWEEN StartTime AND EndTime," "CommentTchVisible," "Title" " FROM att_events" " WHERE AttCod=%ld", Att->AttCod); /***** Get data of attendance event from database *****/ if ((Found = (DB_QuerySELECT (Query,&mysql_res,"can not get attendance event data") != 0))) // Attendance event found... { /* Get row */ row = mysql_fetch_row (mysql_res); /* Get code of the attendance event (row[0]) */ Att->AttCod = Str_ConvertStrCodToLongCod (row[0]); /* Get code of the course (row[1]) */ Att->CrsCod = Str_ConvertStrCodToLongCod (row[1]); /* Get whether the attendance event is hidden or not (row[2]) */ Att->Hidden = (row[2][0] == 'Y'); /* Get author of the attendance event (row[3]) */ Att->UsrCod = Str_ConvertStrCodToLongCod (row[3]); /* Get start date (row[4] holds the start UTC time) */ Att->TimeUTC[Att_START_TIME] = Dat_GetUNIXTimeFromStr (row[4]); /* Get end date (row[5] holds the end UTC time) */ Att->TimeUTC[Att_END_TIME ] = Dat_GetUNIXTimeFromStr (row[5]); /* Get whether the attendance event is open or closed (row(6)) */ Att->Open = (row[6][0] == '1'); /* Get whether the attendance event is visible or not (row[7]) */ Att->CommentTchVisible = (row[7][0] == 'Y'); /* Get the title of the attendance event (row[8]) */ Str_Copy (Att->Title,row[8], Att_MAX_BYTES_ATTENDANCE_EVENT_TITLE); } /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); } return Found; } /*****************************************************************************/ /********************** Clear all attendance event data **********************/ /*****************************************************************************/ static void Att_ResetAttendanceEvent (struct AttendanceEvent *Att) { if (Att->AttCod <= 0) // If > 0 ==> keep values of AttCod and Selected { Att->AttCod = -1L; Att->NumStdsTotal = 0; Att->NumStdsFromList = 0; Att->Selected = false; } Att->CrsCod = -1L; Att->Hidden = false; Att->UsrCod = -1L; Att->TimeUTC[Att_START_TIME] = Att->TimeUTC[Att_END_TIME ] = (time_t) 0; Att->Open = false; Att->Title[0] = '\0'; Att->CommentTchVisible = false; } /*****************************************************************************/ /********************** Free list of attendance events ***********************/ /*****************************************************************************/ void Att_FreeListAttEvents (void) { if (Gbl.AttEvents.LstIsRead && Gbl.AttEvents.Lst) { /***** Free memory used by the list of attendance events *****/ free ((void *) Gbl.AttEvents.Lst); Gbl.AttEvents.Lst = NULL; Gbl.AttEvents.Num = 0; Gbl.AttEvents.LstIsRead = false; } } /*****************************************************************************/ /***************** Get attendance event text from database *******************/ /*****************************************************************************/ static void Att_GetAttEventTxtFromDB (long AttCod,char Txt[Cns_MAX_BYTES_TEXT + 1]) { char Query[256]; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned long NumRows; /***** Get text of attendance event from database *****/ sprintf (Query,"SELECT Txt FROM att_events" " WHERE AttCod=%ld AND CrsCod=%ld", AttCod,Gbl.CurrentCrs.Crs.CrsCod); NumRows = DB_QuerySELECT (Query,&mysql_res,"can not get attendance event text"); /***** The result of the query must have one row or none *****/ if (NumRows == 1) { /* Get row */ row = mysql_fetch_row (mysql_res); /* Get info text */ Str_Copy (Txt,row[0], Cns_MAX_BYTES_TEXT); } else Txt[0] = '\0'; /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); if (NumRows > 1) Lay_ShowErrorAndExit ("Error when getting attendance event text."); } /*****************************************************************************/ /************** Write parameter with code of attendance event ****************/ /*****************************************************************************/ void Att_PutParamAttCod (long AttCod) { Par_PutHiddenParamLong ("AttCod",AttCod); } /*****************************************************************************/ /*************** Get parameter with code of attendance event *****************/ /*****************************************************************************/ long Att_GetParamAttCod (void) { /***** Get code of attendance event *****/ return Par_GetParToLong ("AttCod"); } /*****************************************************************************/ /********* Ask for confirmation of removing of an attendance event ***********/ /*****************************************************************************/ void Att_AskRemAttEvent (void) { extern const char *Txt_Do_you_really_want_to_remove_the_event_X; extern const char *Txt_Remove_event; struct AttendanceEvent Att; /***** Get parameters *****/ Att_GetParamAttOrder (); Grp_GetParamWhichGrps (); Gbl.AttEvents.CurrentPage = Pag_GetParamPagNum (Pag_ATT_EVENTS); /***** Get attendance event code *****/ if ((Att.AttCod = Att_GetParamAttCod ()) == -1L) Lay_ShowErrorAndExit ("Code of attendance event is missing."); /***** Get data of the attendance event from database *****/ Att_GetDataOfAttEventByCodAndCheckCrs (&Att); /***** Button of confirmation of removing *****/ Act_FormStart (ActRemAtt); Att_PutParamAttCod (Att.AttCod); Att_PutHiddenParamAttOrder (); Grp_PutParamWhichGrps (); Pag_PutHiddenParamPagNum (Pag_ATT_EVENTS,Gbl.AttEvents.CurrentPage); /***** Ask for confirmation of removing *****/ sprintf (Gbl.Alert.Txt,Txt_Do_you_really_want_to_remove_the_event_X, Att.Title); Ale_ShowAlert (Ale_WARNING,Gbl.Alert.Txt); Lay_PutRemoveButton (Txt_Remove_event); Act_FormEnd (); /***** Show attendance events again *****/ Att_SeeAttEvents (); } /*****************************************************************************/ /** Get param., remove an attendance event and show attendance events again **/ /*****************************************************************************/ void Att_GetAndRemAttEvent (void) { extern const char *Txt_Event_X_removed; struct AttendanceEvent Att; /***** Get attendance event code *****/ if ((Att.AttCod = Att_GetParamAttCod ()) == -1L) Lay_ShowErrorAndExit ("Code of attendance event is missing."); /***** Get data of the attendance event from database *****/ // Inside this function, the course is checked to be the current one Att_GetDataOfAttEventByCodAndCheckCrs (&Att); /***** Remove the attendance event from database *****/ Att_RemoveAttEventFromDB (Att.AttCod); /***** Write message to show the change made *****/ sprintf (Gbl.Alert.Txt,Txt_Event_X_removed,Att.Title); Ale_ShowAlert (Ale_SUCCESS,Gbl.Alert.Txt); /***** Show attendance events again *****/ Att_SeeAttEvents (); } /*****************************************************************************/ /**************** Remove an attendance event from database *******************/ /*****************************************************************************/ void Att_RemoveAttEventFromDB (long AttCod) { /***** Remove users registered in the attendance event *****/ Att_RemoveAllUsrsFromAnAttEvent (AttCod); /***** Remove all the groups of this attendance event *****/ Att_RemoveAllTheGrpsAssociatedToAnAttEvent (AttCod); /***** Remove attendance event *****/ Att_RemoveAttEventFromCurrentCrs (AttCod); } /*****************************************************************************/ /************************* Hide an attendance event **************************/ /*****************************************************************************/ void Att_HideAttEvent (void) { extern const char *Txt_Event_X_is_now_hidden; char Query[512]; struct AttendanceEvent Att; /***** Get attendance event code *****/ if ((Att.AttCod = Att_GetParamAttCod ()) == -1L) Lay_ShowErrorAndExit ("Code of attendance event is missing."); /***** Get data of the attendance event from database *****/ Att_GetDataOfAttEventByCodAndCheckCrs (&Att); /***** Hide attendance event *****/ sprintf (Query,"UPDATE att_events SET Hidden='Y'" " WHERE AttCod=%ld AND CrsCod=%ld", Att.AttCod,Gbl.CurrentCrs.Crs.CrsCod); DB_QueryUPDATE (Query,"can not hide attendance event"); /***** Write message to show the change made *****/ sprintf (Gbl.Alert.Txt,Txt_Event_X_is_now_hidden, Att.Title); Ale_ShowAlert (Ale_SUCCESS,Gbl.Alert.Txt); /***** Show attendance events again *****/ Att_SeeAttEvents (); } /*****************************************************************************/ /************************* Show an attendance event **************************/ /*****************************************************************************/ void Att_ShowAttEvent (void) { extern const char *Txt_Event_X_is_now_visible; char Query[512]; struct AttendanceEvent Att; /***** Get attendance event code *****/ if ((Att.AttCod = Att_GetParamAttCod ()) == -1L) Lay_ShowErrorAndExit ("Code of attendance event is missing."); /***** Get data of the attendance event from database *****/ Att_GetDataOfAttEventByCodAndCheckCrs (&Att); /***** Hide attendance event *****/ sprintf (Query,"UPDATE att_events SET Hidden='N'" " WHERE AttCod=%ld AND CrsCod=%ld", Att.AttCod,Gbl.CurrentCrs.Crs.CrsCod); DB_QueryUPDATE (Query,"can not show attendance event"); /***** Write message to show the change made *****/ sprintf (Gbl.Alert.Txt,Txt_Event_X_is_now_visible, Att.Title); Ale_ShowAlert (Ale_SUCCESS,Gbl.Alert.Txt); /***** Show attendance events again *****/ Att_SeeAttEvents (); } /*****************************************************************************/ /***** Check if the title or the folder of an attendance event exists ********/ /*****************************************************************************/ static bool Att_CheckIfSimilarAttEventExists (const char *Field,const char *Value,long AttCod) { char Query[256 + Att_MAX_BYTES_ATTENDANCE_EVENT_TITLE]; /***** Get number of attendance events with a field value from database *****/ sprintf (Query,"SELECT COUNT(*) FROM att_events" " WHERE CrsCod=%ld AND %s='%s' AND AttCod<>%ld", Gbl.CurrentCrs.Crs.CrsCod,Field,Value,AttCod); return (DB_QueryCOUNT (Query,"can not get similar attendance events") != 0); } /*****************************************************************************/ /*************** Put a form to create a new attendance event *****************/ /*****************************************************************************/ void Att_RequestCreatOrEditAttEvent (void) { extern const char *Hlp_USERS_Attendance_new_event; extern const char *Hlp_USERS_Attendance_edit_event; extern const char *The_ClassForm[The_NUM_THEMES]; extern const char *Txt_New_event; extern const char *Txt_Edit_event; extern const char *Txt_Teachers_comment; extern const char *Txt_Title; extern const char *Txt_Hidden_MALE_PLURAL; extern const char *Txt_Visible_MALE_PLURAL; extern const char *Txt_Description; extern const char *Txt_Create_event; extern const char *Txt_Save; struct AttendanceEvent Att; bool ItsANewAttEvent; char Txt[Cns_MAX_BYTES_TEXT + 1]; /***** Get parameters *****/ Att_GetParamAttOrder (); Grp_GetParamWhichGrps (); Gbl.AttEvents.CurrentPage = Pag_GetParamPagNum (Pag_ATT_EVENTS); /***** Get the code of the attendance event *****/ Att.AttCod = Att_GetParamAttCod (); ItsANewAttEvent = (Att.AttCod <= 0); /***** Get from the database the data of the attendance event *****/ if (ItsANewAttEvent) { /* Reset attendance event data */ Att.AttCod = -1L; Att_ResetAttendanceEvent (&Att); /* Initialize some fields */ Att.CrsCod = Gbl.CurrentCrs.Crs.CrsCod; Att.UsrCod = Gbl.Usrs.Me.UsrDat.UsrCod; Att.TimeUTC[Att_START_TIME] = Gbl.StartExecutionTimeUTC; Att.TimeUTC[Att_END_TIME ] = Gbl.StartExecutionTimeUTC + (2 * 60 * 60); // +2 hours Att.Open = true; } else { /* Get data of the attendance event from database */ Att_GetDataOfAttEventByCodAndCheckCrs (&Att); /* Get text of the attendance event from database */ Att_GetAttEventTxtFromDB (Att.AttCod,Txt); } /***** Start form *****/ if (ItsANewAttEvent) Act_FormStart (ActNewAtt); else { Act_FormStart (ActChgAtt); Att_PutParamAttCod (Att.AttCod); } Att_PutHiddenParamAttOrder (); Grp_PutParamWhichGrps (); Pag_PutHiddenParamPagNum (Pag_ATT_EVENTS,Gbl.AttEvents.CurrentPage); /***** Table start *****/ Lay_StartRoundFrameTable (NULL, ItsANewAttEvent ? Txt_New_event : Txt_Edit_event, NULL, ItsANewAttEvent ? Hlp_USERS_Attendance_new_event : Hlp_USERS_Attendance_edit_event, 2); /***** Attendance event title *****/ fprintf (Gbl.F.Out,"" "" "" "" "" "" "" "", The_ClassForm[Gbl.Prefs.Theme],Txt_Title, Att_MAX_CHARS_ATTENDANCE_EVENT_TITLE,Att.Title); /***** Assignment start and end dates *****/ Dat_PutFormStartEndClientLocalDateTimes (Att.TimeUTC,Dat_FORM_SECONDS_ON); /***** Visibility of comments *****/ fprintf (Gbl.F.Out,"" "" "" "" "" "" "" ""); /***** Attendance event description *****/ fprintf (Gbl.F.Out,"" "" "" "" "" "" "" ""); /***** Groups *****/ Att_ShowLstGrpsToEditAttEvent (Att.AttCod); /***** Button and end frame *****/ if (ItsANewAttEvent) Lay_EndRoundFrameTableWithButton (Lay_CREATE_BUTTON,Txt_Create_event); else Lay_EndRoundFrameTableWithButton (Lay_CONFIRM_BUTTON,Txt_Save); /***** End form *****/ Act_FormEnd (); /***** Show current attendance events *****/ Att_GetListAttEvents (Att_NEWEST_FIRST); Att_ShowAllAttEvents (); } /*****************************************************************************/ /************* Show list of groups to edit and attendance event **************/ /*****************************************************************************/ static void Att_ShowLstGrpsToEditAttEvent (long AttCod) { extern const char *The_ClassForm[The_NUM_THEMES]; extern const char *Txt_Groups; extern const char *Txt_The_whole_course; unsigned NumGrpTyp; /***** Get list of groups types and groups in this course *****/ Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_ONLY_GROUP_TYPES_WITH_GROUPS); if (Gbl.CurrentCrs.Grps.GrpTypes.Num) { /***** Start table *****/ fprintf (Gbl.F.Out,"" "" "%s:" "" "", The_ClassForm[Gbl.Prefs.Theme],Txt_Groups); Lay_StartRoundFrameTable ("100%",NULL,NULL,NULL,0); /***** First row: checkbox to select the whole course *****/ fprintf (Gbl.F.Out,"" "" "" "" "", Txt_The_whole_course,Gbl.CurrentCrs.Crs.ShrtName); /***** List the groups for each group type *****/ for (NumGrpTyp = 0; NumGrpTyp < Gbl.CurrentCrs.Grps.GrpTypes.Num; NumGrpTyp++) if (Gbl.CurrentCrs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps) Grp_ListGrpsToEditAsgAttOrSvy (&Gbl.CurrentCrs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp],AttCod,Grp_ATT_EVENT); /***** End table *****/ Lay_EndRoundFrameTable (); fprintf (Gbl.F.Out,"" ""); } /***** Free list of groups types and groups in this course *****/ Grp_FreeListGrpTypesAndGrps (); } /*****************************************************************************/ /*************** Receive form to create a new attendance event ***************/ /*****************************************************************************/ void Att_RecFormAttEvent (void) { extern const char *Txt_Already_existed_an_event_with_the_title_X; extern const char *Txt_You_must_specify_the_title_of_the_event; extern const char *Txt_Created_new_event_X; extern const char *Txt_The_event_has_been_modified; struct AttendanceEvent OldAtt; struct AttendanceEvent ReceivedAtt; bool ItsANewAttEvent; bool ReceivedAttEventIsCorrect = true; char Txt[Cns_MAX_BYTES_TEXT + 1]; /***** Get the code of the attendance event *****/ ItsANewAttEvent = ((ReceivedAtt.AttCod = Att_GetParamAttCod ()) == -1L); if (!ItsANewAttEvent) { /* Get data of the old (current) attendance event from database */ OldAtt.AttCod = ReceivedAtt.AttCod; Att_GetDataOfAttEventByCodAndCheckCrs (&OldAtt); ReceivedAtt.Hidden = OldAtt.Hidden; } /***** Get start/end date-times *****/ ReceivedAtt.TimeUTC[Att_START_TIME] = Dat_GetTimeUTCFromForm ("StartTimeUTC"); ReceivedAtt.TimeUTC[Att_END_TIME ] = Dat_GetTimeUTCFromForm ("EndTimeUTC" ); /***** Get boolean parameter that indicates if teacher's comments are visible by students *****/ ReceivedAtt.CommentTchVisible = Par_GetParToBool ("ComTchVisible"); /***** Get attendance event title *****/ Par_GetParToText ("Title",ReceivedAtt.Title,Att_MAX_BYTES_ATTENDANCE_EVENT_TITLE); /***** Get attendance event text *****/ Par_GetParToHTML ("Txt",Txt,Cns_MAX_BYTES_TEXT); // Store in HTML format (not rigorous) /***** Adjust dates *****/ if (ReceivedAtt.TimeUTC[Att_START_TIME] == 0) ReceivedAtt.TimeUTC[Att_START_TIME] = Gbl.StartExecutionTimeUTC; if (ReceivedAtt.TimeUTC[Att_END_TIME] == 0) ReceivedAtt.TimeUTC[Att_END_TIME] = ReceivedAtt.TimeUTC[Att_START_TIME] + 2 * 60 * 60; // +2 hours // TODO: 2 * 60 * 60 should be in a #define in swad_config.h /***** Check if title is correct *****/ if (ReceivedAtt.Title[0]) // If there's an attendance event title { /* If title of attendance event was in database... */ if (Att_CheckIfSimilarAttEventExists ("Title",ReceivedAtt.Title,ReceivedAtt.AttCod)) { ReceivedAttEventIsCorrect = false; sprintf (Gbl.Alert.Txt,Txt_Already_existed_an_event_with_the_title_X, ReceivedAtt.Title); Ale_ShowAlert (Ale_WARNING,Gbl.Alert.Txt); } } else // If there is not an attendance event title { ReceivedAttEventIsCorrect = false; Ale_ShowAlert (Ale_WARNING,Txt_You_must_specify_the_title_of_the_event); } /***** Create a new attendance event or update an existing one *****/ if (ReceivedAttEventIsCorrect) { /* Get groups for this attendance events */ Grp_GetParCodsSeveralGrps (); if (ItsANewAttEvent) { ReceivedAtt.Hidden = false; // New attendance events are visible by default Att_CreateAttEvent (&ReceivedAtt,Txt); // Add new attendance event to database /***** Write success message *****/ sprintf (Gbl.Alert.Txt,Txt_Created_new_event_X,ReceivedAtt.Title); Ale_ShowAlert (Ale_SUCCESS,Gbl.Alert.Txt); } else { Att_UpdateAttEvent (&ReceivedAtt,Txt); /***** Write success message *****/ Ale_ShowAlert (Ale_SUCCESS,Txt_The_event_has_been_modified); } /* Free memory for list of selected groups */ Grp_FreeListCodSelectedGrps (); } else Att_RequestCreatOrEditAttEvent (); /***** Show attendance events again *****/ Att_SeeAttEvents (); } /*****************************************************************************/ /********************* Create a new attendance event *************************/ /*****************************************************************************/ void Att_CreateAttEvent (struct AttendanceEvent *Att,const char *Txt) { char Query[1024 + Att_MAX_BYTES_ATTENDANCE_EVENT_TITLE + Cns_MAX_BYTES_TEXT]; /***** Create a new attendance event *****/ sprintf (Query,"INSERT INTO att_events" " (CrsCod,Hidden,UsrCod," "StartTime,EndTime,CommentTchVisible,Title,Txt)" " VALUES" " (%ld,'%c',%ld," "FROM_UNIXTIME(%ld),FROM_UNIXTIME(%ld),'%c','%s','%s')", Gbl.CurrentCrs.Crs.CrsCod, Att->Hidden ? 'Y' : 'N', Gbl.Usrs.Me.UsrDat.UsrCod, Att->TimeUTC[Att_START_TIME], Att->TimeUTC[Att_END_TIME ], Att->CommentTchVisible ? 'Y' : 'N', Att->Title, Txt); Att->AttCod = DB_QueryINSERTandReturnCode (Query,"can not create new attendance event"); /***** Create groups *****/ if (Gbl.CurrentCrs.Grps.LstGrpsSel.NumGrps) Att_CreateGrps (Att->AttCod); } /*****************************************************************************/ /****************** Update an existing attendance event **********************/ /*****************************************************************************/ void Att_UpdateAttEvent (struct AttendanceEvent *Att,const char *Txt) { char Query[1024 + Att_MAX_BYTES_ATTENDANCE_EVENT_TITLE + Cns_MAX_BYTES_TEXT]; /***** Update the data of the attendance event *****/ sprintf (Query,"UPDATE att_events SET " "Hidden='%c'," "StartTime=FROM_UNIXTIME(%ld)," "EndTime=FROM_UNIXTIME(%ld)," "CommentTchVisible='%c',Title='%s',Txt='%s'" " WHERE AttCod=%ld AND CrsCod=%ld", Att->Hidden ? 'Y' : 'N', Att->TimeUTC[Att_START_TIME], Att->TimeUTC[Att_END_TIME ], Att->CommentTchVisible ? 'Y' : 'N', Att->Title, Txt, Att->AttCod,Gbl.CurrentCrs.Crs.CrsCod); DB_QueryUPDATE (Query,"can not update attendance event"); /***** Update groups *****/ /* Remove old groups */ Att_RemoveAllTheGrpsAssociatedToAnAttEvent (Att->AttCod); /* Create new groups */ if (Gbl.CurrentCrs.Grps.LstGrpsSel.NumGrps) Att_CreateGrps (Att->AttCod); } /*****************************************************************************/ /******** Check if an attendance event is associated to any group ************/ /*****************************************************************************/ bool Att_CheckIfAttEventIsAssociatedToGrps (long AttCod) { char Query[256]; /***** Get if an attendance event is associated to a group from database *****/ sprintf (Query,"SELECT COUNT(*) FROM att_grp WHERE AttCod=%ld", AttCod); return (DB_QueryCOUNT (Query,"can not check if an attendance event is associated to groups") != 0); } /*****************************************************************************/ /********* Check if an attendance event is associated to a group *************/ /*****************************************************************************/ bool Att_CheckIfAttEventIsAssociatedToGrp (long AttCod,long GrpCod) { char Query[512]; /***** Get if an attendance event is associated to a group from database *****/ sprintf (Query,"SELECT COUNT(*) FROM att_grp" " WHERE AttCod=%ld AND GrpCod=%ld", AttCod,GrpCod); return (DB_QueryCOUNT (Query,"can not check if an attendance event is associated to a group") != 0); } /*****************************************************************************/ /****************** Remove groups of an attendance event *********************/ /*****************************************************************************/ static void Att_RemoveAllTheGrpsAssociatedToAnAttEvent (long AttCod) { char Query[256]; /***** Remove groups of the attendance event *****/ sprintf (Query,"DELETE FROM att_grp WHERE AttCod=%ld",AttCod); DB_QueryDELETE (Query,"can not remove the groups associated to an attendance event"); } /*****************************************************************************/ /************* Remove one group from all the attendance events ***************/ /*****************************************************************************/ void Att_RemoveGroup (long GrpCod) { char Query[256]; /***** Remove group from all the attendance events *****/ sprintf (Query,"DELETE FROM att_grp WHERE GrpCod=%ld",GrpCod); DB_QueryDELETE (Query,"can not remove group from the associations between attendance events and groups"); } /*****************************************************************************/ /******** Remove groups of one type from all the attendance events ***********/ /*****************************************************************************/ void Att_RemoveGroupsOfType (long GrpTypCod) { char Query[256]; /***** Remove group from all the attendance events *****/ sprintf (Query,"DELETE FROM att_grp USING crs_grp,att_grp" " WHERE crs_grp.GrpTypCod=%ld" " AND crs_grp.GrpCod=att_grp.GrpCod", GrpTypCod); DB_QueryDELETE (Query,"can not remove groups of a type from the associations between attendance events and groups"); } /*****************************************************************************/ /***************** Create groups of an attendance event **********************/ /*****************************************************************************/ static void Att_CreateGrps (long AttCod) { unsigned NumGrpSel; char Query[256]; /***** Create groups of the attendance event *****/ for (NumGrpSel = 0; NumGrpSel < Gbl.CurrentCrs.Grps.LstGrpsSel.NumGrps; NumGrpSel++) { /* Create group */ sprintf (Query,"INSERT INTO att_grp" " (AttCod,GrpCod)" " VALUES" " (%ld,%ld)", AttCod,Gbl.CurrentCrs.Grps.LstGrpsSel.GrpCods[NumGrpSel]); DB_QueryINSERT (Query,"can not associate a group to an attendance event"); } } /*****************************************************************************/ /****** Get and write the names of the groups of an attendance event *********/ /*****************************************************************************/ static void Att_GetAndWriteNamesOfGrpsAssociatedToAttEvent (struct AttendanceEvent *Att) { extern const char *Txt_Group; extern const char *Txt_Groups; extern const char *Txt_and; extern const char *Txt_The_whole_course; char Query[512]; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumGrp; unsigned NumGrps; /***** Get groups associated to an attendance event from database *****/ sprintf (Query,"SELECT crs_grp_types.GrpTypName,crs_grp.GrpName" " FROM att_grp,crs_grp,crs_grp_types" " WHERE att_grp.AttCod=%ld" " AND att_grp.GrpCod=crs_grp.GrpCod" " AND crs_grp.GrpTypCod=crs_grp_types.GrpTypCod" " ORDER BY crs_grp_types.GrpTypName,crs_grp.GrpName", Att->AttCod); NumGrps = (unsigned) DB_QuerySELECT (Query,&mysql_res,"can not get groups of an attendance event"); /***** Write heading *****/ fprintf (Gbl.F.Out,"
%s: ", Att->Hidden ? "ASG_GRP_LIGHT" : "ASG_GRP", (NumGrps == 1) ? Txt_Group : Txt_Groups); /***** Write groups *****/ if (NumGrps) // Groups found... { /* Get and write the group types and names */ for (NumGrp = 0; NumGrp < NumGrps; NumGrp++) { /* Get next group */ row = mysql_fetch_row (mysql_res); /* Write group type name and group name */ fprintf (Gbl.F.Out,"%s %s",row[0],row[1]); if (NumGrps >= 2) { if (NumGrp == NumGrps-2) fprintf (Gbl.F.Out," %s ",Txt_and); if (NumGrps >= 3) if (NumGrp < NumGrps-2) fprintf (Gbl.F.Out,", "); } } } else fprintf (Gbl.F.Out,"%s %s", Txt_The_whole_course,Gbl.CurrentCrs.Crs.ShrtName); fprintf (Gbl.F.Out,"
"); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); } /*****************************************************************************/ /*********** Remove all users registered in an attendance event **************/ /*****************************************************************************/ static void Att_RemoveAllUsrsFromAnAttEvent (long AttCod) { char Query[256]; sprintf (Query,"DELETE FROM att_usr WHERE AttCod=%ld",AttCod); DB_QueryDELETE (Query,"can not remove attendance event"); } /*****************************************************************************/ /* Remove one user from all the attendance events where he/she is registered */ /*****************************************************************************/ void Att_RemoveUsrFromAllAttEvents (long UsrCod) { char Query[256]; /***** Remove group from all the attendance events *****/ sprintf (Query,"DELETE FROM att_usr WHERE UsrCod=%ld",UsrCod); DB_QueryDELETE (Query,"can not remove user from all attendance events"); } /*****************************************************************************/ /*********** Remove one student from all the attendance events ***************/ /*****************************************************************************/ void Att_RemoveUsrFromCrsAttEvents (long UsrCod,long CrsCod) { char Query[512]; /***** Remove group from all the attendance events *****/ sprintf (Query,"DELETE FROM att_usr USING att_events,att_usr" " WHERE att_events.CrsCod=%ld" " AND att_events.AttCod=att_usr.AttCod" " AND att_usr.UsrCod=%ld", CrsCod,UsrCod); DB_QueryDELETE (Query,"can not remove user from attendance events of a course"); } /*****************************************************************************/ /*********************** Remove an attendance event **************************/ /*****************************************************************************/ static void Att_RemoveAttEventFromCurrentCrs (long AttCod) { char Query[256]; sprintf (Query,"DELETE FROM att_events" " WHERE AttCod=%ld AND CrsCod=%ld", AttCod,Gbl.CurrentCrs.Crs.CrsCod); DB_QueryDELETE (Query,"can not remove attendance event"); } /*****************************************************************************/ /*************** Remove all the attendance events of a course ****************/ /*****************************************************************************/ void Att_RemoveCrsAttEvents (long CrsCod) { char Query[512]; /***** Remove students *****/ sprintf (Query,"DELETE FROM att_usr USING att_events,att_usr" " WHERE att_events.CrsCod=%ld" " AND att_events.AttCod=att_usr.AttCod", CrsCod); DB_QueryDELETE (Query,"can not remove all the students registered in events of a course"); /***** Remove groups *****/ sprintf (Query,"DELETE FROM att_grp USING att_events,att_grp" " WHERE att_events.CrsCod=%ld" " AND att_events.AttCod=att_grp.AttCod", CrsCod); DB_QueryDELETE (Query,"can not remove all the groups associated to attendance events of a course"); /***** Remove attendance events *****/ sprintf (Query,"DELETE FROM att_events WHERE CrsCod=%ld", CrsCod); DB_QueryDELETE (Query,"can not remove all the attendance events of a course"); } /*****************************************************************************/ /*************** Get number of attendance events in a course *****************/ /*****************************************************************************/ unsigned Att_GetNumAttEventsInCrs (long CrsCod) { char Query[256]; /***** Get number of attendance events in a course from database *****/ sprintf (Query,"SELECT COUNT(*) FROM att_events WHERE CrsCod=%ld", CrsCod); return (unsigned) DB_QueryCOUNT (Query,"can not get number of attendance events in course"); } /*****************************************************************************/ /*************** Get number of courses with attendance events ****************/ /*****************************************************************************/ // Returns the number of courses with attendance events // in this location (all the platform, current degree or current course) unsigned Att_GetNumCoursesWithAttEvents (Sco_Scope_t Scope) { char Query[1024]; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumCourses; /***** Get number of courses with attendance events from database *****/ switch (Scope) { case Sco_SCOPE_SYS: sprintf (Query,"SELECT COUNT(DISTINCT CrsCod)" " FROM att_events" " WHERE CrsCod>0"); break; case Sco_SCOPE_INS: sprintf (Query,"SELECT COUNT(DISTINCT att_events.CrsCod)" " FROM centres,degrees,courses,att_events" " WHERE centres.InsCod=%ld" " AND centres.CtrCod=degrees.CtrCod" " AND degrees.DegCod=courses.DegCod" " AND courses.Status=0" " AND courses.CrsCod=att_events.CrsCod", Gbl.CurrentIns.Ins.InsCod); break; case Sco_SCOPE_CTR: sprintf (Query,"SELECT COUNT(DISTINCT att_events.CrsCod)" " FROM degrees,courses,att_events" " WHERE degrees.CtrCod=%ld" " AND degrees.DegCod=courses.DegCod" " AND courses.Status=0" " AND courses.CrsCod=att_events.CrsCod", Gbl.CurrentCtr.Ctr.CtrCod); break; case Sco_SCOPE_DEG: sprintf (Query,"SELECT COUNT(DISTINCT att_events.CrsCod)" " FROM courses,att_events" " WHERE courses.DegCod=%ld" " AND courses.Status=0" " AND courses.CrsCod=att_events.CrsCod", Gbl.CurrentDeg.Deg.DegCod); break; case Sco_SCOPE_CRS: sprintf (Query,"SELECT COUNT(DISTINCT CrsCod)" " FROM att_events" " WHERE CrsCod=%ld", Gbl.CurrentCrs.Crs.CrsCod); break; default: Lay_ShowErrorAndExit ("Wrong scope."); break; } DB_QuerySELECT (Query,&mysql_res,"can not get number of courses with attendance events"); /***** Get number of courses *****/ row = mysql_fetch_row (mysql_res); if (sscanf (row[0],"%u",&NumCourses) != 1) Lay_ShowErrorAndExit ("Error when getting number of courses with attendance events."); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return NumCourses; } /*****************************************************************************/ /********************* Get number of attendance events ***********************/ /*****************************************************************************/ // Returns the number of attendance events // in this location (all the platform, current degree or current course) unsigned Att_GetNumAttEvents (Sco_Scope_t Scope,unsigned *NumNotif) { char Query[1024]; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumAttEvents; /***** Get number of attendance events from database *****/ switch (Scope) { case Sco_SCOPE_SYS: sprintf (Query,"SELECT COUNT(*),SUM(NumNotif)" " FROM att_events" " WHERE CrsCod>0"); break; case Sco_SCOPE_INS: sprintf (Query,"SELECT COUNT(*),SUM(att_events.NumNotif)" " FROM centres,degrees,courses,att_events" " WHERE centres.InsCod=%ld" " AND centres.CtrCod=degrees.CtrCod" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=att_events.CrsCod", Gbl.CurrentIns.Ins.InsCod); break; case Sco_SCOPE_CTR: sprintf (Query,"SELECT COUNT(*),SUM(att_events.NumNotif)" " FROM degrees,courses,att_events" " WHERE degrees.CtrCod=%ld" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=att_events.CrsCod", Gbl.CurrentCtr.Ctr.CtrCod); break; case Sco_SCOPE_DEG: sprintf (Query,"SELECT COUNT(*),SUM(att_events.NumNotif)" " FROM courses,att_events" " WHERE courses.DegCod=%ld" " AND courses.CrsCod=att_events.CrsCod", Gbl.CurrentDeg.Deg.DegCod); break; case Sco_SCOPE_CRS: sprintf (Query,"SELECT COUNT(*),SUM(NumNotif)" " FROM att_events" " WHERE CrsCod=%ld", Gbl.CurrentCrs.Crs.CrsCod); break; default: Lay_ShowErrorAndExit ("Wrong scope."); break; } DB_QuerySELECT (Query,&mysql_res,"can not get number of attendance events"); /***** Get number of attendance events *****/ row = mysql_fetch_row (mysql_res); if (sscanf (row[0],"%u",&NumAttEvents) != 1) Lay_ShowErrorAndExit ("Error when getting number of attendance events."); /***** Get number of notifications by email *****/ if (row[1]) { if (sscanf (row[1],"%u",NumNotif) != 1) Lay_ShowErrorAndExit ("Error when getting number of notifications of attendance events."); } else *NumNotif = 0; /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return NumAttEvents; } /*****************************************************************************/ /************************ Show one attendance event **************************/ /*****************************************************************************/ void Att_SeeOneAttEvent (void) { extern const char *Hlp_USERS_Attendance; extern const char *Txt_Event; struct AttendanceEvent Att; /***** Get attendance event code *****/ if (Gbl.AttEvents.AttCod <= 0) if ((Gbl.AttEvents.AttCod = Att_GetParamAttCod ()) == -1L) Lay_ShowErrorAndExit ("Code of attendance event is missing."); /***** Get parameters *****/ Att_GetParamAttOrder (); Grp_GetParamWhichGrps (); Gbl.AttEvents.CurrentPage = Pag_GetParamPagNum (Pag_ATT_EVENTS); /***** Show attendance *****/ Lay_StartRoundFrameTable (NULL,Txt_Event,NULL,Hlp_USERS_Attendance,2); Att.AttCod = Gbl.AttEvents.AttCod; Att_ShowOneAttEvent (&Att,true); Lay_EndRoundFrameTable (); switch (Gbl.Usrs.Me.LoggedRole) { case Rol_STUDENT: Att_ListAttOnlyMeAsStudent (&Att); break; case Rol_TEACHER: case Rol_SYS_ADM: /***** Show list of students *****/ Att_ListAttStudents (&Att); break; default: break; } } /*****************************************************************************/ /*********************** List me as student in one event *********************/ /*****************************************************************************/ // Att must be filled before calling this function static void Att_ListAttOnlyMeAsStudent (struct AttendanceEvent *Att) { extern const char *Hlp_USERS_Attendance; extern const char *Txt_Student_comment; extern const char *Txt_Teachers_comment; extern const char *Txt_ROLES_SINGUL_Abc[Rol_NUM_ROLES][Usr_NUM_SEXS]; extern const char *Txt_Save; /***** Get my preference about photos in users' list for current course *****/ Usr_GetMyPrefAboutListWithPhotosFromDB (); /***** Start form *****/ if (Att->Open) { Act_FormStart (ActRecAttMe); Att_PutParamAttCod (Att->AttCod); } /***** List students' data *****/ /* Header */ Lay_StartRoundFrameTable (NULL,NULL,NULL,Hlp_USERS_Attendance,2); fprintf (Gbl.F.Out,"" "" "" ""); if (Gbl.Usrs.Listing.WithPhotos) fprintf (Gbl.F.Out,""); fprintf (Gbl.F.Out,"" "%s" "" "" "%s" "" "" "%s" "" "", Txt_ROLES_SINGUL_Abc[Rol_STUDENT][Usr_SEX_UNKNOWN], Txt_Student_comment, Txt_Teachers_comment); /* List of students (only me) */ Att_WriteRowStdToCallTheRoll (1,&Gbl.Usrs.Me.UsrDat,Att); /* Footer */ Lay_EndRoundFrameTable (); if (Att->Open) { /***** Send button *****/ Lay_PutConfirmButton (Txt_Save); Act_FormEnd (); } } /*****************************************************************************/ /*************** List students who attended to one event *********************/ /*****************************************************************************/ // Att must be filled before calling this function static void Att_ListAttStudents (struct AttendanceEvent *Att) { extern const char *Hlp_USERS_Attendance; extern const char *Txt_Attendance; extern const char *Txt_Student_comment; extern const char *Txt_Teachers_comment; extern const char *Txt_ROLES_SINGUL_Abc[Rol_NUM_ROLES][Usr_NUM_SEXS]; extern const char *Txt_Save; unsigned NumStd; struct UsrData UsrDat; /***** Get groups to show ******/ Grp_GetParCodsSeveralGrpsToShowUsrs (); /***** Get and order list of students in this course *****/ Usr_GetListUsrs (Rol_STUDENT,Sco_SCOPE_CRS); /***** Start frame *****/ Lay_StartRoundFrame (NULL,Txt_Attendance,NULL,Hlp_USERS_Attendance); /***** Form to select groups *****/ Grp_ShowFormToSelectSeveralGroups (ActSeeOneAtt); if (Gbl.Usrs.LstUsrs[Rol_STUDENT].NumUsrs) { /***** Get my preference about photos in users' list for current course *****/ Usr_GetMyPrefAboutListWithPhotosFromDB (); /***** Initialize structure with user's data *****/ Usr_UsrDataConstructor (&UsrDat); /***** Start form *****/ Act_FormStart (ActRecAttStd); Att_PutParamAttCod (Att->AttCod); Grp_PutParamsCodGrps (); /***** List students' data *****/ Lay_StartTableWideMargin (2); fprintf (Gbl.F.Out,"" "" "" ""); if (Gbl.Usrs.Listing.WithPhotos) fprintf (Gbl.F.Out,""); fprintf (Gbl.F.Out,"" "%s" "" "" "%s" "" "" "%s" "" "", Txt_ROLES_SINGUL_Abc[Rol_STUDENT][Usr_SEX_UNKNOWN], Txt_Student_comment, Txt_Teachers_comment); /* List of students */ for (NumStd = 0, Gbl.RowEvenOdd = 0; NumStd < Gbl.Usrs.LstUsrs[Rol_STUDENT].NumUsrs; NumStd++) { /* Copy user's basic data from list */ Usr_CopyBasicUsrDataFromList (&UsrDat,&Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst[NumStd]); /* Get list of user's IDs */ ID_GetListIDsFromUsrCod (&UsrDat); Att_WriteRowStdToCallTheRoll (NumStd + 1,&UsrDat,Att); } Lay_EndTable (); /* Send button */ Lay_PutConfirmButton (Txt_Save); /***** End form *****/ Act_FormEnd (); /***** Free memory used for user's data *****/ Usr_UsrDataDestructor (&UsrDat); } else Usr_ShowWarningNoUsersFound (Rol_STUDENT); /***** End frame *****/ Lay_EndRoundFrame (); /***** Free memory for students list *****/ Usr_FreeUsrsList (Rol_STUDENT); /***** Free memory for list of selected groups *****/ Grp_FreeListCodSelectedGrps (); } /*****************************************************************************/ /************ Write a row of a table with the data of a student **************/ /*****************************************************************************/ static void Att_WriteRowStdToCallTheRoll (unsigned NumStd,struct UsrData *UsrDat,struct AttendanceEvent *Att) { extern const char *Txt_Present; extern const char *Txt_Absent; bool Present; char PhotoURL[PATH_MAX + 1]; bool ShowPhoto; char CommentStd[Cns_MAX_BYTES_TEXT + 1]; char CommentTch[Cns_MAX_BYTES_TEXT + 1]; /***** Check if this student is already registered in the current event *****/ Present = Att_CheckIfUsrIsPresentInAttEventAndGetComments (Att->AttCod,UsrDat->UsrCod,CommentStd,CommentTch); /***** Icon to show if the user is already registered *****/ fprintf (Gbl.F.Out,"" "" "" "", Gbl.RowEvenOdd,NumStd, Gbl.Prefs.IconsURL, Present ? "check" : "check-empty", Present ? Txt_Present : Txt_Absent, Present ? Txt_Present : Txt_Absent); /***** Checkbox to select user *****/ fprintf (Gbl.F.Out,"" "EncryptedUsrCod); if (Present) // This student has attended to the event? fprintf (Gbl.F.Out," checked=\"checked\""); if (Gbl.Usrs.Me.LoggedRole == Rol_STUDENT) // A student can not change his attendance fprintf (Gbl.F.Out," disabled=\"disabled\""); fprintf (Gbl.F.Out," />" ""); /***** Write number of student in the list *****/ fprintf (Gbl.F.Out,"" "%u" "", UsrDat->Accepted ? "DAT_SMALL_N" : "DAT_SMALL", Gbl.RowEvenOdd, NumStd); /***** Show student's photo *****/ if (Gbl.Usrs.Listing.WithPhotos) { fprintf (Gbl.F.Out,"", Gbl.RowEvenOdd); ShowPhoto = Pho_ShowingUsrPhotoIsAllowed (UsrDat,PhotoURL); Pho_ShowUsrPhoto (UsrDat,ShowPhoto ? PhotoURL : NULL, "PHOTO45x60",Pho_ZOOM,false); fprintf (Gbl.F.Out,""); } /***** Write user's ID ******/ fprintf (Gbl.F.Out,"", UsrDat->Accepted ? "DAT_SMALL_N" : "DAT_SMALL", Gbl.RowEvenOdd); ID_WriteUsrIDs (UsrDat,NULL); fprintf (Gbl.F.Out,""); /***** Write student's name *****/ fprintf (Gbl.F.Out,"%s", UsrDat->Accepted ? "DAT_SMALL_N" : "DAT_SMALL", Gbl.RowEvenOdd, UsrDat->Surname1); if (UsrDat->Surname2[0]) fprintf (Gbl.F.Out," %s",UsrDat->Surname2); fprintf (Gbl.F.Out,", %s", UsrDat->FirstName); /***** Student's comment: write form or text */ fprintf (Gbl.F.Out,"", Gbl.RowEvenOdd); if (Gbl.Usrs.Me.LoggedRole == Rol_STUDENT && Att->Open) // Show with form fprintf (Gbl.F.Out,"", UsrDat->UsrCod,CommentStd); else // Show without form { Str_ChangeFormat (Str_FROM_HTML,Str_TO_RIGOROUS_HTML, CommentStd,Cns_MAX_BYTES_TEXT,false); fprintf (Gbl.F.Out,"%s",CommentStd); } fprintf (Gbl.F.Out,""); /***** Teacher's comment: write form, text or nothing */ fprintf (Gbl.F.Out,"", Gbl.RowEvenOdd); if (Gbl.Usrs.Me.LoggedRole == Rol_TEACHER) // Show with form fprintf (Gbl.F.Out,"", UsrDat->UsrCod,CommentTch); else if (Att->CommentTchVisible) // Show without form { Str_ChangeFormat (Str_FROM_HTML,Str_TO_RIGOROUS_HTML, CommentTch,Cns_MAX_BYTES_TEXT,false); fprintf (Gbl.F.Out,"%s",CommentTch); } fprintf (Gbl.F.Out,"" ""); Gbl.RowEvenOdd = 1 - Gbl.RowEvenOdd; } /*****************************************************************************/ /****** Put parameters with the default groups in an attendance event ********/ /*****************************************************************************/ static void Att_PutParamsCodGrps (long AttCod) { char Query[256]; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumGrp; unsigned NumGrps; /***** Get groups associated to an attendance event from database *****/ if (Gbl.CurrentCrs.Grps.NumGrps) { sprintf (Query,"SELECT GrpCod FROM att_grp WHERE att_grp.AttCod=%ld", AttCod); NumGrps = (unsigned) DB_QuerySELECT (Query,&mysql_res,"can not get groups of an attendance event"); } else NumGrps = 0; /***** Get groups *****/ if (NumGrps) // Groups found... { fprintf (Gbl.F.Out,""); } else /***** Write the boolean parameter that indicates if all the groups must be listed *****/ Par_PutHiddenParamChar ("AllGroups",'Y'); /***** Free structure that stores the query result *****/ if (Gbl.CurrentCrs.Grps.NumGrps) DB_FreeMySQLResult (&mysql_res); } /*****************************************************************************/ /*************** Save me as students who attended to an event ****************/ /*****************************************************************************/ void Att_RegisterMeAsStdInAttEvent (void) { extern const char *Txt_Your_comment_has_been_updated; struct AttendanceEvent Att; bool Present; char CommentParamName[10 + 10 + 1]; char CommentStd[Cns_MAX_BYTES_TEXT + 1]; char CommentTch[Cns_MAX_BYTES_TEXT + 1]; /***** Get attendance event code *****/ if ((Att.AttCod = Att_GetParamAttCod ()) == -1L) Lay_ShowErrorAndExit ("Code of attendance event is missing."); Att_GetDataOfAttEventByCodAndCheckCrs (&Att); // This checks that event belong to current course if (Att.Open) { /***** Get comments for this student *****/ Present = Att_CheckIfUsrIsPresentInAttEventAndGetComments (Att.AttCod,Gbl.Usrs.Me.UsrDat.UsrCod,CommentStd,CommentTch); sprintf (CommentParamName,"CommentStd%ld",Gbl.Usrs.Me.UsrDat.UsrCod); Par_GetParToHTML (CommentParamName,CommentStd,Cns_MAX_BYTES_TEXT); if (Present || CommentStd[0] || CommentTch[0]) /***** Register student *****/ Att_RegUsrInAttEventChangingComments (Att.AttCod,Gbl.Usrs.Me.UsrDat.UsrCod, Present,CommentStd,CommentTch); else /***** Remove student *****/ Att_RemoveUsrFromAttEvent (Att.AttCod,Gbl.Usrs.Me.UsrDat.UsrCod); /***** Write final message *****/ Ale_ShowAlert (Ale_SUCCESS,Txt_Your_comment_has_been_updated); } /***** Show the attendance event again *****/ Gbl.AttEvents.AttCod = Att.AttCod; Att_SeeOneAttEvent (); } /*****************************************************************************/ /***************** Save students who attended to an event ********************/ /*****************************************************************************/ /* Algorithm: 1. Get list of students in the groups selected: Gbl.Usrs.LstUsrs[Rol_STUDENT] 2. Mark all students in the groups selected setting Remove=true 3. Get list of students marked as present by me: Gbl.Usrs.Select.Std 4. Loop over the list Gbl.Usrs.Select.Std, that holds the list of the students marked as present, marking the students in Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst as Remove=false 5. Delete from att_usr all the students marked as Remove=true 6. Replace (insert without duplicated) into att_usr all the students marked as Remove=false */ void Att_RegisterStudentsInAttEvent (void) { extern const char *Txt_Presents; extern const char *Txt_Absents; struct AttendanceEvent Att; char Format[256]; unsigned NumStd; const char *Ptr; bool Present; unsigned NumStdsPresent; unsigned NumStdsAbsent; struct UsrData UsrData; char CommentParamName[10 + 10 + 1]; char CommentStd[Cns_MAX_BYTES_TEXT + 1]; char CommentTch[Cns_MAX_BYTES_TEXT + 1]; /***** Get attendance event code *****/ if ((Att.AttCod = Att_GetParamAttCod ()) == -1L) Lay_ShowErrorAndExit ("Code of attendance event is missing."); Att_GetDataOfAttEventByCodAndCheckCrs (&Att); // This checks that event belong to current course /***** Get groups selected *****/ Grp_GetParCodsSeveralGrpsToShowUsrs (); /***** 1. Get list of students in the groups selected: Gbl.Usrs.LstUsrs[Rol_STUDENT] *****/ /* Get list of students in the groups selected */ Usr_GetListUsrs (Rol_STUDENT,Sco_SCOPE_CRS); if (Gbl.Usrs.LstUsrs[Rol_STUDENT].NumUsrs) // If there are students in the groups selected... { /***** 2. Mark all students in the groups selected setting Remove=true *****/ for (NumStd = 0; NumStd < Gbl.Usrs.LstUsrs[Rol_STUDENT].NumUsrs; NumStd++) Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst[NumStd].Remove = true; /***** 3. Get list of students marked as present by me: Gbl.Usrs.Select.Std *****/ Usr_GetListsSelectedUsrsCods (); /***** Initialize structure with user's data *****/ Usr_UsrDataConstructor (&UsrData); /***** 4. Loop over the list Gbl.Usrs.Select.Std, that holds the list of the students marked as present, marking the students in Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst as Remove=false *****/ Ptr = Gbl.Usrs.Select.Std; while (*Ptr) { Par_GetNextStrUntilSeparParamMult (&Ptr,UsrData.EncryptedUsrCod, Cry_BYTES_ENCRYPTED_STR_SHA256_BASE64); Usr_GetUsrCodFromEncryptedUsrCod (&UsrData); if (UsrData.UsrCod > 0) // Student exists in database /***** Mark student to not be removed *****/ for (NumStd = 0; NumStd < Gbl.Usrs.LstUsrs[Rol_STUDENT].NumUsrs; NumStd++) if (Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst[NumStd].UsrCod == UsrData.UsrCod) { Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst[NumStd].Remove = false; break; // Found! Exit loop } } /***** Free memory used for user's data *****/ Usr_UsrDataDestructor (&UsrData); /***** Free memory *****/ /* Free memory used by list of selected students' codes */ Usr_FreeListsSelectedUsrsCods (); // 5. Delete from att_usr all the students marked as Remove=true // 6. Replace (insert without duplicated) into att_usr all the students marked as Remove=false for (NumStd = 0, NumStdsAbsent = NumStdsPresent = 0; NumStd < Gbl.Usrs.LstUsrs[Rol_STUDENT].NumUsrs; NumStd++) { /***** Get comments for this student *****/ Att_CheckIfUsrIsPresentInAttEventAndGetComments (Att.AttCod,Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst[NumStd].UsrCod,CommentStd,CommentTch); sprintf (CommentParamName,"CommentTch%ld",Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst[NumStd].UsrCod); Par_GetParToHTML (CommentParamName,CommentTch,Cns_MAX_BYTES_TEXT); Present = !Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst[NumStd].Remove; if (Present || CommentStd[0] || CommentTch[0]) /***** Register student *****/ Att_RegUsrInAttEventChangingComments (Att.AttCod,Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst[NumStd].UsrCod, Present,CommentStd,CommentTch); else /***** Remove student *****/ Att_RemoveUsrFromAttEvent (Att.AttCod,Gbl.Usrs.LstUsrs[Rol_STUDENT].Lst[NumStd].UsrCod); if (Present) NumStdsPresent++; else NumStdsAbsent++; } /***** Free memory for students list *****/ Usr_FreeUsrsList (Rol_STUDENT); /***** Write final message *****/ sprintf (Format,"%s: %%u
%s: %%u",Txt_Presents,Txt_Absents); sprintf (Gbl.Alert.Txt,Format, NumStdsPresent,NumStdsAbsent); Ale_ShowAlert (Ale_INFO,Gbl.Alert.Txt); } else // Gbl.Usrs.LstUsrs[Rol_STUDENT].NumUsrs == 0 /***** Show warning indicating no students found *****/ Usr_ShowWarningNoUsersFound (Rol_STUDENT); /***** Show the attendance event again *****/ Gbl.AttEvents.AttCod = Att.AttCod; Att_SeeOneAttEvent (); /***** Free memory for list of groups selected *****/ Grp_FreeListCodSelectedGrps (); } /*****************************************************************************/ /******* Get number of students from a list who attended to an event *********/ /*****************************************************************************/ static void Att_GetNumStdsTotalWhoAreInAttEvent (struct AttendanceEvent *Att) { char Query[128]; /***** Count number of students registered in an event in database *****/ sprintf (Query,"SELECT COUNT(*) FROM att_usr" " WHERE AttCod=%ld AND Present='Y'", Att->AttCod); Att->NumStdsTotal = (unsigned) DB_QueryCOUNT (Query,"can not get number of students who are registered in an event"); } /*****************************************************************************/ /******* Get number of students from a list who attended to an event *********/ /*****************************************************************************/ static unsigned Att_GetNumStdsFromAListWhoAreInAttEvent (long AttCod,long LstSelectedUsrCods[],unsigned NumStdsInList) { char *Query; char SubQuery[1 + 1 + 10 + 1]; unsigned NumStd; unsigned NumStdsInAttEvent = 0; size_t MaxLength; if (NumStdsInList) { /***** Allocate space for query *****/ MaxLength = 256 + NumStdsInList * (1 + 1 + 10); if ((Query = (char *) malloc (MaxLength + 1)) == NULL) Lay_ShowErrorAndExit ("Not enough memory for query."); /***** Count number of students registered in an event in database *****/ sprintf (Query,"SELECT COUNT(*) FROM att_usr" " WHERE AttCod=%ld" " AND UsrCod IN (", AttCod); for (NumStd = 0; NumStd < NumStdsInList; NumStd++) { sprintf (SubQuery, NumStd ? ",%ld" : "%ld", LstSelectedUsrCods[NumStd]); Str_Concat (Query,SubQuery, MaxLength); } Str_Concat (Query,") AND Present='Y'", MaxLength); NumStdsInAttEvent = (unsigned) DB_QueryCOUNT (Query,"can not get number of students from a list who are registered in an event"); /***** Free query *****/ free ((void *) Query); } return NumStdsInAttEvent; } /*****************************************************************************/ /***************** Check if a student attended to an event *******************/ /*****************************************************************************/ static bool Att_CheckIfUsrIsInTableAttUsr (long AttCod,long UsrCod,bool *Present) { char Query[256]; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumRows; bool InDBTable; /***** Check if a student is registered in an event in database *****/ sprintf (Query,"SELECT Present FROM att_usr" " WHERE AttCod=%ld AND UsrCod=%ld", AttCod,UsrCod); if ((NumRows = (unsigned) DB_QuerySELECT (Query,&mysql_res,"can not get if a student is already registered in an event"))) { InDBTable = true; /* Get row */ row = mysql_fetch_row (mysql_res); /* Get if present (row[0]) */ *Present = (row[0][0] == 'Y'); } else // User is not present { InDBTable = false; *Present = false; } /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return InDBTable; } /*****************************************************************************/ /***************** Check if a student attended to an event *******************/ /*****************************************************************************/ static bool Att_CheckIfUsrIsPresentInAttEvent (long AttCod,long UsrCod) { bool Present; Att_CheckIfUsrIsInTableAttUsr (AttCod,UsrCod,&Present); return Present; } /*****************************************************************************/ /***************** Check if a student attended to an event *******************/ /*****************************************************************************/ static bool Att_CheckIfUsrIsPresentInAttEventAndGetComments (long AttCod,long UsrCod, char CommentStd[Cns_MAX_BYTES_TEXT + 1], char CommentTch[Cns_MAX_BYTES_TEXT + 1]) { char Query[256]; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumRows; bool Present; /***** Check if a students is registered in an event in database *****/ sprintf (Query,"SELECT Present,CommentStd,CommentTch FROM att_usr" " WHERE AttCod=%ld AND UsrCod=%ld", AttCod,UsrCod); if ((NumRows = (unsigned) DB_QuerySELECT (Query,&mysql_res,"can not get if a student is already registered in an event"))) { /* Get row */ row = mysql_fetch_row (mysql_res); /* Get if present (row[0]) */ Present = (row[0][0] == 'Y'); /* Get student's comment (row[1]) */ Str_Copy (CommentStd,row[1], Cns_MAX_BYTES_TEXT); /* Get teacher's comment (row[2]) */ Str_Copy (CommentTch,row[2], Cns_MAX_BYTES_TEXT); } else // User is not present { Present = false; CommentStd[0] = CommentTch[0] = '\0'; } /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return Present; } /*****************************************************************************/ /******* Register a user in an attendance event not changing comments ********/ /*****************************************************************************/ void Att_RegUsrInAttEventNotChangingComments (long AttCod,long UsrCod) { bool Present; char Query[256]; /***** Check if user is already in table att_usr (present or not) *****/ if (Att_CheckIfUsrIsInTableAttUsr (AttCod,UsrCod,&Present)) // User is in table att_usr { // If already present ==> nothing to do if (!Present) { /***** Set user as present in database *****/ sprintf (Query,"UPDATE att_usr SET Present='Y'" " WHERE AttCod=%ld AND UsrCod=%ld", AttCod,UsrCod); DB_QueryUPDATE (Query,"can not set user as present in an event"); } } else // User is not in table att_usr Att_RegUsrInAttEventChangingComments (AttCod,UsrCod,true,"",""); } /*****************************************************************************/ /********* Register a user in an attendance event changing comments **********/ /*****************************************************************************/ static void Att_RegUsrInAttEventChangingComments (long AttCod,long UsrCod,bool Present, const char *CommentStd,const char *CommentTch) { char Query[256 + Cns_MAX_BYTES_TEXT * 2]; /***** Register user as assistant to an event in database *****/ sprintf (Query,"REPLACE INTO att_usr" " (AttCod,UsrCod,Present,CommentStd,CommentTch)" " VALUES" " (%ld,%ld,'%c','%s','%s')", AttCod,UsrCod, Present ? 'Y' : 'N', CommentStd, CommentTch); DB_QueryREPLACE (Query,"can not register user in an event"); } /*****************************************************************************/ /********************** Remove a user from an event **************************/ /*****************************************************************************/ static void Att_RemoveUsrFromAttEvent (long AttCod,long UsrCod) { char Query[256]; /***** Remove user if there is no comment in database *****/ sprintf (Query,"DELETE FROM att_usr" " WHERE AttCod=%ld AND UsrCod=%ld", AttCod,UsrCod); DB_QueryREPLACE (Query,"can not remove student from an event"); } /*****************************************************************************/ /************ Remove users absent without comments from an event *************/ /*****************************************************************************/ void Att_RemoveUsrsAbsentWithoutCommentsFromAttEvent (long AttCod) { char Query[256]; /***** Clean table att_usr *****/ sprintf (Query,"DELETE FROM att_usr" " WHERE AttCod=%ld AND Present='N'" " AND CommentStd='' AND CommentTch=''", AttCod); DB_QueryDELETE (Query,"can not remove users absent without comments from an event"); } /*****************************************************************************/ /********* Request listing attendance of students to several events **********/ /*****************************************************************************/ void Usr_ReqListStdsAttendanceCrs (void) { extern const char *Hlp_USERS_Attendance_attendance_list; extern const char *Txt_ROLES_PLURAL_Abc[Rol_NUM_ROLES][Usr_NUM_SEXS]; extern const char *Txt_Show_list; /***** Get list of attendance events *****/ Att_GetListAttEvents (Att_OLDEST_FIRST); /***** Get and update type of list, number of columns in class photo and preference about view photos *****/ Usr_GetAndUpdatePrefsAboutUsrList (); /***** Get groups to show ******/ Grp_GetParCodsSeveralGrpsToShowUsrs (); /***** Get and order lists of users from current course *****/ Usr_GetListUsrs (Rol_STUDENT,Sco_SCOPE_CRS); /***** Start frame *****/ Lay_StartRoundFrame (NULL,Txt_ROLES_PLURAL_Abc[Rol_STUDENT][Usr_SEX_UNKNOWN], NULL,Hlp_USERS_Attendance_attendance_list); /***** Form to select groups *****/ Grp_ShowFormToSelectSeveralGroups (ActReqLstStdAtt); if (Gbl.Usrs.LstUsrs[Rol_STUDENT].NumUsrs) { if (Usr_GetIfShowBigList (Gbl.Usrs.LstUsrs[Rol_STUDENT].NumUsrs,NULL)) { /***** Get list of selected users *****/ Usr_GetListsSelectedUsrsCods (); /***** Draw a class photo with students of the course *****/ /* Form to select type of list used for select several users */ Usr_ShowFormsToSelectUsrListType (ActReqLstStdAtt); /* Start form */ Act_FormStart (ActSeeLstStdAtt); Grp_PutParamsCodGrps (); /* Write list of students to select some of them */ Lay_StartTableCenter (0); Usr_ListUsersToSelect (Rol_STUDENT); Lay_EndTable (); /* Send button */ Lay_PutConfirmButton (Txt_Show_list); /* End form */ Act_FormEnd (); /***** Free memory used by list of selected users' codes *****/ Usr_FreeListsSelectedUsrsCods (); } } else Usr_ShowWarningNoUsersFound (Rol_STUDENT); /***** End frame *****/ Lay_EndRoundFrame (); /***** Free memory for students list *****/ Usr_FreeUsrsList (Rol_STUDENT); /***** Free memory for list of selected groups *****/ Grp_FreeListCodSelectedGrps (); /***** Free list of attendance events *****/ Att_FreeListAttEvents (); } /*****************************************************************************/ /********** List my attendance (I am a student) to several events ************/ /*****************************************************************************/ void Usr_ListMyAttendanceCrs (void) { Usr_ListOrPrintMyAttendanceCrs (Att_NORMAL_VIEW_ONLY_ME); } void Usr_PrintMyAttendanceCrs (void) { Usr_ListOrPrintMyAttendanceCrs (Att_PRINT_VIEW); } static void Usr_ListOrPrintMyAttendanceCrs (Att_TypeOfView_t TypeOfView) { unsigned NumAttEvent; /***** Get list of attendance events *****/ Att_GetListAttEvents (Att_OLDEST_FIRST); /***** Get boolean parameter that indicates if details must be shown *****/ Gbl.AttEvents.ShowDetails = Par_GetParToBool ("ShowDetails"); /***** Get list of groups selected ******/ Grp_GetParCodsSeveralGrpsToShowUsrs (); /***** Get number of students in each event *****/ for (NumAttEvent = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++) /* Get number of students in this event */ Gbl.AttEvents.Lst[NumAttEvent].NumStdsFromList = Att_GetNumStdsFromAListWhoAreInAttEvent (Gbl.AttEvents.Lst[NumAttEvent].AttCod, &Gbl.Usrs.Me.UsrDat.UsrCod,1); /***** Get list of attendance events selected *****/ Att_GetListSelectedAttCods (&Gbl.AttEvents.StrAttCodsSelected); /***** List events to select *****/ Att_ListEventsToSelect (TypeOfView); /***** Get my preference about photos in users' list for current course *****/ Usr_GetMyPrefAboutListWithPhotosFromDB (); /***** Show table with attendances for every student in list *****/ Att_ListStdsAttendanceTable (TypeOfView,1,&Gbl.Usrs.Me.UsrDat.UsrCod); /***** Show details or put button to show details *****/ if (Gbl.AttEvents.ShowDetails) Att_ListStdsWithAttEventsDetails (TypeOfView,1,&Gbl.Usrs.Me.UsrDat.UsrCod); /***** Free memory for list of attendance events selected *****/ free ((void *) Gbl.AttEvents.StrAttCodsSelected); /***** Free list of groups selected *****/ Grp_FreeListCodSelectedGrps (); /***** Free list of attendance events *****/ Att_FreeListAttEvents (); } /*****************************************************************************/ /************* List attendance of students to several events *****************/ /*****************************************************************************/ void Usr_ListStdsAttendanceCrs (void) { Usr_ListOrPrintStdsAttendanceCrs (Att_NORMAL_VIEW_STUDENTS); } void Usr_PrintStdsAttendanceCrs (void) { Usr_ListOrPrintStdsAttendanceCrs (Att_PRINT_VIEW); } static void Usr_ListOrPrintStdsAttendanceCrs (Att_TypeOfView_t TypeOfView) { extern const char *Txt_You_must_select_one_ore_more_students; unsigned NumStdsInList; long *LstSelectedUsrCods; unsigned NumAttEvent; /***** Get list of attendance events *****/ Att_GetListAttEvents (Att_OLDEST_FIRST); /***** Get list of selected students *****/ Usr_GetListsSelectedUsrsCods (); /* Check the number of students to list */ if ((NumStdsInList = Usr_CountNumUsrsInListOfSelectedUsrs ())) { /***** Get boolean parameter that indicates if details must be shown *****/ Gbl.AttEvents.ShowDetails = Par_GetParToBool ("ShowDetails"); /***** Get list of groups selected ******/ Grp_GetParCodsSeveralGrpsToShowUsrs (); /***** Get list of students selected to show their attendances *****/ Att_GetListSelectedUsrCods (NumStdsInList,&LstSelectedUsrCods); /***** Get number of students in each event *****/ for (NumAttEvent = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++) /* Get number of students in this event */ Gbl.AttEvents.Lst[NumAttEvent].NumStdsFromList = Att_GetNumStdsFromAListWhoAreInAttEvent (Gbl.AttEvents.Lst[NumAttEvent].AttCod, LstSelectedUsrCods,NumStdsInList); /***** Get list of attendance events selected *****/ Att_GetListSelectedAttCods (&Gbl.AttEvents.StrAttCodsSelected); /***** List events to select *****/ Att_ListEventsToSelect (TypeOfView); /***** Get my preference about photos in users' list for current course *****/ Usr_GetMyPrefAboutListWithPhotosFromDB (); /***** Show table with attendances for every student in list *****/ Att_ListStdsAttendanceTable (TypeOfView,NumStdsInList,LstSelectedUsrCods); /***** Show details or put button to show details *****/ if (Gbl.AttEvents.ShowDetails) Att_ListStdsWithAttEventsDetails (TypeOfView,NumStdsInList,LstSelectedUsrCods); /***** Free memory for list of attendance events selected *****/ free ((void *) Gbl.AttEvents.StrAttCodsSelected); /***** Free list of user codes *****/ free ((void *) LstSelectedUsrCods); /***** Free list of groups selected *****/ Grp_FreeListCodSelectedGrps (); } else // No students selected { Ale_ShowAlert (Ale_WARNING,Txt_You_must_select_one_ore_more_students); Usr_ReqListStdsAttendanceCrs (); // ...show again the form } /***** Free memory used by list of selected users' codes *****/ Usr_FreeListsSelectedUsrsCods (); /***** Free list of attendance events *****/ Att_FreeListAttEvents (); } /*****************************************************************************/ /********** Get list of students selected to show their attendances **********/ /*****************************************************************************/ static void Att_GetListSelectedUsrCods (unsigned NumStdsInList,long **LstSelectedUsrCods) { unsigned NumStd; const char *Ptr; struct UsrData UsrDat; /***** Create list of user codes *****/ if ((*LstSelectedUsrCods = (long *) calloc ((size_t) NumStdsInList,sizeof (long))) == NULL) Lay_ShowErrorAndExit ("Not enough memory to store list of user codes."); /***** Initialize structure with user's data *****/ Usr_UsrDataConstructor (&UsrDat); /***** Loop over the list Gbl.Usrs.Select.All getting users' codes *****/ for (NumStd = 0, Ptr = Gbl.Usrs.Select.All; NumStd < NumStdsInList && *Ptr; NumStd++) { Par_GetNextStrUntilSeparParamMult (&Ptr,UsrDat.EncryptedUsrCod, Cry_BYTES_ENCRYPTED_STR_SHA256_BASE64); Usr_GetUsrCodFromEncryptedUsrCod (&UsrDat); (*LstSelectedUsrCods)[NumStd] = UsrDat.UsrCod; } /***** Free memory used for user's data *****/ Usr_UsrDataDestructor (&UsrDat); } /*****************************************************************************/ /****************** Get list of attendance events selected *******************/ /*****************************************************************************/ static void Att_GetListSelectedAttCods (char **StrAttCodsSelected) { unsigned MaxSizeListAttCodsSelected; unsigned NumAttEvent; const char *Ptr; long AttCod; char LongStr[1 + 10 + 1]; char Query[256]; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumGrpsInThisEvent; unsigned NumGrpInThisEvent; long GrpCodInThisEvent; unsigned NumGrpSel; /***** Allocate memory for list of attendance events selected *****/ MaxSizeListAttCodsSelected = Gbl.AttEvents.Num * (1 + 10 + 1); if ((*StrAttCodsSelected = (char *) malloc (MaxSizeListAttCodsSelected + 1)) == NULL) Lay_ShowErrorAndExit ("Not enough memory to store list of attendance events selected."); /***** Get parameter multiple with list of attendance events selected *****/ Par_GetParMultiToText ("AttCods",*StrAttCodsSelected,MaxSizeListAttCodsSelected); /***** Set which attendance events will be shown as selected (checkboxes on) *****/ if ((*StrAttCodsSelected)[0]) // There are events selected { /* Reset selection */ for (NumAttEvent = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++) Gbl.AttEvents.Lst[NumAttEvent].Selected = false; /* Set some events as selected */ for (Ptr = *StrAttCodsSelected; *Ptr; ) { /* Get next attendance event selected */ Par_GetNextStrUntilSeparParamMult (&Ptr,LongStr,1 + 10); AttCod = Str_ConvertStrCodToLongCod (LongStr); /* Set each event in *StrAttCodsSelected as selected */ for (NumAttEvent = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++) if (Gbl.AttEvents.Lst[NumAttEvent].AttCod == AttCod) Gbl.AttEvents.Lst[NumAttEvent].Selected = true; } } else // No events selected { /***** Set which events will be marked as selected by default *****/ if (!Gbl.CurrentCrs.Grps.NumGrps || // Course has no groups Gbl.Usrs.ClassPhoto.AllGroups) // All groups selected /* Set all events as selected */ for (NumAttEvent = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++) Gbl.AttEvents.Lst[NumAttEvent].Selected = true; else // Course has groups and not all of them are selected for (NumAttEvent = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++) { /* Reset selection */ Gbl.AttEvents.Lst[NumAttEvent].Selected = false; /* Set this event as selected? */ if (Gbl.AttEvents.Lst[NumAttEvent].NumStdsFromList) // Some students attended to this event Gbl.AttEvents.Lst[NumAttEvent].Selected = true; else // No students attended to this event { /***** Get groups associated to an attendance event from database *****/ sprintf (Query,"SELECT GrpCod FROM att_grp" " WHERE att_grp.AttCod=%ld", Gbl.AttEvents.Lst[NumAttEvent].AttCod); NumGrpsInThisEvent = (unsigned) DB_QuerySELECT (Query,&mysql_res,"can not get groups of an attendance event"); if (NumGrpsInThisEvent) // This event is associated to groups /* Get groups associated to this event */ for (NumGrpInThisEvent = 0; NumGrpInThisEvent < NumGrpsInThisEvent && !Gbl.AttEvents.Lst[NumAttEvent].Selected; NumGrpInThisEvent++) { /* Get next group associated to this event */ row = mysql_fetch_row (mysql_res); if ((GrpCodInThisEvent = Str_ConvertStrCodToLongCod (row[0])) > 0) /* Check if this group is selected */ for (NumGrpSel = 0; NumGrpSel < Gbl.CurrentCrs.Grps.LstGrpsSel.NumGrps && !Gbl.AttEvents.Lst[NumAttEvent].Selected; NumGrpSel++) if (Gbl.CurrentCrs.Grps.LstGrpsSel.GrpCods[NumGrpSel] == GrpCodInThisEvent) Gbl.AttEvents.Lst[NumAttEvent].Selected = true; } else // This event is not associated to groups Gbl.AttEvents.Lst[NumAttEvent].Selected = true; /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); } } } } /*****************************************************************************/ /****** Put icon to print my assistance (as student) to several events *******/ /*****************************************************************************/ static void Att_PutIconToPrintMyList (void) { Lay_PutContextualIconToPrint (ActPrnLstMyAtt,Att_PutFormToPrintMyListParams); } static void Att_PutFormToPrintMyListParams (void) { if (Gbl.AttEvents.ShowDetails) Par_PutHiddenParamChar ("ShowDetails",'Y'); if (Gbl.AttEvents.StrAttCodsSelected[0]) Par_PutHiddenParamString ("AttCods",Gbl.AttEvents.StrAttCodsSelected); } /*****************************************************************************/ /******** Put icon to print assistance of students to several events *********/ /*****************************************************************************/ static void Att_PutIconToPrintStdsList (void) { Lay_PutContextualIconToPrint (ActPrnLstStdAtt,Att_PutParamsToPrintStdsList); } static void Att_PutParamsToPrintStdsList (void) { if (Gbl.AttEvents.ShowDetails) Par_PutHiddenParamChar ("ShowDetails",'Y'); Grp_PutParamsCodGrps (); Usr_PutHiddenParUsrCodAll (ActPrnLstStdAtt,Gbl.Usrs.Select.All); if (Gbl.AttEvents.StrAttCodsSelected[0]) Par_PutHiddenParamString ("AttCods",Gbl.AttEvents.StrAttCodsSelected); } /*****************************************************************************/ /**** Put a link (form) to list assistance of students to several events *****/ /*****************************************************************************/ static void Att_PutButtonToShowDetails (void) { extern const char *Txt_Show_more_details; /***** Button to show more details *****/ Act_FormStart (Gbl.Action.Act); Par_PutHiddenParamChar ("ShowDetails",'Y'); Grp_PutParamsCodGrps (); Usr_PutHiddenParUsrCodAll (Gbl.Action.Act,Gbl.Usrs.Select.All); if (Gbl.AttEvents.StrAttCodsSelected[0]) Par_PutHiddenParamString ("AttCods",Gbl.AttEvents.StrAttCodsSelected); Lay_PutConfirmButton (Txt_Show_more_details); Act_FormEnd (); } /*****************************************************************************/ /********** Write list of those attendance events that have students *********/ /*****************************************************************************/ static void Att_ListEventsToSelect (Att_TypeOfView_t TypeOfView) { extern const char *Hlp_USERS_Attendance_attendance_list; extern const char *The_ClassFormBold[The_NUM_THEMES]; extern const char *Txt_Events; extern const char *Txt_Event; extern const char *Txt_ROLES_PLURAL_Abc[Rol_NUM_ROLES][Usr_NUM_SEXS]; extern const char *Txt_Today; extern const char *Txt_Update_attendance_according_to_selected_events; extern const char *Txt_Update_attendance; unsigned UniqueId; unsigned NumAttEvent; /***** Start form to update the attendance depending on the events selected *****/ if (TypeOfView == Att_NORMAL_VIEW_ONLY_ME || TypeOfView == Att_NORMAL_VIEW_STUDENTS) { Act_FormStart (Gbl.Action.Act); Grp_PutParamsCodGrps (); Usr_PutHiddenParUsrCodAll (Gbl.Action.Act,Gbl.Usrs.Select.All); } /***** Start frame *****/ Lay_StartRoundFrameTable (NULL,Txt_Events,NULL, TypeOfView == Att_PRINT_VIEW ? NULL : Hlp_USERS_Attendance_attendance_list, 2); /***** Heading row *****/ fprintf (Gbl.F.Out,"" "" "%s" "" "" "%s" "" "", Txt_Event, Txt_ROLES_PLURAL_Abc[Rol_STUDENT][Usr_SEX_UNKNOWN]); /***** List the events *****/ for (NumAttEvent = 0, UniqueId = 1, Gbl.RowEvenOdd = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++, UniqueId++, Gbl.RowEvenOdd = 1 - Gbl.RowEvenOdd) { /* Get data of the attendance event from database */ Att_GetDataOfAttEventByCodAndCheckCrs (&Gbl.AttEvents.Lst[NumAttEvent]); Att_GetNumStdsTotalWhoAreInAttEvent (&Gbl.AttEvents.Lst[NumAttEvent]); /* Write a row for this event */ fprintf (Gbl.F.Out,"" "" "" "" "" "" "" "" "" "" "" "" "%u" "" "", Gbl.RowEvenOdd, NumAttEvent,NumAttEvent + 1, Gbl.RowEvenOdd, NumAttEvent,UniqueId,Gbl.AttEvents.Lst[NumAttEvent].Title, UniqueId,Gbl.AttEvents.Lst[NumAttEvent].TimeUTC[Att_START_TIME], (unsigned) Gbl.Prefs.DateFormat,Txt_Today, Gbl.RowEvenOdd, Gbl.AttEvents.Lst[NumAttEvent].NumStdsTotal); } /***** Put button to refresh *****/ if (TypeOfView == Att_NORMAL_VIEW_ONLY_ME || TypeOfView == Att_NORMAL_VIEW_STUDENTS) { fprintf (Gbl.F.Out,"" ""); Act_LinkFormSubmitAnimated (Txt_Update_attendance_according_to_selected_events, The_ClassFormBold[Gbl.Prefs.Theme], NULL); Lay_PutCalculateIconWithText (Txt_Update_attendance_according_to_selected_events, Txt_Update_attendance); fprintf (Gbl.F.Out,"" ""); } /***** End frame *****/ Lay_EndRoundFrameTable (); /***** End form *****/ if (TypeOfView == Att_NORMAL_VIEW_ONLY_ME || TypeOfView == Att_NORMAL_VIEW_STUDENTS) Act_FormEnd (); } /*****************************************************************************/ /*********** Show table with attendances for every student in list ***********/ /*****************************************************************************/ static void Att_ListStdsAttendanceTable (Att_TypeOfView_t TypeOfView, unsigned NumStdsInList, long *LstSelectedUsrCods) { extern const char *Hlp_USERS_Attendance_attendance_list; extern const char *Txt_Attendance; extern const char *Txt_Number_of_students; struct UsrData UsrDat; unsigned NumStd; unsigned NumAttEvent; unsigned Total; bool PutButtonShowDetails = (!Gbl.AttEvents.ShowDetails && (TypeOfView == Att_NORMAL_VIEW_ONLY_ME || TypeOfView == Att_NORMAL_VIEW_STUDENTS)); /***** Initialize structure with user's data *****/ Usr_UsrDataConstructor (&UsrDat); /***** Start frame *****/ Lay_StartRoundFrame (NULL,Txt_Attendance, (TypeOfView == Att_NORMAL_VIEW_ONLY_ME) ? Att_PutIconToPrintMyList : ((TypeOfView == Att_NORMAL_VIEW_STUDENTS) ? Att_PutIconToPrintStdsList : NULL), TypeOfView == Att_PRINT_VIEW ? NULL : Hlp_USERS_Attendance_attendance_list); if (PutButtonShowDetails) Lay_StartTableWideMargin (2); else Lay_StartTableWide (2); /***** Heading row *****/ Att_WriteTableHeadSeveralAttEvents (); /***** List the students *****/ for (NumStd = 0, Gbl.RowEvenOdd = 0; NumStd < NumStdsInList; NumStd++) { UsrDat.UsrCod = LstSelectedUsrCods[NumStd]; if (Usr_ChkUsrCodAndGetAllUsrDataFromUsrCod (&UsrDat)) // Get from the database the data of the student { UsrDat.Accepted = Usr_CheckIfUsrBelongsToCrs (UsrDat.UsrCod, Gbl.CurrentCrs.Crs.CrsCod, true); Att_WriteRowStdSeveralAttEvents (NumStd,&UsrDat); } } /***** Last row with the total of students present in each event *****/ if (NumStdsInList > 1) { fprintf (Gbl.F.Out,"" "" "%s:" "", Gbl.Usrs.Listing.WithPhotos ? 4 : 3, Txt_Number_of_students); for (NumAttEvent = 0, Total = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++) if (Gbl.AttEvents.Lst[NumAttEvent].Selected) { fprintf (Gbl.F.Out,"" "%u" "", Gbl.AttEvents.Lst[NumAttEvent].NumStdsFromList); Total += Gbl.AttEvents.Lst[NumAttEvent].NumStdsFromList; } fprintf (Gbl.F.Out,"" "%u" "" "", Total); } /***** End table *****/ Lay_EndTable (); /***** Button to show more details *****/ if (PutButtonShowDetails) Att_PutButtonToShowDetails (); /***** End frame *****/ Lay_EndRoundFrame (); /***** Free memory used for user's data *****/ Usr_UsrDataDestructor (&UsrDat); } /*****************************************************************************/ /* Write table heading for listing of students in several attendance events **/ /*****************************************************************************/ static void Att_WriteTableHeadSeveralAttEvents (void) { extern const char *Txt_ROLES_SINGUL_Abc[Rol_NUM_ROLES][Usr_NUM_SEXS]; extern const char *Txt_Attendance; unsigned NumAttEvent; fprintf (Gbl.F.Out,"" "" "%s" "", Gbl.Usrs.Listing.WithPhotos ? 4 : 3, Txt_ROLES_SINGUL_Abc[Rol_STUDENT][Usr_SEX_UNKNOWN]); for (NumAttEvent = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++) if (Gbl.AttEvents.Lst[NumAttEvent].Selected) { /***** Get data of this attendance event *****/ Att_GetDataOfAttEventByCodAndCheckCrs (&Gbl.AttEvents.Lst[NumAttEvent]); fprintf (Gbl.F.Out,"" "%u" "", Gbl.AttEvents.Lst[NumAttEvent].Title, NumAttEvent + 1); } fprintf (Gbl.F.Out,"" "%s" "" "", Txt_Attendance); } /*****************************************************************************/ /************ Write a row of a table with the data of a student **************/ /*****************************************************************************/ static void Att_WriteRowStdSeveralAttEvents (unsigned NumStd,struct UsrData *UsrDat) { extern const char *Txt_Present; extern const char *Txt_Absent; char PhotoURL[PATH_MAX + 1]; bool ShowPhoto; unsigned NumAttEvent; bool Present; unsigned NumTimesPresent; /***** Write number of student in the list *****/ fprintf (Gbl.F.Out,"" "" "%u" "", UsrDat->Accepted ? "DAT_SMALL_N" : "DAT_SMALL", Gbl.RowEvenOdd, NumStd + 1); /***** Show student's photo *****/ if (Gbl.Usrs.Listing.WithPhotos) { fprintf (Gbl.F.Out,"", Gbl.RowEvenOdd); ShowPhoto = Pho_ShowingUsrPhotoIsAllowed (UsrDat,PhotoURL); Pho_ShowUsrPhoto (UsrDat,ShowPhoto ? PhotoURL : NULL, "PHOTO21x28",Pho_ZOOM,false); fprintf (Gbl.F.Out,""); } /***** Write user's ID ******/ fprintf (Gbl.F.Out,"", UsrDat->Accepted ? "DAT_SMALL_N" : "DAT_SMALL", Gbl.RowEvenOdd); ID_WriteUsrIDs (UsrDat,NULL); fprintf (Gbl.F.Out,""); /***** Write student's name *****/ fprintf (Gbl.F.Out,"" "%s", UsrDat->Accepted ? "DAT_SMALL_N" : "DAT_SMALL", Gbl.RowEvenOdd, UsrDat->Surname1); if (UsrDat->Surname2[0]) fprintf (Gbl.F.Out," %s",UsrDat->Surname2); fprintf (Gbl.F.Out,", %s", UsrDat->FirstName); /***** Icon to show if the user is already registered *****/ for (NumAttEvent = 0, NumTimesPresent = 0; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++) if (Gbl.AttEvents.Lst[NumAttEvent].Selected) { /***** Check if this student is already registered in the current event *****/ // Here it is not necessary to get comments Present = Att_CheckIfUsrIsPresentInAttEvent (Gbl.AttEvents.Lst[NumAttEvent].AttCod,UsrDat->UsrCod); fprintf (Gbl.F.Out,"" "\"%s\"" "", Gbl.RowEvenOdd, Gbl.Prefs.IconsURL, Present ? "check" : "check-empty", Present ? Txt_Present : Txt_Absent, Present ? Txt_Present : Txt_Absent); if (Present) NumTimesPresent++; } /***** Last column with the number of times this user is present *****/ fprintf (Gbl.F.Out,"" "%u" "" "", Gbl.RowEvenOdd, NumTimesPresent); Gbl.RowEvenOdd = 1 - Gbl.RowEvenOdd; } /*****************************************************************************/ /**************** List the students with details and comments ****************/ /*****************************************************************************/ static void Att_ListStdsWithAttEventsDetails (Att_TypeOfView_t TypeOfView, unsigned NumStdsInList, long *LstSelectedUsrCods) { extern const char *Hlp_USERS_Attendance_attendance_list; extern const char *Txt_Details; struct UsrData UsrDat; unsigned NumStd; /***** Initialize structure with user's data *****/ Usr_UsrDataConstructor (&UsrDat); /***** Start frame *****/ Lay_StartRoundFrameTable (NULL,Txt_Details,NULL, TypeOfView == Att_PRINT_VIEW ? NULL : Hlp_USERS_Attendance_attendance_list, 2); /***** List students with attendance details *****/ for (NumStd = 0, Gbl.RowEvenOdd = 0; NumStd < NumStdsInList; NumStd++) { UsrDat.UsrCod = LstSelectedUsrCods[NumStd]; if (Usr_ChkUsrCodAndGetAllUsrDataFromUsrCod (&UsrDat)) // Get from the database the data of the student { UsrDat.Accepted = Usr_CheckIfUsrBelongsToCrs (UsrDat.UsrCod, Gbl.CurrentCrs.Crs.CrsCod, true); Att_ListAttEventsForAStd (NumStd,&UsrDat); } } /***** End frame *****/ Lay_EndRoundFrameTable (); /***** Free memory used for user's data *****/ Usr_UsrDataDestructor (&UsrDat); } /*****************************************************************************/ /*************** Write list of attendance events for a student ***************/ /*****************************************************************************/ static void Att_ListAttEventsForAStd (unsigned NumStd,struct UsrData *UsrDat) { extern const char *Txt_Today; extern const char *Txt_Present; extern const char *Txt_Absent; extern const char *Txt_Student_comment; extern const char *Txt_Teachers_comment; char PhotoURL[PATH_MAX + 1]; bool ShowPhoto; unsigned NumAttEvent; unsigned UniqueId; bool Present; bool ShowCommentStd; bool ShowCommentTch; char CommentStd[Cns_MAX_BYTES_TEXT + 1]; char CommentTch[Cns_MAX_BYTES_TEXT + 1]; /***** Write number of student in the list *****/ fprintf (Gbl.F.Out,"" "" "%u:" "", UsrDat->Accepted ? "DAT_SMALL_N" : "DAT_SMALL", Gbl.RowEvenOdd, NumStd + 1); /***** Show student's photo *****/ fprintf (Gbl.F.Out,"", Gbl.RowEvenOdd); ShowPhoto = Pho_ShowingUsrPhotoIsAllowed (UsrDat,PhotoURL); Pho_ShowUsrPhoto (UsrDat,ShowPhoto ? PhotoURL : NULL, "PHOTO21x28",Pho_ZOOM,false); fprintf (Gbl.F.Out,""); /***** Write user's ID ******/ fprintf (Gbl.F.Out,"" "" "" ""); /***** Write student's name *****/ fprintf (Gbl.F.Out,"" "" "
", Gbl.RowEvenOdd, UsrDat->Accepted ? "DAT_SMALL_N" : "DAT_SMALL"); ID_WriteUsrIDs (UsrDat,NULL); fprintf (Gbl.F.Out,"%s", UsrDat->Accepted ? "DAT_SMALL_N" : "DAT_SMALL", UsrDat->Surname1); if (UsrDat->Surname2[0]) fprintf (Gbl.F.Out," %s",UsrDat->Surname2); fprintf (Gbl.F.Out,", %s
" "" "", UsrDat->FirstName); /***** List the events with students *****/ for (NumAttEvent = 0, UniqueId = 1; NumAttEvent < Gbl.AttEvents.Num; NumAttEvent++, UniqueId++) if (Gbl.AttEvents.Lst[NumAttEvent].Selected) { /***** Get data of the attendance event from database *****/ Att_GetDataOfAttEventByCodAndCheckCrs (&Gbl.AttEvents.Lst[NumAttEvent]); Att_GetNumStdsTotalWhoAreInAttEvent (&Gbl.AttEvents.Lst[NumAttEvent]); /***** Get comments for this student *****/ Present = Att_CheckIfUsrIsPresentInAttEventAndGetComments (Gbl.AttEvents.Lst[NumAttEvent].AttCod,UsrDat->UsrCod,CommentStd,CommentTch); ShowCommentStd = CommentStd[0]; ShowCommentTch = CommentTch[0] && (Gbl.Usrs.Me.LoggedRole == Rol_TEACHER || Gbl.AttEvents.Lst[NumAttEvent].CommentTchVisible); /***** Write a row for this event *****/ fprintf (Gbl.F.Out,"" "" "" "%u:" "" "" "\"%s\"" " %s" "" "" "", Gbl.RowEvenOdd, Gbl.RowEvenOdd, NumAttEvent + 1, Gbl.RowEvenOdd, Gbl.Prefs.IconsURL, Present ? "check" : "check-empty", Present ? Txt_Present : Txt_Absent, Present ? Txt_Present : Txt_Absent, UniqueId, Gbl.AttEvents.Lst[NumAttEvent].Title, UniqueId,Gbl.AttEvents.Lst[NumAttEvent].TimeUTC[Att_START_TIME], (unsigned) Gbl.Prefs.DateFormat,Txt_Today); /***** Write comments for this student *****/ if (ShowCommentStd || ShowCommentTch) { fprintf (Gbl.F.Out,"" "" "" "" "
", Gbl.RowEvenOdd, Gbl.RowEvenOdd, Gbl.RowEvenOdd); if (ShowCommentStd) { Str_ChangeFormat (Str_FROM_HTML,Str_TO_RIGOROUS_HTML, CommentStd,Cns_MAX_BYTES_TEXT,false); fprintf (Gbl.F.Out,"
%s:
%s
", Txt_Student_comment, CommentStd); } if (ShowCommentTch) { Str_ChangeFormat (Str_FROM_HTML,Str_TO_RIGOROUS_HTML, CommentTch,Cns_MAX_BYTES_TEXT,false); fprintf (Gbl.F.Out,"
%s:
" "
%s
", Txt_Teachers_comment, CommentTch); } fprintf (Gbl.F.Out,"
" "" ""); } } Gbl.RowEvenOdd = 1 - Gbl.RowEvenOdd; }