mirror of
https://github.com/acanas/swad-core.git
synced 2024-09-20 00:02:42 +02:00
4530 lines
165 KiB
C
4530 lines
165 KiB
C
// swad_group.c: types of groups and groups
|
|
|
|
/*
|
|
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-2024 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 <http://www.gnu.org/licenses/>.
|
|
*/
|
|
/*****************************************************************************/
|
|
/*********************************** Headers *********************************/
|
|
/*****************************************************************************/
|
|
|
|
#define _GNU_SOURCE // For asprintf
|
|
#include <stddef.h> // For NULL
|
|
#include <stdio.h> // For asprintf
|
|
#include <stdlib.h> // For exit, system, malloc, free, rand, etc.
|
|
#include <string.h> // For string functions
|
|
|
|
#include "swad_action.h"
|
|
#include "swad_action_list.h"
|
|
#include "swad_alert.h"
|
|
#include "swad_assignment_database.h"
|
|
#include "swad_attendance_database.h"
|
|
#include "swad_box.h"
|
|
#include "swad_database.h"
|
|
#include "swad_error.h"
|
|
#include "swad_exam_database.h"
|
|
#include "swad_form.h"
|
|
#include "swad_game.h"
|
|
#include "swad_global.h"
|
|
#include "swad_group.h"
|
|
#include "swad_group_database.h"
|
|
#include "swad_HTML.h"
|
|
#include "swad_match_database.h"
|
|
#include "swad_notification.h"
|
|
#include "swad_parameter_code.h"
|
|
#include "swad_program.h"
|
|
#include "swad_project.h"
|
|
#include "swad_setting.h"
|
|
#include "swad_survey.h"
|
|
#include "swad_survey_database.h"
|
|
#include "swad_timetable.h"
|
|
#include "swad_timetable_database.h"
|
|
|
|
/*****************************************************************************/
|
|
/*************************** Private constants *******************************/
|
|
/*****************************************************************************/
|
|
|
|
#define Grp_GROUP_TYPES_SECTION_ID "grp_types"
|
|
#define Grp_NEW_GROUP_TYPE_SECTION_ID "new_grp_type"
|
|
#define Grp_GROUPS_SECTION_ID "grps"
|
|
#define Grp_NEW_GROUP_SECTION_ID "new_grp"
|
|
|
|
/*****************************************************************************/
|
|
/************* External global variables from others modules *****************/
|
|
/*****************************************************************************/
|
|
|
|
extern struct Globals Gbl;
|
|
|
|
/*****************************************************************************/
|
|
/***************************** Private prototypes ****************************/
|
|
/*****************************************************************************/
|
|
|
|
static Usr_Can_t Grp_CheckIfICanChangeGrps (void);
|
|
|
|
static void Grp_ReqEditGroupsInternal (Ale_AlertType_t AlertTypeGroupTypes,const char *AlertTextGroupTypes,
|
|
Ale_AlertType_t AlertTypeGroups,const char *AlertTextGroups);
|
|
static void Grp_ReqEditGroupsInternal0 (void);
|
|
static void Grp_ReqEditGroupsInternal1 (Ale_AlertType_t AlertTypeGroupTypes,
|
|
const char *AlertTextGroupTypes);
|
|
static void Grp_ReqEditGroupsInternal2 (Ale_AlertType_t AlertTypeGroups,
|
|
const char *AlertTextGroups);
|
|
|
|
static void Grp_EditGroupTypes (void);
|
|
static void Grp_EditGroups (const struct Roo_Rooms *Rooms);
|
|
static void Grp_PutIconsEditingGroups (__attribute__((unused)) void *Args);
|
|
|
|
static void Grp_PutCheckboxAllGrps (void);
|
|
|
|
static bool Grp_CheckIfSelectionIsValid (struct ListCodGrps *LstGrpsIWant,
|
|
struct ListCodGrps *LstGrpsIBelong);
|
|
static void Grp_RemoveMeFromGrps (struct ListCodGrps *LstGrpsIWant,
|
|
struct ListCodGrps *LstGrpsIBelong);
|
|
static void Grp_RegisterMeInGrps (struct ListCodGrps *LstGrpsIWant,
|
|
struct ListCodGrps *LstGrpsIBelong);
|
|
|
|
static void Grp_ConstructorListGrpAlreadySelec (struct ListGrpsAlreadySelec **AlreadyExistsGroupOfType);
|
|
static void Grp_DestructorListGrpAlreadySelec (struct ListGrpsAlreadySelec **AlreadyExistsGroupOfType);
|
|
static void Grp_RemoveUsrFromGroup (long UsrCod,long GrpCod);
|
|
|
|
static void Grp_ListGroupTypesForEdition (void);
|
|
static void Grp_PutIconsEditingGroupTypes (__attribute__((unused)) void *Args);
|
|
static void Grp_PutIconToViewGroups (void);
|
|
static void Grp_WriteHeadingGroupTypes (void);
|
|
|
|
static void Grp_ListGroupsForEdition (const struct Roo_Rooms *Rooms);
|
|
static void Grp_WriteHeadingGroups (void);
|
|
|
|
static void Grp_PutIconToEditGroups (__attribute__((unused)) void *Args);
|
|
|
|
static void Grp_ShowWarningToStdsToChangeGrps (void);
|
|
static Usr_Can_t Grp_ListGrpsForChangeMySelection (const struct GroupType *GrpTyp,
|
|
unsigned *NumGrpsThisTypeIBelong);
|
|
static void Grp_ListGrpsToAddOrRemUsrs (const struct GroupType *GrpTyp,long UsrCod);
|
|
|
|
static void Grp_ListGrpsForMultipleSelection (const struct GroupType *GrpTyp);
|
|
static HTM_Attributes_t Grp_Checked (long GrpCod);
|
|
static void Grp_WriteRowToSelectUsrsWhoDontBelongToAnyGrp (const struct GroupType *GrpTyp);
|
|
|
|
static void Grp_WriteGrpHead (const struct GroupType *GrpTyp);
|
|
static void Grp_WriteRowGrp (const struct Group *Grp,Lay_Highlight_t Highlight);
|
|
static void Grp_PutFormToCreateGroupType (void);
|
|
static void Grp_PutFormToCreateGroup (const struct Roo_Rooms *Rooms);
|
|
static void Grp_GetGroupTypeDataByCod (struct GroupType *GrpTyp);
|
|
static bool Grp_GetMultipleEnrolmentOfAGroupType (long GrpTypCod);
|
|
static void Grp_GetLstCodGrpsUsrBelongs (long UsrCod,long GrpTypCod,
|
|
struct ListCodGrps *LstGrps,
|
|
Grp_ClosedOpenGroups_t ClosedOpenGroups);
|
|
static bool Grp_CheckIfGrpIsInList (long GrpCod,struct ListCodGrps *LstGrps);
|
|
static bool Grp_CheckIfOpenTimeInTheFuture (time_t OpenTimeUTC);
|
|
|
|
static void Grp_AskConfirmRemGrpTypWithGrps (void);
|
|
static void Grp_AskConfirmRemGrp (void);
|
|
static void Grp_RemoveGroupTypeCompletely (void);
|
|
static void Grp_RemoveGroupCompletely (void);
|
|
|
|
static void Grp_WriteMaxStds (char Str[Cns_MAX_DIGITS_UINT + 1],unsigned MaxStudents);
|
|
static void Grp_PutParGrpTypCod (void *GrpTypCod);
|
|
static void Grp_PutParGrpCod (void *GrpCod);
|
|
|
|
/*****************************************************************************/
|
|
/************************ Check if I can change groups ***********************/
|
|
/*****************************************************************************/
|
|
|
|
static Usr_Can_t Grp_CheckIfICanChangeGrps (void)
|
|
{
|
|
static Usr_Can_t Grp_ICanChangeGrps[Rol_NUM_ROLES] =
|
|
{
|
|
[Rol_UNK ] = Usr_CAN_NOT,
|
|
[Rol_GST ] = Usr_CAN_NOT,
|
|
[Rol_USR ] = Usr_CAN_NOT,
|
|
[Rol_STD ] = Usr_CAN,
|
|
[Rol_NET ] = Usr_CAN_NOT,
|
|
[Rol_TCH ] = Usr_CAN,
|
|
[Rol_DEG_ADM] = Usr_CAN_NOT,
|
|
[Rol_CTR_ADM] = Usr_CAN_NOT,
|
|
[Rol_INS_ADM] = Usr_CAN_NOT,
|
|
[Rol_SYS_ADM] = Usr_CAN,
|
|
};
|
|
|
|
return Grp_ICanChangeGrps[Gbl.Usrs.Me.Role.Logged];
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************* Write the names of the selected groups ******************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_WriteNamesOfSelectedGrps (void)
|
|
{
|
|
extern const char *Txt_Group;
|
|
extern const char *Txt_Groups;
|
|
extern const char *Txt_users_with_no_group;
|
|
extern const char *Txt_and;
|
|
long GrpCod;
|
|
unsigned NumGrpSel;
|
|
struct GroupData GrpDat;
|
|
|
|
/***** Show the selected groups *****/
|
|
HTM_TxtColonNBSP (Gbl.Crs.Grps.LstGrpsSel.NumGrps == 1 ? Txt_Group :
|
|
Txt_Groups);
|
|
for (NumGrpSel = 0;
|
|
NumGrpSel < Gbl.Crs.Grps.LstGrpsSel.NumGrps;
|
|
NumGrpSel++)
|
|
{
|
|
if ((GrpCod = Gbl.Crs.Grps.LstGrpsSel.GrpCods[NumGrpSel]) >= 0)
|
|
{
|
|
GrpDat.GrpCod = GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
HTM_TxtF ("%s %s",GrpDat.GrpTypName,GrpDat.GrpName);
|
|
}
|
|
else // GrpCod < 0 ==> students not belonging to any group of type (-GrpCod)
|
|
{
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypCod = -GrpCod;
|
|
Grp_GetGroupTypeDataByCod (&Gbl.Crs.Grps.GrpTyp);
|
|
HTM_TxtF ("%s (%s)",Gbl.Crs.Grps.GrpTyp.GrpTypName,
|
|
Txt_users_with_no_group);
|
|
}
|
|
|
|
if (Gbl.Crs.Grps.LstGrpsSel.NumGrps >= 2)
|
|
{
|
|
if (NumGrpSel == Gbl.Crs.Grps.LstGrpsSel.NumGrps-2)
|
|
HTM_TxtF (" %s ",Txt_and);
|
|
if (Gbl.Crs.Grps.LstGrpsSel.NumGrps >= 3)
|
|
if (NumGrpSel < Gbl.Crs.Grps.LstGrpsSel.NumGrps-2)
|
|
HTM_Txt (", ");
|
|
}
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************** Put forms to edit groups *************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ReqEditGroups (void)
|
|
{
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
Ale_INFO,NULL);
|
|
}
|
|
|
|
static void Grp_ReqEditGroupsInternal (Ale_AlertType_t AlertTypeGroupTypes,
|
|
const char *AlertTextGroupTypes,
|
|
Ale_AlertType_t AlertTypeGroups,
|
|
const char *AlertTextGroups)
|
|
{
|
|
Grp_ReqEditGroupsInternal0 ();
|
|
Grp_ReqEditGroupsInternal1 (AlertTypeGroupTypes,AlertTextGroupTypes);
|
|
Grp_ReqEditGroupsInternal2 (AlertTypeGroups,AlertTextGroups);
|
|
}
|
|
|
|
static void Grp_ReqEditGroupsInternal0 (void)
|
|
{
|
|
/***** Begin groups types section *****/
|
|
HTM_SECTION_Begin (Grp_GROUP_TYPES_SECTION_ID);
|
|
}
|
|
|
|
static void Grp_ReqEditGroupsInternal1 (Ale_AlertType_t AlertTypeGroupTypes,
|
|
const char *AlertTextGroupTypes)
|
|
{
|
|
/***** Get list of groups types and groups in this course *****/
|
|
Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_ALL_GROUP_TYPES);
|
|
|
|
/***** Show optional alert *****/
|
|
if (AlertTextGroupTypes)
|
|
if (AlertTextGroupTypes[0])
|
|
Ale_ShowAlert (AlertTypeGroupTypes,AlertTextGroupTypes);
|
|
|
|
/***** Put form to edit group types *****/
|
|
Grp_EditGroupTypes ();
|
|
|
|
/***** End groups types section *****/
|
|
HTM_SECTION_End ();
|
|
|
|
/***** Begin groups section *****/
|
|
HTM_SECTION_Begin (Grp_GROUPS_SECTION_ID);
|
|
}
|
|
|
|
static void Grp_ReqEditGroupsInternal2 (Ale_AlertType_t AlertTypeGroups,
|
|
const char *AlertTextGroups)
|
|
{
|
|
struct Roo_Rooms Rooms;
|
|
|
|
/***** Reset rooms context *****/
|
|
Roo_ResetRooms (&Rooms);
|
|
|
|
/***** Show optional alert *****/
|
|
if (AlertTextGroups)
|
|
if (AlertTextGroups[0])
|
|
Ale_ShowAlert (AlertTypeGroups,AlertTextGroups);
|
|
|
|
/***** Get list of rooms in this center *****/
|
|
Roo_GetListRooms (&Rooms,Roo_ONLY_SHRT_NAME);
|
|
|
|
/***** Put form to edit groups *****/
|
|
if (Gbl.Crs.Grps.GrpTypes.NumGrpTypes) // If there are group types...
|
|
Grp_EditGroups (&Rooms);
|
|
|
|
/***** End groups section *****/
|
|
HTM_SECTION_End ();
|
|
|
|
/***** Free list of rooms in this center *****/
|
|
Roo_FreeListRooms (&Rooms);
|
|
|
|
/***** Free list of groups types and groups in this course *****/
|
|
Grp_FreeListGrpTypesAndGrps ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************* Put forms to edit group types *********************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_EditGroupTypes (void)
|
|
{
|
|
extern const char *Hlp_USERS_Groups;
|
|
extern const char *Txt_Types_of_group;
|
|
extern const char *Txt_There_are_no_types_of_group_in_the_course_X;
|
|
|
|
/***** Begin box *****/
|
|
Box_BoxBegin (Txt_Types_of_group,Grp_PutIconsEditingGroupTypes,NULL,
|
|
Hlp_USERS_Groups,Box_NOT_CLOSABLE);
|
|
|
|
/***** Put a form to create a new group type *****/
|
|
Grp_PutFormToCreateGroupType ();
|
|
|
|
/***** Forms to edit current group types *****/
|
|
if (Gbl.Crs.Grps.GrpTypes.NumGrpTypes) // Group types found...
|
|
Grp_ListGroupTypesForEdition ();
|
|
else // No group types found in this course
|
|
Ale_ShowAlert (Ale_INFO,Txt_There_are_no_types_of_group_in_the_course_X,
|
|
Gbl.Hierarchy.Node[Hie_CRS].ShrtName);
|
|
|
|
/***** End box *****/
|
|
Box_BoxEnd ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/**************************** Put forms to edit groups ***********************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_EditGroups (const struct Roo_Rooms *Rooms)
|
|
{
|
|
extern const char *Hlp_USERS_Groups;
|
|
extern const char *Txt_Groups;
|
|
extern const char *Txt_No_groups_have_been_created_in_the_course_X;
|
|
|
|
/***** Begin box *****/
|
|
Box_BoxBegin (Txt_Groups,Grp_PutIconsEditingGroups,NULL,
|
|
Hlp_USERS_Groups,Box_NOT_CLOSABLE);
|
|
|
|
/***** Put a form to create a new group *****/
|
|
Grp_PutFormToCreateGroup (Rooms);
|
|
|
|
/***** Forms to edit current groups *****/
|
|
if (Gbl.Crs.Grps.GrpTypes.NumGrpsTotal) // If there are groups...
|
|
Grp_ListGroupsForEdition (Rooms);
|
|
else // There are group types, but there aren't groups
|
|
Ale_ShowAlert (Ale_INFO,Txt_No_groups_have_been_created_in_the_course_X,
|
|
Gbl.Hierarchy.Node[Hie_CRS].ShrtName);
|
|
|
|
/***** End box *****/
|
|
Box_BoxEnd ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/**************** Put contextual icons in edition of groups ******************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_PutIconsEditingGroups (__attribute__((unused)) void *Args)
|
|
{
|
|
/***** Put icon to view groups *****/
|
|
Grp_PutIconToViewGroups ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*************** Show form to select one or several groups *******************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ShowFormToSelectSeveralGroups (Act_Action_t NextAction,
|
|
void (*FuncPars) (void *Args),void *Args,
|
|
const char *OnSubmit)
|
|
{
|
|
extern const char *Hlp_USERS_Groups;
|
|
extern const char *Txt_Groups;
|
|
extern const char *Txt_Update_users;
|
|
unsigned NumGrpTyp;
|
|
Usr_Can_t ICanEdit;
|
|
static void (*FunctionToDrawContextualIcons[Usr_NUM_CAN]) (void *Args) =
|
|
{
|
|
[Usr_CAN_NOT] = NULL,
|
|
[Usr_CAN ] = Grp_PutIconToEditGroups,
|
|
};
|
|
|
|
/***** Trivial check: if no groups ==> nothing to do *****/
|
|
if (!Gbl.Crs.Grps.NumGrps)
|
|
return;
|
|
|
|
/***** Begin box *****/
|
|
ICanEdit = (!Frm_CheckIfInside () &&
|
|
(Gbl.Usrs.Me.Role.Logged == Rol_TCH ||
|
|
Gbl.Usrs.Me.Role.Logged == Rol_SYS_ADM)) ? Usr_CAN :
|
|
Usr_CAN_NOT;
|
|
Box_BoxBegin (Txt_Groups,
|
|
FunctionToDrawContextualIcons[ICanEdit],NULL,
|
|
Hlp_USERS_Groups,Box_CLOSABLE);
|
|
|
|
/***** Begin form to update the students listed
|
|
depending on the groups selected *****/
|
|
Frm_BeginFormAnchorOnSubmit (NextAction,Usr_USER_LIST_SECTION_ID,OnSubmit);
|
|
Set_PutParsPrefsAboutUsrList ();
|
|
if (FuncPars)
|
|
FuncPars (Args);
|
|
|
|
/***** Select all groups *****/
|
|
Grp_PutCheckboxAllGrps ();
|
|
|
|
/***** Get list of groups types and groups in this course *****/
|
|
Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_ONLY_GROUP_TYPES_WITH_GROUPS);
|
|
|
|
/***** List the groups for each group type *****/
|
|
HTM_TABLE_Begin ("TBL_SCROLL");
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
if (Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps)
|
|
{
|
|
Grp_ListGrpsForMultipleSelection (&Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp]);
|
|
Grp_WriteRowToSelectUsrsWhoDontBelongToAnyGrp (&Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp]);
|
|
}
|
|
HTM_TABLE_End ();
|
|
|
|
/***** Free list of groups types and groups in this course *****/
|
|
Grp_FreeListGrpTypesAndGrps ();
|
|
|
|
/***** Submit button *****/
|
|
Lay_WriteLinkToUpdate (Txt_Update_users,NULL);
|
|
|
|
/***** End form *****/
|
|
Frm_EndForm ();
|
|
|
|
/***** End box *****/
|
|
Box_BoxEnd ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************* Put checkbox to select all groups ***********************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_PutCheckboxAllGrps (void)
|
|
{
|
|
extern const char *Txt_All_groups;
|
|
Usr_Can_t ICanSelUnselGroup;
|
|
|
|
switch (Gbl.Usrs.Me.Role.Logged)
|
|
{
|
|
case Rol_TCH:
|
|
case Rol_DEG_ADM:
|
|
case Rol_CTR_ADM:
|
|
case Rol_INS_ADM:
|
|
case Rol_SYS_ADM:
|
|
ICanSelUnselGroup = Usr_CAN;
|
|
break;
|
|
default:
|
|
ICanSelUnselGroup = Usr_CAN_NOT;
|
|
break;
|
|
}
|
|
|
|
HTM_DIV_Begin ("class=\"CONTEXT_OPT\"");
|
|
HTM_LABEL_Begin ("class=\"FORM_IN_%s\"",The_GetSuffix ());
|
|
HTM_INPUT_CHECKBOX ("AllGroups",
|
|
(ICanSelUnselGroup == Usr_CAN) ? (Gbl.Crs.Grps.AllGrps ? HTM_CHECKED :
|
|
HTM_NO_ATTR) :
|
|
HTM_DISABLED,
|
|
"value=\"Y\"%s",
|
|
(ICanSelUnselGroup == Usr_CAN) ? " onclick=\"togglecheckChildren(this,'GrpCods')\"" :
|
|
"");
|
|
HTM_NBSPTxt (Txt_All_groups);
|
|
HTM_LABEL_End ();
|
|
HTM_DIV_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************ Put parameters with the groups of students selected ************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_PutParsCodGrps (void)
|
|
{
|
|
extern const char *Par_SEPARATOR_PARAM_MULTIPLE;
|
|
unsigned NumGrpSel;
|
|
size_t MaxLengthGrpCods;
|
|
char *GrpCods;
|
|
char GrpCod[Cns_MAX_DIGITS_LONG + 1];
|
|
|
|
/***** Write the boolean parameter that indicates if all groups must be listed *****/
|
|
Par_PutParChar ("AllGroups",
|
|
Gbl.Crs.Grps.AllGrps ? 'Y' :
|
|
'N');
|
|
|
|
/***** Write the parameter with the list of group codes to show *****/
|
|
if (!Gbl.Crs.Grps.AllGrps &&
|
|
Gbl.Crs.Grps.LstGrpsSel.NumGrps)
|
|
{
|
|
MaxLengthGrpCods = Gbl.Crs.Grps.LstGrpsSel.NumGrps * (Cns_MAX_DIGITS_LONG + 1) - 1;
|
|
if ((GrpCods = malloc (MaxLengthGrpCods + 1)) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
GrpCods[0] = '\0';
|
|
|
|
for (NumGrpSel = 0;
|
|
NumGrpSel < Gbl.Crs.Grps.LstGrpsSel.NumGrps;
|
|
NumGrpSel++)
|
|
{
|
|
/* Append group code to list */
|
|
if (NumGrpSel)
|
|
Str_Concat (GrpCods,Par_SEPARATOR_PARAM_MULTIPLE,MaxLengthGrpCods);
|
|
snprintf (GrpCod,sizeof (GrpCod),"%ld",
|
|
Gbl.Crs.Grps.LstGrpsSel.GrpCods[NumGrpSel]);
|
|
Str_Concat (GrpCods,GrpCod,MaxLengthGrpCods);
|
|
}
|
|
|
|
Par_PutParString (NULL,"GrpCods",GrpCods);
|
|
free (GrpCods);
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/**************** Get parameters related to groups selected ******************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_GetParCodsSeveralGrpsToShowUsrs (void)
|
|
{
|
|
struct ListCodGrps LstGrpsIBelong;
|
|
unsigned NumGrp;
|
|
|
|
if (++Gbl.Crs.Grps.LstGrpsSel.NestedCalls > 1) // If list is created yet, there's nothing to do
|
|
return;
|
|
|
|
/***** Get boolean parameter that indicates if all groups must be listed *****/
|
|
Gbl.Crs.Grps.AllGrps = Par_GetParBool ("AllGroups");
|
|
|
|
/***** Get parameter with list of groups selected *****/
|
|
Grp_GetParCodsSeveralGrps ();
|
|
|
|
if (Gbl.Crs.Grps.NumGrps && // This course has groups and...
|
|
!Gbl.Crs.Grps.LstGrpsSel.NumGrps) // ...I haven't selected any group
|
|
{
|
|
/***** I I haven't selected any group, show by default the groups I belong to *****/
|
|
/* Get list of groups of all types in current course I belong to */
|
|
Grp_GetLstCodGrpsUsrBelongs (Gbl.Usrs.Me.UsrDat.UsrCod,-1L,
|
|
&LstGrpsIBelong,
|
|
Grp_CLOSED_AND_OPEN_GROUPS);
|
|
|
|
if (LstGrpsIBelong.NumGrps)
|
|
{
|
|
/* Allocate space for list of selected groups */
|
|
if ((Gbl.Crs.Grps.LstGrpsSel.GrpCods = calloc (LstGrpsIBelong.NumGrps,
|
|
sizeof (*Gbl.Crs.Grps.LstGrpsSel.GrpCods))) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
|
|
/* Fill list of selected groups with list of groups I belong to */
|
|
for (NumGrp = 0;
|
|
NumGrp < LstGrpsIBelong.NumGrps;
|
|
NumGrp++)
|
|
Gbl.Crs.Grps.LstGrpsSel.GrpCods[NumGrp] = LstGrpsIBelong.GrpCods[NumGrp];
|
|
Gbl.Crs.Grps.LstGrpsSel.NumGrps = LstGrpsIBelong.NumGrps;
|
|
}
|
|
|
|
/* Free list of groups I belong to */
|
|
Grp_FreeListCodGrp (&LstGrpsIBelong);
|
|
}
|
|
|
|
/***** If no groups selected ==> show all groups *****/
|
|
if (!Gbl.Crs.Grps.LstGrpsSel.NumGrps)
|
|
Gbl.Crs.Grps.AllGrps = true;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/**************** Get parameter with list of groups selected *****************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_GetParCodsSeveralGrps (void)
|
|
{
|
|
char *ParLstCodGrps;
|
|
const char *Ptr;
|
|
char LongStr[Cns_MAX_DIGITS_LONG + 1];
|
|
unsigned NumGrp;
|
|
unsigned long MaxSizeLstGrpCods;
|
|
|
|
/***** Reset number of groups selected *****/
|
|
Gbl.Crs.Grps.LstGrpsSel.NumGrps = 0;
|
|
|
|
if (Gbl.Crs.Grps.NumGrps) // If course has groups
|
|
{
|
|
MaxSizeLstGrpCods = ((Cns_MAX_DIGITS_LONG + 1) * Gbl.Crs.Grps.NumGrps) - 1;
|
|
|
|
/***** Allocate memory for the list of group codes selected *****/
|
|
if ((ParLstCodGrps = malloc (MaxSizeLstGrpCods + 1)) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
|
|
/***** Get parameter with list of groups to list *****/
|
|
Par_GetParMultiToText ("GrpCods",ParLstCodGrps,MaxSizeLstGrpCods);
|
|
|
|
// Ale_ShowAlert (Ale_INFO,"ParLstCodGrps = "%s"",ParLstCodGrps);
|
|
|
|
if (ParLstCodGrps[0])
|
|
{
|
|
/***** Count number of groups selected from LstCodGrps *****/
|
|
for (Ptr = ParLstCodGrps, NumGrp = 0;
|
|
*Ptr;
|
|
NumGrp++)
|
|
Par_GetNextStrUntilSeparParMult (&Ptr,LongStr,Cns_MAX_DIGITS_LONG);
|
|
Gbl.Crs.Grps.LstGrpsSel.NumGrps = NumGrp;
|
|
|
|
if (Gbl.Crs.Grps.LstGrpsSel.NumGrps) // If I have selected groups...
|
|
{
|
|
/***** Create a list of groups selected from LstCodGrps *****/
|
|
if ((Gbl.Crs.Grps.LstGrpsSel.GrpCods = calloc (Gbl.Crs.Grps.LstGrpsSel.NumGrps,
|
|
sizeof (*Gbl.Crs.Grps.LstGrpsSel.GrpCods))) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
for (Ptr = ParLstCodGrps, NumGrp = 0;
|
|
*Ptr;
|
|
NumGrp++)
|
|
{
|
|
Par_GetNextStrUntilSeparParMult (&Ptr,LongStr,Cns_MAX_DIGITS_LONG);
|
|
Gbl.Crs.Grps.LstGrpsSel.GrpCods[NumGrp] = Str_ConvertStrCodToLongCod (LongStr);
|
|
}
|
|
}
|
|
}
|
|
|
|
/***** Free memory used for the list of groups to show *****/
|
|
free (ParLstCodGrps);
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********* Free memory used for the list of group codes selected *************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_FreeListCodSelectedGrps (void)
|
|
{
|
|
if (Gbl.Crs.Grps.LstGrpsSel.NestedCalls > 0)
|
|
if (--Gbl.Crs.Grps.LstGrpsSel.NestedCalls == 0)
|
|
if (Gbl.Crs.Grps.LstGrpsSel.GrpCods)
|
|
{
|
|
free (Gbl.Crs.Grps.LstGrpsSel.GrpCods);
|
|
Gbl.Crs.Grps.LstGrpsSel.GrpCods = NULL;
|
|
Gbl.Crs.Grps.LstGrpsSel.NumGrps = 0;
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************* Change my groups and show form again ********************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ChangeMyGrpsAndShowChanges (void)
|
|
{
|
|
/***** Change my groups *****/
|
|
Grp_ChangeMyGrps (Cns_VERBOSE);
|
|
|
|
/***** Show possible alerts *****/
|
|
Ale_ShowAlerts (NULL);
|
|
|
|
/***** Show again the table of selection of groups with the changes already made *****/
|
|
Grp_ReqRegisterInGrps ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/****************************** Change my groups *****************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ChangeMyGrps (Cns_Verbose_t Verbose)
|
|
{
|
|
extern const char *Txt_The_requested_group_changes_were_successful;
|
|
extern const char *Txt_There_has_been_no_change_in_groups;
|
|
extern const char *Txt_In_a_type_of_group_with_single_enrolment_students_can_not_be_registered_in_more_than_one_group;
|
|
struct ListCodGrps LstGrpsIWant;
|
|
bool SelectionIsValid = true;
|
|
bool ChangesMade;
|
|
|
|
/***** Can I change my groups? *****/
|
|
if (Grp_CheckIfICanChangeGrps () == Usr_CAN_NOT)
|
|
return;
|
|
|
|
/***** Get list of groups types and groups in this course *****/
|
|
Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_ONLY_GROUP_TYPES_WITH_GROUPS);
|
|
|
|
/***** Get the group codes which I want to join to *****/
|
|
LstGrpsIWant.GrpCods = NULL; // Initialized to avoid bug reported by Coverity
|
|
LstGrpsIWant.NumGrps = 0; // Initialized to avoid bug reported by Coverity
|
|
Grp_GetLstCodsGrpWanted (&LstGrpsIWant);
|
|
|
|
/***** A student can not be enroled in more than one group
|
|
if the type of group is of single enrolment *****/
|
|
// As the form to register in groups of single enrolment...
|
|
// ...is a radio-based form and not a checkbox-based form...
|
|
// ...this check is made only to avoid problems...
|
|
// ...if the student manipulates the form
|
|
switch (Gbl.Usrs.Me.Role.Logged)
|
|
{
|
|
case Rol_STD:
|
|
SelectionIsValid = Grp_CheckIfAtMostOneSingleEnrolmentGrpIsSelected (&LstGrpsIWant,
|
|
true); // Check also closed groups I belong
|
|
break;
|
|
case Rol_TCH:
|
|
case Rol_SYS_ADM:
|
|
break;
|
|
default:
|
|
Err_WrongRoleExit ();
|
|
break;
|
|
}
|
|
|
|
/***** Free list of groups types and groups in this course *****/
|
|
// The lists of group types and groups need to be freed here...
|
|
// ...in order to get them again when changing my groups atomically
|
|
Grp_FreeListGrpTypesAndGrps ();
|
|
|
|
/***** Change my groups *****/
|
|
if (SelectionIsValid)
|
|
{
|
|
ChangesMade = Grp_ChangeMyGrpsAtomically (&LstGrpsIWant);
|
|
if (Verbose == Cns_VERBOSE)
|
|
{
|
|
if (ChangesMade)
|
|
Ale_CreateAlert (Ale_SUCCESS,NULL,
|
|
Txt_The_requested_group_changes_were_successful);
|
|
else
|
|
Ale_CreateAlert (Ale_WARNING,NULL,
|
|
Txt_There_has_been_no_change_in_groups);
|
|
}
|
|
}
|
|
else if (Verbose == Cns_VERBOSE)
|
|
Ale_CreateAlert (Ale_WARNING,NULL,
|
|
Txt_In_a_type_of_group_with_single_enrolment_students_can_not_be_registered_in_more_than_one_group);
|
|
|
|
/***** Free memory with the list of groups which I want to belong to *****/
|
|
Grp_FreeListCodGrp (&LstGrpsIWant);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********************** Change groups of another user ************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ChangeOtherUsrGrps (void)
|
|
{
|
|
extern const char *Txt_The_requested_group_changes_were_successful;
|
|
extern const char *Txt_There_has_been_no_change_in_groups;
|
|
extern const char *Txt_In_a_type_of_group_with_single_enrolment_students_can_not_be_registered_in_more_than_one_group;
|
|
struct ListCodGrps LstGrpsUsrWants;
|
|
bool SelectionIsValid = true;
|
|
|
|
/***** Can I change another user's groups? *****/
|
|
if (Grp_CheckIfICanChangeGrps () == Usr_CAN_NOT)
|
|
return;
|
|
|
|
/***** Get list of groups types and groups in current course *****/
|
|
Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_ONLY_GROUP_TYPES_WITH_GROUPS);
|
|
|
|
/***** Get the list of groups to which register this user *****/
|
|
LstGrpsUsrWants.GrpCods = NULL; // Initialized to avoid bug reported by Coverity
|
|
LstGrpsUsrWants.NumGrps = 0; // Initialized to avoid bug reported by Coverity
|
|
Grp_GetLstCodsGrpWanted (&LstGrpsUsrWants);
|
|
|
|
/***** A student can not be enroled in more than one group
|
|
if the type of group is of single enrolment *****/
|
|
switch (Gbl.Usrs.Other.UsrDat.Roles.InCurrentCrs)
|
|
{
|
|
case Rol_STD:
|
|
SelectionIsValid = Grp_CheckIfAtMostOneSingleEnrolmentGrpIsSelected (&LstGrpsUsrWants,
|
|
false); // Don't check closed groups
|
|
break;
|
|
case Rol_NET:
|
|
case Rol_TCH:
|
|
break;
|
|
default:
|
|
Err_WrongRoleExit ();
|
|
break;
|
|
}
|
|
|
|
/***** Free list of groups types and groups in this course *****/
|
|
// The lists of group types and groups need to be freed here...
|
|
// ...in order to get them again when changing groups atomically
|
|
Grp_FreeListGrpTypesAndGrps ();
|
|
|
|
/***** Register user in the selected groups *****/
|
|
if (SelectionIsValid)
|
|
Grp_ChangeGrpsOtherUsrAtomically (&LstGrpsUsrWants);
|
|
else
|
|
Ale_CreateAlert (Ale_WARNING,NULL,
|
|
Txt_In_a_type_of_group_with_single_enrolment_students_can_not_be_registered_in_more_than_one_group);
|
|
|
|
/***** Free memory with the list of groups to/from which register/remove users *****/
|
|
Grp_FreeListCodGrp (&LstGrpsUsrWants);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********************** Change my groups atomically **************************/
|
|
/*****************************************************************************/
|
|
// Return true if desired changes are made
|
|
|
|
bool Grp_ChangeMyGrpsAtomically (struct ListCodGrps *LstGrpsIWant)
|
|
{
|
|
struct ListCodGrps LstGrpsIBelong;
|
|
bool SelectionIsValid = true;
|
|
|
|
/***** Lock tables to make the inscription atomic *****/
|
|
Grp_DB_LockTables ();
|
|
|
|
/***** Get list of groups types and groups in this course *****/
|
|
Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_ONLY_GROUP_TYPES_WITH_GROUPS);
|
|
|
|
/***** Query in the database the groups which I belong to *****/
|
|
Grp_GetLstCodGrpsUsrBelongs (Gbl.Usrs.Me.UsrDat.UsrCod,-1L,
|
|
&LstGrpsIBelong,
|
|
Grp_CLOSED_AND_OPEN_GROUPS);
|
|
|
|
switch (Gbl.Usrs.Me.Role.Logged)
|
|
{
|
|
case Rol_STD:
|
|
/***** Go across the received list of groups which I want to belong
|
|
and check that they are not closed or full *****/
|
|
SelectionIsValid = Grp_CheckIfSelectionIsValid (LstGrpsIWant,&LstGrpsIBelong);
|
|
break;
|
|
case Rol_TCH:
|
|
case Rol_SYS_ADM:
|
|
break;
|
|
default:
|
|
Err_WrongRoleExit ();
|
|
break;
|
|
}
|
|
|
|
if (SelectionIsValid)
|
|
{
|
|
/***** Go across the list of groups I belong to,
|
|
removing me from those open groups that are not present
|
|
in the received list of groups I want to belong to *****/
|
|
Grp_RemoveMeFromGrps (LstGrpsIWant,&LstGrpsIBelong);
|
|
|
|
/***** Go across the list of groups that I want to register in,
|
|
adding me to those groups that are not present in the list of groups I belong to *****/
|
|
Grp_RegisterMeInGrps (LstGrpsIWant,&LstGrpsIBelong);
|
|
}
|
|
|
|
/***** Unlock tables after changes in my groups *****/
|
|
DB_UnlockTables ();
|
|
|
|
/***** Free memory with the list of open groups which I belonged to *****/
|
|
Grp_FreeListCodGrp (&LstGrpsIBelong);
|
|
|
|
/***** Free list of groups types and groups in this course *****/
|
|
Grp_FreeListGrpTypesAndGrps ();
|
|
|
|
return SelectionIsValid;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********* Go across the list of groups I belong to, ***********/
|
|
/********* removing me from those open groups that are not present ***********/
|
|
/********* in the received list of groups I want to register in ***********/
|
|
/*****************************************************************************/
|
|
|
|
static bool Grp_CheckIfSelectionIsValid (struct ListCodGrps *LstGrpsIWant,
|
|
struct ListCodGrps *LstGrpsIBelong)
|
|
{
|
|
unsigned NumGrpIWant;
|
|
unsigned NumGrpIBelong;
|
|
long GrpCodIWant;
|
|
unsigned NumGrpTyp;
|
|
unsigned NumGrpThisType;
|
|
struct GroupType *GrpTyp;
|
|
bool RegisterMeInThisGrp;
|
|
|
|
/***** Go across the received list of groups which I want to belong
|
|
and check that they are not closed or full *****/
|
|
for (NumGrpIWant = 0;
|
|
NumGrpIWant < LstGrpsIWant->NumGrps;
|
|
NumGrpIWant++)
|
|
{
|
|
GrpCodIWant = LstGrpsIWant->GrpCods[NumGrpIWant];
|
|
|
|
for (NumGrpIBelong = 0, RegisterMeInThisGrp = true;
|
|
NumGrpIBelong < LstGrpsIBelong->NumGrps && RegisterMeInThisGrp;
|
|
NumGrpIBelong++)
|
|
if (GrpCodIWant == LstGrpsIBelong->GrpCods[NumGrpIBelong])
|
|
RegisterMeInThisGrp = false;
|
|
|
|
if (RegisterMeInThisGrp)
|
|
/* Check if the group is closed or full */
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
GrpTyp = &Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp];
|
|
|
|
for (NumGrpThisType = 0;
|
|
NumGrpThisType < GrpTyp->NumGrps;
|
|
NumGrpThisType++)
|
|
if (GrpTyp->LstGrps[NumGrpThisType].GrpCod == GrpCodIWant)
|
|
{
|
|
/* Check if the group is closed */
|
|
if (GrpTyp->LstGrps[NumGrpThisType].ClosedOrOpen == CloOpe_CLOSED)
|
|
return false; // Selection is not valid
|
|
|
|
/* Check if the group is full */
|
|
if (GrpTyp->LstGrps[NumGrpThisType].NumUsrs[Rol_STD] >=
|
|
GrpTyp->LstGrps[NumGrpThisType].MaxStudents)
|
|
return false; // Selection is not valid
|
|
}
|
|
}
|
|
}
|
|
|
|
return true; // Selection is valid
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********* Go across the list of groups I belong to, ***********/
|
|
/********* removing me from those open groups that are not present ***********/
|
|
/********* in the received list of groups I want to register in ***********/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_RemoveMeFromGrps (struct ListCodGrps *LstGrpsIWant,
|
|
struct ListCodGrps *LstGrpsIBelong)
|
|
{
|
|
unsigned NumGrpIBelong;
|
|
unsigned NumGrpIWant;
|
|
long GrpCodIBelong;
|
|
bool RemoveMeFromThisGrp;
|
|
unsigned NumGrpTyp;
|
|
unsigned NumGrpThisType;
|
|
struct GroupType *GrpTyp;
|
|
|
|
for (NumGrpIBelong = 0;
|
|
NumGrpIBelong < LstGrpsIBelong->NumGrps;
|
|
NumGrpIBelong++)
|
|
{
|
|
GrpCodIBelong = LstGrpsIBelong->GrpCods[NumGrpIBelong];
|
|
|
|
/* Step 1: if I checked this group ==> don't remove me */
|
|
for (NumGrpIWant = 0, RemoveMeFromThisGrp = true;
|
|
NumGrpIWant < LstGrpsIWant->NumGrps && RemoveMeFromThisGrp;
|
|
NumGrpIWant++)
|
|
if (GrpCodIBelong == LstGrpsIWant->GrpCods[NumGrpIWant]) // I checked this group ==> don't remove me
|
|
RemoveMeFromThisGrp = false;
|
|
|
|
/* Step 2 (only for students): if the group is closed ==> don't remove me */
|
|
if (Gbl.Usrs.Me.Role.Logged == Rol_STD && RemoveMeFromThisGrp)
|
|
/* Find if this group is closed.
|
|
- If the group is closed,
|
|
it was not sent in the received list of groups I want
|
|
because it was disabled ==> don't remove me.
|
|
- If the group is open,
|
|
it was not sent in the received list of groups I want
|
|
because I unchecked it ==> remove me. */
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes && RemoveMeFromThisGrp;
|
|
NumGrpTyp++)
|
|
{
|
|
GrpTyp = &Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp];
|
|
for (NumGrpThisType = 0;
|
|
NumGrpThisType < GrpTyp->NumGrps && RemoveMeFromThisGrp;
|
|
NumGrpThisType++)
|
|
if (GrpTyp->LstGrps[NumGrpThisType].GrpCod == GrpCodIBelong) // Found
|
|
if (GrpTyp->LstGrps[NumGrpThisType].ClosedOrOpen == CloOpe_CLOSED)
|
|
RemoveMeFromThisGrp = false;
|
|
}
|
|
|
|
if (RemoveMeFromThisGrp)
|
|
Grp_RemoveUsrFromGroup (Gbl.Usrs.Me.UsrDat.UsrCod,GrpCodIBelong);
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/***** Go across the received list of groups that I want to register in, *****/
|
|
/***** adding me to those groups that I don't belong to *****/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_RegisterMeInGrps (struct ListCodGrps *LstGrpsIWant,
|
|
struct ListCodGrps *LstGrpsIBelong)
|
|
{
|
|
unsigned NumGrpIWant;
|
|
unsigned NumGrpIBelong;
|
|
long GrpCodIWant;
|
|
bool RegisterMeInThisGrp;
|
|
|
|
for (NumGrpIWant = 0;
|
|
NumGrpIWant < LstGrpsIWant->NumGrps;
|
|
NumGrpIWant++)
|
|
{
|
|
GrpCodIWant = LstGrpsIWant->GrpCods[NumGrpIWant];
|
|
|
|
for (NumGrpIBelong = 0, RegisterMeInThisGrp = true;
|
|
NumGrpIBelong < LstGrpsIBelong->NumGrps && RegisterMeInThisGrp;
|
|
NumGrpIBelong++)
|
|
if (GrpCodIWant == LstGrpsIBelong->GrpCods[NumGrpIBelong]) // I already belong
|
|
RegisterMeInThisGrp = false;
|
|
|
|
if (RegisterMeInThisGrp)
|
|
Grp_DB_AddUsrToGrp (Gbl.Usrs.Me.UsrDat.UsrCod,GrpCodIWant);
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********************** Change my groups atomically **************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ChangeGrpsOtherUsrAtomically (struct ListCodGrps *LstGrpsUsrWants)
|
|
{
|
|
struct ListCodGrps LstGrpsUsrBelongs;
|
|
unsigned NumGrpUsrBelongs;
|
|
unsigned NumGrpUsrWants;
|
|
bool RemoveUsrFromThisGrp;
|
|
bool RegisterUsrInThisGrp;
|
|
|
|
/***** Lock tables to make the inscription atomic *****/
|
|
if (Gbl.Usrs.Other.UsrDat.Roles.InCurrentCrs == Rol_STD)
|
|
Grp_DB_LockTables ();
|
|
|
|
/***** Get list of groups types and groups in this course *****/
|
|
Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_ONLY_GROUP_TYPES_WITH_GROUPS);
|
|
|
|
/***** Query in the database the group codes which user belongs to *****/
|
|
Grp_GetLstCodGrpsUsrBelongs (Gbl.Usrs.Other.UsrDat.UsrCod,-1L,
|
|
&LstGrpsUsrBelongs,
|
|
Grp_CLOSED_AND_OPEN_GROUPS);
|
|
|
|
/***** Go across the list of groups user belongs to, removing those groups that are not present in the list of groups user wants to belong to *****/
|
|
for (NumGrpUsrBelongs = 0;
|
|
NumGrpUsrBelongs < LstGrpsUsrBelongs.NumGrps;
|
|
NumGrpUsrBelongs++)
|
|
{
|
|
for (NumGrpUsrWants = 0, RemoveUsrFromThisGrp = true;
|
|
NumGrpUsrWants < LstGrpsUsrWants->NumGrps && RemoveUsrFromThisGrp;
|
|
NumGrpUsrWants++)
|
|
if (LstGrpsUsrBelongs.GrpCods[NumGrpUsrBelongs] == LstGrpsUsrWants->GrpCods[NumGrpUsrWants])
|
|
RemoveUsrFromThisGrp = false;
|
|
if (RemoveUsrFromThisGrp)
|
|
Grp_RemoveUsrFromGroup (Gbl.Usrs.Other.UsrDat.UsrCod,LstGrpsUsrBelongs.GrpCods[NumGrpUsrBelongs]);
|
|
}
|
|
|
|
/***** Go across the list of groups that user wants to register in, adding those groups that are not present in the list of groups user belongs to *****/
|
|
for (NumGrpUsrWants = 0;
|
|
NumGrpUsrWants < LstGrpsUsrWants->NumGrps;
|
|
NumGrpUsrWants++)
|
|
{
|
|
for (NumGrpUsrBelongs = 0, RegisterUsrInThisGrp = true;
|
|
NumGrpUsrBelongs < LstGrpsUsrBelongs.NumGrps && RegisterUsrInThisGrp;
|
|
NumGrpUsrBelongs++)
|
|
if (LstGrpsUsrWants->GrpCods[NumGrpUsrWants] == LstGrpsUsrBelongs.GrpCods[NumGrpUsrBelongs])
|
|
RegisterUsrInThisGrp = false;
|
|
if (RegisterUsrInThisGrp)
|
|
Grp_DB_AddUsrToGrp (Gbl.Usrs.Other.UsrDat.UsrCod,
|
|
LstGrpsUsrWants->GrpCods[NumGrpUsrWants]);
|
|
}
|
|
|
|
/***** Free memory with the list of groups which user belonged to *****/
|
|
Grp_FreeListCodGrp (&LstGrpsUsrBelongs);
|
|
|
|
/***** Unlock tables after changes in groups *****/
|
|
if (Gbl.Usrs.Other.UsrDat.Roles.InCurrentCrs == Rol_STD)
|
|
DB_UnlockTables ();
|
|
|
|
/***** Free list of groups types and groups in this course *****/
|
|
Grp_FreeListGrpTypesAndGrps ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******* Check if at most one single-enrolment group has been selected *******/
|
|
/*****************************************************************************/
|
|
|
|
bool Grp_CheckIfAtMostOneSingleEnrolmentGrpIsSelected (struct ListCodGrps *LstGrps,
|
|
bool CheckClosedGroupsIBelong)
|
|
{
|
|
struct ListCodGrps LstClosedGrpsIBelong;
|
|
struct ListGrpsAlreadySelec *AlreadyExistsGroupOfType;
|
|
unsigned NumCodGrp;
|
|
unsigned NumGrpTyp;
|
|
long GrpTypCod;
|
|
bool MultipleEnrolment;
|
|
bool SelectionIsValid = true;
|
|
|
|
/***** Create and initialize list of groups already selected *****/
|
|
Grp_ConstructorListGrpAlreadySelec (&AlreadyExistsGroupOfType);
|
|
|
|
/***** Go across the list of closed groups to which i belong
|
|
checking if a group of the same type is already selected *****/
|
|
/* Step 1 (only if I am a student selecting groups):
|
|
check the closed groups I belong
|
|
because these groups are disabled in form, an so not received */
|
|
if (CheckClosedGroupsIBelong)
|
|
{
|
|
/* Query in the database the closed group codes which I belong to */
|
|
Grp_GetLstCodGrpsUsrBelongs (Gbl.Usrs.Me.UsrDat.UsrCod,-1L,
|
|
&LstClosedGrpsIBelong,
|
|
Grp_ONLY_CLOSED_GROUPS);
|
|
for (NumCodGrp = 0;
|
|
NumCodGrp < LstClosedGrpsIBelong.NumGrps && SelectionIsValid;
|
|
NumCodGrp++)
|
|
{
|
|
GrpTypCod = Grp_DB_GetGrpTypeFromGrp (LstClosedGrpsIBelong.GrpCods[NumCodGrp]);
|
|
MultipleEnrolment = Grp_GetMultipleEnrolmentOfAGroupType (GrpTypCod);
|
|
|
|
if (!MultipleEnrolment)
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
if (GrpTypCod == AlreadyExistsGroupOfType[NumGrpTyp].GrpTypCod)
|
|
{
|
|
if (AlreadyExistsGroupOfType[NumGrpTyp].AlreadySelected)
|
|
SelectionIsValid = false;
|
|
else
|
|
AlreadyExistsGroupOfType[NumGrpTyp].AlreadySelected = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
/* Free memory with the list of closed groups which I belongs to */
|
|
Grp_FreeListCodGrp (&LstClosedGrpsIBelong);
|
|
}
|
|
|
|
/* Step 2: Check the list of groups selected received from form */
|
|
for (NumCodGrp = 0;
|
|
NumCodGrp < LstGrps->NumGrps && SelectionIsValid;
|
|
NumCodGrp++)
|
|
{
|
|
GrpTypCod = Grp_DB_GetGrpTypeFromGrp (LstGrps->GrpCods[NumCodGrp]);
|
|
MultipleEnrolment = Grp_GetMultipleEnrolmentOfAGroupType (GrpTypCod);
|
|
|
|
if (!MultipleEnrolment)
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
if (GrpTypCod == AlreadyExistsGroupOfType[NumGrpTyp].GrpTypCod)
|
|
{
|
|
if (AlreadyExistsGroupOfType[NumGrpTyp].AlreadySelected)
|
|
SelectionIsValid = false;
|
|
else
|
|
AlreadyExistsGroupOfType[NumGrpTyp].AlreadySelected = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
/***** Free memory of the list of booleanos that indicates
|
|
if a group of each type has been selected *****/
|
|
Grp_DestructorListGrpAlreadySelec (&AlreadyExistsGroupOfType);
|
|
|
|
return SelectionIsValid; // Return true if the selection of groups is correct
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*********** Create e inicializar list of groups already selected ************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_ConstructorListGrpAlreadySelec (struct ListGrpsAlreadySelec **AlreadyExistsGroupOfType)
|
|
{
|
|
unsigned NumGrpTyp;
|
|
|
|
/***** Allocate memory to a list of booleanos that indica if already se ha selected a group of cada type *****/
|
|
if ((*AlreadyExistsGroupOfType = calloc (Gbl.Crs.Grps.GrpTypes.NumGrpTypes,
|
|
sizeof (**AlreadyExistsGroupOfType))) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
|
|
/***** Initialize the list *****/
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
(*AlreadyExistsGroupOfType)[NumGrpTyp].GrpTypCod = Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypCod;
|
|
(*AlreadyExistsGroupOfType)[NumGrpTyp].AlreadySelected = false;
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/***************** Liberar list of groups already selected *******************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_DestructorListGrpAlreadySelec (struct ListGrpsAlreadySelec **AlreadyExistsGroupOfType)
|
|
{
|
|
free (*AlreadyExistsGroupOfType);
|
|
*AlreadyExistsGroupOfType = NULL;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************* Register user in the groups of a list *******************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_RegisterUsrIntoGroups (struct Usr_Data *UsrDat,struct ListCodGrps *LstGrps)
|
|
{
|
|
extern const char *Txt_THE_USER_X_has_been_removed_from_the_group_of_type_Y_to_which_it_belonged;
|
|
extern const char *Txt_THE_USER_X_has_been_enroled_in_the_group_of_type_Y_Z;
|
|
struct ListCodGrps LstGrpsUsrBelongs;
|
|
unsigned NumGrpTyp;
|
|
unsigned NumGrpSel;
|
|
unsigned NumGrpThisType;
|
|
unsigned NumGrpHeBelongs;
|
|
bool MultipleEnrolment;
|
|
bool AlreadyRegisteredInGrp;
|
|
|
|
/***** For each existing type of group in the course... *****/
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
MultipleEnrolment = Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].MultipleEnrolment;
|
|
|
|
/***** Query in the database the group codes of any group of this type the student belongs to *****/
|
|
LstGrpsUsrBelongs.NumGrps = 0; // Initialized to avoid bug reported by Coverity
|
|
LstGrpsUsrBelongs.GrpCods = NULL; // Initialized to avoid bug reported by Coverity
|
|
Grp_GetLstCodGrpsUsrBelongs (UsrDat->UsrCod,Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypCod,
|
|
&LstGrpsUsrBelongs,
|
|
Grp_CLOSED_AND_OPEN_GROUPS);
|
|
|
|
/***** For each group selected by me... *****/
|
|
for (NumGrpSel = 0;
|
|
NumGrpSel < LstGrps->NumGrps;
|
|
NumGrpSel++)
|
|
{
|
|
/* Check if the selected group is of this type */
|
|
for (NumGrpThisType = 0;
|
|
NumGrpThisType < Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps;
|
|
NumGrpThisType++)
|
|
if (LstGrps->GrpCods[NumGrpSel] == Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].LstGrps[NumGrpThisType].GrpCod)
|
|
{ // The selected group is of this type
|
|
AlreadyRegisteredInGrp = false;
|
|
|
|
/* For each group of this type to which the user belongs... */
|
|
for (NumGrpHeBelongs = 0;
|
|
NumGrpHeBelongs < LstGrpsUsrBelongs.NumGrps;
|
|
NumGrpHeBelongs++)
|
|
if (LstGrps->GrpCods[NumGrpSel] == LstGrpsUsrBelongs.GrpCods[NumGrpHeBelongs])
|
|
AlreadyRegisteredInGrp = true;
|
|
else if (!MultipleEnrolment) // If the type of group is of single enrolment
|
|
{
|
|
/* If the enrolment is single and the group to which the user belongs is different from the selected ==>
|
|
remove user from the group to which he belongs */
|
|
Grp_RemoveUsrFromGroup (UsrDat->UsrCod,LstGrpsUsrBelongs.GrpCods[NumGrpHeBelongs]);
|
|
Ale_ShowAlert (Ale_SUCCESS,Txt_THE_USER_X_has_been_removed_from_the_group_of_type_Y_to_which_it_belonged,
|
|
UsrDat->FullName,Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypName);
|
|
}
|
|
|
|
if (!AlreadyRegisteredInGrp) // If the user does not belong to the selected group
|
|
{
|
|
Grp_DB_AddUsrToGrp (UsrDat->UsrCod,
|
|
LstGrps->GrpCods[NumGrpSel]);
|
|
Ale_ShowAlert (Ale_SUCCESS,Txt_THE_USER_X_has_been_enroled_in_the_group_of_type_Y_Z,
|
|
UsrDat->FullName,Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypName,
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].LstGrps[NumGrpThisType].GrpName);
|
|
}
|
|
|
|
break; // Once we know the type of a selected group, it's not necessary to check the rest of types
|
|
}
|
|
}
|
|
|
|
/***** Free the list of groups of this type to which the user belonged *****/
|
|
Grp_FreeListCodGrp (&LstGrpsUsrBelongs);
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/**************** Remove user of the groups indicados in a list **************/
|
|
/*****************************************************************************/
|
|
// Returns NumGrpsHeIsRemoved
|
|
|
|
unsigned Grp_RemoveUsrFromGroups (struct Usr_Data *UsrDat,struct ListCodGrps *LstGrps)
|
|
{
|
|
extern const char *Txt_THE_USER_X_has_not_been_removed_from_any_group;
|
|
extern const char *Txt_THE_USER_X_has_been_removed_from_one_group;
|
|
extern const char *Txt_THE_USER_X_has_been_removed_from_Y_groups;
|
|
struct ListCodGrps LstGrpsUsrBelongs;
|
|
unsigned NumGrpSel;
|
|
unsigned NumGrpUsrBelongs;
|
|
unsigned NumGrpsUsrIsRemoved = 0;
|
|
|
|
/***** Query in the database the group codes of any group the user belongs to *****/
|
|
Grp_GetLstCodGrpsUsrBelongs (UsrDat->UsrCod,-1L,
|
|
&LstGrpsUsrBelongs,
|
|
Grp_CLOSED_AND_OPEN_GROUPS);
|
|
|
|
/***** For each group selected by me... *****/
|
|
for (NumGrpSel = 0;
|
|
NumGrpSel < LstGrps->NumGrps;
|
|
NumGrpSel++)
|
|
/* For each group to which the user belongs... */
|
|
for (NumGrpUsrBelongs = 0;
|
|
NumGrpUsrBelongs < LstGrpsUsrBelongs.NumGrps;
|
|
NumGrpUsrBelongs++)
|
|
/* If the user belongs to a selected group from which he must be removed */
|
|
if (LstGrpsUsrBelongs.GrpCods[NumGrpUsrBelongs] == LstGrps->GrpCods[NumGrpSel])
|
|
{
|
|
Grp_RemoveUsrFromGroup (UsrDat->UsrCod,LstGrpsUsrBelongs.GrpCods[NumGrpUsrBelongs]);
|
|
NumGrpsUsrIsRemoved++;
|
|
}
|
|
|
|
/***** Write message to inform about how many groups the student has been removed from *****/
|
|
if (NumGrpsUsrIsRemoved == 0)
|
|
Ale_ShowAlert (Ale_SUCCESS,Txt_THE_USER_X_has_not_been_removed_from_any_group,
|
|
UsrDat->FullName);
|
|
else if (NumGrpsUsrIsRemoved == 1)
|
|
Ale_ShowAlert (Ale_SUCCESS,Txt_THE_USER_X_has_been_removed_from_one_group,
|
|
UsrDat->FullName);
|
|
else // NumGrpsHeIsRemoved > 1
|
|
Ale_ShowAlert (Ale_SUCCESS,Txt_THE_USER_X_has_been_removed_from_Y_groups,
|
|
UsrDat->FullName,NumGrpsUsrIsRemoved);
|
|
|
|
/***** Free the list of groups of this type to which the user belonged *****/
|
|
Grp_FreeListCodGrp (&LstGrpsUsrBelongs);
|
|
|
|
return NumGrpsUsrIsRemoved;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/***************** Remove a user of all groups of a course *******************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_RemUsrFromAllGrpsInCrs (long UsrCod,long CrsCod)
|
|
{
|
|
/***** Remove user from all groups in the given course *****/
|
|
Grp_DB_RemUsrFromAllGrpsInCrs (UsrCod,CrsCod);
|
|
|
|
/***** Flush caches *****/
|
|
Grp_FlushCacheUsrSharesAnyOfMyGrpsInCurrentCrs ();
|
|
if (Usr_ItsMe (UsrCod) == Usr_ME)
|
|
Grp_FlushCacheIBelongToGrp ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********* Remove a user from all groups of all the user's courses ***********/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_RemUsrFromAllGrps (long UsrCod)
|
|
{
|
|
/***** Remove user from all groups *****/
|
|
Grp_DB_RemUsrFromAllGrps (UsrCod);
|
|
|
|
/***** Flush caches *****/
|
|
Grp_FlushCacheUsrSharesAnyOfMyGrpsInCurrentCrs ();
|
|
if (Usr_ItsMe (UsrCod) == Usr_ME)
|
|
Grp_FlushCacheIBelongToGrp ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************* Remove a user from a group ************************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_RemoveUsrFromGroup (long UsrCod,long GrpCod)
|
|
{
|
|
/***** Remove user from group *****/
|
|
Grp_DB_RemoveUsrFromGrp (UsrCod,GrpCod);
|
|
|
|
/***** Flush caches *****/
|
|
Grp_FlushCacheUsrSharesAnyOfMyGrpsInCurrentCrs ();
|
|
if (Usr_ItsMe (UsrCod) == Usr_ME)
|
|
Grp_FlushCacheIBelongToGrp ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************** List current group types for edition *******************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_ListGroupTypesForEdition (void)
|
|
{
|
|
extern const char *Txt_It_is_optional_to_choose_a_group;
|
|
extern const char *Txt_It_is_mandatory_to_choose_a_group;
|
|
extern const char *Txt_A_student_can_belong_to_several_groups;
|
|
extern const char *Txt_A_student_can_only_belong_to_one_group;
|
|
extern const char *Txt_The_groups_will_automatically_open;
|
|
extern const char *Txt_The_groups_will_not_automatically_open;
|
|
unsigned NumGrpTyp;
|
|
unsigned CurrentYear = Dat_GetCurrentYear ();
|
|
unsigned UniqueId;
|
|
char Id[32];
|
|
|
|
/***** Begin table *****/
|
|
HTM_TABLE_Begin ("TBL_SCROLL");
|
|
|
|
/***** Write heading *****/
|
|
Grp_WriteHeadingGroupTypes ();
|
|
|
|
/***** List group types with forms for edition *****/
|
|
for (NumGrpTyp = 0, UniqueId=1;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++, UniqueId++)
|
|
{
|
|
HTM_TR_Begin (NULL);
|
|
|
|
/* Put icon to remove group type */
|
|
HTM_TD_Begin ("class=\"BM\"");
|
|
Ico_PutContextualIconToRemove (ActReqRemGrpTyp,Grp_GROUP_TYPES_SECTION_ID,
|
|
Grp_PutParGrpTypCod,&Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypCod);
|
|
HTM_TD_End ();
|
|
|
|
/* Name of group type */
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
Frm_BeginFormAnchor (ActRenGrpTyp,Grp_GROUP_TYPES_SECTION_ID);
|
|
ParCod_PutPar (ParCod_GrpTyp,Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypCod);
|
|
HTM_INPUT_TEXT ("GrpTypName",Grp_MAX_CHARS_GROUP_TYPE_NAME,
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypName,
|
|
HTM_SUBMIT_ON_CHANGE,
|
|
"size=\"12\" class=\"INPUT_%s\"",
|
|
The_GetSuffix ());
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
/* Is it mandatory to register in any group? */
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
Frm_BeginFormAnchor (ActChgMdtGrpTyp,Grp_GROUP_TYPES_SECTION_ID);
|
|
ParCod_PutPar (ParCod_GrpTyp,Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypCod);
|
|
HTM_SELECT_Begin (HTM_SUBMIT_ON_CHANGE,NULL,
|
|
"name=\"MandatoryEnrolment\""
|
|
" class=\"INPUT_%s\" style=\"width:150px;\"",
|
|
The_GetSuffix ());
|
|
HTM_OPTION (HTM_Type_STRING,"N",
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].MandatoryEnrolment ? HTM_NO_ATTR :
|
|
HTM_SELECTED,
|
|
"%s",Txt_It_is_optional_to_choose_a_group);
|
|
HTM_OPTION (HTM_Type_STRING,"Y",
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].MandatoryEnrolment ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",Txt_It_is_mandatory_to_choose_a_group);
|
|
HTM_SELECT_End ();
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
/* Is it possible to register in multiple groups? */
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
Frm_BeginFormAnchor (ActChgMulGrpTyp,Grp_GROUP_TYPES_SECTION_ID);
|
|
ParCod_PutPar (ParCod_GrpTyp,Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypCod);
|
|
HTM_SELECT_Begin (HTM_SUBMIT_ON_CHANGE,NULL,
|
|
"name=\"MultipleEnrolment\""
|
|
" class=\"INPUT_%s\" style=\"width:150px;\"",
|
|
The_GetSuffix ());
|
|
HTM_OPTION (HTM_Type_STRING,"N",
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].MultipleEnrolment ? HTM_NO_ATTR :
|
|
HTM_SELECTED,
|
|
"%s",Txt_A_student_can_only_belong_to_one_group);
|
|
HTM_OPTION (HTM_Type_STRING,"Y",
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].MultipleEnrolment ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",Txt_A_student_can_belong_to_several_groups);
|
|
HTM_SELECT_End ();
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
/* Open time */
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
Frm_BeginFormAnchor (ActChgTimGrpTyp,Grp_GROUP_TYPES_SECTION_ID);
|
|
ParCod_PutPar (ParCod_GrpTyp,Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypCod);
|
|
HTM_TABLE_BeginCenterPadding (2);
|
|
HTM_TR_Begin (NULL);
|
|
|
|
HTM_TD_Begin ("class=\"LM\" style=\"width:16px;\"");
|
|
if (Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].MustBeOpened)
|
|
Ico_PutIconOn ("clock.svg",Ico_BLACK,
|
|
Txt_The_groups_will_automatically_open);
|
|
|
|
else
|
|
Ico_PutIconOff ("clock.svg",Ico_BLACK,
|
|
Txt_The_groups_will_not_automatically_open);
|
|
|
|
HTM_TD_End ();
|
|
|
|
HTM_TD_Begin ("class=\"LM\"");
|
|
snprintf (Id,sizeof (Id),"open_time_%u",UniqueId);
|
|
Dat_WriteFormClientLocalDateTimeFromTimeUTC (Id,
|
|
Dat_STR_TIME,
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].OpenTimeUTC,
|
|
CurrentYear,
|
|
CurrentYear + 1,
|
|
Dat_FORM_SECONDS_ON,
|
|
Dat_HMS_DO_NOT_SET, // Don't set hour, minute and second
|
|
HTM_SUBMIT_ON_CHANGE);
|
|
HTM_TD_End ();
|
|
|
|
HTM_TR_End ();
|
|
HTM_TABLE_End ();
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
/* Number of groups of this type */
|
|
HTM_TD_Begin ("class=\"CM DAT_%s\"",The_GetSuffix ());
|
|
HTM_Unsigned (Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps);
|
|
HTM_TD_End ();
|
|
|
|
HTM_TR_End ();
|
|
}
|
|
|
|
/***** End table *****/
|
|
HTM_TABLE_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************ Put contextual icons in edition of types of group **************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_PutIconsEditingGroupTypes (__attribute__((unused)) void *Args)
|
|
{
|
|
/***** Put icon to view groups *****/
|
|
Grp_PutIconToViewGroups ();
|
|
}
|
|
|
|
static void Grp_PutIconToViewGroups (void)
|
|
{
|
|
Ico_PutContextualIconToView (ActReqSelGrp,NULL,NULL,NULL);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*********************** Write heading of group types ************************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_WriteHeadingGroupTypes (void)
|
|
{
|
|
extern const char *Txt_Type_of_group;
|
|
extern const char *Txt_eg_Lectures_Practicals;
|
|
extern const char *Txt_Mandatory_enrolment;
|
|
extern const char *Txt_Multiple_enrolment;
|
|
extern const char *Txt_Opening_of_groups;
|
|
extern const char *Txt_Number_of_BR_groups;
|
|
|
|
HTM_TR_Begin (NULL);
|
|
|
|
HTM_TH_Span (NULL ,HTM_HEAD_CENTER,1,1,"BT");
|
|
HTM_TH_Begin (HTM_HEAD_CENTER);
|
|
HTM_Txt (Txt_Type_of_group);
|
|
HTM_BR ();
|
|
HTM_TxtF ("(%s)",Txt_eg_Lectures_Practicals);
|
|
HTM_TH_End ();
|
|
HTM_TH (Txt_Mandatory_enrolment,HTM_HEAD_CENTER);
|
|
HTM_TH (Txt_Multiple_enrolment ,HTM_HEAD_CENTER);
|
|
HTM_TH (Txt_Opening_of_groups ,HTM_HEAD_CENTER);
|
|
HTM_TH (Txt_Number_of_BR_groups,HTM_HEAD_CENTER);
|
|
|
|
HTM_TR_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********************** List current groups for edition **********************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_ListGroupsForEdition (const struct Roo_Rooms *Rooms)
|
|
{
|
|
extern const char *Txt_No_assigned_room;
|
|
extern const char *Txt_Another_room;
|
|
static Act_Action_t NextAction[CloOpe_NUM_CLOSED_OPEN] =
|
|
{
|
|
[CloOpe_CLOSED] = ActOpeGrp,
|
|
[CloOpe_OPEN ] = ActCloGrp,
|
|
};
|
|
static const char *Icon[CloOpe_NUM_CLOSED_OPEN] =
|
|
{
|
|
[CloOpe_CLOSED] = "lock.svg",
|
|
[CloOpe_OPEN ] = "unlock.svg",
|
|
};
|
|
static Ico_Color_t Color[CloOpe_NUM_CLOSED_OPEN] =
|
|
{
|
|
[CloOpe_CLOSED] = Ico_RED,
|
|
[CloOpe_OPEN ] = Ico_GREEN,
|
|
};
|
|
unsigned NumGrpTyp1;
|
|
const struct GroupType *GrpTyp1;
|
|
unsigned NumGrpTyp2;
|
|
const struct GroupType *GrpTyp2;
|
|
unsigned NumGrpThisType;
|
|
struct Group *Grp;
|
|
unsigned NumRoo;
|
|
const struct Roo_Room *Roo;
|
|
Rol_Role_t Role;
|
|
char StrMaxStudents[Cns_MAX_DIGITS_UINT + 1];
|
|
|
|
/***** Begin table *****/
|
|
HTM_TABLE_Begin ("TBL_SCROLL");
|
|
|
|
/***** Write heading *****/
|
|
Grp_WriteHeadingGroups ();
|
|
|
|
/***** List the groups *****/
|
|
for (NumGrpTyp1 = 0;
|
|
NumGrpTyp1 < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp1++)
|
|
{
|
|
GrpTyp1 = &Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp1];
|
|
for (NumGrpThisType = 0;
|
|
NumGrpThisType < GrpTyp1->NumGrps;
|
|
NumGrpThisType++)
|
|
{
|
|
Grp = &GrpTyp1->LstGrps[NumGrpThisType];
|
|
|
|
HTM_TR_Begin (NULL);
|
|
|
|
/***** Icon to remove group *****/
|
|
HTM_TD_Begin ("class=\"BM\"");
|
|
Ico_PutContextualIconToRemove (ActReqRemGrp,Grp_GROUPS_SECTION_ID,
|
|
Grp_PutParGrpCod,&Grp->GrpCod);
|
|
HTM_TD_End ();
|
|
|
|
/***** Icon to open/close group *****/
|
|
HTM_TD_Begin ("class=\"BM\"");
|
|
Frm_BeginFormAnchor (NextAction[Grp->ClosedOrOpen],
|
|
Grp_GROUPS_SECTION_ID);
|
|
ParCod_PutPar (ParCod_Grp,Grp->GrpCod);
|
|
Ico_PutIconLink (Icon[Grp->ClosedOrOpen],
|
|
Color[Grp->ClosedOrOpen],
|
|
NextAction[Grp->ClosedOrOpen]);
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Icon to activate file zones for this group *****/
|
|
HTM_TD_Begin ("class=\"BM\"");
|
|
Frm_BeginFormAnchor (Grp->FileZones ? ActDisFilZonGrp :
|
|
ActEnaFilZonGrp,
|
|
Grp_GROUPS_SECTION_ID);
|
|
ParCod_PutPar (ParCod_Grp,Grp->GrpCod);
|
|
Ico_PutIconLink (Grp->FileZones ? "folder-open.svg" :
|
|
"folder.svg",
|
|
Grp->FileZones ? Ico_GREEN :
|
|
Ico_RED,
|
|
Grp->FileZones ? ActDisFilZonGrp :
|
|
ActEnaFilZonGrp);
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Group type *****/
|
|
/* Begin selector */
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
Frm_BeginFormAnchor (ActChgGrpTyp,Grp_GROUPS_SECTION_ID);
|
|
ParCod_PutPar (ParCod_Grp,Grp->GrpCod);
|
|
HTM_SELECT_Begin (HTM_SUBMIT_ON_CHANGE,NULL,
|
|
"name=\"GrpTypCod\""
|
|
" class=\"INPUT_%s\" style=\"width:100px;\"",
|
|
The_GetSuffix ());
|
|
|
|
/* Options for group types */
|
|
for (NumGrpTyp2 = 0;
|
|
NumGrpTyp2 < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp2++)
|
|
{
|
|
GrpTyp2 = &Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp2];
|
|
HTM_OPTION (HTM_Type_LONG,&GrpTyp2->GrpTypCod,
|
|
(GrpTyp2->GrpTypCod == GrpTyp1->GrpTypCod) ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",GrpTyp2->GrpTypName);
|
|
}
|
|
|
|
/* End selector */
|
|
HTM_SELECT_End ();
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Group name *****/
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
Frm_BeginFormAnchor (ActRenGrp,Grp_GROUPS_SECTION_ID);
|
|
ParCod_PutPar (ParCod_Grp,Grp->GrpCod);
|
|
HTM_INPUT_TEXT ("GrpName",Grp_MAX_CHARS_GROUP_NAME,Grp->GrpName,
|
|
HTM_SUBMIT_ON_CHANGE,
|
|
"size=\"20\" class=\"INPUT_%s\"",
|
|
The_GetSuffix ());
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Room *****/
|
|
/* Begin selector */
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
Frm_BeginFormAnchor (ActChgGrpRoo,Grp_GROUPS_SECTION_ID);
|
|
ParCod_PutPar (ParCod_Grp,Grp->GrpCod);
|
|
HTM_SELECT_Begin (HTM_SUBMIT_ON_CHANGE,NULL,
|
|
"name=\"RooCod\""
|
|
" class=\"INPUT_%s\" style=\"width:100px;\"",
|
|
The_GetSuffix ());
|
|
|
|
/* Option for no assigned room */
|
|
HTM_OPTION (HTM_Type_STRING,"-1",
|
|
(Grp->Room.RooCod < 0) ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",Txt_No_assigned_room);
|
|
|
|
/* Option for another room */
|
|
HTM_OPTION (HTM_Type_STRING,"0",
|
|
(Grp->Room.RooCod == 0) ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",Txt_Another_room);
|
|
|
|
/* Options for rooms */
|
|
for (NumRoo = 0;
|
|
NumRoo < Rooms->Num;
|
|
NumRoo++)
|
|
{
|
|
Roo = &Rooms->Lst[NumRoo];
|
|
HTM_OPTION (HTM_Type_LONG,&Roo->RooCod,
|
|
(Roo->RooCod == Grp->Room.RooCod) ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",Roo->ShrtName);
|
|
}
|
|
|
|
/* End selector */
|
|
HTM_SELECT_End ();
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Current number of users in this group *****/
|
|
for (Role = Rol_TCH;
|
|
Role >= Rol_STD;
|
|
Role--)
|
|
{
|
|
HTM_TD_Begin ("class=\"CM DAT_%s\"",The_GetSuffix ());
|
|
HTM_Int (Grp->NumUsrs[Role]);
|
|
HTM_TD_End ();
|
|
}
|
|
|
|
/***** Maximum number of students of the group (row[3]) *****/
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
Frm_BeginFormAnchor (ActChgMaxStdGrp,Grp_GROUPS_SECTION_ID);
|
|
ParCod_PutPar (ParCod_Grp,Grp->GrpCod);
|
|
Grp_WriteMaxStds (StrMaxStudents,Grp->MaxStudents);
|
|
HTM_INPUT_TEXT ("MaxStudents",Cns_MAX_DIGITS_UINT,StrMaxStudents,
|
|
HTM_SUBMIT_ON_CHANGE,
|
|
"size=\"3\" class=\"INPUT_%s\"",
|
|
The_GetSuffix ());
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
HTM_TR_End ();
|
|
}
|
|
}
|
|
|
|
/***** End table *****/
|
|
HTM_TABLE_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************** Write heading of groups **************************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_WriteHeadingGroups (void)
|
|
{
|
|
extern const char *Txt_Type_BR_of_group;
|
|
extern const char *Txt_Group_name;
|
|
extern const char *Txt_eg_A_B;
|
|
extern const char *Txt_Room;
|
|
extern const char *Txt_ROLES_PLURAL_BRIEF_Abc[Rol_NUM_ROLES];
|
|
extern const char *Txt_Max_BR_students;
|
|
Rol_Role_t Role;
|
|
|
|
HTM_TR_Begin (NULL);
|
|
|
|
HTM_TH_Span (NULL ,HTM_HEAD_CENTER,1,1,"BT");
|
|
HTM_TH_Span (NULL ,HTM_HEAD_CENTER,1,1,"BT");
|
|
HTM_TH_Span (NULL ,HTM_HEAD_CENTER,1,1,"BT");
|
|
HTM_TH (Txt_Type_BR_of_group,HTM_HEAD_CENTER);
|
|
HTM_TH_Begin (HTM_HEAD_CENTER);
|
|
HTM_Txt (Txt_Group_name);
|
|
HTM_BR ();
|
|
HTM_TxtF ("(%s)",Txt_eg_A_B);
|
|
HTM_TH_End ();
|
|
HTM_TH (Txt_Room,HTM_HEAD_CENTER);
|
|
for (Role = Rol_TCH;
|
|
Role >= Rol_STD;
|
|
Role--)
|
|
HTM_TH (Txt_ROLES_PLURAL_BRIEF_Abc[Role],HTM_HEAD_CENTER);
|
|
HTM_TH (Txt_Max_BR_students ,HTM_HEAD_CENTER);
|
|
|
|
HTM_TR_End ();
|
|
}
|
|
|
|
/*********************** Write text "the whole course" ***********************/
|
|
|
|
void Grp_WriteTheWholeCourse (void)
|
|
{
|
|
extern const char *Txt_The_whole_course;
|
|
|
|
HTM_TxtF ("%s %s",Txt_The_whole_course,Gbl.Hierarchy.Node[Hie_CRS].ShrtName);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/****** List groups of a type to edit ******/
|
|
/****** assignments, attendance events, surveys, exam events or matches ******/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ListGrpsToEditAsgAttSvyEvtMch (struct GroupType *GrpTyp,
|
|
Grp_WhichIsAssociatedToGrp_t WhichIsAssociatedToGrp,
|
|
long Cod) // Assignment, attendance event, survey, exam event or match
|
|
{
|
|
static const struct
|
|
{
|
|
const char *Table;
|
|
const char *Field;
|
|
} AssociationsToGrps[Grp_NUM_ASSOCIATIONS_TO_GROUPS] =
|
|
{
|
|
[Grp_ASSIGNMENT] = {"asg_groups","AsgCod"},
|
|
[Grp_ATT_EVENT ] = {"att_groups","AttCod"},
|
|
[Grp_SURVEY ] = {"svy_groups","SvyCod"},
|
|
[Grp_EXA_EVENT ] = {"exa_groups","SesCod"},
|
|
[Grp_MATCH ] = {"mch_groups","MchCod"},
|
|
};
|
|
struct ListCodGrps LstGrpsIBelong;
|
|
unsigned NumGrpThisType;
|
|
bool IBelongToThisGroup;
|
|
struct Group *Grp;
|
|
|
|
/***** Write heading *****/
|
|
Grp_WriteGrpHead (GrpTyp);
|
|
|
|
/***** Query from the database the groups of this type which I belong to *****/
|
|
Grp_GetLstCodGrpsUsrBelongs (Gbl.Usrs.Me.UsrDat.UsrCod,GrpTyp->GrpTypCod,
|
|
&LstGrpsIBelong,
|
|
Grp_CLOSED_AND_OPEN_GROUPS);
|
|
|
|
/***** List the groups *****/
|
|
for (NumGrpThisType = 0;
|
|
NumGrpThisType < GrpTyp->NumGrps;
|
|
NumGrpThisType++)
|
|
{
|
|
Grp = &(GrpTyp->LstGrps[NumGrpThisType]);
|
|
IBelongToThisGroup = Grp_CheckIfGrpIsInList (Grp->GrpCod,&LstGrpsIBelong);
|
|
|
|
/* Put checkbox to select the group */
|
|
HTM_TR_Begin (NULL);
|
|
|
|
HTM_TD_Begin (IBelongToThisGroup ? "class=\"LM BG_HIGHLIGHT\"" :
|
|
"class=\"LM\"");
|
|
HTM_INPUT_CHECKBOX ("GrpCods",
|
|
(Grp_DB_CheckIfAssociatedToGrp (AssociationsToGrps[WhichIsAssociatedToGrp].Table,
|
|
AssociationsToGrps[WhichIsAssociatedToGrp].Field,
|
|
Cod,Grp->GrpCod) ? HTM_CHECKED :
|
|
HTM_NO_ATTR) |
|
|
((IBelongToThisGroup ||
|
|
Gbl.Usrs.Me.Role.Logged == Rol_SYS_ADM) ? HTM_NO_ATTR :
|
|
HTM_DISABLED),
|
|
"id=\"Grp%ld\" value=\"%ld\""
|
|
" onclick=\"uncheckParent(this,'WholeCrs')\"",
|
|
Grp->GrpCod,Grp->GrpCod);
|
|
HTM_TD_End ();
|
|
|
|
Grp_WriteRowGrp (Grp,IBelongToThisGroup ? Lay_HIGHLIGHT :
|
|
Lay_NO_HIGHLIGHT);
|
|
|
|
HTM_TR_End ();
|
|
}
|
|
|
|
/***** Free memory with the list of groups which I belongs to *****/
|
|
Grp_FreeListCodGrp (&LstGrpsIBelong);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/***************** Show list of groups to register/remove me *****************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ReqRegisterInGrps (void)
|
|
{
|
|
/***** Show list of groups to register/remove me *****/
|
|
Grp_ShowLstGrpsToChgMyGrps ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/***************** Show list of groups to register/remove me *****************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ShowLstGrpsToChgMyGrps (void)
|
|
{
|
|
extern const char *Hlp_USERS_Groups;
|
|
extern const char *Txt_My_groups;
|
|
extern const char *Txt_Change_my_groups;
|
|
extern const char *Txt_Enrol_in_groups;
|
|
extern const char *Txt_No_groups_have_been_created_in_the_course_X;
|
|
unsigned NumGrpTyp;
|
|
unsigned NumGrpsThisTypeIBelong;
|
|
unsigned NumGrpsIBelong = 0;
|
|
Frm_PutForm_t PutFormToChangeGrps = Frm_CheckIfInside () ? Frm_DONT_PUT_FORM : // Inside another form (record card)?
|
|
Frm_PUT_FORM;
|
|
Usr_Can_t ICanEdit = (!Frm_CheckIfInside () &&
|
|
(Gbl.Usrs.Me.Role.Logged == Rol_TCH ||
|
|
Gbl.Usrs.Me.Role.Logged == Rol_SYS_ADM)) ? Usr_CAN :
|
|
Usr_CAN_NOT;
|
|
Usr_Can_t ICanChangeMyGrps = Usr_CAN_NOT;
|
|
static void (*FunctionToDrawContextualIcons[Usr_NUM_CAN]) (void *Args) =
|
|
{
|
|
[Usr_CAN_NOT] = NULL,
|
|
[Usr_CAN ] = Grp_PutIconToEditGroups,
|
|
};
|
|
|
|
if (Gbl.Crs.Grps.NumGrps) // This course has groups
|
|
{
|
|
/***** Get list of groups types and groups in this course *****/
|
|
Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_ONLY_GROUP_TYPES_WITH_GROUPS);
|
|
|
|
/***** Show warnings to students *****/
|
|
// Students are required to join groups with mandatory enrolment; teachers don't
|
|
if (Gbl.Usrs.Me.Role.Logged == Rol_STD)
|
|
Grp_ShowWarningToStdsToChangeGrps ();
|
|
}
|
|
|
|
/***** Begin box *****/
|
|
Box_BoxBegin (Txt_My_groups,
|
|
FunctionToDrawContextualIcons[ICanEdit],NULL,
|
|
Hlp_USERS_Groups,Box_NOT_CLOSABLE);
|
|
|
|
if (Gbl.Crs.Grps.NumGrps) // This course has groups
|
|
{
|
|
/***** Begin form *****/
|
|
if (PutFormToChangeGrps)
|
|
Frm_BeginForm (ActChgGrp);
|
|
|
|
/***** List the groups the user belongs to for change *****/
|
|
HTM_TABLE_BeginWidePadding (2);
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
if (Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps) // If there are groups of this type
|
|
{
|
|
if (Grp_ListGrpsForChangeMySelection (&Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp],
|
|
&NumGrpsThisTypeIBelong) == Usr_CAN)
|
|
ICanChangeMyGrps = Usr_CAN;
|
|
NumGrpsIBelong += NumGrpsThisTypeIBelong;
|
|
}
|
|
HTM_TABLE_End ();
|
|
|
|
/***** End form *****/
|
|
if (PutFormToChangeGrps)
|
|
{
|
|
if (ICanChangeMyGrps == Usr_CAN)
|
|
Btn_PutConfirmButton (NumGrpsIBelong ? Txt_Change_my_groups :
|
|
Txt_Enrol_in_groups);
|
|
Frm_EndForm ();
|
|
}
|
|
}
|
|
else // This course has no groups
|
|
Ale_ShowAlert (Ale_INFO,Txt_No_groups_have_been_created_in_the_course_X,
|
|
Gbl.Hierarchy.Node[Hie_CRS].FullName);
|
|
|
|
/***** End box *****/
|
|
Box_BoxEnd ();
|
|
|
|
if (Gbl.Crs.Grps.NumGrps) // This course has groups
|
|
/***** Free list of groups types and groups in this course *****/
|
|
Grp_FreeListGrpTypesAndGrps ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*************************** Put icon to edit groups *************************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_PutIconToEditGroups (__attribute__((unused)) void *Args)
|
|
{
|
|
Ico_PutContextualIconToEdit (ActReqEdiGrp,NULL,NULL,NULL);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*********** Show warnings to students before form to change groups **********/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_ShowWarningToStdsToChangeGrps (void)
|
|
{
|
|
extern const char *Txt_You_have_to_register_compulsorily_at_least_in_one_group_of_type_X;
|
|
extern const char *Txt_You_have_to_register_compulsorily_in_one_group_of_type_X;
|
|
extern const char *Txt_You_can_register_voluntarily_in_one_or_more_groups_of_type_X;
|
|
extern const char *Txt_You_can_register_voluntarily_in_one_group_of_type_X;
|
|
unsigned NumGrpTyp;
|
|
struct GroupType *GrpTyp;
|
|
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
GrpTyp = &Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp];
|
|
// If there are groups of this type...
|
|
if (GrpTyp->NumGrps)
|
|
// If I don't belong to any group
|
|
if (!Grp_DB_CheckIfIBelongToGrpsOfType (GrpTyp->GrpTypCod)) // Fast check (not necesary, but avoid slow check)
|
|
// If there is any group of this type available
|
|
if (Grp_DB_CheckIfAvailableGrpTyp (GrpTyp->GrpTypCod)) // Slow check
|
|
{
|
|
if (GrpTyp->MandatoryEnrolment)
|
|
Ale_ShowAlert (Ale_WARNING,GrpTyp->MultipleEnrolment ? Txt_You_have_to_register_compulsorily_at_least_in_one_group_of_type_X :
|
|
Txt_You_have_to_register_compulsorily_in_one_group_of_type_X,
|
|
GrpTyp->GrpTypName);
|
|
else
|
|
Ale_ShowAlert (Ale_INFO,GrpTyp->MultipleEnrolment ? Txt_You_can_register_voluntarily_in_one_or_more_groups_of_type_X :
|
|
Txt_You_can_register_voluntarily_in_one_group_of_type_X,
|
|
GrpTyp->GrpTypName);
|
|
}
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*************** List the groups of a type to register in ********************/
|
|
/*****************************************************************************/
|
|
// Returns true if I can change my selection
|
|
|
|
static Usr_Can_t Grp_ListGrpsForChangeMySelection (const struct GroupType *GrpTyp,
|
|
unsigned *NumGrpsThisTypeIBelong)
|
|
{
|
|
struct ListCodGrps LstGrpsIBelong;
|
|
unsigned NumGrpThisType;
|
|
struct Group *Grp;
|
|
bool IBelongToThisGroup;
|
|
bool IBelongToAClosedGroup;
|
|
Usr_Can_t ICanChangeMySelectionForThisGrpTyp;
|
|
Usr_Can_t ICanChangeMySelectionForThisGrp;
|
|
HTM_Attributes_t Attributes;
|
|
char StrGrpCod[32];
|
|
|
|
/***** Write heading *****/
|
|
Grp_WriteGrpHead (GrpTyp);
|
|
|
|
/***** Query in the database the group of this type that I belong to *****/
|
|
Grp_GetLstCodGrpsUsrBelongs (Gbl.Usrs.Me.UsrDat.UsrCod,GrpTyp->GrpTypCod,
|
|
&LstGrpsIBelong,
|
|
Grp_CLOSED_AND_OPEN_GROUPS);
|
|
*NumGrpsThisTypeIBelong = LstGrpsIBelong.NumGrps;
|
|
|
|
/***** Check if I can change my selection *****/
|
|
switch (Gbl.Usrs.Me.Role.Logged)
|
|
{
|
|
case Rol_STD:
|
|
if (GrpTyp->MultipleEnrolment) // Enrolment is multiple
|
|
{
|
|
for (NumGrpThisType = 0, ICanChangeMySelectionForThisGrpTyp = Usr_CAN_NOT;
|
|
NumGrpThisType < GrpTyp->NumGrps &&
|
|
ICanChangeMySelectionForThisGrpTyp == Usr_CAN_NOT;
|
|
NumGrpThisType++)
|
|
{
|
|
Grp = &(GrpTyp->LstGrps[NumGrpThisType]);
|
|
if (Grp->ClosedOrOpen == CloOpe_OPEN) // If group is open
|
|
{
|
|
IBelongToThisGroup = Grp_CheckIfGrpIsInList (Grp->GrpCod,&LstGrpsIBelong);
|
|
if (IBelongToThisGroup) // I belong to this group
|
|
ICanChangeMySelectionForThisGrpTyp = Usr_CAN; // I can unregister from group
|
|
else // I don't belong
|
|
if (Grp->NumUsrs[Rol_STD] < Grp->MaxStudents) // Group is not full
|
|
ICanChangeMySelectionForThisGrpTyp = Usr_CAN; // I can register into group
|
|
}
|
|
}
|
|
}
|
|
else // Enrolment is single
|
|
{
|
|
/* Step 1: Check if I belong to a closed group */
|
|
for (NumGrpThisType = 0, IBelongToAClosedGroup = false;
|
|
NumGrpThisType < GrpTyp->NumGrps && !IBelongToAClosedGroup;
|
|
NumGrpThisType++)
|
|
{
|
|
Grp = &(GrpTyp->LstGrps[NumGrpThisType]);
|
|
if (Grp->ClosedOrOpen == CloOpe_CLOSED) // If group is closed
|
|
{
|
|
IBelongToThisGroup = Grp_CheckIfGrpIsInList (Grp->GrpCod,&LstGrpsIBelong);
|
|
if (IBelongToThisGroup) // I belong to this group
|
|
IBelongToAClosedGroup = true; // I belong to a closed group
|
|
}
|
|
}
|
|
|
|
if (IBelongToAClosedGroup) // I belong to a closed group
|
|
ICanChangeMySelectionForThisGrpTyp = Usr_CAN_NOT; // I can not unregister
|
|
else // I don't belong to a closed group
|
|
{
|
|
/* Step 2: If enrolment is not mandatory, I can unregister */
|
|
if (!GrpTyp->MandatoryEnrolment)
|
|
ICanChangeMySelectionForThisGrpTyp = Usr_CAN; // I can unregister from group
|
|
else
|
|
{
|
|
/* Step 3: Check if I can register in at least one group to which I don't belong */
|
|
for (NumGrpThisType = 0, ICanChangeMySelectionForThisGrpTyp = Usr_CAN_NOT;
|
|
NumGrpThisType < GrpTyp->NumGrps &&
|
|
ICanChangeMySelectionForThisGrpTyp == Usr_CAN_NOT;
|
|
NumGrpThisType++)
|
|
{
|
|
Grp = &(GrpTyp->LstGrps[NumGrpThisType]);
|
|
if (Grp->ClosedOrOpen == CloOpe_OPEN && // If group is open...
|
|
Grp->NumUsrs[Rol_STD] < Grp->MaxStudents) // ...and not full
|
|
{
|
|
IBelongToThisGroup = Grp_CheckIfGrpIsInList (Grp->GrpCod,&LstGrpsIBelong);
|
|
if (!IBelongToThisGroup) // I don't belong to this group
|
|
ICanChangeMySelectionForThisGrpTyp = Usr_CAN; // I can register into this group
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
break;
|
|
case Rol_TCH:
|
|
case Rol_SYS_ADM:
|
|
ICanChangeMySelectionForThisGrpTyp = Usr_CAN; // I can not register/unregister
|
|
break;
|
|
default:
|
|
ICanChangeMySelectionForThisGrpTyp = Usr_CAN_NOT; // I can not register/unregister
|
|
break;
|
|
}
|
|
|
|
/***** List the groups *****/
|
|
for (NumGrpThisType = 0;
|
|
NumGrpThisType < GrpTyp->NumGrps;
|
|
NumGrpThisType++)
|
|
{
|
|
Grp = &(GrpTyp->LstGrps[NumGrpThisType]);
|
|
IBelongToThisGroup = Grp_CheckIfGrpIsInList (Grp->GrpCod,&LstGrpsIBelong);
|
|
|
|
/* Selection disabled? */
|
|
switch (ICanChangeMySelectionForThisGrpTyp) // I can change my selection for this group type
|
|
{
|
|
case Usr_CAN:
|
|
ICanChangeMySelectionForThisGrp = Usr_CAN;
|
|
if (Gbl.Usrs.Me.Role.Logged == Rol_STD)
|
|
switch (Grp->ClosedOrOpen)
|
|
{
|
|
case CloOpe_OPEN: // If group is open
|
|
if (!IBelongToThisGroup && // I don't belong to group
|
|
Grp->NumUsrs[Rol_STD] >= Grp->MaxStudents) // Group is full
|
|
ICanChangeMySelectionForThisGrp = Usr_CAN_NOT;
|
|
break;
|
|
case CloOpe_CLOSED: // If group is closed
|
|
default:
|
|
ICanChangeMySelectionForThisGrp = Usr_CAN_NOT;
|
|
break;
|
|
}
|
|
break;
|
|
case Usr_CAN_NOT: // I can not change my selection for this group type
|
|
default:
|
|
ICanChangeMySelectionForThisGrp = Usr_CAN_NOT;
|
|
break;
|
|
}
|
|
|
|
/* Put radio item or checkbox to select the group */
|
|
HTM_TR_Begin (NULL);
|
|
|
|
HTM_TD_Begin (IBelongToThisGroup ? "class=\"LM BG_HIGHLIGHT\"" :
|
|
"class=\"LM\"");
|
|
Attributes = (IBelongToThisGroup ? HTM_CHECKED :
|
|
HTM_NO_ATTR) |
|
|
((ICanChangeMySelectionForThisGrp == Usr_CAN) ? HTM_NO_ATTR :
|
|
HTM_DISABLED);
|
|
snprintf (StrGrpCod,sizeof (StrGrpCod),"GrpCod%ld",GrpTyp->GrpTypCod);
|
|
if (Gbl.Usrs.Me.Role.Logged == Rol_STD && // If I am a student
|
|
!GrpTyp->MultipleEnrolment && // ...and the enrolment is single
|
|
GrpTyp->NumGrps > 1) // ...and there are more than one group
|
|
{
|
|
/* Put a radio item */
|
|
if (GrpTyp->MandatoryEnrolment)
|
|
HTM_INPUT_RADIO (StrGrpCod,
|
|
Attributes,
|
|
"id=\"Grp%ld\" value=\"%ld\"",
|
|
Grp->GrpCod,Grp->GrpCod);
|
|
else // If the enrolment is not mandatory, I can select no groups
|
|
HTM_INPUT_RADIO (StrGrpCod,
|
|
Attributes,
|
|
"id=\"Grp%ld\" value=\"%ld\""
|
|
" onclick=\"selectUnselectRadio(this,%s,this.form.GrpCod%ld,%u)\"",
|
|
Grp->GrpCod,Grp->GrpCod,
|
|
IBelongToThisGroup ? "true" : // initially checked
|
|
"false", // initially unchecked
|
|
GrpTyp->GrpTypCod,GrpTyp->NumGrps);
|
|
}
|
|
else
|
|
/* Put a checkbox item */
|
|
HTM_INPUT_CHECKBOX (StrGrpCod,
|
|
Attributes,
|
|
"id=\"Grp%ld\" value=\"%ld\"",
|
|
Grp->GrpCod,Grp->GrpCod);
|
|
|
|
HTM_TD_End ();
|
|
|
|
Grp_WriteRowGrp (Grp,IBelongToThisGroup ? Lay_HIGHLIGHT :
|
|
Lay_NO_HIGHLIGHT);
|
|
|
|
HTM_TR_End ();
|
|
}
|
|
|
|
/***** Free memory with the list of groups a the that belongs the user *****/
|
|
Grp_FreeListCodGrp (&LstGrpsIBelong);
|
|
|
|
return ICanChangeMySelectionForThisGrpTyp;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*************** Show list of groups to register/remove users ****************/
|
|
/*****************************************************************************/
|
|
// If UsrCod > 0 ==> mark her/his groups as checked
|
|
// If UsrCod <= 0 ==> do not mark any group as checked
|
|
|
|
void Grp_ShowLstGrpsToChgOtherUsrsGrps (long UsrCod)
|
|
{
|
|
extern const char *Hlp_USERS_Groups;
|
|
extern const char *Txt_Groups;
|
|
unsigned NumGrpTyp;
|
|
|
|
/***** Get list of groups types and groups in current course *****/
|
|
Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_ONLY_GROUP_TYPES_WITH_GROUPS);
|
|
|
|
/***** Begin box and table *****/
|
|
Box_BoxTableBegin (Txt_Groups,NULL,NULL,
|
|
Hlp_USERS_Groups,Box_NOT_CLOSABLE,0);
|
|
|
|
/***** List to select the groups the user belongs to *****/
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
if (Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps)
|
|
Grp_ListGrpsToAddOrRemUsrs (&Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp],UsrCod);
|
|
|
|
/***** End table and box *****/
|
|
Box_BoxTableEnd ();
|
|
|
|
/***** Free list of groups types and groups in current course *****/
|
|
Grp_FreeListGrpTypesAndGrps ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*************** List groups of a type to add or remove users ****************/
|
|
/*****************************************************************************/
|
|
// If UsrCod > 0 ==> mark her/his groups as checked
|
|
// If UsrCod <= 0 ==> do not mark any group as checked
|
|
|
|
static void Grp_ListGrpsToAddOrRemUsrs (const struct GroupType *GrpTyp,long UsrCod)
|
|
{
|
|
struct ListCodGrps LstGrpsUsrBelongs;
|
|
unsigned NumGrpThisType;
|
|
bool UsrBelongsToThisGroup;
|
|
struct Group *Grp;
|
|
char StrGrpCod[32];
|
|
|
|
/***** Write heading *****/
|
|
Grp_WriteGrpHead (GrpTyp);
|
|
|
|
/***** Query the groups of this type which the user belongs to *****/
|
|
if (UsrCod > 0)
|
|
Grp_GetLstCodGrpsUsrBelongs (Gbl.Usrs.Other.UsrDat.UsrCod,GrpTyp->GrpTypCod,
|
|
&LstGrpsUsrBelongs,
|
|
Grp_CLOSED_AND_OPEN_GROUPS);
|
|
|
|
/***** List the groups *****/
|
|
for (NumGrpThisType = 0;
|
|
NumGrpThisType < GrpTyp->NumGrps;
|
|
NumGrpThisType++)
|
|
{
|
|
Grp = &(GrpTyp->LstGrps[NumGrpThisType]);
|
|
UsrBelongsToThisGroup = (UsrCod > 0) ? Grp_CheckIfGrpIsInList (Grp->GrpCod,&LstGrpsUsrBelongs) :
|
|
false;
|
|
|
|
/* Begin row */
|
|
HTM_TR_Begin (NULL);
|
|
|
|
/* Begin cell for checkbox */
|
|
HTM_TD_Begin (UsrBelongsToThisGroup ? "class=\"LM BG_HIGHLIGHT\"" :
|
|
"class=\"LM\"");
|
|
|
|
/* Put checkbox to select the group */
|
|
// Always checkbox, not radio, because the role in the form may be teacher,
|
|
// so if he/she is registered as teacher, he/she can belong to several groups
|
|
snprintf (StrGrpCod,sizeof (StrGrpCod),"GrpCod%ld",GrpTyp->GrpTypCod);
|
|
HTM_INPUT_CHECKBOX (StrGrpCod,
|
|
UsrBelongsToThisGroup ? HTM_CHECKED :
|
|
HTM_NO_ATTR,
|
|
"id=\"Grp%ld\" value=\"%ld\"",
|
|
Grp->GrpCod,Grp->GrpCod);
|
|
|
|
/* End cell for checkbox */
|
|
HTM_TD_End ();
|
|
|
|
/* Write cell for group */
|
|
Grp_WriteRowGrp (Grp,UsrBelongsToThisGroup ? Lay_HIGHLIGHT :
|
|
Lay_NO_HIGHLIGHT);
|
|
|
|
/* End row */
|
|
HTM_TR_End ();
|
|
}
|
|
|
|
/***** Free memory with the lists of groups *****/
|
|
if (UsrCod > 0)
|
|
Grp_FreeListCodGrp (&LstGrpsUsrBelongs);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******* Write a list of groups as checkbox form for unique selection ********/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_ListGrpsForMultipleSelection (const struct GroupType *GrpTyp)
|
|
{
|
|
extern const char *Txt_users_with_no_group;
|
|
unsigned NumGrpThisType;
|
|
struct ListCodGrps LstGrpsIBelong;
|
|
bool IBelongToThisGroup;
|
|
Usr_Can_t ICanSelUnselGroup;
|
|
struct Group *Grp;
|
|
|
|
/***** Write heading *****/
|
|
Grp_WriteGrpHead (GrpTyp);
|
|
|
|
/***** Query from the database the groups of this type which I belong to *****/
|
|
Grp_GetLstCodGrpsUsrBelongs (Gbl.Usrs.Me.UsrDat.UsrCod,GrpTyp->GrpTypCod,
|
|
&LstGrpsIBelong,
|
|
Grp_CLOSED_AND_OPEN_GROUPS);
|
|
|
|
/***** List the groups of this type *****/
|
|
for (NumGrpThisType = 0;
|
|
NumGrpThisType < GrpTyp->NumGrps;
|
|
NumGrpThisType++)
|
|
{
|
|
/* Pointer to group */
|
|
Grp = &(GrpTyp->LstGrps[NumGrpThisType]);
|
|
|
|
/* Check if I belong to his group */
|
|
IBelongToThisGroup = Grp_CheckIfGrpIsInList (Grp->GrpCod,&LstGrpsIBelong);
|
|
|
|
/* Check if I can select / unselect this group */
|
|
if (IBelongToThisGroup)
|
|
ICanSelUnselGroup = Usr_CAN;
|
|
else
|
|
switch (Gbl.Usrs.Me.Role.Logged)
|
|
{
|
|
case Rol_STD:
|
|
case Rol_NET:
|
|
ICanSelUnselGroup = IBelongToThisGroup ? Usr_CAN :
|
|
Usr_CAN_NOT;
|
|
break;
|
|
case Rol_TCH:
|
|
case Rol_DEG_ADM:
|
|
case Rol_CTR_ADM:
|
|
case Rol_INS_ADM:
|
|
case Rol_SYS_ADM:
|
|
ICanSelUnselGroup = Usr_CAN;
|
|
break;
|
|
default:
|
|
ICanSelUnselGroup = Usr_CAN_NOT;
|
|
break;
|
|
}
|
|
|
|
/* Put checkbox to select the group */
|
|
HTM_TR_Begin (NULL);
|
|
|
|
HTM_TD_Begin (IBelongToThisGroup ? "class=\"LM BG_HIGHLIGHT\"" :
|
|
"class=\"LM\"");
|
|
HTM_INPUT_CHECKBOX ("GrpCods",
|
|
Grp_Checked (Grp->GrpCod) |
|
|
((ICanSelUnselGroup == Usr_CAN) ? HTM_NO_ATTR :
|
|
HTM_DISABLED),
|
|
"id=\"Grp%ld\" value=\"%ld\"%s",
|
|
Grp->GrpCod,Grp->GrpCod,
|
|
(ICanSelUnselGroup == Usr_CAN) ? " onclick=\"checkParent(this,'AllGroups')\"" :
|
|
"");
|
|
HTM_TD_End ();
|
|
|
|
Grp_WriteRowGrp (Grp,IBelongToThisGroup ? Lay_HIGHLIGHT :
|
|
Lay_NO_HIGHLIGHT);
|
|
|
|
HTM_TR_End ();
|
|
}
|
|
|
|
/***** Free memory with the list of groups which I belongs to *****/
|
|
Grp_FreeListCodGrp (&LstGrpsIBelong);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******** The checkbox associated to a given group should be checked? ********/
|
|
/*****************************************************************************/
|
|
|
|
static HTM_Attributes_t Grp_Checked (long GrpCod)
|
|
{
|
|
unsigned NumGrpSel;
|
|
|
|
if (Gbl.Crs.Grps.AllGrps)
|
|
return HTM_CHECKED;
|
|
|
|
for (NumGrpSel = 0;
|
|
NumGrpSel < Gbl.Crs.Grps.LstGrpsSel.NumGrps;
|
|
NumGrpSel++)
|
|
if (Gbl.Crs.Grps.LstGrpsSel.GrpCods[NumGrpSel] == GrpCod)
|
|
return HTM_CHECKED;
|
|
|
|
return HTM_NO_ATTR;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******* Write row to select the users who don't belong to any group *********/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_WriteRowToSelectUsrsWhoDontBelongToAnyGrp (const struct GroupType *GrpTyp)
|
|
{
|
|
extern const char *Txt_users_with_no_group;
|
|
Rol_Role_t Role;
|
|
|
|
HTM_TR_Begin (NULL);
|
|
|
|
/* Write checkbox to select the group */
|
|
HTM_TD_Begin ("class=\"LM\"");
|
|
// To get the users who don't belong to a type of group,
|
|
// use group code -(GrpTyp->GrpTypCod)
|
|
HTM_INPUT_CHECKBOX ("GrpCods",
|
|
Grp_Checked (-GrpTyp->GrpTypCod),
|
|
"id=\"Grp%ld\" value=\"%ld\""
|
|
" onclick=\"checkParent(this,'AllGroups')\"",
|
|
-GrpTyp->GrpTypCod,-GrpTyp->GrpTypCod);
|
|
HTM_TD_End ();
|
|
|
|
/* Column closed/open */
|
|
HTM_TD_Begin ("class=\"LM\"");
|
|
HTM_TD_End ();
|
|
|
|
/* Group name = students with no group */
|
|
HTM_TD_Begin ("class=\"LM DAT_%s\"",The_GetSuffix ());
|
|
HTM_LABEL_Begin ("for=\"Grp%ld\"",-GrpTyp->GrpTypCod);
|
|
HTM_Txt (Txt_users_with_no_group);
|
|
HTM_LABEL_End ();
|
|
HTM_TD_End ();
|
|
|
|
/* Room */
|
|
HTM_TD_Empty (1);
|
|
|
|
/* Number of students who don't belong to any group of this type */
|
|
for (Role = Rol_TCH;
|
|
Role >= Rol_STD;
|
|
Role--)
|
|
{
|
|
HTM_TD_Begin ("class=\"CM DAT_%s\"",The_GetSuffix ());
|
|
HTM_Unsigned (Grp_DB_CountNumUsrsInNoGrpsOfType (Role,GrpTyp->GrpTypCod));
|
|
HTM_TD_End ();
|
|
}
|
|
|
|
/* Last empty columns for max. students and vacants */
|
|
HTM_TD_Empty (2);
|
|
|
|
HTM_TR_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************** Write a row with the head for list of groups *****************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_WriteGrpHead (const struct GroupType *GrpTyp)
|
|
{
|
|
extern const char *Txt_Opening_of_groups;
|
|
extern const char *Txt_Group;
|
|
extern const char *Txt_Room;
|
|
extern const char *Txt_Max_BR_students;
|
|
extern const char *Txt_ROLES_PLURAL_BRIEF_Abc[Rol_NUM_ROLES];
|
|
extern const char *Txt_Vacants;
|
|
static unsigned UniqueId = 0;
|
|
char *Id;
|
|
Rol_Role_t Role;
|
|
|
|
/***** Name of group type *****/
|
|
HTM_TR_Begin (NULL);
|
|
HTM_TD_Begin ("colspan=\"9\" class=\"GRP_TITLE LM\"");
|
|
HTM_BR ();
|
|
HTM_Txt (GrpTyp->GrpTypName);
|
|
if (GrpTyp->MustBeOpened)
|
|
{
|
|
UniqueId++;
|
|
if (asprintf (&Id,"open_time_%u",UniqueId) < 0)
|
|
Err_NotEnoughMemoryExit ();
|
|
HTM_BR ();
|
|
HTM_TxtColonNBSP (Txt_Opening_of_groups);
|
|
HTM_SPAN_Begin ("id=\"%s\"",Id);
|
|
HTM_SPAN_End ();
|
|
Dat_WriteLocalDateHMSFromUTC (Id,GrpTyp->OpenTimeUTC,
|
|
Gbl.Prefs.DateFormat,Dat_SEPARATOR_COMMA,
|
|
Dat_WRITE_TODAY |
|
|
Dat_WRITE_DATE_ON_SAME_DAY |
|
|
Dat_WRITE_WEEK_DAY |
|
|
Dat_WRITE_HOUR |
|
|
Dat_WRITE_MINUTE |
|
|
Dat_WRITE_SECOND);
|
|
free (Id);
|
|
}
|
|
HTM_TD_End ();
|
|
HTM_TR_End ();
|
|
|
|
/***** Head row with title of each column *****/
|
|
HTM_TR_Begin (NULL);
|
|
|
|
HTM_TH_Empty (2);
|
|
HTM_TH (Txt_Group ,HTM_HEAD_LEFT );
|
|
HTM_TH (Txt_Room ,HTM_HEAD_LEFT );
|
|
for (Role = Rol_TCH;
|
|
Role >= Rol_STD;
|
|
Role--)
|
|
HTM_TH (Txt_ROLES_PLURAL_BRIEF_Abc[Role],HTM_HEAD_CENTER);
|
|
HTM_TH (Txt_Max_BR_students,HTM_HEAD_CENTER);
|
|
HTM_TH (Txt_Vacants ,HTM_HEAD_CENTER);
|
|
|
|
HTM_TR_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/****************** Write a row with the data of a group *********************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_WriteRowGrp (const struct Group *Grp,Lay_Highlight_t Highlight)
|
|
{
|
|
extern const char *Txt_Group_X_open;
|
|
extern const char *Txt_Group_X_closed;
|
|
char *Title;
|
|
int Vacant;
|
|
Rol_Role_t Role;
|
|
char StrMaxStudents[Cns_MAX_DIGITS_UINT + 1];
|
|
static const char *HighlightClass[Lay_NUM_HIGHLIGHT] =
|
|
{
|
|
[Lay_NO_HIGHLIGHT] = "",
|
|
[Lay_HIGHLIGHT ] = " BG_HIGHLIGHT",
|
|
};
|
|
static const char **TitleFormat[CloOpe_NUM_CLOSED_OPEN] =
|
|
{
|
|
[CloOpe_CLOSED] = &Txt_Group_X_closed,
|
|
[CloOpe_OPEN ] = &Txt_Group_X_open,
|
|
};
|
|
static const char *Icon[CloOpe_NUM_CLOSED_OPEN] =
|
|
{
|
|
[CloOpe_CLOSED] = "lock.svg",
|
|
[CloOpe_OPEN ] = "unlock.svg",
|
|
};
|
|
static Ico_Color_t Color[CloOpe_NUM_CLOSED_OPEN] =
|
|
{
|
|
[CloOpe_CLOSED] = Ico_RED,
|
|
[CloOpe_OPEN ] = Ico_GREEN,
|
|
};
|
|
|
|
|
|
/***** Write icon to show if group is open or closed *****/
|
|
HTM_TD_Begin ("class=\"BM%s\"",HighlightClass[Highlight]);
|
|
if (asprintf (&Title,*TitleFormat[Grp->ClosedOrOpen],Grp->GrpName) < 0)
|
|
Err_NotEnoughMemoryExit ();
|
|
Ico_PutIconOff (Icon[Grp->ClosedOrOpen],Color[Grp->ClosedOrOpen],Title);
|
|
free (Title);
|
|
HTM_TD_End ();
|
|
|
|
/***** Group name *****/
|
|
HTM_TD_Begin ("class=\"LM%s\"",HighlightClass[Highlight]);
|
|
HTM_LABEL_Begin ("for=\"Grp%ld\" class=\"DAT_%s\"",
|
|
Grp->GrpCod,The_GetSuffix ());
|
|
HTM_Txt (Grp->GrpName);
|
|
HTM_LABEL_End ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Room *****/
|
|
HTM_TD_Begin ("class=\"LM DAT_%s%s\"",
|
|
The_GetSuffix (),HighlightClass[Highlight]);
|
|
HTM_Txt (Grp->Room.ShrtName);
|
|
HTM_TD_End ();
|
|
|
|
/***** Current number of users in this group *****/
|
|
for (Role = Rol_TCH;
|
|
Role >= Rol_STD;
|
|
Role--)
|
|
{
|
|
HTM_TD_Begin ("class=\"CM DAT_%s%s\"",
|
|
The_GetSuffix (),HighlightClass[Highlight]);
|
|
HTM_Int (Grp->NumUsrs[Role]);
|
|
HTM_TD_End ();
|
|
}
|
|
|
|
/***** Max. number of students in this group *****/
|
|
HTM_TD_Begin ("class=\"CM DAT_%s%s\"",
|
|
The_GetSuffix (),HighlightClass[Highlight]);
|
|
Grp_WriteMaxStds (StrMaxStudents,Grp->MaxStudents);
|
|
HTM_TxtF ("%s ",StrMaxStudents);
|
|
HTM_TD_End ();
|
|
|
|
/***** Vacants in this group *****/
|
|
HTM_TD_Begin ("class=\"CM DAT_%s%s\"",
|
|
The_GetSuffix (),HighlightClass[Highlight]);
|
|
if (Grp->MaxStudents <= Grp_MAX_STUDENTS_IN_A_GROUP)
|
|
{
|
|
Vacant = (int) Grp->MaxStudents - (int) Grp->NumUsrs[Rol_STD];
|
|
HTM_Unsigned (Vacant > 0 ? (unsigned) Vacant :
|
|
0);
|
|
}
|
|
HTM_TD_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********************* Put a form to create a new group type *****************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_PutFormToCreateGroupType (void)
|
|
{
|
|
extern const char *Txt_Type_of_group;
|
|
extern const char *Txt_It_is_optional_to_choose_a_group;
|
|
extern const char *Txt_It_is_mandatory_to_choose_a_group;
|
|
extern const char *Txt_A_student_can_belong_to_several_groups;
|
|
extern const char *Txt_A_student_can_only_belong_to_one_group;
|
|
extern const char *Txt_The_groups_will_automatically_open;
|
|
extern const char *Txt_The_groups_will_not_automatically_open;
|
|
unsigned CurrentYear = Dat_GetCurrentYear ();
|
|
|
|
/***** Begin section *****/
|
|
HTM_SECTION_Begin (Grp_NEW_GROUP_TYPE_SECTION_ID);
|
|
|
|
/***** Begin form to create *****/
|
|
Frm_BeginFormTable (ActNewGrpTyp,Grp_NEW_GROUP_TYPE_SECTION_ID,
|
|
NULL,NULL,"TBL_SCROLL");
|
|
|
|
/***** Write heading *****/
|
|
Grp_WriteHeadingGroupTypes ();
|
|
|
|
HTM_TR_Begin (NULL);
|
|
|
|
/***** Column to remove group type, disabled here *****/
|
|
HTM_TD_Begin ("class=\"BM\"");
|
|
HTM_TD_End ();
|
|
|
|
/***** Name of group type *****/
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
HTM_INPUT_TEXT ("GrpTypName",Grp_MAX_CHARS_GROUP_TYPE_NAME,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypName,
|
|
HTM_REQUIRED,
|
|
"size=\"12\" class=\"INPUT_%s\"",The_GetSuffix ());
|
|
HTM_TD_End ();
|
|
|
|
/***** Is it mandatory to register in any groups of this type? *****/
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
HTM_SELECT_Begin (HTM_NO_ATTR,NULL,
|
|
"name=\"MandatoryEnrolment\""
|
|
" class=\"INPUT_%s\" style=\"width:150px;\"",
|
|
The_GetSuffix ());
|
|
HTM_OPTION (HTM_Type_STRING,"N",
|
|
Gbl.Crs.Grps.GrpTyp.MandatoryEnrolment ? HTM_NO_ATTR :
|
|
HTM_SELECTED,
|
|
"%s",Txt_It_is_optional_to_choose_a_group);
|
|
HTM_OPTION (HTM_Type_STRING,"Y",
|
|
Gbl.Crs.Grps.GrpTyp.MandatoryEnrolment ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",Txt_It_is_mandatory_to_choose_a_group);
|
|
HTM_SELECT_End ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Is it possible to register in multiple groups of this type? *****/
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
HTM_SELECT_Begin (HTM_NO_ATTR,NULL,
|
|
"name=\"MultipleEnrolment\""
|
|
" class=\"INPUT_%s\" style=\"width:150px;\"",
|
|
The_GetSuffix ());
|
|
HTM_OPTION (HTM_Type_STRING,"N",
|
|
Gbl.Crs.Grps.GrpTyp.MultipleEnrolment ? HTM_NO_ATTR :
|
|
HTM_SELECTED,
|
|
"%s",Txt_A_student_can_only_belong_to_one_group);
|
|
HTM_OPTION (HTM_Type_STRING,"Y",
|
|
Gbl.Crs.Grps.GrpTyp.MultipleEnrolment ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",Txt_A_student_can_belong_to_several_groups);
|
|
HTM_SELECT_End ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Open time *****/
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
HTM_TABLE_BeginCenterPadding (2);
|
|
HTM_TR_Begin (NULL);
|
|
|
|
HTM_TD_Begin ("class=\"LM\" style=\"width:20px;\"");
|
|
if (Gbl.Crs.Grps.GrpTyp.MustBeOpened)
|
|
Ico_PutIconOn ("clock.svg",Ico_BLACK,
|
|
Txt_The_groups_will_automatically_open);
|
|
else
|
|
Ico_PutIconOff ("clock.svg",Ico_BLACK,
|
|
Txt_The_groups_will_not_automatically_open);
|
|
HTM_TD_End ();
|
|
|
|
HTM_TD_Begin ("class=\"LM\"");
|
|
Dat_WriteFormClientLocalDateTimeFromTimeUTC ("open_time",
|
|
Dat_STR_TIME,
|
|
Gbl.Crs.Grps.GrpTyp.OpenTimeUTC,
|
|
CurrentYear,
|
|
CurrentYear + 1,
|
|
Dat_FORM_SECONDS_ON,
|
|
Dat_HMS_DO_NOT_SET, // Don't set hour, minute and second
|
|
HTM_NO_ATTR);
|
|
HTM_TD_End ();
|
|
|
|
HTM_TR_End ();
|
|
HTM_TABLE_End ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Number of groups of this type *****/
|
|
HTM_TD_Begin ("class=\"CM DAT_%s\"",The_GetSuffix ());
|
|
HTM_Unsigned (0); // It's a new group type ==> 0 groups
|
|
HTM_TD_End ();
|
|
|
|
HTM_TR_End ();
|
|
|
|
/***** End form to create *****/
|
|
Frm_EndFormTable (Btn_CREATE_BUTTON);
|
|
|
|
/***** End section *****/
|
|
HTM_SECTION_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*********************** Put a form to create a new group ********************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_PutFormToCreateGroup (const struct Roo_Rooms *Rooms)
|
|
{
|
|
extern const char *Txt_Group;
|
|
extern const char *Txt_Group_closed;
|
|
extern const char *Txt_File_zones_disabled;
|
|
extern const char *Txt_No_assigned_room;
|
|
extern const char *Txt_Another_room;
|
|
unsigned NumGrpTyp;
|
|
const struct GroupType *GrpTyp;
|
|
unsigned NumRoo;
|
|
const struct Roo_Room *Roo;
|
|
Rol_Role_t Role;
|
|
char StrMaxStudents[Cns_MAX_DIGITS_UINT + 1];
|
|
|
|
/***** Begin section *****/
|
|
HTM_SECTION_Begin (Grp_NEW_GROUP_SECTION_ID);
|
|
|
|
/***** Begin form to create *****/
|
|
Frm_BeginFormTable (ActNewGrp,Grp_GROUPS_SECTION_ID,NULL,NULL,
|
|
"TBL_SCROLL");
|
|
|
|
/***** Write heading *****/
|
|
Grp_WriteHeadingGroups ();
|
|
|
|
HTM_TR_Begin (NULL);
|
|
|
|
/***** Empty column to remove *****/
|
|
HTM_TD_Begin ("class=\"BM\"");
|
|
HTM_TD_End ();
|
|
|
|
/***** Disabled icon to open group *****/
|
|
HTM_TD_Begin ("class=\"BM\"");
|
|
Ico_PutIconOff ("lock.svg",Ico_RED,Txt_Group_closed);
|
|
HTM_TD_End ();
|
|
|
|
/***** Disabled icon for archive zone *****/
|
|
HTM_TD_Begin ("class=\"BM\"");
|
|
Ico_PutIconOff ("folder.svg",Ico_RED,Txt_File_zones_disabled);
|
|
HTM_TD_End ();
|
|
|
|
/***** Group type *****/
|
|
/* Begin selector */
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
HTM_SELECT_Begin (HTM_NO_ATTR,NULL,
|
|
"name=\"GrpTypCod\""
|
|
" class=\"INPUT_%s\" style=\"width:100px;\"",
|
|
The_GetSuffix ());
|
|
|
|
/* Options for group types */
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
GrpTyp = &Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp];
|
|
HTM_OPTION (HTM_Type_LONG,&GrpTyp->GrpTypCod,
|
|
(GrpTyp->GrpTypCod == Gbl.Crs.Grps.GrpTyp.GrpTypCod) ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",GrpTyp->GrpTypName);
|
|
}
|
|
|
|
/* End selector */
|
|
HTM_SELECT_End ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Group name *****/
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
HTM_INPUT_TEXT ("GrpName",Grp_MAX_CHARS_GROUP_NAME,Gbl.Crs.Grps.GrpName,
|
|
HTM_REQUIRED,
|
|
"size=\"20\" class=\"INPUT_%s\"",The_GetSuffix ());
|
|
HTM_TD_End ();
|
|
|
|
/***** Room *****/
|
|
/* Begin selector */
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
HTM_SELECT_Begin (HTM_NO_ATTR,NULL,
|
|
"name=\"RooCod\""
|
|
" class=\"INPUT_%s\" style=\"width:100px;\"",
|
|
The_GetSuffix ());
|
|
|
|
/* Option for no assigned room */
|
|
HTM_OPTION (HTM_Type_STRING,"-1",
|
|
(Gbl.Crs.Grps.RooCod < 0) ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",Txt_No_assigned_room);
|
|
|
|
/* Option for another room */
|
|
HTM_OPTION (HTM_Type_STRING,"0",
|
|
(Gbl.Crs.Grps.RooCod == 0) ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",Txt_Another_room);
|
|
|
|
/* Options for rooms */
|
|
for (NumRoo = 0;
|
|
NumRoo < Rooms->Num;
|
|
NumRoo++)
|
|
{
|
|
Roo = &Rooms->Lst[NumRoo];
|
|
HTM_OPTION (HTM_Type_LONG,&Roo->RooCod,
|
|
(Roo->RooCod == Gbl.Crs.Grps.RooCod) ? HTM_SELECTED :
|
|
HTM_NO_ATTR,
|
|
"%s",Roo->ShrtName);
|
|
}
|
|
|
|
/* End selector */
|
|
HTM_SELECT_End ();
|
|
HTM_TD_End ();
|
|
|
|
/***** Current number of users in this group *****/
|
|
for (Role = Rol_TCH;
|
|
Role >= Rol_STD;
|
|
Role--)
|
|
{
|
|
HTM_TD_Begin ("class=\"CM DAT_%s\"",The_GetSuffix ());
|
|
HTM_Unsigned (0);
|
|
HTM_TD_End ();
|
|
}
|
|
|
|
/***** Maximum number of students *****/
|
|
HTM_TD_Begin ("class=\"CM\"");
|
|
Grp_WriteMaxStds (StrMaxStudents,Gbl.Crs.Grps.MaxStudents);
|
|
HTM_INPUT_TEXT ("MaxStudents",Cns_MAX_DIGITS_UINT,StrMaxStudents,
|
|
HTM_NO_ATTR,
|
|
"size=\"3\" class=\"INPUT_%s\"",The_GetSuffix ());
|
|
HTM_TD_End ();
|
|
|
|
HTM_TR_End ();
|
|
|
|
/***** End form to create *****/
|
|
Frm_EndFormTable (Btn_CREATE_BUTTON);
|
|
|
|
/***** End section *****/
|
|
HTM_SECTION_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*********** Create a list with current group types in this course ***********/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_GetListGrpTypesInCurrentCrs (Grp_WhichGroupTypes_t WhichGroupTypes)
|
|
{
|
|
MYSQL_RES *mysql_res;
|
|
MYSQL_ROW row;
|
|
unsigned long NumGrpTyp;
|
|
static unsigned (*Grp_DB_GetGrpTypesInCurrentCrs[Grp_NUM_WHICH_GROUP_TYPES]) (MYSQL_RES **mysql_res,long HieCod) =
|
|
{
|
|
[Grp_ONLY_GROUP_TYPES_WITH_GROUPS] = Grp_DB_GetGrpTypesWithGrpsInCrs,
|
|
[Grp_ALL_GROUP_TYPES ] = Grp_DB_GetAllGrpTypesInCrs,
|
|
};
|
|
|
|
if (++Gbl.Crs.Grps.GrpTypes.NestedCalls > 1) // If list is created yet, there's nothing to do
|
|
return;
|
|
|
|
/***** Open groups of this course that must be opened
|
|
if open time is in the past *****/
|
|
Grp_OpenGroupsAutomatically ();
|
|
|
|
/***** Get group types from database *****/
|
|
Gbl.Crs.Grps.GrpTypes.NumGrpTypes = Grp_DB_GetGrpTypesInCurrentCrs[WhichGroupTypes] (&mysql_res,Gbl.Hierarchy.Node[Hie_CRS].HieCod);
|
|
|
|
/***** Get group types *****/
|
|
Gbl.Crs.Grps.GrpTypes.NumGrpsTotal = 0;
|
|
|
|
if (Gbl.Crs.Grps.GrpTypes.NumGrpTypes)
|
|
{
|
|
/***** Create a list of group types *****/
|
|
if ((Gbl.Crs.Grps.GrpTypes.LstGrpTypes = calloc (Gbl.Crs.Grps.GrpTypes.NumGrpTypes,
|
|
sizeof (*Gbl.Crs.Grps.GrpTypes.LstGrpTypes))) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
|
|
/***** Get group types *****/
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
/* Get next group type */
|
|
row = mysql_fetch_row (mysql_res);
|
|
|
|
/* Get group type code (row[0]) */
|
|
if ((Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypCod = Str_ConvertStrCodToLongCod (row[0])) <= 0)
|
|
Err_WrongGrpTypExit ();
|
|
|
|
/* Get group type name (row[1]) */
|
|
Str_Copy (Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypName,row[1],
|
|
sizeof (Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypName) - 1);
|
|
|
|
/* Is it mandatory to register in any groups of this type? (row[2]) */
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].MandatoryEnrolment = (row[2][0] == 'Y');
|
|
|
|
/* Is it possible to register in multiple groups of this type? (row[3]) */
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].MultipleEnrolment = (row[3][0] == 'Y');
|
|
|
|
/* Groups of this type must be opened? (row[4]) */
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].MustBeOpened = (row[4][0] == 'Y');
|
|
|
|
/* Get open time (row[5] holds the open time UTC) */
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].OpenTimeUTC = Dat_GetUNIXTimeFromStr (row[5]);
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].MustBeOpened &= Grp_CheckIfOpenTimeInTheFuture (Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].OpenTimeUTC);
|
|
|
|
/* Number of groups of this type (row[6]) */
|
|
if (sscanf (row[6],"%u",&Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps) != 1)
|
|
Err_ShowErrorAndExit ("Wrong number of groups of a type.");
|
|
|
|
/* Add number of groups to total number of groups */
|
|
Gbl.Crs.Grps.GrpTypes.NumGrpsTotal += Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps;
|
|
|
|
/* Initialize pointer to the list of groups of this type */
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].LstGrps = NULL;
|
|
}
|
|
}
|
|
|
|
/***** Free structure that stores the query result *****/
|
|
DB_FreeMySQLResult (&mysql_res);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/***************** Open automatically groups in this course ******************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_OpenGroupsAutomatically (void)
|
|
{
|
|
MYSQL_RES *mysql_res;
|
|
unsigned NumGrpTypes;
|
|
unsigned NumGrpTyp;
|
|
long GrpTypCod;
|
|
|
|
/***** Find group types to be opened *****/
|
|
NumGrpTypes = Grp_DB_GetGrpTypesInCurrentCrsToBeOpened (&mysql_res);
|
|
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
/* Get next group type */
|
|
if ((GrpTypCod = DB_GetNextCode (mysql_res)) > 0)
|
|
{
|
|
/***** Open all closed groups of this type that are closed ****/
|
|
Grp_DB_OpenGrpsOfType (GrpTypCod);
|
|
|
|
/***** To not try to open groups again, set MustBeOpened to false *****/
|
|
Grp_DB_ClearMustBeOpened (GrpTypCod);
|
|
}
|
|
}
|
|
|
|
/***** Free structure that stores the query result *****/
|
|
DB_FreeMySQLResult (&mysql_res);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********* Create a list with group types and groups in this course **********/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_WhichGroupTypes_t WhichGroupTypes)
|
|
{
|
|
unsigned NumGrpTyp;
|
|
unsigned NumGrp;
|
|
MYSQL_RES *mysql_res;
|
|
MYSQL_ROW row;
|
|
struct GroupType *GrpTyp;
|
|
struct Group *Grp;
|
|
Rol_Role_t Role;
|
|
|
|
/***** First we get the list of group types *****/
|
|
Grp_GetListGrpTypesInCurrentCrs (WhichGroupTypes);
|
|
|
|
/***** Then we get the list of groups for each group type *****/
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
GrpTyp = &Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp];
|
|
if (GrpTyp->NumGrps) // If there are groups of this type...
|
|
{
|
|
/***** Query database *****/
|
|
GrpTyp->NumGrps = Grp_DB_GetGrpsOfType (&mysql_res,GrpTyp->GrpTypCod);
|
|
if (GrpTyp->NumGrps > 0) // Groups found...
|
|
{
|
|
/***** Create list with groups of this type *****/
|
|
if ((GrpTyp->LstGrps = calloc ((size_t) GrpTyp->NumGrps,
|
|
sizeof (*GrpTyp->LstGrps))) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
|
|
/***** Get the groups of this type *****/
|
|
for (NumGrp = 0;
|
|
NumGrp < GrpTyp->NumGrps;
|
|
NumGrp++)
|
|
{
|
|
Grp = &(GrpTyp->LstGrps[NumGrp]);
|
|
|
|
/* Get next group */
|
|
row = mysql_fetch_row (mysql_res);
|
|
|
|
/* Get group code (row[0]) */
|
|
if ((Grp->GrpCod = Str_ConvertStrCodToLongCod (row[0])) <= 0)
|
|
Err_WrongGroupExit ();
|
|
|
|
/* Get group name (row[1]) */
|
|
Str_Copy (Grp->GrpName,row[1],sizeof (Grp->GrpName) - 1);
|
|
|
|
/* Get room code (row[2]) */
|
|
Grp->Room.RooCod = Str_ConvertStrCodToLongCod (row[2]);
|
|
|
|
/* Get room short name (row[3]) */
|
|
if (row[3]) // May be NULL because of LEFT JOIN
|
|
Str_Copy (Grp->Room.ShrtName,row[3],
|
|
sizeof (Grp->Room.ShrtName) - 1);
|
|
else // NULL
|
|
Grp->Room.ShrtName[0] = '\0';
|
|
|
|
/* Get number of current users in group */
|
|
for (Role = Rol_TCH;
|
|
Role >= Rol_STD;
|
|
Role--)
|
|
Grp->NumUsrs[Role] = Grp_DB_CountNumUsrsInGrp (Role,Grp->GrpCod);
|
|
|
|
/* Get maximum number of students in group (row[4]) */
|
|
Grp->MaxStudents = Grp_ConvertToNumMaxStdsGrp (row[4]);
|
|
|
|
/* Get whether group is open ('Y') or closed ('N') (row[5]),
|
|
and whether group have file zones ('Y') or not ('N') (row[6]) */
|
|
Grp->ClosedOrOpen = CloOpe_GetClosedOrOpenFromYN (row[5][0]);
|
|
Grp->FileZones = (row[6][0] == 'Y');
|
|
}
|
|
}
|
|
|
|
/***** Free structure that stores the query result *****/
|
|
DB_FreeMySQLResult (&mysql_res);
|
|
}
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********* Free list of groups types and list of groups of each type *********/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_FreeListGrpTypesAndGrps (void)
|
|
{
|
|
unsigned NumGrpTyp;
|
|
struct GroupType *GrpTyp;
|
|
|
|
if (Gbl.Crs.Grps.GrpTypes.NestedCalls > 0)
|
|
if (--Gbl.Crs.Grps.GrpTypes.NestedCalls == 0)
|
|
if (Gbl.Crs.Grps.GrpTypes.LstGrpTypes)
|
|
{
|
|
/***** Free memory used for each list of groups (one list for each group type) *****/
|
|
for (NumGrpTyp = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
GrpTyp = &Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp];
|
|
if (GrpTyp->LstGrps)
|
|
{
|
|
free (GrpTyp->LstGrps);
|
|
GrpTyp->LstGrps = NULL;
|
|
GrpTyp->NumGrps = 0;
|
|
}
|
|
}
|
|
|
|
/***** Free memory used by the list of group types *****/
|
|
free (Gbl.Crs.Grps.GrpTypes.LstGrpTypes);
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes = NULL;
|
|
Gbl.Crs.Grps.GrpTypes.NumGrpTypes = 0;
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************* Get data of a group type from its code ******************/
|
|
/*****************************************************************************/
|
|
// GrpTyp->GrpTypCod must have the code of the type of group
|
|
|
|
static void Grp_GetGroupTypeDataByCod (struct GroupType *GrpTyp)
|
|
{
|
|
MYSQL_RES *mysql_res;
|
|
MYSQL_ROW row;
|
|
|
|
/***** Get data of a type of group from database *****/
|
|
if (Grp_DB_GetGroupTypeDataByCod (&mysql_res,GrpTyp->GrpTypCod) != 1)
|
|
Err_WrongGrpTypExit ();
|
|
|
|
/***** Get some data of group type *****/
|
|
row = mysql_fetch_row (mysql_res);
|
|
Str_Copy (GrpTyp->GrpTypName,row[0],sizeof (GrpTyp->GrpTypName) - 1);
|
|
GrpTyp->MandatoryEnrolment = (row[1][0] == 'Y');
|
|
GrpTyp->MultipleEnrolment = (row[2][0] == 'Y');
|
|
GrpTyp->MustBeOpened = (row[3][0] == 'Y');
|
|
GrpTyp->OpenTimeUTC = Dat_GetUNIXTimeFromStr (row[4]);
|
|
|
|
/***** Free structure that stores the query result *****/
|
|
DB_FreeMySQLResult (&mysql_res);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************* Check if a group type has multiple enrolment *****************/
|
|
/*****************************************************************************/
|
|
|
|
static bool Grp_GetMultipleEnrolmentOfAGroupType (long GrpTypCod)
|
|
{
|
|
MYSQL_RES *mysql_res;
|
|
MYSQL_ROW row;
|
|
bool MultipleEnrolment;
|
|
|
|
/***** Get data of a type of group from database *****/
|
|
if (Grp_DB_GetMultipleEnrolmentOfAGroupType (&mysql_res,GrpTypCod) != 1)
|
|
Err_ShowErrorAndExit ("Error when getting type of enrolment.");
|
|
|
|
/***** Get multiple enrolment *****/
|
|
row = mysql_fetch_row (mysql_res);
|
|
MultipleEnrolment = (row[0][0] == 'Y');
|
|
|
|
/***** Free structure that stores the query result *****/
|
|
DB_FreeMySQLResult (&mysql_res);
|
|
|
|
return MultipleEnrolment;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********************** Get data of a group from its code ********************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_GetGroupDataByCod (struct GroupData *GrpDat)
|
|
{
|
|
MYSQL_RES *mysql_res;
|
|
MYSQL_ROW row;
|
|
|
|
/***** Reset values *****/
|
|
GrpDat->GrpTypCod = -1L;
|
|
GrpDat->CrsCod = -1L;
|
|
GrpDat->GrpTypName[0] = '\0';
|
|
GrpDat->GrpName[0] = '\0';
|
|
GrpDat->Room.RooCod = -1L;
|
|
GrpDat->Room.ShrtName[0] = '\0';
|
|
GrpDat->MaxStudents = 0;
|
|
GrpDat->Vacant = 0;
|
|
GrpDat->ClosedOrOpen = CloOpe_CLOSED;
|
|
GrpDat->FileZones = false;
|
|
GrpDat->MultipleEnrolment = false;
|
|
|
|
if (GrpDat->GrpCod > 0)
|
|
{
|
|
/***** Get data of a group from database *****/
|
|
if (Grp_DB_GetGroupDataByCod (&mysql_res,GrpDat->GrpCod) == 1)
|
|
{
|
|
/***** Get data of group *****/
|
|
row = mysql_fetch_row (mysql_res);
|
|
|
|
/* Get the code of the group type (row[0]) */
|
|
if ((GrpDat->GrpTypCod = Str_ConvertStrCodToLongCod (row[0])) <= 0)
|
|
Err_WrongGrpTypExit ();
|
|
|
|
/* Get the code of the course (row[1]) */
|
|
if ((GrpDat->CrsCod = Str_ConvertStrCodToLongCod (row[1])) <= 0)
|
|
Err_WrongCourseExit ();
|
|
|
|
/* Get the name of the group type (row[2]) */
|
|
Str_Copy (GrpDat->GrpTypName,row[2],sizeof (GrpDat->GrpTypName) - 1);
|
|
|
|
/* Get whether a student may be in one or multiple groups (row[3]) */
|
|
GrpDat->MultipleEnrolment = (row[3][0] == 'Y');
|
|
|
|
/* Get the name of the group (row[4]) */
|
|
Str_Copy (GrpDat->GrpName,row[4],sizeof (GrpDat->GrpName) - 1);
|
|
|
|
/* Get the code of the course (row[5]) */
|
|
GrpDat->Room.RooCod = Str_ConvertStrCodToLongCod (row[5]);
|
|
|
|
/* Get the name of the room (row[6]) */
|
|
if (row[6]) // May be NULL because of LEFT JOIN
|
|
Str_Copy (GrpDat->Room.ShrtName,row[6],
|
|
sizeof (GrpDat->Room.ShrtName) - 1);
|
|
else // NULL
|
|
GrpDat->Room.ShrtName[0] = '\0';
|
|
|
|
/* Get maximum number of students (row[7]) */
|
|
GrpDat->MaxStudents = Grp_ConvertToNumMaxStdsGrp (row[7]);
|
|
|
|
/* Get whether group is open or closed (row[8]),
|
|
and whether group has file zones (row[9]) */
|
|
GrpDat->ClosedOrOpen = CloOpe_GetClosedOrOpenFromYN (row[8][0]);
|
|
GrpDat->FileZones = (row[9][0] == 'Y');
|
|
}
|
|
|
|
/***** Free structure that stores the query result *****/
|
|
DB_FreeMySQLResult (&mysql_res);
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************ Check if I belong to a group ***********************/
|
|
/*****************************************************************************/
|
|
// Return true if I belong to group with code GrpCod
|
|
|
|
void Grp_FlushCacheIBelongToGrp (void)
|
|
{
|
|
Gbl.Cache.IBelongToGrp.Valid = false;
|
|
}
|
|
|
|
bool Grp_GetIfIBelongToGrp (long GrpCod)
|
|
{
|
|
/***** 1. Fast check: Trivial case *****/
|
|
if (GrpCod <= 0)
|
|
return false;
|
|
|
|
/***** 2. Fast check: Is already calculated if I belong to group? *****/
|
|
if (Gbl.Cache.IBelongToGrp.Valid &&
|
|
GrpCod == Gbl.Cache.IBelongToGrp.GrpCod)
|
|
return Gbl.Cache.IBelongToGrp.IBelong;
|
|
|
|
/***** 3. Slow check: Get if I belong to a group from database *****/
|
|
Gbl.Cache.IBelongToGrp.GrpCod = GrpCod;
|
|
Gbl.Cache.IBelongToGrp.IBelong = Grp_DB_CheckIfIBelongToGrp (GrpCod);
|
|
Gbl.Cache.IBelongToGrp.Valid = true;
|
|
return Gbl.Cache.IBelongToGrp.IBelong;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/***** Check if a user belongs to any of my groups in the current course *****/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_FlushCacheUsrSharesAnyOfMyGrpsInCurrentCrs (void)
|
|
{
|
|
Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.Valid = false;
|
|
}
|
|
|
|
bool Grp_CheckIfUsrSharesAnyOfMyGrpsInCurrentCrs (const struct Usr_Data *UsrDat)
|
|
{
|
|
/***** 1. Fast check: Am I logged? *****/
|
|
if (!Gbl.Usrs.Me.Logged)
|
|
return false;
|
|
|
|
/***** 2. Fast check: Is it a valid user code? *****/
|
|
if (UsrDat->UsrCod <= 0)
|
|
return false;
|
|
|
|
/***** 3. Fast check: Is it a course selected? *****/
|
|
if (Gbl.Hierarchy.Node[Hie_CRS].HieCod <= 0)
|
|
return false;
|
|
|
|
/***** 4. Fast check: Do I belong to the current course? *****/
|
|
if (Gbl.Usrs.Me.IBelongToCurrent[Hie_CRS] == Usr_DONT_BELONG)
|
|
return false;
|
|
|
|
/***** 5. Fast check: It's me? *****/
|
|
if (Usr_ItsMe (UsrDat->UsrCod) == Usr_ME)
|
|
return true;
|
|
|
|
/***** 6. Fast check: Is already calculated if user shares
|
|
any group in the current course with me? *****/
|
|
if (Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.Valid &&
|
|
UsrDat->UsrCod == Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.UsrCod)
|
|
return Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.Shares;
|
|
|
|
/***** 7. Fast / slow check: Does he/she belong to the current course? *****/
|
|
if (Enr_CheckIfUsrBelongsToCurrentCrs (UsrDat) == Usr_DONT_BELONG)
|
|
{
|
|
Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.UsrCod = UsrDat->UsrCod;
|
|
Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.Shares = false;
|
|
Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.Valid = true;
|
|
return false;
|
|
}
|
|
|
|
/***** 8. Fast check: Course has groups? *****/
|
|
if (!Gbl.Crs.Grps.NumGrps)
|
|
{
|
|
Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.UsrCod = UsrDat->UsrCod;
|
|
Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.Shares = true;
|
|
Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.Valid = true;
|
|
return true;
|
|
}
|
|
|
|
// Course has groups
|
|
|
|
/***** 9. Slow check: Get if user shares any group in this course with me from database *****/
|
|
/* Check if user shares any group with me */
|
|
Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.UsrCod = UsrDat->UsrCod;
|
|
Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.Shares = Grp_DB_CheckIfUsrSharesAnyOfMyGrpsInCurrentCrs (UsrDat->UsrCod);
|
|
Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.Valid = true;
|
|
return Gbl.Cache.UsrSharesAnyOfMyGrpsInCurrentCrs.Shares;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/****** Query list of group codes of a type to which a user belongs to *******/
|
|
/*****************************************************************************/
|
|
// If GrpTypCod < 0 ==> get the groups of any type
|
|
|
|
static void Grp_GetLstCodGrpsUsrBelongs (long UsrCod,long GrpTypCod,
|
|
struct ListCodGrps *LstGrps,
|
|
Grp_ClosedOpenGroups_t ClosedOpenGroups)
|
|
{
|
|
MYSQL_RES *mysql_res;
|
|
unsigned NumGrp;
|
|
|
|
/***** Get groups which a user belong to from database *****/
|
|
if (GrpTypCod < 0) // Query the groups of any type in the current course
|
|
LstGrps->NumGrps = Grp_DB_GetLstCodGrpsOfAnyTypeInCurrentCrsUsrBelongs (&mysql_res,UsrCod,
|
|
ClosedOpenGroups);
|
|
else // Query only the groups of specified type in the current course
|
|
LstGrps->NumGrps = Grp_DB_GetLstCodGrpsOfATypeInCurrentCrsUsrBelongs (&mysql_res,UsrCod,GrpTypCod);
|
|
|
|
/***** Get the groups *****/
|
|
if (LstGrps->NumGrps)
|
|
{
|
|
/***** Create a list of groups the user belongs to *****/
|
|
if ((LstGrps->GrpCods = calloc (LstGrps->NumGrps,
|
|
sizeof (*LstGrps->GrpCods))) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
for (NumGrp = 0;
|
|
NumGrp < LstGrps->NumGrps;
|
|
NumGrp++)
|
|
/* Get the code of group (row[0]) */
|
|
if ((LstGrps->GrpCods[NumGrp] = DB_GetNextCode (mysql_res)) <= 0)
|
|
Err_WrongGroupExit ();
|
|
}
|
|
|
|
/***** Free structure that stores the query result *****/
|
|
DB_FreeMySQLResult (&mysql_res);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********** Query list of group codes with file zones I belong to ************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_GetLstCodGrpsWithFileZonesIBelong (struct ListCodGrps *LstGrps)
|
|
{
|
|
MYSQL_RES *mysql_res;
|
|
unsigned NumGrp;
|
|
|
|
/***** Get groups with file zones which I belong to from database *****/
|
|
LstGrps->NumGrps = Grp_DB_GetLstCodGrpsWithFileZonesInCurrentCrsIBelong (&mysql_res);
|
|
|
|
/***** Get the groups *****/
|
|
if (LstGrps->NumGrps)
|
|
{
|
|
/***** Create a list of groups I belong to *****/
|
|
if ((LstGrps->GrpCods = calloc (LstGrps->NumGrps,
|
|
sizeof (*LstGrps->GrpCods))) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
for (NumGrp = 0;
|
|
NumGrp < LstGrps->NumGrps;
|
|
NumGrp++)
|
|
/* Get the code of group */
|
|
if ((LstGrps->GrpCods[NumGrp] = DB_GetNextCode (mysql_res)) <= 0)
|
|
Err_WrongGroupExit ();
|
|
}
|
|
|
|
/***** Free structure that stores the query result *****/
|
|
DB_FreeMySQLResult (&mysql_res);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******** Check if a group is in a list of groups which I belong to **********/
|
|
/*****************************************************************************/
|
|
|
|
static bool Grp_CheckIfGrpIsInList (long GrpCod,struct ListCodGrps *LstGrps)
|
|
{
|
|
unsigned NumGrp;
|
|
|
|
for (NumGrp = 0;
|
|
NumGrp < LstGrps->NumGrps;
|
|
NumGrp++)
|
|
if (GrpCod == LstGrps->GrpCods[NumGrp])
|
|
return true;
|
|
|
|
return false;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********** Query names of groups of a type which user belongs to ************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_GetNamesGrpsUsrBelongsTo (long UsrCod,long GrpTypCod,char *GroupNames)
|
|
{
|
|
MYSQL_RES *mysql_res;
|
|
MYSQL_ROW row;
|
|
unsigned NumGrps;
|
|
unsigned NumGrp;
|
|
size_t MaxLength = (Grp_MAX_BYTES_GROUP_NAME + 2) *
|
|
Gbl.Crs.Grps.GrpTypes.NumGrpsTotal;
|
|
|
|
/***** Get the names of groups which a user belongs to, from database *****/
|
|
NumGrps = Grp_DB_GetNamesGrpsUsrBelongsTo (&mysql_res,UsrCod,GrpTypCod);
|
|
|
|
/***** Get the groups *****/
|
|
GroupNames[0] = '\0';
|
|
for (NumGrp = 0;
|
|
NumGrp < NumGrps;
|
|
NumGrp++)
|
|
{
|
|
/* Get next group */
|
|
row = mysql_fetch_row (mysql_res);
|
|
|
|
/* Group name is in row[0] */
|
|
if (NumGrp)
|
|
Str_Concat (GroupNames,", ",MaxLength);
|
|
Str_Concat (GroupNames,row[0],MaxLength);
|
|
}
|
|
|
|
/***** Free structure that stores the query result *****/
|
|
DB_FreeMySQLResult (&mysql_res);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/****************** Receive form to create a new group type ******************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ReceiveNewGrpTyp (void)
|
|
{
|
|
extern const char *Txt_The_type_of_group_X_already_exists;
|
|
extern const char *Txt_Created_new_type_of_group_X;
|
|
extern const char *Txt_You_must_specify_the_name;
|
|
Ale_AlertType_t AlertType;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_TYPE_NAME];
|
|
|
|
/***** Get parameters from form *****/
|
|
/* Get the name of group type */
|
|
Par_GetParText ("GrpTypName",Gbl.Crs.Grps.GrpTyp.GrpTypName,
|
|
Grp_MAX_BYTES_GROUP_TYPE_NAME);
|
|
|
|
/* Get whether it is mandatory to regisrer in any group of this type
|
|
and whether it is possible to register in multiple groups of this type */
|
|
Gbl.Crs.Grps.GrpTyp.MandatoryEnrolment = Par_GetParBool ("MandatoryEnrolment");
|
|
Gbl.Crs.Grps.GrpTyp.MultipleEnrolment = Par_GetParBool ("MultipleEnrolment");
|
|
|
|
/* Get open time */
|
|
Gbl.Crs.Grps.GrpTyp.OpenTimeUTC = Dat_GetTimeUTCFromForm (Dat_STR_TIME);
|
|
Gbl.Crs.Grps.GrpTyp.MustBeOpened = Grp_CheckIfOpenTimeInTheFuture (Gbl.Crs.Grps.GrpTyp.OpenTimeUTC);
|
|
|
|
if (Gbl.Crs.Grps.GrpTyp.GrpTypName[0]) // If there's a group type name
|
|
{
|
|
/***** If name of group type was in database... *****/
|
|
if (Grp_DB_CheckIfGrpTypNameExistsInCurrentCrs (Gbl.Crs.Grps.GrpTyp.GrpTypName,-1L))
|
|
{
|
|
AlertType = Ale_WARNING;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_type_of_group_X_already_exists,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypName);
|
|
}
|
|
else // Add new group type to database
|
|
{
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypCod = Grp_DB_CreateGroupType (&Gbl.Crs.Grps.GrpTyp);
|
|
|
|
AlertType = Ale_SUCCESS;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_Created_new_type_of_group_X,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypName);
|
|
}
|
|
}
|
|
else // If there is not a group type name
|
|
{
|
|
AlertType = Ale_WARNING;
|
|
Str_Copy (AlertTxt,Txt_You_must_specify_the_name,
|
|
sizeof (AlertTxt) - 1);
|
|
}
|
|
|
|
/***** Show the form again *****/
|
|
Grp_ReqEditGroupsInternal (AlertType,AlertTxt,
|
|
Ale_INFO,NULL);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/**************** Check if the open time if in the future ********************/
|
|
/*****************************************************************************/
|
|
|
|
static bool Grp_CheckIfOpenTimeInTheFuture (time_t OpenTimeUTC)
|
|
{
|
|
/***** If open time is 0 ==> groups must no be opened *****/
|
|
if (OpenTimeUTC == (time_t) 0)
|
|
return false;
|
|
|
|
/***** Is open time in the future? *****/
|
|
return (OpenTimeUTC > Dat_GetStartExecutionTimeUTC ());
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************** Receive form to create a new group *********************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ReceiveNewGrp (void)
|
|
{
|
|
extern const char *Txt_The_group_X_already_exists;
|
|
extern const char *Txt_Created_new_group_X;
|
|
extern const char *Txt_You_must_specify_the_name;
|
|
Ale_AlertType_t AlertType;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_NAME];
|
|
|
|
/***** Get parameters from form *****/
|
|
if ((Gbl.Crs.Grps.GrpTyp.GrpTypCod = ParCod_GetPar (ParCod_GrpTyp)) > 0) // Group type valid
|
|
{
|
|
/* Get group name */
|
|
Par_GetParText ("GrpName",Gbl.Crs.Grps.GrpName,Grp_MAX_BYTES_GROUP_NAME);
|
|
|
|
/* Get room */
|
|
Gbl.Crs.Grps.RooCod = ParCod_GetPar (ParCod_Roo);
|
|
|
|
/* Get maximum number of students */
|
|
Gbl.Crs.Grps.MaxStudents = (unsigned)
|
|
Par_GetParUnsignedLong ("MaxStudents",
|
|
0,
|
|
Grp_MAX_STUDENTS_IN_A_GROUP,
|
|
Grp_NUM_STUDENTS_NOT_LIMITED);
|
|
|
|
if (Gbl.Crs.Grps.GrpName[0]) // If there's a group name
|
|
{
|
|
/***** If name of group was in database... *****/
|
|
if (Grp_DB_CheckIfGrpNameExistsForGrpTyp (Gbl.Crs.Grps.GrpTyp.GrpTypCod,
|
|
Gbl.Crs.Grps.GrpName,-1L))
|
|
{
|
|
AlertType = Ale_WARNING;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_group_X_already_exists,
|
|
Gbl.Crs.Grps.GrpName);
|
|
}
|
|
else // Add new group to database
|
|
{
|
|
Grp_DB_CreateGroup (&Gbl.Crs.Grps);
|
|
|
|
/* Write success message */
|
|
AlertType = Ale_SUCCESS;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_Created_new_group_X,
|
|
Gbl.Crs.Grps.GrpName);
|
|
}
|
|
}
|
|
else // If there is not a group name
|
|
{
|
|
AlertType = Ale_ERROR;
|
|
Str_Copy (AlertTxt,Txt_You_must_specify_the_name,
|
|
sizeof (AlertTxt) - 1);
|
|
}
|
|
}
|
|
else // Invalid group type
|
|
{
|
|
AlertType = Ale_ERROR;
|
|
Str_Copy (AlertTxt,"Wrong type of group.",
|
|
sizeof (AlertTxt) - 1);
|
|
}
|
|
|
|
/***** Show the form again *****/
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
AlertType,AlertTxt);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********************* Request removing of a group type **********************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ReqRemGroupType (void)
|
|
{
|
|
/***** Get the code of the group type *****/
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypCod = ParCod_GetAndCheckPar (ParCod_GrpTyp);
|
|
|
|
/***** Check if this group type has groups *****/
|
|
if (Grp_DB_CountNumGrpsInThisCrsOfType (Gbl.Crs.Grps.GrpTyp.GrpTypCod)) // Group type has groups ==> Ask for confirmation
|
|
Grp_AskConfirmRemGrpTypWithGrps ();
|
|
else // Group type has no groups ==> remove directly
|
|
Grp_RemoveGroupTypeCompletely ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************* Request removal of a group ************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ReqRemGroup (void)
|
|
{
|
|
/***** Get group code *****/
|
|
Gbl.Crs.Grps.GrpCod = ParCod_GetAndCheckPar (ParCod_Grp);
|
|
|
|
/***** Confirm removing *****/
|
|
Grp_AskConfirmRemGrp ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********** Ask for confirmation to remove a group type with groups **********/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_AskConfirmRemGrpTypWithGrps (void)
|
|
{
|
|
extern const char *Txt_Do_you_really_want_to_remove_the_type_of_group_X;
|
|
|
|
/***** Get data of the group type from database *****/
|
|
Grp_GetGroupTypeDataByCod (&Gbl.Crs.Grps.GrpTyp);
|
|
|
|
/***** Begin section to edit group types *****/
|
|
Grp_ReqEditGroupsInternal0 ();
|
|
|
|
/***** Show question and button to remove type of group *****/
|
|
Ale_ShowAlertRemove (ActRemGrpTyp,Grp_GROUP_TYPES_SECTION_ID,
|
|
Grp_PutParGrpTypCod,&Gbl.Crs.Grps.GrpTyp.GrpTypCod,
|
|
Txt_Do_you_really_want_to_remove_the_type_of_group_X,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypName);
|
|
|
|
/***** Show the form to edit group types and groups again *****/
|
|
Grp_ReqEditGroupsInternal1 (Ale_INFO,NULL);
|
|
Grp_ReqEditGroupsInternal2 (Ale_INFO,NULL);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************* Ask for confirmation to remove a group ******************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_AskConfirmRemGrp (void)
|
|
{
|
|
extern const char *Txt_Do_you_really_want_to_remove_the_group_X;
|
|
struct GroupData GrpDat;
|
|
|
|
/***** Get name of the group from database *****/
|
|
GrpDat.GrpCod = Gbl.Crs.Grps.GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
|
|
/***** Show the form to edit group types again *****/
|
|
Grp_ReqEditGroupsInternal0 ();
|
|
Grp_ReqEditGroupsInternal1 (Ale_INFO,NULL);
|
|
|
|
/***** Show question and button to remove group *****/
|
|
Ale_ShowAlertRemove (ActRemGrp,Grp_GROUPS_SECTION_ID,
|
|
Grp_PutParGrpCod,&Gbl.Crs.Grps.GrpCod,
|
|
Txt_Do_you_really_want_to_remove_the_group_X,
|
|
GrpDat.GrpName);
|
|
|
|
/***** Show the form to edit groups again *****/
|
|
Grp_ReqEditGroupsInternal2 (Ale_INFO,NULL);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/**************************** Remove a group type ****************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_RemoveGroupType (void)
|
|
{
|
|
/***** Get param with code of group type *****/
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypCod = ParCod_GetAndCheckPar (ParCod_GrpTyp);
|
|
|
|
/***** Remove group type and its groups *****/
|
|
Grp_RemoveGroupTypeCompletely ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************************* Remove a group ******************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_RemoveGroup (void)
|
|
{
|
|
/***** Get param with group code *****/
|
|
Gbl.Crs.Grps.GrpCod = ParCod_GetAndCheckPar (ParCod_Grp);
|
|
|
|
/***** Remove group *****/
|
|
Grp_RemoveGroupCompletely ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********************* Remove a group type from database *********************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_RemoveGroupTypeCompletely (void)
|
|
{
|
|
extern const char *Txt_Type_of_group_X_removed;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_TYPE_NAME];
|
|
|
|
/***** Get name and type of the group from database *****/
|
|
Grp_GetGroupTypeDataByCod (&Gbl.Crs.Grps.GrpTyp);
|
|
|
|
/***** Remove file zones of all groups of this type *****/
|
|
Brw_RemoveZonesOfGroupsOfType (Gbl.Crs.Grps.GrpTyp.GrpTypCod);
|
|
|
|
/***** Remove the associations of assignments to groups of this type *****/
|
|
Asg_DB_RemoveGroupsOfType (Gbl.Crs.Grps.GrpTyp.GrpTypCod);
|
|
|
|
/***** Remove the associations of attendance events to groups of this type *****/
|
|
Att_DB_RemoveGroupsOfType (Gbl.Crs.Grps.GrpTyp.GrpTypCod);
|
|
|
|
/***** Remove the associations of exam sessions to groups of this type *****/
|
|
Exa_DB_RemoveAllGrpsOfType (Gbl.Crs.Grps.GrpTyp.GrpTypCod);
|
|
|
|
/***** Remove the associations of matches to groups of this type *****/
|
|
Mch_DB_RemoveGroupsOfType (Gbl.Crs.Grps.GrpTyp.GrpTypCod);
|
|
|
|
/***** Remove the associations of surveys to groups of this type *****/
|
|
Svy_DB_RemoveGroupsOfType (Gbl.Crs.Grps.GrpTyp.GrpTypCod);
|
|
|
|
/***** Orphan all groups of this type in course timetable *****/
|
|
Tmt_DB_OrphanAllGrpsOfATypeInCrsTimeTable (Gbl.Crs.Grps.GrpTyp.GrpTypCod);
|
|
|
|
/***** Remove all users from groups of this type *****/
|
|
Grp_DB_RemoveUsrsFromGrpsOfType (Gbl.Crs.Grps.GrpTyp.GrpTypCod);
|
|
|
|
/***** Remove all groups of this type *****/
|
|
Grp_DB_RemoveGrpsOfType (Gbl.Crs.Grps.GrpTyp.GrpTypCod);
|
|
|
|
/***** Remove the group type *****/
|
|
Grp_DB_RemoveGrpType (Gbl.Crs.Grps.GrpTyp.GrpTypCod);
|
|
|
|
/***** Create message to show the change made *****/
|
|
snprintf (AlertTxt,sizeof (AlertTxt),Txt_Type_of_group_X_removed,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypName);
|
|
|
|
/***** Show the form again *****/
|
|
Grp_ReqEditGroupsInternal (Ale_SUCCESS,AlertTxt,
|
|
Ale_INFO,NULL);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******* Remove a group from data base and remove group common zone **********/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_RemoveGroupCompletely (void)
|
|
{
|
|
extern const char *Txt_Group_X_removed;
|
|
struct GroupData GrpDat;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_NAME];
|
|
|
|
/***** Get name and type of the group from database *****/
|
|
GrpDat.GrpCod = Gbl.Crs.Grps.GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
|
|
/***** Remove file zones of this group *****/
|
|
Brw_RemoveGrpZones (Gbl.Hierarchy.Node[Hie_CRS].HieCod,GrpDat.GrpCod);
|
|
|
|
/***** Remove this group from all assignments *****/
|
|
Asg_DB_RemoveGroup (GrpDat.GrpCod);
|
|
|
|
/***** Remove this group from all attendance events *****/
|
|
Att_DB_RemoveGroup (GrpDat.GrpCod);
|
|
|
|
/***** Remove this group from all matches *****/
|
|
Mch_DB_RemoveGroup (GrpDat.GrpCod);
|
|
|
|
/***** Remove this group from all exam sessions *****/
|
|
Exa_DB_RemoveGroup (GrpDat.GrpCod);
|
|
|
|
/***** Remove this group from all surveys *****/
|
|
Svy_DB_RemoveGroup (GrpDat.GrpCod);
|
|
|
|
/***** Orphan this group in course timetable *****/
|
|
Tmt_DB_OrphanGrpInCrsTimeTable (GrpDat.GrpCod);
|
|
|
|
/***** Remove all users in this group *****/
|
|
Grp_DB_RemoveUsrsFromGrp (GrpDat.GrpCod);
|
|
|
|
/***** Remove the group *****/
|
|
Grp_DB_RemoveGrp (GrpDat.GrpCod);
|
|
|
|
/***** Create message to show the change made *****/
|
|
snprintf (AlertTxt,sizeof (AlertTxt),Txt_Group_X_removed,
|
|
GrpDat.GrpName);
|
|
|
|
/***** Show the form again *****/
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
Ale_SUCCESS,AlertTxt);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************************* Open a group ********************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_OpenGroup (void)
|
|
{
|
|
extern const char *Txt_The_group_X_is_now_open;
|
|
struct GroupData GrpDat;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_NAME];
|
|
|
|
/***** Get group code *****/
|
|
Gbl.Crs.Grps.GrpCod = ParCod_GetAndCheckPar (ParCod_Grp);
|
|
|
|
/***** Get group data from database *****/
|
|
GrpDat.GrpCod = Gbl.Crs.Grps.GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
|
|
/***** Update the table of groups changing open/close status *****/
|
|
Grp_DB_OpenGrp (GrpDat.GrpCod);
|
|
|
|
/***** Create message to show the change made *****/
|
|
snprintf (AlertTxt,sizeof (AlertTxt),Txt_The_group_X_is_now_open,
|
|
GrpDat.GrpName);
|
|
|
|
/***** Show the form again *****/
|
|
Gbl.Crs.Grps.ClosedOrOpen = CloOpe_OPEN;
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
Ale_SUCCESS,AlertTxt);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************************* Close a group *******************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_CloseGroup (void)
|
|
{
|
|
extern const char *Txt_The_group_X_is_now_closed;
|
|
struct GroupData GrpDat;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_NAME];
|
|
|
|
/***** Get group code *****/
|
|
Gbl.Crs.Grps.GrpCod = ParCod_GetAndCheckPar (ParCod_Grp);
|
|
|
|
/***** Get group data from database *****/
|
|
GrpDat.GrpCod = Gbl.Crs.Grps.GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
|
|
/***** Update the table of groups changing open/close status *****/
|
|
Grp_DB_CloseGrp (Gbl.Crs.Grps.GrpCod);
|
|
|
|
/***** Create message to show the change made *****/
|
|
snprintf (AlertTxt,sizeof (AlertTxt),Txt_The_group_X_is_now_closed,
|
|
GrpDat.GrpName);
|
|
|
|
/***** Show the form again *****/
|
|
Gbl.Crs.Grps.ClosedOrOpen = CloOpe_CLOSED;
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
Ale_SUCCESS,AlertTxt);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************ Enable file zones of a group ***********************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_EnableFileZonesGrp (void)
|
|
{
|
|
extern const char *Txt_File_zones_of_the_group_X_are_now_enabled;
|
|
struct GroupData GrpDat;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_NAME];
|
|
|
|
/***** Get group code *****/
|
|
Gbl.Crs.Grps.GrpCod = ParCod_GetAndCheckPar (ParCod_Grp);
|
|
|
|
/***** Get group data from database *****/
|
|
GrpDat.GrpCod = Gbl.Crs.Grps.GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
|
|
/***** Update the table of groups changing file zones status *****/
|
|
Grp_DB_EnableFileZonesGrp (Gbl.Crs.Grps.GrpCod);
|
|
|
|
/***** Create message to show the change made *****/
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_File_zones_of_the_group_X_are_now_enabled,
|
|
GrpDat.GrpName);
|
|
|
|
/***** Show the form again *****/
|
|
Gbl.Crs.Grps.FileZones = true;
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
Ale_SUCCESS,AlertTxt);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*********************** Disable file zones of a group ***********************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_DisableFileZonesGrp (void)
|
|
{
|
|
extern const char *Txt_File_zones_of_the_group_X_are_now_disabled;
|
|
struct GroupData GrpDat;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_NAME];
|
|
|
|
/***** Get group code *****/
|
|
Gbl.Crs.Grps.GrpCod = ParCod_GetAndCheckPar (ParCod_Grp);
|
|
|
|
/***** Get group data from database *****/
|
|
GrpDat.GrpCod = Gbl.Crs.Grps.GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
|
|
/***** Update the table of groups changing file zones status *****/
|
|
Grp_DB_DisableFileZonesGrp (GrpDat.GrpCod);
|
|
|
|
/***** Create message to show the change made *****/
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_File_zones_of_the_group_X_are_now_disabled,
|
|
GrpDat.GrpName);
|
|
|
|
/***** Show the form again *****/
|
|
Gbl.Crs.Grps.FileZones = false;
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
Ale_SUCCESS,AlertTxt);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*********************** Change the group type of a group ********************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ChangeGroupType (void)
|
|
{
|
|
extern const char *Txt_The_group_X_already_exists;
|
|
extern const char *Txt_The_type_of_group_of_the_group_X_has_changed;
|
|
long NewGrpTypCod;
|
|
struct GroupData GrpDat;
|
|
Ale_AlertType_t AlertType;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_NAME];
|
|
|
|
/***** Get parameters from form *****/
|
|
/* Get group code */
|
|
Gbl.Crs.Grps.GrpCod = ParCod_GetAndCheckPar (ParCod_Grp);
|
|
|
|
/* Get the new group type */
|
|
NewGrpTypCod = ParCod_GetAndCheckPar (ParCod_GrpTyp);
|
|
|
|
/* Get from the database the type and the name of the group */
|
|
GrpDat.GrpCod = Gbl.Crs.Grps.GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
|
|
/***** If group was in database... *****/
|
|
if (Grp_DB_CheckIfGrpNameExistsForGrpTyp (NewGrpTypCod,GrpDat.GrpName,-1L))
|
|
{
|
|
/* Create warning message */
|
|
AlertType = Ale_WARNING;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),Txt_The_group_X_already_exists,
|
|
GrpDat.GrpName);
|
|
}
|
|
else // Group is not in database
|
|
{
|
|
/* Update the table of groups changing old type by new type */
|
|
Grp_DB_ChangeGrpTypOfGrp (GrpDat.GrpCod,NewGrpTypCod);
|
|
|
|
/* Create message to show the change made */
|
|
AlertType = Ale_SUCCESS;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_type_of_group_of_the_group_X_has_changed,
|
|
GrpDat.GrpName);
|
|
}
|
|
|
|
/***** Show the form again *****/
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypCod = NewGrpTypCod;
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
AlertType,AlertTxt);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************* Change the room of a group ************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ChangeGroupRoom (void)
|
|
{
|
|
extern const char *Txt_The_room_assigned_to_the_group_X_has_changed;
|
|
long NewRooCod;
|
|
struct GroupData GrpDat;
|
|
Ale_AlertType_t AlertType;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_NAME];
|
|
|
|
/***** Get parameters from form *****/
|
|
/* Get group code */
|
|
Gbl.Crs.Grps.GrpCod = ParCod_GetAndCheckPar (ParCod_Grp);
|
|
|
|
/* Get the new room */
|
|
NewRooCod = ParCod_GetPar (ParCod_Roo);
|
|
|
|
/* Get from the database the name of the group */
|
|
GrpDat.GrpCod = Gbl.Crs.Grps.GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
|
|
/***** Update the table of groups changing old room by new room *****/
|
|
Grp_DB_ChangeRoomOfGrp (Gbl.Crs.Grps.GrpCod,NewRooCod);
|
|
|
|
/* Create message to show the change made */
|
|
AlertType = Ale_SUCCESS;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_room_assigned_to_the_group_X_has_changed,
|
|
GrpDat.GrpName);
|
|
|
|
/***** Show the form again *****/
|
|
Gbl.Crs.Grps.RooCod = NewRooCod;
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
AlertType,AlertTxt);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************ Change mandatory registration to a group of a type *************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ChangeMandatGrpTyp (void)
|
|
{
|
|
extern const char *Txt_The_type_of_enrolment_of_the_type_of_group_X_has_not_changed;
|
|
extern const char *Txt_The_enrolment_of_students_into_groups_of_type_X_is_now_mandatory;
|
|
extern const char *Txt_The_enrolment_of_students_into_groups_of_type_X_is_now_voluntary;
|
|
bool NewMandatoryEnrolment;
|
|
Ale_AlertType_t AlertType;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_TYPE_NAME];
|
|
|
|
/***** Get parameters of the form *****/
|
|
/* Get the código of type of group */
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypCod = ParCod_GetAndCheckPar (ParCod_GrpTyp);
|
|
|
|
/* Get the new type of enrolment (mandatory or voluntaria) of this type of group */
|
|
NewMandatoryEnrolment = Par_GetParBool ("MandatoryEnrolment");
|
|
|
|
/* Get from the database the name of the type and the old type of enrolment */
|
|
Grp_GetGroupTypeDataByCod (&Gbl.Crs.Grps.GrpTyp);
|
|
|
|
/***** Check if the old type of enrolment match the new
|
|
(this happens when return is pressed without changes) *****/
|
|
if (Gbl.Crs.Grps.GrpTyp.MandatoryEnrolment == NewMandatoryEnrolment)
|
|
{
|
|
AlertType = Ale_INFO;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_type_of_enrolment_of_the_type_of_group_X_has_not_changed,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypName);
|
|
}
|
|
else
|
|
{
|
|
/***** Update of the table of types of group
|
|
changing the old type of enrolment by the new *****/
|
|
Grp_DB_ChangeMandatoryEnrolmentOfAGrpTyp (Gbl.Crs.Grps.GrpTyp.GrpTypCod,
|
|
NewMandatoryEnrolment);
|
|
|
|
/***** Write message to show the change made *****/
|
|
AlertType = Ale_SUCCESS;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
NewMandatoryEnrolment ? Txt_The_enrolment_of_students_into_groups_of_type_X_is_now_mandatory :
|
|
Txt_The_enrolment_of_students_into_groups_of_type_X_is_now_voluntary,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypName);
|
|
}
|
|
|
|
/***** Show the form again *****/
|
|
Gbl.Crs.Grps.GrpTyp.MandatoryEnrolment = NewMandatoryEnrolment;
|
|
Grp_ReqEditGroupsInternal (AlertType,AlertTxt,
|
|
Ale_INFO,NULL);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******** Change multiple enrolment to one or more groups of a type *********/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ChangeMultiGrpTyp (void)
|
|
{
|
|
extern const char *Txt_The_type_of_enrolment_of_the_type_of_group_X_has_not_changed;
|
|
extern const char *Txt_Now_each_student_can_belong_to_multiple_groups_of_type_X;
|
|
extern const char *Txt_Now_each_student_can_only_belong_to_a_group_of_type_X;
|
|
bool NewMultipleEnrolment;
|
|
Ale_AlertType_t AlertType;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_TYPE_NAME];
|
|
|
|
/***** Get parameters from the form *****/
|
|
/* Get the code of type of group */
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypCod = ParCod_GetAndCheckPar (ParCod_GrpTyp);
|
|
|
|
/* Get the new type of enrolment (single or multiple) of this type of group */
|
|
NewMultipleEnrolment = Par_GetParBool ("MultipleEnrolment");
|
|
|
|
/* Get from the database the name of the type and the old type of enrolment */
|
|
Grp_GetGroupTypeDataByCod (&Gbl.Crs.Grps.GrpTyp);
|
|
|
|
/***** Check if the old type of enrolment match the new one
|
|
(this happends when return is pressed without changes) *****/
|
|
if (Gbl.Crs.Grps.GrpTyp.MultipleEnrolment == NewMultipleEnrolment)
|
|
{
|
|
AlertType = Ale_INFO;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_type_of_enrolment_of_the_type_of_group_X_has_not_changed,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypName);
|
|
}
|
|
else
|
|
{
|
|
/***** Update of the table of types of group changing the old type of enrolment by the new *****/
|
|
Grp_DB_ChangeMultipleEnrolmentOfAGrpTyp (Gbl.Crs.Grps.GrpTyp.GrpTypCod,
|
|
NewMultipleEnrolment);
|
|
|
|
/***** Write message to show the change made *****/
|
|
AlertType = Ale_SUCCESS;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
NewMultipleEnrolment ? Txt_Now_each_student_can_belong_to_multiple_groups_of_type_X :
|
|
Txt_Now_each_student_can_only_belong_to_a_group_of_type_X,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypName);
|
|
}
|
|
|
|
/***** Show the form again *****/
|
|
Gbl.Crs.Grps.GrpTyp.MultipleEnrolment = NewMultipleEnrolment;
|
|
Grp_ReqEditGroupsInternal (AlertType,AlertTxt,
|
|
Ale_INFO,NULL);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/****************** Change open time for a type of group *********************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ChangeOpenTimeGrpTyp (void)
|
|
{
|
|
extern const char *Txt_The_date_time_of_opening_of_groups_has_changed;
|
|
|
|
/***** Get the code of type of group *****/
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypCod = ParCod_GetAndCheckPar (ParCod_GrpTyp);
|
|
|
|
/***** Get from the database the data of this type of group *****/
|
|
Grp_GetGroupTypeDataByCod (&Gbl.Crs.Grps.GrpTyp);
|
|
|
|
/***** Get open time *****/
|
|
Gbl.Crs.Grps.GrpTyp.OpenTimeUTC = Dat_GetTimeUTCFromForm (Dat_STR_TIME);
|
|
Gbl.Crs.Grps.GrpTyp.MustBeOpened = Grp_CheckIfOpenTimeInTheFuture (Gbl.Crs.Grps.GrpTyp.OpenTimeUTC);
|
|
|
|
/***** Update the table of types of group
|
|
changing the old opening time of enrolment by the new *****/
|
|
Grp_DB_ChangeOpeningTimeOfAGrpTyp (Gbl.Crs.Grps.GrpTyp.GrpTypCod,
|
|
Gbl.Crs.Grps.GrpTyp.MustBeOpened,
|
|
Gbl.Crs.Grps.GrpTyp.OpenTimeUTC);
|
|
|
|
/***** Write message to show the change made *****/
|
|
Ale_ShowAlert (Ale_SUCCESS,Txt_The_date_time_of_opening_of_groups_has_changed);
|
|
|
|
/***** Show the form again *****/
|
|
Grp_ReqEditGroupsInternal (Ale_SUCCESS,NULL,
|
|
Ale_INFO,NULL);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/***************** Change maximum of students in a group *********************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ChangeMaxStdsGrp (void)
|
|
{
|
|
extern const char *Txt_The_maximum_number_of_students_in_group_X_has_not_changed;
|
|
extern const char *Txt_The_group_X_does_not_have_a_student_limit_now;
|
|
extern const char *Txt_The_maximum_number_of_students_in_group_X_is_now_Y;
|
|
struct GroupData GrpDat;
|
|
unsigned NewMaxStds;
|
|
Ale_AlertType_t AlertType;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_NAME];
|
|
|
|
/***** Get parameters of the form *****/
|
|
/* Get group code */
|
|
Gbl.Crs.Grps.GrpCod = ParCod_GetAndCheckPar (ParCod_Grp);
|
|
|
|
/* Get the new maximum number of students of the group */
|
|
NewMaxStds = (unsigned)
|
|
Par_GetParUnsignedLong ("MaxStudents",
|
|
0,
|
|
Grp_MAX_STUDENTS_IN_A_GROUP,
|
|
Grp_NUM_STUDENTS_NOT_LIMITED);
|
|
|
|
/* Get from the database the type, name, and old maximum of students of the group */
|
|
GrpDat.GrpCod = Gbl.Crs.Grps.GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
|
|
/***** Check if the old maximum of students equals the new one
|
|
(this happens when return is pressed without changes) *****/
|
|
if (GrpDat.MaxStudents == NewMaxStds)
|
|
{
|
|
AlertType = Ale_INFO;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_maximum_number_of_students_in_group_X_has_not_changed,
|
|
GrpDat.GrpName);
|
|
}
|
|
else
|
|
{
|
|
/***** Update the table of groups changing the old maximum of students to the new *****/
|
|
Grp_DB_ChangeMaxStdsOfGrp (Gbl.Crs.Grps.GrpCod,NewMaxStds);
|
|
|
|
/***** Write message to show the change made *****/
|
|
AlertType = Ale_SUCCESS;
|
|
if (NewMaxStds > Grp_MAX_STUDENTS_IN_A_GROUP)
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_group_X_does_not_have_a_student_limit_now,
|
|
GrpDat.GrpName);
|
|
else
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_maximum_number_of_students_in_group_X_is_now_Y,
|
|
GrpDat.GrpName,NewMaxStds);
|
|
}
|
|
|
|
/***** Show the form again *****/
|
|
Gbl.Crs.Grps.MaxStudents = NewMaxStds;
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
AlertType,AlertTxt);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************* Write the maximum number of students in a group ***************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_WriteMaxStds (char Str[Cns_MAX_DIGITS_UINT + 1],unsigned MaxStudents)
|
|
{
|
|
if (MaxStudents <= Grp_MAX_STUDENTS_IN_A_GROUP)
|
|
snprintf (Str,Cns_MAX_DIGITS_UINT + 1,"%u",MaxStudents);
|
|
else
|
|
Str[0] = '\0';
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********* Convert string to maximum number of students in a group ***********/
|
|
/*****************************************************************************/
|
|
|
|
unsigned Grp_ConvertToNumMaxStdsGrp (const char *StrMaxStudents)
|
|
{
|
|
unsigned MaxStudents;
|
|
|
|
if (sscanf (StrMaxStudents,"%u",&MaxStudents) != 1)
|
|
return Grp_NUM_STUDENTS_NOT_LIMITED;
|
|
else if (MaxStudents > Grp_MAX_STUDENTS_IN_A_GROUP)
|
|
return Grp_NUM_STUDENTS_NOT_LIMITED;
|
|
return MaxStudents;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/***************************** Rename a group type ***************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_RenameGroupType (void)
|
|
{
|
|
extern const char *Txt_You_can_not_leave_the_field_empty;
|
|
extern const char *Txt_The_type_of_group_X_already_exists;
|
|
extern const char *Txt_The_type_of_group_X_has_been_renamed_as_Y;
|
|
extern const char *Txt_The_name_X_has_not_changed;
|
|
char NewNameGrpTyp[Grp_MAX_BYTES_GROUP_TYPE_NAME + 1];
|
|
Ale_AlertType_t AlertType;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_TYPE_NAME];
|
|
|
|
/***** Get parameters from form *****/
|
|
/* Get the code of the group type */
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypCod = ParCod_GetAndCheckPar (ParCod_GrpTyp);
|
|
|
|
/* Get the new name for the group type */
|
|
Par_GetParText ("GrpTypName",NewNameGrpTyp,Grp_MAX_BYTES_GROUP_TYPE_NAME);
|
|
|
|
/***** Get from the database the old name of the group type *****/
|
|
Grp_GetGroupTypeDataByCod (&Gbl.Crs.Grps.GrpTyp);
|
|
|
|
/***** Check if new name is empty *****/
|
|
if (NewNameGrpTyp[0])
|
|
{
|
|
/***** Check if old and new names are the same
|
|
(this happens when return is pressed without changes) *****/
|
|
if (strcmp (Gbl.Crs.Grps.GrpTyp.GrpTypName,NewNameGrpTyp)) // Different names
|
|
{
|
|
/***** If group type was in database... *****/
|
|
if (Grp_DB_CheckIfGrpTypNameExistsInCurrentCrs (NewNameGrpTyp,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypCod))
|
|
{
|
|
AlertType = Ale_WARNING;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_type_of_group_X_already_exists,NewNameGrpTyp);
|
|
}
|
|
else
|
|
{
|
|
/***** Update the table changing old name by new name *****/
|
|
Grp_DB_RenameGrpTyp (Gbl.Crs.Grps.GrpTyp.GrpTypCod,NewNameGrpTyp);
|
|
|
|
/***** Write message to show the change made *****/
|
|
AlertType = Ale_SUCCESS;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_type_of_group_X_has_been_renamed_as_Y,
|
|
Gbl.Crs.Grps.GrpTyp.GrpTypName,NewNameGrpTyp);
|
|
}
|
|
}
|
|
else // The same name
|
|
{
|
|
AlertType = Ale_INFO;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_name_X_has_not_changed,NewNameGrpTyp);
|
|
}
|
|
}
|
|
else
|
|
{
|
|
AlertType = Ale_WARNING;
|
|
Str_Copy (AlertTxt,Txt_You_can_not_leave_the_field_empty,
|
|
sizeof (AlertTxt) - 1);
|
|
}
|
|
|
|
/***** Show the form again *****/
|
|
Str_Copy (Gbl.Crs.Grps.GrpTyp.GrpTypName,NewNameGrpTyp,
|
|
sizeof (Gbl.Crs.Grps.GrpTyp.GrpTypName) - 1);
|
|
Grp_ReqEditGroupsInternal (AlertType,AlertTxt,
|
|
Ale_INFO,NULL);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/******************************* Rename a group ******************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_RenameGroup (void)
|
|
{
|
|
extern const char *Txt_You_can_not_leave_the_field_empty;
|
|
extern const char *Txt_The_group_X_already_exists;
|
|
extern const char *Txt_The_group_X_has_been_renamed_as_Y;
|
|
extern const char *Txt_The_name_X_has_not_changed;
|
|
struct GroupData GrpDat;
|
|
char NewNameGrp[Grp_MAX_BYTES_GROUP_NAME + 1];
|
|
Ale_AlertType_t AlertType;
|
|
char AlertTxt[256 + Grp_MAX_BYTES_GROUP_NAME];
|
|
|
|
/***** Get parameters from form *****/
|
|
/* Get the code of the group */
|
|
Gbl.Crs.Grps.GrpCod = ParCod_GetAndCheckPar (ParCod_Grp);
|
|
|
|
/* Get the new name for the group */
|
|
Par_GetParText ("GrpName",NewNameGrp,Grp_MAX_BYTES_GROUP_NAME);
|
|
|
|
/***** Get from the database the type and the old name of the group *****/
|
|
GrpDat.GrpCod = Gbl.Crs.Grps.GrpCod;
|
|
Grp_GetGroupDataByCod (&GrpDat);
|
|
|
|
/***** Check if new name is empty *****/
|
|
if (!NewNameGrp[0])
|
|
{
|
|
AlertType = Ale_WARNING;
|
|
Str_Copy (AlertTxt,Txt_You_can_not_leave_the_field_empty,
|
|
sizeof (AlertTxt) - 1);
|
|
}
|
|
else
|
|
{
|
|
/***** Check if old and new names are the same
|
|
(this happens when return is pressed without changes) *****/
|
|
if (strcmp (GrpDat.GrpName,NewNameGrp)) // Different names
|
|
{
|
|
/***** If group was in database... *****/
|
|
if (Grp_DB_CheckIfGrpNameExistsForGrpTyp (GrpDat.GrpTypCod,NewNameGrp,
|
|
Gbl.Crs.Grps.GrpCod))
|
|
{
|
|
AlertType = Ale_WARNING;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_group_X_already_exists,NewNameGrp);
|
|
}
|
|
else
|
|
{
|
|
/***** Update the table changing old name by new name *****/
|
|
Grp_DB_RenameGrp (Gbl.Crs.Grps.GrpCod,NewNameGrp);
|
|
|
|
/***** Write message to show the change made *****/
|
|
AlertType = Ale_SUCCESS;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_group_X_has_been_renamed_as_Y,
|
|
GrpDat.GrpName,NewNameGrp);
|
|
}
|
|
}
|
|
else // The same name
|
|
{
|
|
AlertType = Ale_INFO;
|
|
snprintf (AlertTxt,sizeof (AlertTxt),
|
|
Txt_The_name_X_has_not_changed,NewNameGrp);
|
|
}
|
|
}
|
|
|
|
/***** Show the form again *****/
|
|
Str_Copy (Gbl.Crs.Grps.GrpName,NewNameGrp,sizeof (Gbl.Crs.Grps.GrpName) - 1);
|
|
Grp_ReqEditGroupsInternal (Ale_INFO,NULL,
|
|
AlertType,AlertTxt);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/****************** Write parameter with code of group type ******************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_PutParGrpTypCod (void *GrpTypCod)
|
|
{
|
|
if (GrpTypCod)
|
|
ParCod_PutPar (ParCod_GrpTyp,*((long *) GrpTypCod));
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********************* Write parameter with code of group ********************/
|
|
/*****************************************************************************/
|
|
|
|
static void Grp_PutParGrpCod (void *GrpCod)
|
|
{
|
|
if (GrpCod)
|
|
ParCod_PutPar (ParCod_Grp,*((long *) GrpCod));
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************ Get list of group codes selected *******************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_GetLstCodsGrpWanted (struct ListCodGrps *LstGrpsWanted)
|
|
{
|
|
unsigned NumGrpTyp;
|
|
char Par[6 + Cns_MAX_DIGITS_LONG + 1];
|
|
char LongStr[1 + Cns_MAX_DIGITS_LONG + 1];
|
|
char **LstStrCodGrps;
|
|
const char *Ptr;
|
|
unsigned NumGrpWanted;
|
|
|
|
/***** Allocate memory for the strings with group codes in each type *****/
|
|
if ((LstStrCodGrps = calloc (Gbl.Crs.Grps.GrpTypes.NumGrpTypes,
|
|
sizeof (*LstStrCodGrps))) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
|
|
/***** Get lists with the groups that I want in each type
|
|
in order to count the total number of groups selected *****/
|
|
for (NumGrpTyp = 0, LstGrpsWanted->NumGrps = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
/***** Allocate memory for the list of group codes of this type *****/
|
|
if ((LstStrCodGrps[NumGrpTyp] = malloc (Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps *
|
|
(Cns_MAX_DIGITS_LONG + 1))) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
|
|
/***** Get the multiple parameter code of group of this type *****/
|
|
snprintf (Par,sizeof (Par),"GrpCod%ld",
|
|
Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].GrpTypCod);
|
|
Par_GetParMultiToText (Par,LstStrCodGrps[NumGrpTyp],
|
|
((Cns_MAX_DIGITS_LONG + 1) * Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps) - 1);
|
|
if (LstStrCodGrps[NumGrpTyp][0])
|
|
{
|
|
/***** Count the number of groups selected of this type of LstCodGrps[NumGrpTyp] *****/
|
|
for (Ptr = LstStrCodGrps[NumGrpTyp], NumGrpWanted = 0;
|
|
*Ptr;
|
|
NumGrpWanted++)
|
|
Par_GetNextStrUntilSeparParMult (&Ptr,LongStr,Cns_MAX_DIGITS_LONG);
|
|
|
|
/***** Add the number of groups selected of this type to the number of groups selected total *****/
|
|
LstGrpsWanted->NumGrps += NumGrpWanted;
|
|
}
|
|
}
|
|
|
|
/***** Create the list (argument passed to this function)
|
|
with all groups selected (of all the types) *****/
|
|
if (LstGrpsWanted->NumGrps)
|
|
{
|
|
if ((LstGrpsWanted->GrpCods = calloc (LstGrpsWanted->NumGrps,
|
|
sizeof (*LstGrpsWanted->GrpCods))) == NULL)
|
|
Err_NotEnoughMemoryExit ();
|
|
|
|
/***** Get the groups *****/
|
|
for (NumGrpTyp = 0, NumGrpWanted = 0;
|
|
NumGrpTyp < Gbl.Crs.Grps.GrpTypes.NumGrpTypes;
|
|
NumGrpTyp++)
|
|
{
|
|
/* Open groups of this type selected by user */
|
|
for (Ptr = LstStrCodGrps[NumGrpTyp];
|
|
*Ptr;
|
|
NumGrpWanted++)
|
|
{
|
|
Par_GetNextStrUntilSeparParMult (&Ptr,LongStr,Cns_MAX_DIGITS_LONG);
|
|
LstGrpsWanted->GrpCods[NumGrpWanted] = Str_ConvertStrCodToLongCod (LongStr);
|
|
}
|
|
|
|
/* Free memory used by the list of group codes of this type */
|
|
free (LstStrCodGrps[NumGrpTyp]);
|
|
}
|
|
}
|
|
|
|
/***** Free memory used by the lists of group codes of each type *****/
|
|
free (LstStrCodGrps);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************** Free list of group codes *************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_FreeListCodGrp (struct ListCodGrps *LstGrps)
|
|
{
|
|
if (LstGrps->NumGrps && LstGrps->GrpCods)
|
|
free (LstGrps->GrpCods);
|
|
LstGrps->GrpCods = NULL;
|
|
LstGrps->NumGrps = 0;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*********** Put parameter that indicates all groups selected ****************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_PutParAllGroups (void)
|
|
{
|
|
Par_PutParChar ("AllGroups",'Y');
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************* Parameter to show only my groups or all groups ****************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_PutParWhichGroups (void *WhichGrps)
|
|
{
|
|
if (WhichGrps)
|
|
Par_PutParUnsigned (NULL,"WhichGrps",
|
|
(unsigned) *((Grp_WhichGroups_t *) WhichGrps));
|
|
}
|
|
|
|
void Grp_PutParWhichGrpsOnlyMyGrps (void)
|
|
{
|
|
Par_PutParUnsigned (NULL,"WhichGrps",(unsigned) Grp_MY_GROUPS);
|
|
}
|
|
|
|
void Grp_PutParWhichGrpsAllGrps (void)
|
|
{
|
|
Par_PutParUnsigned (NULL,"WhichGrps",(unsigned) Grp_ALL_GROUPS);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/***** Show form to choice whether to show only my groups or all groups ******/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_ShowFormToSelWhichGrps (Act_Action_t Action,
|
|
void (*FuncPars) (void *Args),void *Args)
|
|
{
|
|
extern const char *Txt_GROUP_WHICH_GROUPS[2];
|
|
Grp_WhichGroups_t WhichGrps;
|
|
|
|
Set_BeginOneSettingSelector ();
|
|
for (WhichGrps = Grp_MY_GROUPS;
|
|
WhichGrps <= Grp_ALL_GROUPS;
|
|
WhichGrps++)
|
|
{
|
|
Set_BeginPref (WhichGrps == Gbl.Crs.Grps.WhichGrps);
|
|
Frm_BeginForm (Action);
|
|
Par_PutParUnsigned (NULL,"WhichGrps",(unsigned) WhichGrps);
|
|
if (FuncPars) // Extra parameters depending on the action
|
|
FuncPars (Args);
|
|
Ico_PutSettingIconLink (WhichGrps == Grp_MY_GROUPS ? "mysitemap.png" :
|
|
"sitemap.svg",
|
|
Ico_BLACK,Txt_GROUP_WHICH_GROUPS[WhichGrps]);
|
|
Frm_EndForm ();
|
|
Set_EndPref ();
|
|
}
|
|
Set_EndOneSettingSelector ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************* Get whether to show only my groups or all groups **************/
|
|
/*****************************************************************************/
|
|
|
|
Grp_WhichGroups_t Grp_GetParWhichGroups (void)
|
|
{
|
|
static bool AlreadyGot = false;
|
|
Grp_WhichGroups_t WhichGroupsDefault;
|
|
|
|
if (!AlreadyGot)
|
|
{
|
|
/***** Get which groups (my groups or all groups) *****/
|
|
/* Set default */
|
|
switch (Gbl.Action.Act)
|
|
{
|
|
case ActSeeCrsTT: // Show course timetable
|
|
case ActPrnCrsTT: // Print course timetable
|
|
case ActChgCrsTT1stDay:// Change first day of week in course timetable
|
|
case ActSeeAllAsg: // List assignments
|
|
case ActSeeAllExa: // List exams
|
|
case ActSeeAllGam: // List games
|
|
case ActSeeAllAtt: // List attendance
|
|
case ActSeeAllSvy: // List surveys
|
|
/*
|
|
If I belong to this course ==> see only my groups
|
|
If I don't belong to this course ==> see all groups
|
|
*/
|
|
WhichGroupsDefault = (Gbl.Usrs.Me.IBelongToCurrent[Hie_CRS] == Usr_BELONG) ? Grp_MY_GROUPS :
|
|
Grp_ALL_GROUPS;
|
|
break;
|
|
case ActSeeMyTT: // Show my timetable
|
|
case ActPrnMyTT: // Print my timetable
|
|
case ActChgMyTT1stDay: // Change first day of week in my timetable
|
|
/* By default, show only my groups */
|
|
WhichGroupsDefault = Grp_MY_GROUPS;
|
|
break;
|
|
default: // Control never should enter here
|
|
WhichGroupsDefault = Grp_WHICH_GROUPS_DEFAULT;
|
|
break;
|
|
}
|
|
|
|
/* Get parameter */
|
|
Gbl.Crs.Grps.WhichGrps = (Grp_WhichGroups_t)
|
|
Par_GetParUnsignedLong ("WhichGrps",
|
|
0,
|
|
Grp_NUM_WHICH_GROUPS - 1,
|
|
(unsigned long) WhichGroupsDefault);
|
|
|
|
AlreadyGot = true;
|
|
}
|
|
|
|
return Gbl.Crs.Grps.WhichGrps;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************** Remove groups in a course ************************/
|
|
/*****************************************************************************/
|
|
|
|
void Grp_DB_RemoveCrsGrps (long HieCod)
|
|
{
|
|
/***** Remove all users in groups in the course *****/
|
|
Grp_DB_RemoveUsrsFromGrpsOfCrs (HieCod);
|
|
|
|
/***** Remove all groups in the course *****/
|
|
Grp_DB_RemoveGrpsInCrs (HieCod);
|
|
|
|
/***** Remove all group types in the course *****/
|
|
Grp_DB_RemoveGrpTypesInCrs (HieCod);
|
|
}
|