// swad_game.c: games using remote control /* 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-2019 Antonio Caņas Vargas This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see . */ /*****************************************************************************/ /********************************* Headers ***********************************/ /*****************************************************************************/ #define _GNU_SOURCE // For asprintf #include // For PATH_MAX #include // For NULL #include // For asprintf #include // For calloc #include // For string functions #include "swad_alert.h" #include "swad_box.h" #include "swad_database.h" #include "swad_form.h" #include "swad_game.h" #include "swad_global.h" #include "swad_group.h" #include "swad_pagination.h" #include "swad_parameter.h" #include "swad_role.h" #include "swad_setting.h" #include "swad_table.h" #include "swad_test.h" /*****************************************************************************/ /************** External global variables from others modules ****************/ /*****************************************************************************/ extern struct Globals Gbl; /*****************************************************************************/ /***************************** Private constants *****************************/ /*****************************************************************************/ #define Gam_MAX_CHARS_ANSWER (1024 - 1) // 1023 #define Gam_MAX_BYTES_ANSWER ((Gam_MAX_CHARS_ANSWER + 1) * Str_MAX_BYTES_PER_CHAR - 1) // 16383 #define Gam_MAX_BYTES_LIST_ANSWER_TYPES (10 + (Gam_NUM_ANS_TYPES - 1) * (1 + 10)) const char *Gam_StrAnswerTypesDB[Gam_NUM_ANS_TYPES] = { "unique_choice", "multiple_choice", }; #define Gam_MAX_ANSWERS_PER_QUESTION 10 #define Gam_MAX_SELECTED_QUESTIONS 1000 #define Gam_MAX_BYTES_LIST_SELECTED_QUESTIONS (Gam_MAX_SELECTED_QUESTIONS * (1 + 10 + 1)) #define Gam_NEW_MATCH_SECTION_ID "new_match" /*****************************************************************************/ /******************************* Private types *******************************/ /*****************************************************************************/ struct Match { long MchCod; long GamCod; long UsrCod; time_t TimeUTC[2]; char Title[Gam_MAX_BYTES_TITLE + 1]; struct { unsigned QstInd; // 0 means that the game has not started. First question has index 0. long QstCod; time_t QstStartTimeUTC; bool ShowingAnswers; bool Finished; bool BeingPlayed; } Status; }; /*****************************************************************************/ /***************************** Private variables *****************************/ /*****************************************************************************/ long Gam_CurrentGamCod = -1L; // Used as parameter in contextual links long Gam_CurrentMchCod = -1L; // Used as parameter in contextual links unsigned Gam_CurrentQstInd = 0; // Used as parameter in contextual links /*****************************************************************************/ /***************************** Private prototypes ****************************/ /*****************************************************************************/ static void Gam_ListAllGames (void); static bool Gam_CheckIfICanEditGames (void); static void Gam_PutIconsListGames (void); static void Gam_PutIconToCreateNewGame (void); static void Gam_PutButtonToCreateNewGame (void); static void Gam_PutParamsToCreateNewGame (void); static void Gam_ShowOneGame (long GamCod, bool ShowOnlyThisGame, bool ListGameQuestions, bool PutFormNewMatch); static void Gam_WriteAuthor (struct Game *Game); static void Gam_PutFormsToRemEditOneGame (const struct Game *Game, const char *Anchor); static void Gam_PutParams (void); static void Gam_PutParamCurrentMchCod (void); static void Gam_PutHiddenParamOrder (void); static void Gam_GetParamOrder (void); static void Gam_GetGameTxtFromDB (long GamCod,char Txt[Cns_MAX_BYTES_TEXT + 1]); static void Gam_PutParamMatchCod (long MchCod); static long Gam_GetParamMatchCod (void); static bool Gam_CheckIfSimilarGameExists (struct Game *Game); static void Gam_ShowLstGrpsToCreateMatch (void); static void Gam_CreateGame (struct Game *Game,const char *Txt); static void Gam_UpdateGame (struct Game *Game,const char *Txt); static void Gam_CreateGrps (long MchCod); static void Gam_GetAndWriteNamesOfGrpsAssociatedToMatch (struct Match *Match); static bool Gam_CheckIfIPlayThisMatchBasedOnGrps (long GamCod); static unsigned Gam_GetNumQstsGame (long GamCod); static void Gam_PutParamQstInd (unsigned QstInd); static unsigned Gam_GetParamQstInd (void); static void Gam_PutParamAnswer (unsigned AnsInd); static unsigned Gam_GetParamAnswer (void); static unsigned Gam_GetQstIndFromStr (const char *UnsignedStr); static void Gam_RemAnswersOfAQuestion (long GamCod,unsigned QstInd); static long Gam_GetQstCodFromQstInd (long GamCod,unsigned QstInd); static unsigned Gam_GetMaxQuestionIndexInGame (long GamCod); static unsigned Gam_GetFirstQuestionIndexInGame (long GamCod); static unsigned Gam_GetPrevQuestionIndexInGame (long GamCod,unsigned QstInd); static unsigned Gam_GetNextQuestionIndexInGame (long GamCod,unsigned QstInd); static void Gam_ListGameQuestions (struct Game *Game); static void Gam_ListOneOrMoreQuestionsForEdition (long GamCod,unsigned NumQsts, MYSQL_RES *mysql_res); static void Gam_PutIconToAddNewQuestions (void); static void Gam_PutButtonToAddNewQuestions (void); static void Gam_AllocateListSelectedQuestions (void); static void Gam_FreeListsSelectedQuestions (void); static unsigned Gam_CountNumQuestionsInList (void); static unsigned Gam_GetNumUsrsWhoAnswered (long GamCod,unsigned QstInd,unsigned AnsInd); static void Gam_DrawBarNumUsrs (unsigned NumUsrs,unsigned MaxUsrs); static void Gam_PutParamsOneQst (void); static void Gam_ExchangeQuestions (long GamCod, unsigned QstIndTop,unsigned QstIndBottom); static void Gam_ListMatches (struct Game *Game,bool PutFormNewMatch); static void Gam_PutIconToPlayNewMatch (void); static void Gam_ListOneOrMoreMatches (struct Game *Game, unsigned NumMatches, MYSQL_RES *mysql_res); static void Gam_GetMatchDataFromRow (MYSQL_RES *mysql_res, struct Match *Match); static void Gam_PutButtonNewMatch (long GamCod); static void Gam_PutFormNewMatch (struct Game *Game); static long Gam_CreateMatch (long GamCod,char Title[Gam_MAX_BYTES_TITLE + 1]); static void Gam_UpdateMatchBeingPlayed (struct Match *Match); static void Gam_ShowMatchStatusForTch (struct Match *Match); static void Gam_ShowAlertFinishedMatch (void); static void Gam_PlayGameShowQuestionAndAnswers (struct Match *Match); static void Gam_PutBigButton (Act_Action_t NextAction,long MchCod, const char *Icon,const char *Txt); static void Gam_RemoveOldPlayers (void); static void Gam_UpdateMatchAsBeingPlayed (long MchCod); static void Gam_SetMatchAsNotBeingPlayed (long MchCod); static bool Gam_GetIfMatchIsBeingPlayed (long MchCod); static void Gam_RegisterMeAsPlayerInMatch (long MchCod); static void Gam_GetAndShowNumPlayersInMatch (long MchCod); static unsigned Gam_GetNumPlayers (long MchCod); static void Gam_ShowMatchStatusForStd (struct Match *Match); static int Gam_GetQstAnsFromDB (long MchCod,unsigned QstInd); static unsigned Gam_GetNumUsrsWhoHaveAnsweredGame (long GamCod); /*****************************************************************************/ /*************************** List all the games ******************************/ /*****************************************************************************/ void Gam_SeeAllGames (void) { /***** Get parameters *****/ Gam_GetParamOrder (); Grp_GetParamWhichGrps (); Gbl.Games.CurrentPage = Pag_GetParamPagNum (Pag_GAMES); /***** Show all the games *****/ Gam_ListAllGames (); } /*****************************************************************************/ /**************************** Show all the games *****************************/ /*****************************************************************************/ static void Gam_ListAllGames (void) { extern const char *Hlp_ASSESSMENT_Games; extern const char *Txt_Games; extern const char *Txt_GAMES_ORDER_HELP[Gam_NUM_ORDERS]; extern const char *Txt_GAMES_ORDER[Gam_NUM_ORDERS]; extern const char *Txt_No_games; Gam_Order_t Order; struct Pagination Pagination; unsigned NumGame; /***** Get number of groups in current course *****/ if (!Gbl.Crs.Grps.NumGrps) Gbl.Crs.Grps.WhichGrps = Grp_ALL_GROUPS; /***** Get list of games *****/ Gam_GetListGames (); /***** Compute variables related to pagination *****/ Pagination.NumItems = Gbl.Games.Num; Pagination.CurrentPage = (int) Gbl.Games.CurrentPage; Pag_CalculatePagination (&Pagination); Gbl.Games.CurrentPage = (unsigned) Pagination.CurrentPage; /***** Write links to pages *****/ if (Pagination.MoreThanOnePage) Pag_WriteLinksToPagesCentered (Pag_GAMES, 0, &Pagination); /***** Start box *****/ Box_StartBox ("100%",Txt_Games,Gam_PutIconsListGames, Hlp_ASSESSMENT_Games,Box_NOT_CLOSABLE); if (Gbl.Games.Num) { /***** Table head *****/ Tbl_StartTableWideMargin (2); fprintf (Gbl.F.Out,""); if (Gam_CheckIfICanEditGames ()) fprintf (Gbl.F.Out,""); // Column for contextual icons for (Order = (Gam_Order_t) 0; Order <= (Gam_Order_t) (Gam_NUM_ORDERS - 1); Order++) { fprintf (Gbl.F.Out,""); /* Form to change order */ Frm_StartForm (ActSeeAllGam); Pag_PutHiddenParamPagNum (Pag_GAMES,Gbl.Games.CurrentPage); Par_PutHiddenParamUnsigned ("Order",(unsigned) Order); Frm_LinkFormSubmit (Txt_GAMES_ORDER_HELP[Order],"TIT_TBL",NULL); if (Order == Gbl.Games.SelectedOrder) fprintf (Gbl.F.Out,""); fprintf (Gbl.F.Out,"%s",Txt_GAMES_ORDER[Order]); if (Order == Gbl.Games.SelectedOrder) fprintf (Gbl.F.Out,""); fprintf (Gbl.F.Out,""); Frm_EndForm (); fprintf (Gbl.F.Out,""); } fprintf (Gbl.F.Out,""); /***** Write all the games *****/ for (NumGame = Pagination.FirstItemVisible; NumGame <= Pagination.LastItemVisible; NumGame++) Gam_ShowOneGame (Gbl.Games.LstGamCods[NumGame - 1], false, false, // Do not list game questions false); // Do not put form to start new match /***** End table *****/ Tbl_EndTable (); } else // No games created Ale_ShowAlert (Ale_INFO,Txt_No_games); /***** Button to create a new game *****/ if (Gam_CheckIfICanEditGames ()) Gam_PutButtonToCreateNewGame (); /***** End box *****/ Box_EndBox (); /***** Write again links to pages *****/ if (Pagination.MoreThanOnePage) Pag_WriteLinksToPagesCentered (Pag_GAMES, 0, &Pagination); /***** Free list of games *****/ Gam_FreeListGames (); } /*****************************************************************************/ /******************* Check if I can create a new game **********************/ /*****************************************************************************/ static bool Gam_CheckIfICanEditGames (void) { 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: return true; default: return false; } return false; } /*****************************************************************************/ /***************** Put contextual icons in list of games *******************/ /*****************************************************************************/ static void Gam_PutIconsListGames (void) { /***** Put icon to create a new game *****/ if (Gam_CheckIfICanEditGames ()) Gam_PutIconToCreateNewGame (); /***** Put icon to show a figure *****/ Gbl.Figures.FigureType = Fig_GAMES; Fig_PutIconToShowFigure (); } /*****************************************************************************/ /********************** Put icon to create a new game **********************/ /*****************************************************************************/ static void Gam_PutIconToCreateNewGame (void) { extern const char *Txt_New_game; Ico_PutContextualIconToAdd (ActFrmNewGam,NULL,Gam_PutParamsToCreateNewGame, Txt_New_game); } /*****************************************************************************/ /********************* Put button to create a new game *********************/ /*****************************************************************************/ static void Gam_PutButtonToCreateNewGame (void) { extern const char *Txt_New_game; Frm_StartForm (ActFrmNewGam); Gam_PutParamsToCreateNewGame (); Btn_PutConfirmButton (Txt_New_game); Frm_EndForm (); } /*****************************************************************************/ /******************* Put parameters to create a new game *******************/ /*****************************************************************************/ static void Gam_PutParamsToCreateNewGame (void) { Gam_PutHiddenParamGameOrder (); Pag_PutHiddenParamPagNum (Pag_GAMES,Gbl.Games.CurrentPage); } /*****************************************************************************/ /****************************** Show one game ******************************/ /*****************************************************************************/ void Gam_SeeOneGame (void) { struct Game Game; /***** Get parameters *****/ Gam_GetParamOrder (); Grp_GetParamWhichGrps (); Gbl.Games.CurrentPage = Pag_GetParamPagNum (Pag_GAMES); /***** Get game code *****/ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /***** Show game *****/ Gam_ShowOneGame (Game.GamCod, true, // Show only this game false, // Do not list game questions false); // Do not put form to start new match } /*****************************************************************************/ /******************************* Show one game *******************************/ /*****************************************************************************/ static void Gam_ShowOneGame (long GamCod, bool ShowOnlyThisGame, bool ListGameQuestions, bool PutFormNewMatch) { extern const char *Hlp_ASSESSMENT_Games; extern const char *Txt_Game; extern const char *Txt_Today; extern const char *Txt_View_game; extern const char *Txt_No_of_questions; extern const char *Txt_No_of_users; extern const char *Txt_New_match; char *Anchor = NULL; static unsigned UniqueId = 0; struct Game Game; char Txt[Cns_MAX_BYTES_TEXT + 1]; /***** Start box *****/ if (ShowOnlyThisGame) Box_StartBox (NULL,Txt_Game,NULL, Hlp_ASSESSMENT_Games,Box_NOT_CLOSABLE); /***** Get data of this game *****/ Game.GamCod = GamCod; Gam_GetDataOfGameByCod (&Game); Gam_CurrentGamCod = Game.GamCod; // Used as parameter in contextual links /***** Set anchor string *****/ Frm_SetAnchorStr (Game.GamCod,&Anchor); /***** Start table *****/ if (ShowOnlyThisGame) Tbl_StartTableWide (2); /***** Start first row of this game *****/ fprintf (Gbl.F.Out,""); /***** Icons related to this game *****/ if (Game.Status.ICanEdit) { fprintf (Gbl.F.Out,""); /* Icons to remove/edit this game */ Gam_PutFormsToRemEditOneGame (&Game,Anchor); if (ShowOnlyThisGame) /* Icon to start a new match */ Lay_PutContextualLinkOnlyIcon (ActReqNewMchTch,Gam_NEW_MATCH_SECTION_ID, Gam_PutParams, "play.svg", Txt_New_match); fprintf (Gbl.F.Out,""); } /***** Start date/time *****/ UniqueId++; fprintf (Gbl.F.Out,""); if (Game.TimeUTC[Gam_START_TIME]) fprintf (Gbl.F.Out,"", UniqueId,Game.TimeUTC[Gam_START_TIME], (unsigned) Gbl.Prefs.DateFormat,Txt_Today); fprintf (Gbl.F.Out,""); /***** End date/time *****/ fprintf (Gbl.F.Out,""); if (Game.TimeUTC[Gam_END_TIME]) fprintf (Gbl.F.Out,"", UniqueId,Game.TimeUTC[Gam_END_TIME], (unsigned) Gbl.Prefs.DateFormat,Txt_Today); fprintf (Gbl.F.Out,""); /***** Game title and main data *****/ fprintf (Gbl.F.Out,""); /* Game title */ Lay_StartArticle (Anchor); Frm_StartForm (ActSeeGam); Gam_PutParamGameCod (GamCod); Frm_LinkFormSubmit (Txt_View_game, Game.Status.Visible ? "ASG_TITLE" : "ASG_TITLE_LIGHT",NULL); fprintf (Gbl.F.Out,"%s", Game.Title); Frm_EndForm (); Lay_EndArticle (); /* Number of questions and number of distinct students who have already answered */ fprintf (Gbl.F.Out,"
%s: %u; %s: %u
", Game.Status.Visible ? "ASG_GRP" : "ASG_GRP_LIGHT", Txt_No_of_questions, Game.NumQsts, Txt_No_of_users, Game.NumUsrs); fprintf (Gbl.F.Out,""); /***** End 1st row of this game *****/ fprintf (Gbl.F.Out,""); /***** Start 2nd row of this game *****/ fprintf (Gbl.F.Out,""); /***** Author of the game *****/ fprintf (Gbl.F.Out,""); Gam_WriteAuthor (&Game); fprintf (Gbl.F.Out,""); /***** Text of the game *****/ fprintf (Gbl.F.Out,""); Gam_GetGameTxtFromDB (Game.GamCod,Txt); Str_ChangeFormat (Str_FROM_HTML,Str_TO_RIGOROUS_HTML, Txt,Cns_MAX_BYTES_TEXT,false); // Convert from HTML to rigorous HTML Str_InsertLinks (Txt,Cns_MAX_BYTES_TEXT,60); // Insert links fprintf (Gbl.F.Out,"
%s
" "", Game.Status.Visible ? "DAT" : "DAT_LIGHT", Txt); /***** End 2nd row of this game *****/ fprintf (Gbl.F.Out,""); /***** End table *****/ if (ShowOnlyThisGame) Tbl_EndTable (); else Gbl.RowEvenOdd = 1 - Gbl.RowEvenOdd; /***** Free anchor string *****/ Frm_FreeAnchorStr (Anchor); if (ShowOnlyThisGame) { /***** List matches *****/ Gam_ListMatches (&Game,PutFormNewMatch); /***** Write questions of this game *****/ if (ListGameQuestions) Gam_ListGameQuestions (&Game); /***** End box *****/ Box_EndBox (); } } /*****************************************************************************/ /*********************** Write the author of a game ************************/ /*****************************************************************************/ static void Gam_WriteAuthor (struct Game *Game) { Usr_WriteAuthor1Line (Game->UsrCod,!Game->Status.Visible); } /*****************************************************************************/ /****** Put a hidden parameter with the type of order in list of games *******/ /*****************************************************************************/ void Gam_PutHiddenParamGameOrder (void) { Par_PutHiddenParamUnsigned ("Order",(unsigned) Gbl.Games.SelectedOrder); } /*****************************************************************************/ /******************** Put a link (form) to edit one game *********************/ /*****************************************************************************/ static void Gam_PutFormsToRemEditOneGame (const struct Game *Game, const char *Anchor) { extern const char *Txt_Reset; /***** Put icon to remove game *****/ Ico_PutContextualIconToRemove (ActReqRemGam,Gam_PutParams); /***** Put icon to reset game *****/ Lay_PutContextualLinkOnlyIcon (ActReqRstGam,NULL,Gam_PutParams, "recycle.svg", Txt_Reset); /***** Put icon to hide/show game *****/ if (Game->Status.Visible) Ico_PutContextualIconToHide (ActHidGam,Anchor,Gam_PutParams); else Ico_PutContextualIconToUnhide (ActShoGam,Anchor,Gam_PutParams); /***** Put icon to edit game *****/ Ico_PutContextualIconToEdit (ActEdiOneGam,Gam_PutParams); } /*****************************************************************************/ /******************** Params used to edit/play a game ************************/ /*****************************************************************************/ static void Gam_PutParams (void) { if (Gam_CurrentGamCod > 0) Gam_PutParamGameCod (Gam_CurrentGamCod); Gam_PutHiddenParamOrder (); Pag_PutHiddenParamPagNum (Pag_GAMES,Gbl.Games.CurrentPage); } static void Gam_PutParamCurrentMchCod (void) { if (Gam_CurrentMchCod > 0) Gam_PutParamMatchCod (Gam_CurrentMchCod); } /*****************************************************************************/ /****** Put a hidden parameter with the type of order in list of games *******/ /*****************************************************************************/ static void Gam_PutHiddenParamOrder (void) { Par_PutHiddenParamUnsigned ("Order",(unsigned) Gbl.Games.SelectedOrder); } /*****************************************************************************/ /********** Get parameter with the type or order in list of games ************/ /*****************************************************************************/ static void Gam_GetParamOrder (void) { Gbl.Games.SelectedOrder = (Gam_Order_t) Par_GetParToUnsignedLong ("Order", 0, Gam_NUM_ORDERS - 1, (unsigned long) Gam_ORDER_DEFAULT); } /*****************************************************************************/ /*********************** Get list of all the games *************************/ /*****************************************************************************/ void Gam_GetListGames (void) { static const char *OrderBySubQuery[Gam_NUM_ORDERS] = { "StartTime DESC,EndTime DESC,games.Title DESC", // Gam_ORDER_BY_START_DATE "EndTime DESC,StartTime DESC,games.Title DESC", // Gam_ORDER_BY_END_DATE "games.Title DESC", // Gam_ORDER_BY_TITLE }; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned long NumRows = 0; // Initialized to avoid warning unsigned NumGame; /***** Free list of games *****/ if (Gbl.Games.LstIsRead) Gam_FreeListGames (); /***** Get list of games from database *****/ NumRows = DB_QuerySELECT (&mysql_res,"can not get games", "SELECT games.GamCod," "MIN(gam_matches.StartTime) AS StartTime," "MAX(gam_matches.EndTime) AS EndTime" " FROM games" " LEFT JOIN gam_matches" " ON games.GamCod=gam_matches.GamCod" " WHERE games.CrsCod=%ld" " GROUP BY games.GamCod" " ORDER BY %s", Gbl.Hierarchy.Crs.CrsCod, OrderBySubQuery[Gbl.Games.SelectedOrder]); if (NumRows) // Games found... { Gbl.Games.Num = (unsigned) NumRows; /***** Create list of games *****/ if ((Gbl.Games.LstGamCods = (long *) calloc (NumRows,sizeof (long))) == NULL) Lay_NotEnoughMemoryExit (); /***** Get the games codes *****/ for (NumGame = 0; NumGame < Gbl.Games.Num; NumGame++) { /* Get next game code */ row = mysql_fetch_row (mysql_res); if ((Gbl.Games.LstGamCods[NumGame] = Str_ConvertStrCodToLongCod (row[0])) <= 0) Lay_ShowErrorAndExit ("Error: wrong game code."); } } else Gbl.Games.Num = 0; /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); Gbl.Games.LstIsRead = true; } /*****************************************************************************/ /********************** Get game data using its code *************************/ /*****************************************************************************/ void Gam_GetDataOfGameByCod (struct Game *Game) { MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned long NumRows; /***** Get data of game from database *****/ NumRows = DB_QuerySELECT (&mysql_res,"can not get game data", "SELECT games.GamCod," // row[0] "games.Hidden," // row[1] "games.UsrCod," // row[2] "games.Title" // row[3] " FROM games" " LEFT JOIN gam_matches" " ON games.GamCod=gam_matches.GamCod" " WHERE games.GamCod=%ld", Game->GamCod); if (NumRows) // Game found... { /* Get row */ row = mysql_fetch_row (mysql_res); /* Get code of the game (row[0]) */ Game->GamCod = Str_ConvertStrCodToLongCod (row[0]); /* Get whether the game is hidden (row[1]) */ Game->Status.Visible = (row[1][0] == 'N'); /* Get author of the game (row[2]) */ Game->UsrCod = Str_ConvertStrCodToLongCod (row[2]); /* Get the title of the game (row[3]) */ Str_Copy (Game->Title,row[3], Gam_MAX_BYTES_TITLE); /* Get number of questions and number of users who have already answer this game */ Game->NumQsts = Gam_GetNumQstsGame (Game->GamCod); Game->NumUsrs = Gam_GetNumUsrsWhoHaveAnsweredGame (Game->GamCod); /* Can I view results of the game? Can I edit game? */ switch (Gbl.Usrs.Me.Role.Logged) { case Rol_STD: Game->Status.ICanViewResults = Game->NumQsts != 0 && Game->Status.Visible && Game->Status.Open; Game->Status.ICanEdit = false; break; case Rol_NET: Game->Status.ICanViewResults = Game->NumQsts != 0; Game->Status.ICanEdit = false; break; case Rol_TCH: case Rol_DEG_ADM: case Rol_CTR_ADM: case Rol_INS_ADM: Game->Status.ICanViewResults = Game->NumQsts != 0; Game->Status.ICanEdit = true; break; case Rol_SYS_ADM: Game->Status.ICanViewResults = Game->NumQsts != 0; Game->Status.ICanEdit = true; break; default: Game->Status.ICanViewResults = false; Game->Status.ICanEdit = false; break; } } else { /* Initialize to empty game */ Game->GamCod = -1L; Game->UsrCod = -1L; Game->Title[0] = '\0'; Game->NumQsts = 0; Game->NumUsrs = 0; Game->Status.Visible = true; Game->Status.ICanViewResults = false; Game->Status.ICanEdit = false; } /* Free structure that stores the query result */ DB_FreeMySQLResult (&mysql_res); if (Game->GamCod > 0) { /***** Get start and end times from database *****/ NumRows = DB_QuerySELECT (&mysql_res,"can not get game data", "SELECT UNIX_TIMESTAMP(MIN(StartTime))," // row[0] "UNIX_TIMESTAMP(MAX(EndTime))" // row[1] " FROM gam_matches" " WHERE GamCod=%ld", Game->GamCod); if (NumRows) { /* Get row */ row = mysql_fetch_row (mysql_res); /* Get start date (row[0] holds the start UTC time) */ Game->TimeUTC[Gam_START_TIME] = Dat_GetUNIXTimeFromStr (row[0]); /* Get end date (row[1] holds the end UTC time) */ Game->TimeUTC[Gam_END_TIME ] = Dat_GetUNIXTimeFromStr (row[1]); } /* Free structure that stores the query result */ DB_FreeMySQLResult (&mysql_res); /***** Get whether the game is open or closed *****/ Game->Status.Open = DB_QueryCOUNT ("can not get game data", "SELECT COUNT(*) FROM gam_matches" " WHERE GamCod=%ld" " AND Finished='N'", // Matches not finished Game->GamCod); } else { Game->TimeUTC[Gam_START_TIME] = Game->TimeUTC[Gam_END_TIME ] = (time_t) 0; Game->Status.Open = false; } } /*****************************************************************************/ /***************************** Free list of games ****************************/ /*****************************************************************************/ void Gam_FreeListGames (void) { if (Gbl.Games.LstIsRead && Gbl.Games.LstGamCods) { /***** Free memory used by the list of games *****/ free ((void *) Gbl.Games.LstGamCods); Gbl.Games.LstGamCods = NULL; Gbl.Games.Num = 0; Gbl.Games.LstIsRead = false; } } /*****************************************************************************/ /********************** Get game text from database ************************/ /*****************************************************************************/ static void Gam_GetGameTxtFromDB (long GamCod,char Txt[Cns_MAX_BYTES_TEXT + 1]) { MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned long NumRows; /***** Get text of game from database *****/ NumRows = DB_QuerySELECT (&mysql_res,"can not get game text", "SELECT Txt FROM games WHERE GamCod=%ld", GamCod); /***** The result of the query must have one row or none *****/ if (NumRows == 1) { /* Get info text */ row = mysql_fetch_row (mysql_res); Str_Copy (Txt,row[0], Cns_MAX_BYTES_TEXT); } else Txt[0] = '\0'; /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); if (NumRows > 1) Lay_ShowErrorAndExit ("Error when getting game text."); } /*****************************************************************************/ /******************** Write parameter with code of game **********************/ /*****************************************************************************/ void Gam_PutParamGameCod (long GamCod) { Par_PutHiddenParamLong ("GamCod",GamCod); } /*****************************************************************************/ /********************* Get parameter with code of game ***********************/ /*****************************************************************************/ long Gam_GetParamGameCod (void) { /***** Get code of game *****/ return Par_GetParToLong ("GamCod"); } /*****************************************************************************/ /******************** Write parameter with code of match **********************/ /*****************************************************************************/ static void Gam_PutParamMatchCod (long MchCod) { Par_PutHiddenParamLong ("MchCod",MchCod); } /*****************************************************************************/ /********************* Get parameter with code of match **********************/ /*****************************************************************************/ static long Gam_GetParamMatchCod (void) { /***** Get code of match *****/ return Par_GetParToLong ("MchCod"); } /*****************************************************************************/ /*************** Ask for confirmation of removing of a game ******************/ /*****************************************************************************/ void Gam_AskRemGame (void) { extern const char *Txt_Do_you_really_want_to_remove_the_game_X; extern const char *Txt_Remove_game; struct Game Game; /***** Get parameters *****/ Gam_GetParamOrder (); Grp_GetParamWhichGrps (); Gbl.Games.CurrentPage = Pag_GetParamPagNum (Pag_GAMES); /***** Get game code *****/ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /***** Get data of the game from database *****/ Gam_GetDataOfGameByCod (&Game); if (!Game.Status.ICanEdit) Lay_ShowErrorAndExit ("You can not remove this game."); /***** Show question and button to remove game *****/ Gam_CurrentGamCod = Game.GamCod; Ale_ShowAlertAndButton (ActRemGam,NULL,NULL,Gam_PutParams, Btn_REMOVE_BUTTON,Txt_Remove_game, Ale_QUESTION,Txt_Do_you_really_want_to_remove_the_game_X, Game.Title); /***** Show games again *****/ Gam_ListAllGames (); } /*****************************************************************************/ /******************************* Remove a game *******************************/ /*****************************************************************************/ void Gam_RemoveGame (void) { extern const char *Txt_Game_X_removed; struct Game Game; /***** Get game code *****/ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /***** Get data of the game from database *****/ Gam_GetDataOfGameByCod (&Game); if (!Game.Status.ICanEdit) Lay_ShowErrorAndExit ("You can not remove this game."); /***** Remove all the users in this game *****/ DB_QueryDELETE ("can not remove users who are answered a game", "DELETE FROM gam_users WHERE GamCod=%ld", Game.GamCod); /***** Remove all the questions in this game *****/ DB_QueryDELETE ("can not remove questions of a game", "DELETE FROM gam_questions WHERE GamCod=%ld", Game.GamCod); /***** Remove all the matches in this game *****/ /* Remove groups in matches of the game */ DB_QueryDELETE ("can not remove the groups associated to matches of a game", "DELETE FROM gam_grp USING gam_grp,gam_matches" " WHERE gam_matches.GrpCod=%ld" " AND gam_matches.MchCod=gam_grp.MchCod", Game.GamCod); /* Remove matches of the game */ DB_QueryDELETE ("can not remove matches of a game", "DELETE FROM gam_matches WHERE GamCod=%ld", Game.GamCod); /***** Remove game *****/ DB_QueryDELETE ("can not remove game", "DELETE FROM games WHERE GamCod=%ld", Game.GamCod); /***** Write message to show the change made *****/ Ale_ShowAlert (Ale_SUCCESS,Txt_Game_X_removed, Game.Title); /***** Show games again *****/ Gam_ListAllGames (); } /*****************************************************************************/ /***************** Ask for confirmation of reset of a game *****************/ /*****************************************************************************/ void Gam_AskResetGame (void) { extern const char *Txt_Do_you_really_want_to_reset_the_game_X; extern const char *Txt_Reset_game; struct Game Game; /***** Get parameters *****/ Gam_GetParamOrder (); Grp_GetParamWhichGrps (); Gbl.Games.CurrentPage = Pag_GetParamPagNum (Pag_GAMES); /***** Get game code *****/ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /***** Get data of the game from database *****/ Gam_GetDataOfGameByCod (&Game); if (!Game.Status.ICanEdit) Lay_ShowErrorAndExit ("You can not reset this game."); /***** Ask for confirmation of reset *****/ Gam_CurrentGamCod = Game.GamCod; Ale_ShowAlertAndButton (ActRstGam,NULL,NULL, Gam_PutParams, Btn_REMOVE_BUTTON, Txt_Reset_game, Ale_QUESTION,Txt_Do_you_really_want_to_reset_the_game_X, Game.Title); /***** Show games again *****/ Gam_ListAllGames (); } /*****************************************************************************/ /******************************* Reset a game ******************************/ /*****************************************************************************/ void Gam_ResetGame (void) { extern const char *Txt_Game_X_reset; struct Game Game; /***** Get game code *****/ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /***** Get data of the game from database *****/ Gam_GetDataOfGameByCod (&Game); if (!Game.Status.ICanEdit) Lay_ShowErrorAndExit ("You can not reset this game."); /***** Remove all the users in this game *****/ DB_QueryDELETE ("can not remove users who are answered a game", "DELETE FROM gam_users WHERE GamCod=%ld", Game.GamCod); /***** Reset all the answers in this game *****/ DB_QueryUPDATE ("can not reset answers of a game", "UPDATE gam_answers,gam_questions" " SET gam_answers.NumUsrs=0" " WHERE gam_questions.GamCod=%ld" " AND gam_questions.QstCod=gam_answers.QstCod", Game.GamCod); /***** Write message to show the change made *****/ Ale_ShowAlert (Ale_SUCCESS,Txt_Game_X_reset, Game.Title); /***** Show games again *****/ Gam_ListAllGames (); } /*****************************************************************************/ /******************************** Hide a game ******************************/ /*****************************************************************************/ void Gam_HideGame (void) { struct Game Game; /***** Get game code *****/ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /***** Get data of the game from database *****/ Gam_GetDataOfGameByCod (&Game); if (!Game.Status.ICanEdit) Lay_ShowErrorAndExit ("You can not hide this game."); /***** Hide game *****/ DB_QueryUPDATE ("can not hide game", "UPDATE games SET Hidden='Y' WHERE GamCod=%ld", Game.GamCod); /***** Show games again *****/ Gam_ListAllGames (); } /*****************************************************************************/ /******************************** Show a game ******************************/ /*****************************************************************************/ void Gam_UnhideGame (void) { struct Game Game; /***** Get game code *****/ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /***** Get data of the game from database *****/ Gam_GetDataOfGameByCod (&Game); if (!Game.Status.ICanEdit) Lay_ShowErrorAndExit ("You can not unhide this game."); /***** Show game *****/ DB_QueryUPDATE ("can not show game", "UPDATE games SET Hidden='N' WHERE GamCod=%ld", Game.GamCod); /***** Show games again *****/ Gam_ListAllGames (); } /*****************************************************************************/ /******************* Check if the title of a game exists *******************/ /*****************************************************************************/ static bool Gam_CheckIfSimilarGameExists (struct Game *Game) { /***** Get number of games with a field value from database *****/ return (DB_QueryCOUNT ("can not get similar games", "SELECT COUNT(*) FROM games" " WHERE CrsCod=%ld AND Title='%s'" " AND GamCod<>%ld", Gbl.Hierarchy.Crs.CrsCod,Game->Title, Game->GamCod) != 0); } /*****************************************************************************/ /*********************** Put a form to create a new game *********************/ /*****************************************************************************/ void Gam_RequestCreatOrEditGame (void) { extern const char *Hlp_ASSESSMENT_Games_new_game; extern const char *Hlp_ASSESSMENT_Games_edit_game; extern const char *The_ClassFormInBox[The_NUM_THEMES]; extern const char *Txt_New_game; extern const char *Txt_Edit_game; extern const char *Txt_Title; extern const char *Txt_Description; extern const char *Txt_Create_game; extern const char *Txt_Save_changes; struct Game Game; bool ItsANewGame; char Txt[Cns_MAX_BYTES_TEXT + 1]; /***** Get parameters *****/ Gam_GetParamOrder (); Grp_GetParamWhichGrps (); Gbl.Games.CurrentPage = Pag_GetParamPagNum (Pag_GAMES); /***** Get the code of the game *****/ ItsANewGame = ((Game.GamCod = Gam_GetParamGameCod ()) == -1L); /***** Get from the database the data of the game *****/ if (ItsANewGame) { /***** Put link (form) to create new game *****/ if (!Gam_CheckIfICanEditGames ()) Lay_ShowErrorAndExit ("You can not create a new game here."); /* Initialize to empty game */ Game.GamCod = -1L; Game.UsrCod = Gbl.Usrs.Me.UsrDat.UsrCod; Game.TimeUTC[Gam_START_TIME] = (time_t) 0; Game.TimeUTC[Gam_END_TIME ] = (time_t) 0; Game.Title[0] = '\0'; Game.NumQsts = 0; Game.NumUsrs = 0; Game.Status.Visible = true; Game.Status.Open = true; Game.Status.ICanViewResults = false; } else { /* Get data of the game from database */ Gam_GetDataOfGameByCod (&Game); if (!Game.Status.ICanEdit) Lay_ShowErrorAndExit ("You can not update this game."); /* Get text of the game from database */ Gam_GetGameTxtFromDB (Game.GamCod,Txt); } /***** Start form *****/ Gam_CurrentGamCod = Game.GamCod; Frm_StartForm (ItsANewGame ? ActNewGam : ActChgGam); Gam_PutParams (); /***** Start box and table *****/ if (ItsANewGame) Box_StartBoxTable (NULL,Txt_New_game,NULL, Hlp_ASSESSMENT_Games_new_game,Box_NOT_CLOSABLE,2); else Box_StartBoxTable (NULL, Game.Title[0] ? Game.Title : Txt_Edit_game, NULL, Hlp_ASSESSMENT_Games_edit_game,Box_NOT_CLOSABLE,2); /***** Game title *****/ fprintf (Gbl.F.Out,"" "" "" "" "" "" "" "", The_ClassFormInBox[Gbl.Prefs.Theme], Txt_Title, Gam_MAX_CHARS_TITLE,Game.Title); /***** Game text *****/ fprintf (Gbl.F.Out,"" "" "" "" "" "" "" ""); /***** End table, send button and end box *****/ if (ItsANewGame) Box_EndBoxTableWithButton (Btn_CREATE_BUTTON,Txt_Create_game); else Box_EndBoxTableWithButton (Btn_CONFIRM_BUTTON,Txt_Save_changes); /***** End form *****/ Frm_EndForm (); /***** Show questions of the game ready to be edited *****/ if (!ItsANewGame) Gam_ListGameQuestions (&Game); } /*****************************************************************************/ /***************** Show list of groups to create a new match *****************/ /*****************************************************************************/ static void Gam_ShowLstGrpsToCreateMatch (void) { extern const char *The_ClassFormInBox[The_NUM_THEMES]; extern const char *Txt_Groups; extern const char *Txt_The_whole_course; unsigned NumGrpTyp; /***** Get list of groups types and groups in this course *****/ Grp_GetListGrpTypesAndGrpsInThisCrs (Grp_ONLY_GROUP_TYPES_WITH_GROUPS); if (Gbl.Crs.Grps.GrpTypes.Num) { /***** Start box and table *****/ fprintf (Gbl.F.Out,"" "" "%s:" "" "", The_ClassFormInBox[Gbl.Prefs.Theme], Txt_Groups); Box_StartBoxTable ("95%",NULL,NULL, NULL,Box_NOT_CLOSABLE,0); /***** First row: checkbox to select the whole course *****/ fprintf (Gbl.F.Out,"" "" "" "" "", Txt_The_whole_course,Gbl.Hierarchy.Crs.ShrtName); /***** List the groups for each group type *****/ for (NumGrpTyp = 0; NumGrpTyp < Gbl.Crs.Grps.GrpTypes.Num; NumGrpTyp++) if (Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp].NumGrps) Grp_ListGrpsToEditAsgAttSvyMch (&Gbl.Crs.Grps.GrpTypes.LstGrpTypes[NumGrpTyp], -1L, // -1 means "New match" Grp_MATCH); /***** End table and box *****/ Box_EndBoxTable (); fprintf (Gbl.F.Out,"" ""); } /***** Free list of groups types and groups in this course *****/ Grp_FreeListGrpTypesAndGrps (); } /*****************************************************************************/ /********************* Receive form to create a new game *******************/ /*****************************************************************************/ void Gam_RecFormGame (void) { extern const char *Txt_Already_existed_a_game_with_the_title_X; extern const char *Txt_You_must_specify_the_title_of_the_game; struct Game OldGame; struct Game NewGame; bool ItsANewGame; bool NewGameIsCorrect = true; char Txt[Cns_MAX_BYTES_TEXT + 1]; /***** Get the code of the game *****/ ItsANewGame = ((NewGame.GamCod = Gam_GetParamGameCod ()) == -1L); if (!ItsANewGame) { /* Get data of the old (current) game from database */ OldGame.GamCod = NewGame.GamCod; Gam_GetDataOfGameByCod (&OldGame); if (!OldGame.Status.ICanEdit) Lay_ShowErrorAndExit ("You can not update this game."); } /***** Get game title *****/ Par_GetParToText ("Title",NewGame.Title,Gam_MAX_BYTES_TITLE); /***** Get game text and insert links *****/ Par_GetParToHTML ("Txt",Txt,Cns_MAX_BYTES_TEXT); // Store in HTML format (not rigorous) /***** Check if title is correct *****/ if (NewGame.Title[0]) // If there's a game title { /* If title of game was in database... */ if (Gam_CheckIfSimilarGameExists (&NewGame)) { NewGameIsCorrect = false; Ale_ShowAlert (Ale_WARNING,Txt_Already_existed_a_game_with_the_title_X, NewGame.Title); } } else // If there is not a game title { NewGameIsCorrect = false; Ale_ShowAlert (Ale_WARNING,Txt_You_must_specify_the_title_of_the_game); } /***** Create a new game or update an existing one *****/ if (NewGameIsCorrect) { if (ItsANewGame) Gam_CreateGame (&NewGame,Txt); // Add new game to database else Gam_UpdateGame (&NewGame,Txt); } else Gam_RequestCreatOrEditGame (); /***** Show games again *****/ Gam_ListAllGames (); } /*****************************************************************************/ /**************************** Create a new game ******************************/ /*****************************************************************************/ static void Gam_CreateGame (struct Game *Game,const char *Txt) { extern const char *Txt_Created_new_game_X; /***** Create a new game *****/ Game->GamCod = DB_QueryINSERTandReturnCode ("can not create new game", "INSERT INTO games" " (CrsCod,Hidden,UsrCod,Title,Txt)" " VALUES" " (%ld,'N',%ld,'%s','%s')", Gbl.Hierarchy.Crs.CrsCod, Gbl.Usrs.Me.UsrDat.UsrCod, Game->Title, Txt); /***** Write success message *****/ Ale_ShowAlert (Ale_SUCCESS,Txt_Created_new_game_X, Game->Title); } /*****************************************************************************/ /************************* Update an existing game *************************/ /*****************************************************************************/ static void Gam_UpdateGame (struct Game *Game,const char *Txt) { extern const char *Txt_The_game_has_been_modified; /***** Update the data of the game *****/ DB_QueryUPDATE ("can not update game", "UPDATE games" " SET CrsCod=%ld," "Title='%s'," "Txt='%s'" " WHERE GamCod=%ld", Gbl.Hierarchy.Crs.CrsCod, Game->Title, Txt, Game->GamCod); /***** Write success message *****/ Ale_ShowAlert (Ale_SUCCESS,Txt_The_game_has_been_modified); } /*****************************************************************************/ /************* Check if a match is associated to a given group ***************/ /*****************************************************************************/ bool Gam_CheckIfMatchIsAssociatedToGrp (long MchCod,long GrpCod) { /***** Get if a match is associated to a group from database *****/ return (DB_QueryCOUNT ("can not check if a match is associated to a group", "SELECT COUNT(*) FROM gam_grp" " WHERE MchCod=%ld AND GrpCod=%ld", MchCod,GrpCod) != 0); } /*****************************************************************************/ /******************** Remove one group from all the games ********************/ /*****************************************************************************/ // TODO: Check if this function should be called when removing group void Gam_RemoveGroup (long GrpCod) { /***** Remove group from all the games *****/ DB_QueryDELETE ("can not remove group" " from the associations between games and groups", "DELETE FROM gam_grp WHERE GrpCod=%ld", GrpCod); } /*****************************************************************************/ /**************** Remove groups of one type from all the games ***************/ /*****************************************************************************/ // TODO: Check if this function should be called when removing group type void Gam_RemoveGroupsOfType (long GrpTypCod) { /***** Remove group from all the games *****/ DB_QueryDELETE ("can not remove groups of a type" " from the associations between games and groups", "DELETE FROM gam_grp USING crs_grp,gam_grp" " WHERE crs_grp.GrpTypCod=%ld" " AND crs_grp.GrpCod=gam_grp.GrpCod", GrpTypCod); } /*****************************************************************************/ /******************* Create groups associated to a match *********************/ /*****************************************************************************/ static void Gam_CreateGrps (long MchCod) { unsigned NumGrpSel; /***** Create groups associated to the match *****/ for (NumGrpSel = 0; NumGrpSel < Gbl.Crs.Grps.LstGrpsSel.NumGrps; NumGrpSel++) /* Create group */ DB_QueryINSERT ("can not associate a group to a match", "INSERT INTO gam_grp" " (MchCod,GrpCod)" " VALUES" " (%ld,%ld)", MchCod,Gbl.Crs.Grps.LstGrpsSel.GrpCods[NumGrpSel]); } /*****************************************************************************/ /************* Get and write the names of the groups of a match **************/ /*****************************************************************************/ static void Gam_GetAndWriteNamesOfGrpsAssociatedToMatch (struct Match *Match) { extern const char *Txt_Group; extern const char *Txt_Groups; extern const char *Txt_and; extern const char *Txt_The_whole_course; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned long NumRow; unsigned long NumRows; /***** Get groups associated to a match from database *****/ NumRows = DB_QuerySELECT (&mysql_res,"can not get groups of a match", "SELECT crs_grp_types.GrpTypName,crs_grp.GrpName" " FROM gam_grp,crs_grp,crs_grp_types" " WHERE gam_grp.MchCod=%ld" " AND gam_grp.GrpCod=crs_grp.GrpCod" " AND crs_grp.GrpTypCod=crs_grp_types.GrpTypCod" " ORDER BY crs_grp_types.GrpTypName,crs_grp.GrpName", Match->MchCod); /***** Write heading *****/ fprintf (Gbl.F.Out,"
%s: ", NumRows == 1 ? Txt_Group : Txt_Groups); /***** Write groups *****/ if (NumRows) // Groups found... { /* Get and write the group types and names */ for (NumRow = 0; NumRow < NumRows; NumRow++) { /* Get next group */ row = mysql_fetch_row (mysql_res); /* Write group type name and group name */ fprintf (Gbl.F.Out,"%s %s",row[0],row[1]); if (NumRows >= 2) { if (NumRow == NumRows-2) fprintf (Gbl.F.Out," %s ",Txt_and); if (NumRows >= 3) if (NumRow < NumRows-2) fprintf (Gbl.F.Out,", "); } } } else fprintf (Gbl.F.Out,"%s %s", Txt_The_whole_course,Gbl.Hierarchy.Crs.ShrtName); fprintf (Gbl.F.Out,"
"); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); } /*****************************************************************************/ /************* Remove all the games of a place on the hierarchy **************/ /************* (country, institution, centre, degree or course) **************/ /*****************************************************************************/ void Gam_RemoveGames (Hie_Level_t Scope,long Cod) { /***** Remove all the users in course games *****/ DB_QueryDELETE ("can not remove users who had answered games" " in a place on the hierarchy", "DELETE FROM gam_users" " USING games,gam_users" " WHERE games.Scope='%s' AND games.Cod=%ld" " AND games.GamCod=gam_users.GamCod", Sco_GetDBStrFromScope (Scope),Cod); /***** Remove all the answers in course games *****/ DB_QueryDELETE ("can not remove answers of games" " in a place on the hierarchy" "DELETE FROM gam_answers" " USING games,gam_questions,gam_answers" " WHERE games.Scope='%s' AND games.Cod=%ld" " AND games.GamCod=gam_questions.GamCod" " AND gam_questions.QstCod=gam_answers.QstCod", Sco_GetDBStrFromScope (Scope),Cod); /***** Remove all the questions in course games *****/ DB_QueryDELETE ("can not remove questions of games" " in a place on the hierarchy", "DELETE FROM gam_questions" " USING games,gam_questions" " WHERE games.Scope='%s' AND games.Cod=%ld" " AND games.GamCod=gam_questions.GamCod", Sco_GetDBStrFromScope (Scope),Cod); /***** Remove groups *****/ DB_QueryDELETE ("can not remove all the groups" " associated to games of a course", "DELETE FROM gam_grp" " USING games,gam_grp" " WHERE games.Scope='%s' AND games.Cod=%ld" " AND games.GamCod=gam_grp.GamCod", Sco_GetDBStrFromScope (Scope),Cod); /***** Remove course games *****/ DB_QueryDELETE ("can not remove all the games in a place on the hierarchy", "DELETE FROM games WHERE Scope='%s' AND Cod=%ld", Sco_GetDBStrFromScope (Scope),Cod); } /*****************************************************************************/ /************ Check if I belong to any of the groups of a match **************/ /*****************************************************************************/ static bool Gam_CheckIfIPlayThisMatchBasedOnGrps (long MchCod) { /***** Get if I can play a match from database *****/ return (DB_QueryCOUNT ("can not check if I can play a match", "SELECT COUNT(*) FROM gam_matches" " WHERE MchCod=%ld" " AND (MchCod NOT IN (SELECT MchCod FROM gam_grp) OR" " MchCod IN (SELECT gam_grp.MchCod FROM gam_grp,crs_grp_usr" " WHERE crs_grp_usr.UsrCod=%ld" " AND gam_grp.GrpCod=crs_grp_usr.GrpCod))", MchCod,Gbl.Usrs.Me.UsrDat.UsrCod) != 0); } /*****************************************************************************/ /******************* Get number of questions of a game *********************/ /*****************************************************************************/ static unsigned Gam_GetNumQstsGame (long GamCod) { /***** Get data of questions from database *****/ return (unsigned) DB_QueryCOUNT ("can not get number of questions of a game", "SELECT COUNT(*) FROM gam_questions" " WHERE GamCod=%ld", GamCod); } /*****************************************************************************/ /*********** Put a form to edit/create a question in game *****************/ /*****************************************************************************/ void Gam_RequestNewQuestion (void) { struct Game Game; /***** Get game code *****/ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /***** Get other parameters *****/ Gam_GetParamOrder (); Grp_GetParamWhichGrps (); Gbl.Games.CurrentPage = Pag_GetParamPagNum (Pag_GAMES); /***** Show form to create a new question in this game *****/ Tst_ShowFormAskSelectTstsForGame (Game.GamCod); /***** Show current game *****/ Gam_ShowOneGame (Game.GamCod, true, // Show only this game true, // List game questions false); // Do not put form to start new match } /*****************************************************************************/ /****************** Write parameter with index of question *******************/ /*****************************************************************************/ static void Gam_PutParamQstInd (unsigned QstInd) { Par_PutHiddenParamUnsigned ("QstInd",QstInd); } /*****************************************************************************/ /******************* Get parameter with index of question ********************/ /*****************************************************************************/ static unsigned Gam_GetParamQstInd (void) { long LongNum; LongNum = Par_GetParToLong ("QstInd"); if (LongNum < 0) Lay_ShowErrorAndExit ("Wrong question index."); return (unsigned) LongNum; } /*****************************************************************************/ /******************* Write parameter with student's answer *******************/ /*****************************************************************************/ static void Gam_PutParamAnswer (unsigned AnsInd) { Par_PutHiddenParamUnsigned ("Ans",AnsInd); } /*****************************************************************************/ /******************* Get parameter with student's answer *********************/ /*****************************************************************************/ static unsigned Gam_GetParamAnswer (void) { long LongNum; LongNum = Par_GetParToLong ("Ans"); if (LongNum < 0) Lay_ShowErrorAndExit ("Wrong answer index."); return (unsigned) LongNum; } /*****************************************************************************/ /******************* Get parameter with index of question ********************/ /*****************************************************************************/ static unsigned Gam_GetQstIndFromStr (const char *UnsignedStr) { long LongNum; LongNum = Str_ConvertStrCodToLongCod (UnsignedStr); return (LongNum > 0) ? (unsigned) LongNum : 0; } /*****************************************************************************/ /********************** Remove answers of a game question ********************/ /*****************************************************************************/ static void Gam_RemAnswersOfAQuestion (long GamCod,unsigned QstInd) { /***** Remove answers *****/ DB_QueryDELETE ("can not remove the answers of a question", "DELETE FROM gam_answers" " WHERE GamCod=%ld AND QstInd=%u", GamCod,QstInd); } /*****************************************************************************/ /************ Get question code given game and index of question *************/ /*****************************************************************************/ static long Gam_GetQstCodFromQstInd (long GamCod,unsigned QstInd) { MYSQL_RES *mysql_res; MYSQL_ROW row; long QstCod; /***** Get question code of thw question to be moved up *****/ if (!DB_QuerySELECT (&mysql_res,"can not get question code", "SELECT QstCod FROM gam_questions" " WHERE GamCod=%ld AND QstInd=%u", GamCod,QstInd)) Lay_ShowErrorAndExit ("Error: wrong question code."); /***** Get question code (row[0]) *****/ row = mysql_fetch_row (mysql_res); if ((QstCod = Str_ConvertStrCodToLongCod (row[0])) <= 0) Lay_ShowErrorAndExit ("Error: wrong question code."); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return QstCod; } /*****************************************************************************/ /****************** Get maximum question index in a game *********************/ /*****************************************************************************/ // Question index can be 1, 2, 3... // Return 0 if no questions static unsigned Gam_GetMaxQuestionIndexInGame (long GamCod) { MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned QstInd = 0; /***** Get maximum question index in a game from database *****/ DB_QuerySELECT (&mysql_res,"can not get last question index", "SELECT MAX(QstInd) FROM gam_questions WHERE GamCod=%ld", GamCod); row = mysql_fetch_row (mysql_res); if (row[0]) // There are questions if (sscanf (row[0],"%u",&QstInd) != 1) Lay_ShowErrorAndExit ("Error when getting last question index."); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return QstInd; } /*****************************************************************************/ /******************** Get first question index in a game *********************/ /*****************************************************************************/ static unsigned Gam_GetFirstQuestionIndexInGame (long GamCod) { return Gam_GetNextQuestionIndexInGame (GamCod, 0); // First index > 0 } /*****************************************************************************/ /*********** Get previous question index to a given index in a game **********/ /*****************************************************************************/ // Input question index can be 1, 2, 3... n-1 // Return question index will be 1, 2, 3... n if previous question exists, or 0 if no previous question static unsigned Gam_GetPrevQuestionIndexInGame (long GamCod,unsigned QstInd) { MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned PrevQstInd = 0; /***** Get previous question index in a game from database *****/ // Although indexes are always continuous... // ...this implementation works even with non continuous indexes if (!DB_QuerySELECT (&mysql_res,"can not get previous question index", "SELECT MAX(QstInd) FROM gam_questions" " WHERE GamCod=%ld AND QstInd<%u", GamCod,QstInd)) Lay_ShowErrorAndExit ("Error: previous question index not found."); /***** Get previous question index (row[0]) *****/ row = mysql_fetch_row (mysql_res); if (row[0]) if (sscanf (row[0],"%u",&PrevQstInd) != 1) Lay_ShowErrorAndExit ("Error when getting previous question index."); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return PrevQstInd; } /*****************************************************************************/ /************* Get next question index to a given index in a game ************/ /*****************************************************************************/ // Input question index can be 0, 1, 2, 3... n-1 // Return question index will be 1, 2, 3... n if next question exists, or 0 if no next question static unsigned Gam_GetNextQuestionIndexInGame (long GamCod,unsigned QstInd) { MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NextQstInd = 0; /***** Get next question index in a game from database *****/ // Although indexes are always continuous... // ...this implementation works even with non continuous indexes if (!DB_QuerySELECT (&mysql_res,"can not get next question index", "SELECT MIN(QstInd) FROM gam_questions" " WHERE GamCod=%ld AND QstInd>%u", GamCod,QstInd)) Lay_ShowErrorAndExit ("Error: next question index not found."); /***** Get next question index (row[0]) *****/ row = mysql_fetch_row (mysql_res); if (row[0]) if (sscanf (row[0],"%u",&NextQstInd) != 1) Lay_ShowErrorAndExit ("Error when getting next question index."); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return NextQstInd; } /*****************************************************************************/ /************************ List the questions of a game ***********************/ /*****************************************************************************/ static void Gam_ListGameQuestions (struct Game *Game) { extern const char *Hlp_ASSESSMENT_Games_questions; extern const char *Txt_Questions; extern const char *Txt_This_game_has_no_questions; extern const char *Txt_Done; MYSQL_RES *mysql_res; unsigned NumQsts; bool Editing = (Gbl.Action.Act == ActEdiOneGam || Gbl.Action.Act == ActAddOneGamQst); Tst_ActionToDoWithQuestions_t ActionToDoWithQuestions; /***** How to show the questions ******/ if (Editing) ActionToDoWithQuestions = Tst_SHOW_GAME_RESULT; else ActionToDoWithQuestions = Tst_SHOW_GAME_TO_ANSWER; /***** Get data of questions from database *****/ NumQsts = (unsigned) DB_QuerySELECT (&mysql_res,"can not get data of a question", "SELECT gam_questions.QstInd," // row[0] "gam_questions.QstCod," // row[1] "tst_questions.AnsType," // row[2] "tst_questions.Stem," // row[3] "tst_questions.Feedback," // row[4] "tst_questions.MedCod" // row[5] " FROM gam_questions,tst_questions" " WHERE gam_questions.GamCod=%ld" " AND gam_questions.QstCod=tst_questions.QstCod" " ORDER BY gam_questions.QstInd", Game->GamCod); /***** Start box *****/ Gam_CurrentGamCod = Game->GamCod; Box_StartBox (NULL,Txt_Questions,Game->Status.ICanEdit ? Gam_PutIconToAddNewQuestions : NULL, Hlp_ASSESSMENT_Games_questions,Box_NOT_CLOSABLE); if (NumQsts) { /***** Show the table with the questions *****/ Gam_ListOneOrMoreQuestionsForEdition (Game->GamCod,NumQsts,mysql_res); if (ActionToDoWithQuestions == Tst_SHOW_GAME_TO_ANSWER) { /***** Button to create/modify game *****/ Btn_PutConfirmButton (Txt_Done); /***** End form *****/ Frm_EndForm (); } } else // This game has no questions Ale_ShowAlert (Ale_INFO,Txt_This_game_has_no_questions); if (Game->Status.ICanEdit && // I can edit (!NumQsts || // This game has no questions Editing)) // I am editing /***** Put button to add a new question in this game *****/ Gam_PutButtonToAddNewQuestions (); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); /***** End box *****/ Box_EndBox (); } /*****************************************************************************/ /********************* List game questions for edition ***********************/ /*****************************************************************************/ static void Gam_ListOneOrMoreQuestionsForEdition (long GamCod,unsigned NumQsts, MYSQL_RES *mysql_res) { extern const char *Txt_Questions; extern const char *Txt_No_INDEX; extern const char *Txt_Code; extern const char *Txt_Tags; extern const char *Txt_Question; extern const char *Txt_Move_up_X; extern const char *Txt_Move_down_X; extern const char *Txt_Movement_not_allowed; extern const char *Txt_TST_STR_ANSWER_TYPES[Tst_NUM_ANS_TYPES]; unsigned NumQst; MYSQL_ROW row; unsigned QstInd; unsigned MaxQstInd; long QstCod; char StrQstInd[10 + 1]; /***** Get maximum question index *****/ MaxQstInd = Gam_GetMaxQuestionIndexInGame (GamCod); /***** Write the heading *****/ Tbl_StartTableWideMargin (2); fprintf (Gbl.F.Out,"" "" "" "%s" "" "" "%s" "" "" "%s" "" "" "%s" "" "", Txt_No_INDEX, Txt_Code, Txt_Tags, Txt_Question); /***** Write rows *****/ for (NumQst = 0; NumQst < NumQsts; NumQst++) { Gbl.RowEvenOdd = NumQst % 2; row = mysql_fetch_row (mysql_res); /* row[0] QstInd row[1] QstCod row[2] AnsType row[3] Stem row[4] Feedback row[5] MedCod */ /***** Create test question *****/ Tst_QstConstructor (); /* Get question index (row[0]) */ QstInd = Gam_GetQstIndFromStr (row[0]); snprintf (StrQstInd,sizeof (StrQstInd), "%u", QstInd); /* Get question code (row[1]) */ QstCod = Str_ConvertStrCodToLongCod (row[1]); /***** Icons *****/ Gam_CurrentGamCod = GamCod; Gam_CurrentQstInd = QstInd; fprintf (Gbl.F.Out,"" "",Gbl.RowEvenOdd); /* Put icon to remove the question */ Frm_StartForm (ActReqRemGamQst); Gam_PutParamGameCod (GamCod); Gam_PutParamQstInd (QstInd); Ico_PutIconRemove (); Frm_EndForm (); /* Put icon to move up the question */ if (QstInd > 1) { snprintf (Gbl.Title,sizeof (Gbl.Title), Txt_Move_up_X, StrQstInd); Lay_PutContextualLinkOnlyIcon (ActUp_GamQst,NULL,Gam_PutParamsOneQst, "arrow-up.svg", Gbl.Title); } else Ico_PutIconOff ("arrow-up.svg",Txt_Movement_not_allowed); /* Put icon to move down the question */ if (QstInd < MaxQstInd) { snprintf (Gbl.Title,sizeof (Gbl.Title), Txt_Move_down_X, StrQstInd); Lay_PutContextualLinkOnlyIcon (ActDwnGamQst,NULL,Gam_PutParamsOneQst, "arrow-down.svg", Gbl.Title); } else Ico_PutIconOff ("arrow-down.svg",Txt_Movement_not_allowed); /* Put icon to edit the question */ Gbl.Test.QstCod = QstCod; Ico_PutContextualIconToEdit (ActEdiOneTstQst,Tst_PutParamQstCod); fprintf (Gbl.F.Out,""); /* Write number of question */ fprintf (Gbl.F.Out,"" "
%s
", Gbl.RowEvenOdd, StrQstInd); /* Write answer type (row[2]) */ Gbl.Test.AnswerType = Tst_ConvertFromStrAnsTypDBToAnsTyp (row[2]); fprintf (Gbl.F.Out,"
%s
" "", Txt_TST_STR_ANSWER_TYPES[Gbl.Test.AnswerType]); /* Write question code */ fprintf (Gbl.F.Out,"" "%ld " "", Gbl.RowEvenOdd,Gbl.Test.QstCod); /* Write the question tags */ fprintf (Gbl.F.Out,"", Gbl.RowEvenOdd); Tst_GetAndWriteTagsQst (Gbl.Test.QstCod); fprintf (Gbl.F.Out,""); /* Write stem (row[3]) */ fprintf (Gbl.F.Out,"", Gbl.RowEvenOdd); Tst_WriteQstStem (row[3],"TEST_EDI"); /* Get media (row[5]) */ Gbl.Test.Media.MedCod = Str_ConvertStrCodToLongCod (row[5]); Med_GetMediaDataByCod (&Gbl.Test.Media); /* Show media */ Med_ShowMedia (&Gbl.Test.Media, "TEST_MED_EDIT_LIST_STEM_CONTAINER", "TEST_MED_EDIT_LIST_STEM"); /* Show feedback (row[4]) */ Tst_WriteQstFeedback (row[4],"TEST_EDI_LIGHT"); /* Show answers */ Tst_WriteAnswersGameResult (GamCod,QstInd,QstCod, "TEST_EDI",true); // Show result fprintf (Gbl.F.Out,"" ""); /***** Destroy test question *****/ Tst_QstDestructor (); } /***** End table *****/ Tbl_EndTable (); /***** Button to add a new question *****/ Gam_PutButtonToAddNewQuestions (); /***** End box *****/ Box_EndBox (); } /*****************************************************************************/ /***************** Put icon to add a new questions to game *******************/ /*****************************************************************************/ static void Gam_PutIconToAddNewQuestions (void) { extern const char *Txt_Add_questions; /***** Put form to create a new question *****/ Ico_PutContextualIconToAdd (ActAddOneGamQst,NULL,Gam_PutParams, Txt_Add_questions); } /*****************************************************************************/ /***************** Put button to add new questions to game *******************/ /*****************************************************************************/ static void Gam_PutButtonToAddNewQuestions (void) { extern const char *Txt_Add_questions; Frm_StartForm (ActAddOneGamQst); Gam_PutParams (); Btn_PutConfirmButton (Txt_Add_questions); Frm_EndForm (); } /*****************************************************************************/ /******************** Add selected test questions to game ********************/ /*****************************************************************************/ void Gam_AddTstQuestionsToGame (void) { extern const char *Txt_You_must_select_one_ore_more_questions; struct Game Game; const char *Ptr; char LongStr[1 + 10 + 1]; long QstCod; unsigned MaxQstInd; /***** Get game code *****/ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /***** Get selected questions *****/ /* Allocate space for selected question codes */ Gam_AllocateListSelectedQuestions (); /* Get question codes */ Par_GetParMultiToText ("QstCods",Gbl.Games.ListQuestions, Gam_MAX_BYTES_LIST_SELECTED_QUESTIONS); /* Check number of questions */ if (Gam_CountNumQuestionsInList () == 0) // If no questions selected... { // ...write warning alert Ale_ShowAlert (Ale_WARNING,Txt_You_must_select_one_ore_more_questions); // TODO: Show form again!!! } /***** Insert questions in database *****/ Ptr = Gbl.Games.ListQuestions; while (*Ptr) { /* Get next code */ Par_GetNextStrUntilSeparParamMult (&Ptr,LongStr,1 + 10); if (sscanf (LongStr,"%ld",&QstCod) != 1) Lay_ShowErrorAndExit ("Wrong question code."); /* Get current maximum index */ MaxQstInd = Gam_GetMaxQuestionIndexInGame (Game.GamCod); // -1 if no questions /* Insert question in the table of questions */ DB_QueryINSERT ("can not create question", "INSERT INTO gam_questions" " (GamCod,QstCod,QstInd)" " VALUES" " (%ld,%ld,%u)", Game.GamCod,QstCod,MaxQstInd + 1); } /***** Free space for selected question codes *****/ Gam_FreeListsSelectedQuestions (); /***** Show current game *****/ Gam_ShowOneGame (Game.GamCod, true, // Show only this game true, // List game questions false); // Do not put form to start new match } /*****************************************************************************/ /****************** Allocate memory for list of questions ********************/ /*****************************************************************************/ static void Gam_AllocateListSelectedQuestions (void) { if (!Gbl.Games.ListQuestions) { if ((Gbl.Games.ListQuestions = (char *) malloc (Gam_MAX_BYTES_LIST_SELECTED_QUESTIONS + 1)) == NULL) Lay_NotEnoughMemoryExit ();; Gbl.Games.ListQuestions[0] = '\0'; } } /*****************************************************************************/ /*********** Free memory used by list of selected question codes *************/ /*****************************************************************************/ static void Gam_FreeListsSelectedQuestions (void) { if (Gbl.Games.ListQuestions) { free ((void *) Gbl.Games.ListQuestions); Gbl.Games.ListQuestions = NULL; } } /*****************************************************************************/ /**** Count the number of questions in the list of selected question codes ***/ /*****************************************************************************/ static unsigned Gam_CountNumQuestionsInList (void) { const char *Ptr; unsigned NumQuestions = 0; char LongStr[1 + 10 + 1]; long QstCod; /***** Go over the list Gbl.Test.ListAnsTypes counting the number of types of answer *****/ Ptr = Gbl.Games.ListQuestions; while (*Ptr) { Par_GetNextStrUntilSeparParamMult (&Ptr,LongStr,1 + 10); if (sscanf (LongStr,"%ld",&QstCod) != 1) Lay_ShowErrorAndExit ("Wrong question code."); NumQuestions++; } return NumQuestions; } /*****************************************************************************/ /*** Get number of users who selected this answer and draw proportional bar **/ /*****************************************************************************/ void Gam_GetAndDrawBarNumUsrsWhoAnswered (long GamCod,unsigned QstInd,unsigned AnsInd,unsigned NumUsrs) { unsigned NumUsrsThisAnswer; /***** Get number of users who selected this answer *****/ NumUsrsThisAnswer = Gam_GetNumUsrsWhoAnswered (GamCod,QstInd,AnsInd); /***** Show stats of this answer *****/ Gam_DrawBarNumUsrs (NumUsrsThisAnswer,NumUsrs); } /*****************************************************************************/ /**** Get number of users who selected a given answer of a game question *****/ /*****************************************************************************/ static unsigned Gam_GetNumUsrsWhoAnswered (long GamCod,unsigned QstInd,unsigned AnsInd) { MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumUsrs = 0; // Default returned value /***** Get answers of a question from database *****/ if (DB_QuerySELECT (&mysql_res,"can not get number of users who answered", "SELECT NumUsrs FROM gam_answers" " WHERE GamCod=%ld AND QstInd=%u AND AnsInd=%u", GamCod,QstInd,AnsInd)) { row = mysql_fetch_row (mysql_res); if (row[0]) // There are users who selected this answer if (sscanf (row[0],"%u",&NumUsrs) != 1) Lay_ShowErrorAndExit ("Error when getting number of users who answered."); } return NumUsrs; } /*****************************************************************************/ /***************** Draw a bar with the percentage of answers *****************/ /*****************************************************************************/ #define Gam_MAX_BAR_WIDTH 125 static void Gam_DrawBarNumUsrs (unsigned NumUsrs,unsigned MaxUsrs) { extern const char *Txt_of_PART_OF_A_TOTAL; unsigned BarWidth = 0; /***** String with the number of users *****/ if (MaxUsrs) snprintf (Gbl.Title,sizeof (Gbl.Title), "%u (%u%% %s %u)", NumUsrs, (unsigned) ((((float) NumUsrs * 100.0) / (float) MaxUsrs) + 0.5), Txt_of_PART_OF_A_TOTAL,MaxUsrs); else snprintf (Gbl.Title,sizeof (Gbl.Title), "0 (0%% %s %u)", Txt_of_PART_OF_A_TOTAL,MaxUsrs); /***** Draw bar with a with proportional to the number of clicks *****/ if (NumUsrs && MaxUsrs) BarWidth = (unsigned) ((((float) NumUsrs * (float) Gam_MAX_BAR_WIDTH) / (float) MaxUsrs) + 0.5); if (BarWidth < 2) BarWidth = 2; fprintf (Gbl.F.Out,"\"%s\"" " ", Cfg_URL_ICON_PUBLIC, Gbl.Title, Gbl.Title, BarWidth); /***** Write the number of users *****/ fprintf (Gbl.F.Out,"%s",Gbl.Title); } /*****************************************************************************/ /**************** Put parameter to move/remove one question ******************/ /*****************************************************************************/ static void Gam_PutParamsOneQst (void) { Gam_PutParamGameCod (Gam_CurrentGamCod); Gam_PutParamQstInd (Gam_CurrentQstInd); } /*****************************************************************************/ /********************** Request the removal of a question ********************/ /*****************************************************************************/ void Gam_RequestRemoveQst (void) { extern const char *Txt_Do_you_really_want_to_remove_the_question_X; extern const char *Txt_Remove_question; struct Game Game; unsigned QstInd; /***** Get parameters *****/ /* Get game code */ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /* Get question index */ QstInd = Gam_GetParamQstInd (); /***** Show question and button to remove question *****/ Gam_CurrentGamCod = Game.GamCod; Gam_CurrentQstInd = QstInd; Ale_ShowAlertAndButton (ActRemGamQst,NULL,NULL,Gam_PutParamsOneQst, Btn_REMOVE_BUTTON,Txt_Remove_question, Ale_QUESTION,Txt_Do_you_really_want_to_remove_the_question_X, QstInd); /***** Show current game *****/ Gam_ShowOneGame (Game.GamCod, true, // Show only this game true, // List game questions false); // Do not put form to start new match } /*****************************************************************************/ /****************************** Remove a question ****************************/ /*****************************************************************************/ void Gam_RemoveQst (void) { extern const char *Txt_Question_removed; struct Game Game; unsigned QstInd; /***** Get parameters *****/ /* Get game code */ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /* Get question index */ QstInd = Gam_GetParamQstInd (); /***** Remove the question from all the tables *****/ /* Remove answers from this test question */ Gam_RemAnswersOfAQuestion (Game.GamCod,QstInd); /* Remove the question itself */ DB_QueryDELETE ("can not remove a question", "DELETE FROM gam_questions" " WHERE GamCod=%ld AND QstInd=%u", Game.GamCod,QstInd); if (!mysql_affected_rows (&Gbl.mysql)) Lay_ShowErrorAndExit ("The question to be removed does not exist."); /* Change index of questions greater than this */ DB_QueryUPDATE ("can not update indexes of questions in table of answers", "UPDATE gam_answers SET QstInd=QstInd-1" " WHERE GamCod=%ld AND QstInd>%u", Game.GamCod,QstInd); DB_QueryUPDATE ("can not update indexes of questions", "UPDATE gam_questions SET QstInd=QstInd-1" " WHERE GamCod=%ld AND QstInd>%u", Game.GamCod,QstInd); /***** Write message *****/ Ale_ShowAlert (Ale_SUCCESS,Txt_Question_removed); /***** Show current game *****/ Gam_ShowOneGame (Game.GamCod, true, // Show only this game true, // List game questions false); // Do not put form to start new match } /*****************************************************************************/ /***************** Move up position of a question in a game ******************/ /*****************************************************************************/ void Gam_MoveUpQst (void) { extern const char *Txt_The_question_has_been_moved_up; extern const char *Txt_Movement_not_allowed; struct Game Game; unsigned QstIndTop; unsigned QstIndBottom; /***** Get parameters *****/ /* Get game code */ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /* Get question index */ QstIndBottom = Gam_GetParamQstInd (); /***** Move up question *****/ if (QstIndBottom > 1) { /* Indexes of questions to be exchanged */ QstIndTop = Gam_GetPrevQuestionIndexInGame (Game.GamCod,QstIndBottom); if (!QstIndTop) Lay_ShowErrorAndExit ("Wrong index of question."); /* Exchange questions */ Gam_ExchangeQuestions (Game.GamCod,QstIndTop,QstIndBottom); /* Success alert */ Ale_ShowAlert (Ale_SUCCESS,Txt_The_question_has_been_moved_up); } else Ale_ShowAlert (Ale_WARNING,Txt_Movement_not_allowed); /***** Show current game *****/ Gam_ShowOneGame (Game.GamCod, true, // Show only this game true, // List game questions false); // Do not put form to start new match } /*****************************************************************************/ /**************** Move down position of a question in a game *****************/ /*****************************************************************************/ void Gam_MoveDownQst (void) { extern const char *Txt_The_question_has_been_moved_down; extern const char *Txt_Movement_not_allowed; extern const char *Txt_This_game_has_no_questions; struct Game Game; unsigned QstIndTop; unsigned QstIndBottom; unsigned MaxQstInd; // 0 if no questions /***** Get parameters *****/ /* Get game code */ if ((Game.GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /* Get question index */ QstIndTop = Gam_GetParamQstInd (); /* Get maximum question index */ MaxQstInd = Gam_GetMaxQuestionIndexInGame (Game.GamCod); /***** Move down question *****/ if (MaxQstInd) { if (QstIndTop < MaxQstInd) { /* Indexes of questions to be exchanged */ QstIndBottom = Gam_GetNextQuestionIndexInGame (Game.GamCod,QstIndTop); if (!QstIndBottom) Lay_ShowErrorAndExit ("Wrong index of question."); /* Exchange questions */ Gam_ExchangeQuestions (Game.GamCod,QstIndTop,QstIndBottom); /* Success alert */ Ale_ShowAlert (Ale_SUCCESS,Txt_The_question_has_been_moved_down); } else Ale_ShowAlert (Ale_WARNING,Txt_Movement_not_allowed); } else Ale_ShowAlert (Ale_WARNING,Txt_This_game_has_no_questions); /***** Show current game *****/ Gam_ShowOneGame (Game.GamCod, true, // Show only this game true, // List game questions false); // Do not put form to start new match } /*****************************************************************************/ /********* Exchange the order of two consecutive questions in a game *********/ /*****************************************************************************/ static void Gam_ExchangeQuestions (long GamCod, unsigned QstIndTop,unsigned QstIndBottom) { long QstCodTop; long QstCodBottom; /***** Lock table to make the inscription atomic *****/ DB_Query ("can not lock tables to move game question", "LOCK TABLES gam_questions WRITE"); Gbl.DB.LockedTables = true; /***** Get question code of the questions to be moved *****/ QstCodTop = Gam_GetQstCodFromQstInd (GamCod,QstIndTop); QstCodBottom = Gam_GetQstCodFromQstInd (GamCod,QstIndBottom); /***** Exchange indexes of questions *****/ /* Example: QstIndTop = 1; QstCodTop = 218 QstIndBottom = 2; QstCodBottom = 220 +--------+--------+ +--------+--------+ +--------+--------+ | QstInd | QstCod | | QstInd | QstCod | | QstInd | QstCod | +--------+--------+ +--------+--------+ +--------+--------+ | 1 | 218 | -----> | 2 | 218 | = | 1 | 220 | | 2 | 220 | | 1 | 220 | | 2 | 218 | | 3 | 232 | | 3 | 232 | | 3 | 232 | +--------+--------+ +--------+--------+ +--------+--------+ */ DB_QueryUPDATE ("can not exchange indexes of questions", "UPDATE gam_questions SET QstInd=%u" " WHERE GamCod=%ld AND QstCod=%ld", QstIndBottom, GamCod,QstCodTop); DB_QueryUPDATE ("can not exchange indexes of questions", "UPDATE gam_questions SET QstInd=%u" " WHERE GamCod=%ld AND QstCod=%ld", QstIndTop, GamCod,QstCodBottom); /***** Unlock table *****/ Gbl.DB.LockedTables = false; // Set to false before the following unlock... // ...to not retry the unlock if error in unlocking DB_Query ("can not unlock tables after moving game questions", "UNLOCK TABLES"); } /*****************************************************************************/ /************************* List the matches of a game ************************/ /*****************************************************************************/ static void Gam_ListMatches (struct Game *Game,bool PutFormNewMatch) { extern const char *Hlp_ASSESSMENT_Games_matches; extern const char *Txt_Matches; char *SubQuery; MYSQL_RES *mysql_res; unsigned NumMatches; /***** Get data of matches from database *****/ /* Fill subquery for game */ if (Gbl.Crs.Grps.WhichGrps == Grp_ONLY_MY_GROUPS) { if (asprintf (&SubQuery," AND" "(MchCod NOT IN" " (SELECT MchCod FROM gam_grp)" " OR" " MchCod IN" " (SELECT gam_grp.MchCod" " FROM gam_grp,crs_grp_usr" " WHERE crs_grp_usr.UsrCod=%ld" " AND gam_grp.GrpCod=crs_grp_usr.GrpCod))", Gbl.Usrs.Me.UsrDat.UsrCod) < 0) Lay_NotEnoughMemoryExit (); } else // Gbl.Crs.Grps.WhichGrps == Grp_ALL_GROUPS if (asprintf (&SubQuery,"%s","") < 0) Lay_NotEnoughMemoryExit (); /* Make query */ NumMatches = (unsigned) DB_QuerySELECT (&mysql_res,"can not get matches", "SELECT MchCod," // row[ 0] "GamCod," // row[ 1] "UsrCod," // row[ 2] "UNIX_TIMESTAMP(StartTime)," // row[ 3] "UNIX_TIMESTAMP(EndTime)," // row[ 4] "Title," // row[ 5] "QstInd," // row[ 6] "QstCod," // row[ 7] "UNIX_TIMESTAMP(QstStartTime)," // row[ 8] "ShowingAnswers," // row[ 9] "Finished" // row[10] " FROM gam_matches" " WHERE GamCod=%ld%s" " ORDER BY MchCod", Game->GamCod, SubQuery); /* Free allocated memory for subquery */ free ((void *) SubQuery); /***** Start box *****/ Gam_CurrentGamCod = Game->GamCod; Box_StartBox (NULL,Txt_Matches,Gam_PutIconToPlayNewMatch, Hlp_ASSESSMENT_Games_matches,Box_NOT_CLOSABLE); if (NumMatches) /***** Show the table with the matches *****/ Gam_ListOneOrMoreMatches (Game,NumMatches,mysql_res); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); /***** Put button to play a new match in this game *****/ switch (Gbl.Usrs.Me.Role.Logged) { case Rol_NET: case Rol_TCH: case Rol_SYS_ADM: if (PutFormNewMatch) Gam_PutFormNewMatch (Game); // Form to fill in data and start playing a new match else Gam_PutButtonNewMatch (Game->GamCod); // Button to create a new match break; default: break; } /***** End box *****/ Box_EndBox (); } /*****************************************************************************/ /********************** Get match data using its code ************************/ /*****************************************************************************/ void Gam_GetDataOfMatchByCod (struct Match *Match) { MYSQL_RES *mysql_res; unsigned long NumRows; /***** Get data of match from database *****/ NumRows = (unsigned) DB_QuerySELECT (&mysql_res,"can not get matches", "SELECT MchCod," // row[ 0] "GamCod," // row[ 1] "UsrCod," // row[ 2] "UNIX_TIMESTAMP(StartTime)," // row[ 3] "UNIX_TIMESTAMP(EndTime)," // row[ 4] "Title," // row[ 5] "QstInd," // row[ 6] "QstCod," // row[ 7] "UNIX_TIMESTAMP(QstStartTime)," // row[ 8] "ShowingAnswers," // row[ 9] "Finished" // row[10] " FROM gam_matches" " WHERE MchCod=%ld" " AND GamCod IN" // Extra check " (SELECT GamCod FROM games" " WHERE CrsCod='%ld')", Match->MchCod, Gbl.Hierarchy.Crs.CrsCod); if (NumRows) // Match found... /***** Get match data from row *****/ Gam_GetMatchDataFromRow (mysql_res,Match); else { /* Initialize to empty match */ Match->MchCod = -1L; Match->GamCod = -1L; Match->UsrCod = -1L; Match->TimeUTC[Gam_START_TIME] = Match->TimeUTC[Gam_END_TIME ] = (time_t) 0; Match->Title[0] = '\0'; Match->Status.QstInd = 0; Match->Status.QstCod = -1L; Match->Status.QstStartTimeUTC = (time_t) 0; Match->Status.ShowingAnswers = false; Match->Status.Finished = false; Match->Status.BeingPlayed = false; } /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); } /*****************************************************************************/ /***************** Put icon to add a new questions to game *******************/ /*****************************************************************************/ static void Gam_PutIconToPlayNewMatch (void) { extern const char *Txt_New_match; /***** Put form to create a new question *****/ Ico_PutContextualIconToAdd (ActReqNewMchTch,Gam_NEW_MATCH_SECTION_ID,Gam_PutParams, Txt_New_match); } /*****************************************************************************/ /*********************** List game matches for edition ***********************/ /*****************************************************************************/ static void Gam_ListOneOrMoreMatches (struct Game *Game, unsigned NumMatches, MYSQL_RES *mysql_res) { extern const char *Txt_No_INDEX; extern const char *Txt_ROLES_SINGUL_Abc[Rol_NUM_ROLES][Usr_NUM_SEXS]; extern const char *Txt_START_END_TIME[Dat_NUM_START_END_TIME]; extern const char *Txt_Match; extern const char *Txt_Status; extern const char *Txt_Play; extern const char *Txt_Resume_match; extern const char *Txt_Today; extern const char *Txt_View_game_results; unsigned NumMatch; unsigned UniqueId; struct Match Match; /***** Write the heading *****/ Tbl_StartTableWideMargin (2); fprintf (Gbl.F.Out,"" "" "" "%s" "" "" "%s" "" "" "%s" "" "" "%s" "" "" "%s" "" "" "%s" "" "", Txt_No_INDEX, Txt_ROLES_SINGUL_Abc[Rol_TCH][Usr_SEX_UNKNOWN], Txt_START_END_TIME[Gam_ORDER_BY_START_DATE], Txt_START_END_TIME[Gam_ORDER_BY_END_DATE], Txt_Match, Txt_Status); /***** Write rows *****/ for (NumMatch = 0, UniqueId = 1; NumMatch < NumMatches; NumMatch++, UniqueId++) { Gbl.RowEvenOdd = NumMatch % 2; /***** Get match data from row *****/ Gam_GetMatchDataFromRow (mysql_res,&Match); /***** Icons *****/ fprintf (Gbl.F.Out,"" "",Gbl.RowEvenOdd); /* Put icon to remove the match */ Frm_StartForm (ActReqRemMchTch); Gam_PutParamMatchCod (Match.MchCod); Ico_PutIconRemove (); Frm_EndForm (); fprintf (Gbl.F.Out,""); /***** Number of match ******/ fprintf (Gbl.F.Out,"%u", Gbl.RowEvenOdd,NumMatch + 1); /***** Match player *****/ fprintf (Gbl.F.Out,"", Gbl.RowEvenOdd); Usr_WriteAuthor1Line (Match.UsrCod,false); fprintf (Gbl.F.Out,""); /***** Start date/time *****/ fprintf (Gbl.F.Out,"", UniqueId, Match.Status.Finished ? "DATE_RED" : "DATE_GREEN", Gbl.RowEvenOdd); fprintf (Gbl.F.Out,"" "", UniqueId,Match.TimeUTC[Gam_START_TIME], (unsigned) Gbl.Prefs.DateFormat,Txt_Today); /***** End date/time *****/ fprintf (Gbl.F.Out,"", UniqueId, Match.Status.Finished ? "DATE_RED" : "DATE_GREEN", Gbl.RowEvenOdd); fprintf (Gbl.F.Out,"\">" "" "", UniqueId,Match.TimeUTC[Gam_END_TIME], (unsigned) Gbl.Prefs.DateFormat,Txt_Today); /***** Title and groups *****/ fprintf (Gbl.F.Out,"",Gbl.RowEvenOdd); /* Title */ fprintf (Gbl.F.Out,"%s",Match.Title); /* Groups whose students can answer this match */ if (Gbl.Crs.Grps.NumGrps) Gam_GetAndWriteNamesOfGrpsAssociatedToMatch (&Match); fprintf (Gbl.F.Out,""); /***** Match status ******/ fprintf (Gbl.F.Out,"",Gbl.RowEvenOdd); if (Match.Status.Finished) /* Icon to inform about finished match */ // Ico_PutIconOff ("flag-checkered.svg",Txt_Finished_match); Lay_PutContextualLinkOnlyIcon (ActShoMchTch,NULL, Gam_PutParamCurrentMchCod, "flag-checkered.svg", Txt_View_game_results); else // Unfinished match { /* Current question index / total of questions */ fprintf (Gbl.F.Out,"
%u/%u
", Match.Status.QstInd,Game->NumQsts); switch (Gbl.Usrs.Me.Role.Logged) { case Rol_STD: /* Icon to play as student */ Gam_CurrentMchCod = Match.MchCod; Lay_PutContextualLinkOnlyIcon (ActPlyMchStd,NULL, Gam_PutParamCurrentMchCod, "play.svg", Txt_Play); break; case Rol_NET: case Rol_TCH: case Rol_DEG_ADM: case Rol_CTR_ADM: case Rol_INS_ADM: case Rol_SYS_ADM: /* Icon to resume */ Gam_CurrentMchCod = Match.MchCod; Lay_PutContextualLinkOnlyIcon (ActResMchTch,NULL, Gam_PutParamCurrentMchCod, "play.svg", Txt_Resume_match); break; default: break; } } fprintf (Gbl.F.Out,""); fprintf (Gbl.F.Out,""); } /***** End table *****/ Tbl_EndTable (); } /*****************************************************************************/ /******************** Get game data from a database row **********************/ /*****************************************************************************/ static void Gam_GetMatchDataFromRow (MYSQL_RES *mysql_res, struct Match *Match) { MYSQL_ROW row; /***** Get match data *****/ row = mysql_fetch_row (mysql_res); /* row[ 0] MchCod row[ 1] GamCod row[ 2] UsrCod row[ 3] UNIX_TIMESTAMP(StartTime) row[ 4] UNIX_TIMESTAMP(EndTime) row[ 5] Title */ /***** Get match data *****/ /* Code of the match (row[0]) */ if ((Match->MchCod = Str_ConvertStrCodToLongCod (row[0])) <= 0) Lay_ShowErrorAndExit ("Wrong code of match."); /* Code of the game (row[1]) */ if ((Match->GamCod = Str_ConvertStrCodToLongCod (row[1])) <= 0) Lay_ShowErrorAndExit ("Wrong code of game."); /* Get match teacher (row[2]) */ Match->UsrCod = Str_ConvertStrCodToLongCod (row[2]); /* Get start date (row[3] holds the start UTC time) */ Match->TimeUTC[Gam_START_TIME] = Dat_GetUNIXTimeFromStr (row[3]); /* Get end date (row[4] holds the end UTC time) */ Match->TimeUTC[Gam_END_TIME ] = Dat_GetUNIXTimeFromStr (row[4]); /* Get the title of the game (row[5]) */ if (row[5]) Str_Copy (Match->Title,row[5], Gam_MAX_BYTES_TITLE); else Match->Title[0] = '\0'; /***** Get current match status *****/ /* row[ 6] QstInd row[ 7] QstCod row[ 8] UNIX_TIMESTAMP(QstStartTime) row[ 9] ShowingAnswers row[10] Finished */ /* Current question index (row[6]) */ Match->Status.QstInd = Gam_GetQstIndFromStr (row[6]); /* Current question code (row[7]) */ Match->Status.QstCod = Str_ConvertStrCodToLongCod (row[7]); /* Get question start date (row[8] holds the start UTC time) */ Match->Status.QstStartTimeUTC = Dat_GetUNIXTimeFromStr (row[8]); /* Get whether to show question answers or not (row(9)) */ Match->Status.ShowingAnswers = (row[9][0] == 'Y'); /* Get whether the match is finished or not (row(10)) */ Match->Status.Finished = (row[10][0] == 'Y'); /***** Get whether the match is being played or not *****/ if (Match->Status.Finished) Match->Status.BeingPlayed = false; else Match->Status.BeingPlayed = Gam_GetIfMatchIsBeingPlayed (Match->MchCod); } /*****************************************************************************/ /************** Request the removal of a match (game instance) ***************/ /*****************************************************************************/ void Gam_RequestRemoveMatchTch (void) { extern const char *Txt_Do_you_really_want_to_remove_the_match_X; extern const char *Txt_Remove_match; struct Match Match; /***** Get parameters *****/ /* Get match code */ if ((Match.MchCod = Gam_GetParamMatchCod ()) == -1L) Lay_ShowErrorAndExit ("Code of match is missing."); /***** Get data of the match from database *****/ Gam_GetDataOfMatchByCod (&Match); /***** Show question and button to remove question *****/ Gam_CurrentMchCod = Match.MchCod; Ale_ShowAlertAndButton (ActRemMchTch,NULL,NULL,Gam_PutParamCurrentMchCod, Btn_REMOVE_BUTTON,Txt_Remove_match, Ale_QUESTION,Txt_Do_you_really_want_to_remove_the_match_X, Match.Title); /***** Show current game *****/ Gam_ShowOneGame (Match.GamCod, true, // Show only this game false, // Do not list game questions false); // Do not put form to start new match } /*****************************************************************************/ /********************** Remove a match (game instance) ***********************/ /*****************************************************************************/ void Gam_RemoveMatchTch (void) { extern const char *Txt_Match_X_removed; struct Match Match; /***** Get parameters *****/ /* Get match code */ if ((Match.MchCod = Gam_GetParamMatchCod ()) == -1L) Lay_ShowErrorAndExit ("Code of match is missing."); /***** Get data of the match from database *****/ Gam_GetDataOfMatchByCod (&Match); /***** Remove the match from all the tables *****/ /* Remove groups associated to the match */ DB_QueryDELETE ("can not remove the groups associated to matches of a game", "DELETE FROM gam_grp USING gam_grp,gam_matches,games" " WHERE gam_grp.MchCod=%ld" " AND gam_grp.MchCod=gam_matches.MchCod" " AND gam_matches.GamCod=games.GamCod" " AND games.CrsCod=%ld", // Extra check Match.MchCod); /* Remove the match itself */ DB_QueryDELETE ("can not remove a match", "DELETE FROM gam_matches USING gam_matches,games" " WHERE gam_matches.MchCod=%ld" " AND gam_matches.GamCod=games.GamCod" " AND games.CrsCod=%ld", // Extra check Match.MchCod,Gbl.Hierarchy.Crs.CrsCod); if (!mysql_affected_rows (&Gbl.mysql)) Lay_ShowErrorAndExit ("The match to be removed does not exist."); /***** Write message *****/ Ale_ShowAlert (Ale_SUCCESS,Txt_Match_X_removed, Match.Title); /***** Show current game *****/ Gam_ShowOneGame (Match.GamCod, true, // Show only this game false, // Do not list game questions false); // Do not put form to start new match } /*****************************************************************************/ /********************* Put button to create a new match **********************/ /*****************************************************************************/ static void Gam_PutButtonNewMatch (long GamCod) { extern const char *Txt_New_match; Frm_StartFormAnchor (ActReqNewMchTch,Gam_NEW_MATCH_SECTION_ID); Gam_PutParamGameCod (GamCod); Btn_PutConfirmButton (Txt_New_match); Frm_EndForm (); } /*****************************************************************************/ /******************* Start playing a game as a teacher ***********************/ /*****************************************************************************/ void Gam_RequestNewMatchTch (void) { long GamCod; /***** Get parameters *****/ Gam_GetParamOrder (); Grp_GetParamWhichGrps (); Gbl.Games.CurrentPage = Pag_GetParamPagNum (Pag_GAMES); /***** Get game code *****/ if ((GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /***** Show game *****/ Gam_ShowOneGame (GamCod, true, // Show only this game false, // Do not list game questions true); // Put form to start new match } /*****************************************************************************/ /****** Put a big button to play match (start a new match) as a teacher ******/ /*****************************************************************************/ static void Gam_PutFormNewMatch (struct Game *Game) { extern const char *Hlp_ASSESSMENT_Games_new_match; extern const char *The_ClassFormInBox[The_NUM_THEMES]; extern const char *Txt_New_match; extern const char *Txt_Title; extern const char *Txt_Play; /***** Start section for a new match *****/ Lay_StartSection (Gam_NEW_MATCH_SECTION_ID); /***** Start form *****/ Frm_StartForm (ActNewMchTch); Gam_PutParamGameCod (Game->GamCod); Gam_PutParamQstInd (0); // Start by first question in game /***** Start box and table *****/ Box_StartBoxTable (NULL,Txt_New_match,NULL, Hlp_ASSESSMENT_Games_new_match,Box_NOT_CLOSABLE,2); /***** Match title *****/ fprintf (Gbl.F.Out,"" "" "" "" "" "" "" "", The_ClassFormInBox[Gbl.Prefs.Theme], Txt_Title, Gam_MAX_CHARS_TITLE,Game->Title); /***** Groups *****/ Gam_ShowLstGrpsToCreateMatch (); /***** End table *****/ Tbl_EndTable (); /***** Put icon with link *****/ Frm_LinkFormSubmit (Txt_Play,NULL,NULL); fprintf (Gbl.F.Out,"\"%s\"", Cfg_URL_ICON_PUBLIC,Txt_Play,Txt_Play); fprintf (Gbl.F.Out,""); /***** End box *****/ Box_EndBox (); /***** End form *****/ Frm_EndForm (); /***** End section for a new match *****/ Lay_EndSection (); } /*****************************************************************************/ /********************* Create a new match (by a teacher) *********************/ /*****************************************************************************/ void Gam_CreateNewMatchTch (void) { long GamCod; char Title[Gam_MAX_BYTES_TITLE + 1]; /***** Get form parameters *****/ /* Get match code */ if ((GamCod = Gam_GetParamGameCod ()) == -1L) Lay_ShowErrorAndExit ("Code of game is missing."); /* Get match title */ Par_GetParToText ("Title",Title,Gam_MAX_BYTES_TITLE); /* Get groups for this games */ Grp_GetParCodsSeveralGrps (); /***** Create a new match *****/ Gbl.Games.MchCodBeingPlayed = Gam_CreateMatch (GamCod,Title); /***** Free memory for list of selected groups *****/ Grp_FreeListCodSelectedGrps (); } /*****************************************************************************/ /******* Show button to actually start / resume a match (by a teacher) *******/ /*****************************************************************************/ void Gam_RequestStartResumeMatchTch (void) { extern const char *Txt_Start_match; extern const char *Txt_Resume_match; struct Match Match; /***** Get data of the match from database *****/ Match.MchCod = Gbl.Games.MchCodBeingPlayed; Gam_GetDataOfMatchByCod (&Match); /***** Show current match status *****/ fprintf (Gbl.F.Out,"
"); fprintf (Gbl.F.Out,"
"); Gam_GetAndShowNumPlayersInMatch (Match.MchCod); fprintf (Gbl.F.Out,"
"); if (Match.Status.Finished) Gam_ShowAlertFinishedMatch (); else // Unfinished match /***** Put button to start / resume match *****/ Gam_PutBigButton (ActCurMchTch, Match.MchCod, "play.svg", Match.Status.QstInd == 0 ? Txt_Start_match : Txt_Resume_match); fprintf (Gbl.F.Out,"
"); } /*****************************************************************************/ /********************** Create a new match in a game *************************/ /*****************************************************************************/ static long Gam_CreateMatch (long GamCod,char Title[Gam_MAX_BYTES_TITLE + 1]) { long MchCod; /***** Insert this new match into database *****/ MchCod = DB_QueryINSERTandReturnCode ("can not create match", "INSERT gam_matches" " (GamCod,UsrCod,StartTime,EndTime,Title," "QstInd,QstCod,QstStartTime,ShowingAnswers,Finished)" " VALUES" " (%ld," // GamCod "%ld," // UsrCod "NOW()," // StartTime "NOW()," // EndTime "'%s'," // Title "0," // QstInd: Match has not started, so not the first question yet "-1," // QstCod: Non-existent question "NOW()," // QstStartTime "'N'," // ShowingAnswers: Don't show answers initially "'N')", // Finished: Game unfinished GamCod, Gbl.Usrs.Me.UsrDat.UsrCod, // Game creator Title); /***** Create groups associated to the match *****/ if (Gbl.Crs.Grps.LstGrpsSel.NumGrps) Gam_CreateGrps (MchCod); return MchCod; } /*****************************************************************************/ /***************** Insert/update a game match being played *******************/ /*****************************************************************************/ static void Gam_UpdateMatchBeingPlayed (struct Match *Match) { /***** Update match status in database *****/ DB_QueryUPDATE ("can not update match being played", "UPDATE gam_matches,games" " SET gam_matches.EndTime=NOW()," "gam_matches.QstInd=%u," "gam_matches.QstCod=%ld," "gam_matches.QstStartTime=NOW()," "gam_matches.ShowingAnswers='%c'," "gam_matches.Finished='%c'" " WHERE gam_matches.MchCod=%ld" " AND gam_matches.GamCod=games.GamCod" " AND games.CrsCod=%ld", // Extra check Match->Status.QstInd,Match->Status.QstCod, Match->Status.ShowingAnswers ? 'Y' : 'N', Match->Status.Finished ? 'Y' : 'N', Match->MchCod,Gbl.Hierarchy.Crs.CrsCod); if (Match->Status.Finished) /* Update match as not being played */ Gam_SetMatchAsNotBeingPlayed (Match->MchCod); } /*****************************************************************************/ /** Show current match status (current question, answers...) (by a teacher) **/ /*****************************************************************************/ void Gam_ResumeMatchTch (void) { struct Match Match; long NxtQstInd; /***** Get data of the match from database *****/ Match.MchCod = Gbl.Games.MchCodBeingPlayed; Gam_GetDataOfMatchByCod (&Match); /***** If not yet finished, update status *****/ if (!Match.Status.Finished) { if (Match.Status.QstInd == 0) // Match has been created, but it has not started { /* Get index of the first question */ NxtQstInd = Gam_GetFirstQuestionIndexInGame (Match.GamCod); if (NxtQstInd) // Not last question { Match.Status.QstInd = NxtQstInd; // Go to the next question Match.Status.QstCod = Gam_GetQstCodFromQstInd (Match.GamCod, Match.Status.QstInd); Match.Status.Finished = false; // Match is not finished } else // No more questions { Match.Status.QstInd = 0; // No more questions Match.Status.QstCod = -1L; // No more questions Match.Status.Finished = true; // Match is finished } } Match.Status.ShowingAnswers = false; // Don't show answers /* Update match status in database */ Gam_UpdateMatchBeingPlayed (&Match); } /***** Show current match status *****/ fprintf (Gbl.F.Out,"
"); fprintf (Gbl.F.Out,"
"); Gam_GetAndShowNumPlayersInMatch (Match.MchCod); fprintf (Gbl.F.Out,"
"); Gam_ShowMatchStatusForTch (&Match); fprintf (Gbl.F.Out,"
"); } /*****************************************************************************/ /***** Show next match status (next question, answers...) (by a teacher) *****/ /*****************************************************************************/ void Gam_NextStatusMatchTch (void) { struct Match Match; long NxtQstInd; /***** Get data of the match from database *****/ Match.MchCod = Gbl.Games.MchCodBeingPlayed; Gam_GetDataOfMatchByCod (&Match); /***** If not yet finished, update status *****/ if (!Match.Status.Finished) { if (Match.Status.QstInd == 0) // Match has been created, but it has not started { /* Get index of the first question */ NxtQstInd = Gam_GetFirstQuestionIndexInGame (Match.GamCod); if (NxtQstInd) // Not last question { Match.Status.QstInd = NxtQstInd; // Go to the next question Match.Status.QstCod = Gam_GetQstCodFromQstInd (Match.GamCod, Match.Status.QstInd); Match.Status.Finished = false; // Match is not finished } else // No more questions { Match.Status.QstInd = 0; // No more questions Match.Status.QstCod = -1L; // No more questions Match.Status.Finished = true; // Match is finished } Match.Status.ShowingAnswers = false; // Don't show answers } else // Match has started { if (Match.Status.ShowingAnswers) // Showing answers currently { /* Get index of the next question */ NxtQstInd = Gam_GetNextQuestionIndexInGame (Match.GamCod, Match.Status.QstInd); if (NxtQstInd) // Not last question { Match.Status.QstInd = NxtQstInd; // Go to the next question Match.Status.QstCod = Gam_GetQstCodFromQstInd (Match.GamCod, Match.Status.QstInd); Match.Status.Finished = false; // Match is not finished } else // No more questions { Match.Status.QstInd = 0; // No more questions Match.Status.QstCod = -1L; // No more questions Match.Status.Finished = true; // Match is finished } Match.Status.ShowingAnswers = false; // Don't show answers } else { Match.Status.Finished = false; // Match is not finished Match.Status.ShowingAnswers = true; // Show answers } } /* Update match status in database */ Gam_UpdateMatchBeingPlayed (&Match); } /***** Show current match status *****/ fprintf (Gbl.F.Out,"
"); fprintf (Gbl.F.Out,"
"); Gam_GetAndShowNumPlayersInMatch (Match.MchCod); fprintf (Gbl.F.Out,"
"); Gam_ShowMatchStatusForTch (&Match); fprintf (Gbl.F.Out,"
"); } /*****************************************************************************/ /******* Show current match status (number, question, answers, button) *******/ /*****************************************************************************/ static void Gam_ShowMatchStatusForTch (struct Match *Match) { /***** Show current match status *****/ if (Match->Status.Finished) /* Show alert */ Gam_ShowAlertFinishedMatch (); else // Unfinished match { /* Show current question and possible answers */ Gam_PlayGameShowQuestionAndAnswers (Match); /* Update match as being played */ Gam_UpdateMatchAsBeingPlayed (Match->MchCod); } } /*****************************************************************************/ /********************* Show alert about finished match ***********************/ /*****************************************************************************/ static void Gam_ShowAlertFinishedMatch (void) { extern const char *Txt_Finished_match; /***** Show alert *****/ Ale_ShowAlert (Ale_INFO,Txt_Finished_match); /***** Button to close browser tab *****/ Btn_PutCloseTabButton ("Cerrar"); // TODO: Need translation!!!!! } /*****************************************************************************/ /*********** Show question and its answers when playing a match **************/ /*****************************************************************************/ static void Gam_PlayGameShowQuestionAndAnswers (struct Match *Match) { extern const char *Txt_Continue; extern const char *Txt_Finish; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NxtQstInd; /***** Trivial check: Question index should be > 0 *****/ if (Match->Status.QstInd == 0) return; /***** Get data of question from database *****/ if (!DB_QuerySELECT (&mysql_res,"can not get data of a question", "SELECT AnsType," // row[0] "Stem," // row[1] "MedCod" // row[2] " FROM tst_questions" " WHERE QstCod=%ld", Match->Status.QstCod)) Ale_ShowAlert (Ale_ERROR,"Question doesn't exist."); row = mysql_fetch_row (mysql_res); /***** Show question *****/ /* Write number of question */ fprintf (Gbl.F.Out,"
%u
", Match->Status.QstInd); fprintf (Gbl.F.Out,"
"); /* Get answer type (row[0]) */ Gbl.Test.AnswerType = Tst_ConvertFromStrAnsTypDBToAnsTyp (row[0]); // TODO: Check that answer type is correct (unique choice) /* Write stem (row[1]) */ Tst_WriteQstStem (row[1],"GAM_PLAY_TCH_QST"); /* Get media (row[2]) */ Gbl.Test.Media.MedCod = Str_ConvertStrCodToLongCod (row[2]); Med_GetMediaDataByCod (&Gbl.Test.Media); /* Show media */ Med_ShowMedia (&Gbl.Test.Media, "TEST_MED_EDIT_LIST_STEM_CONTAINER", "TEST_MED_EDIT_LIST_STEM"); /* Write answers? */ if (Match->Status.ShowingAnswers) /* Write answers */ Tst_WriteAnswersGameResult (Match->GamCod, Match->Status.QstInd, Match->Status.QstCod, "GAM_PLAY_TCH_QST",false); // Don't show result fprintf (Gbl.F.Out,"
"); /***** Put button to continue *****/ fprintf (Gbl.F.Out,"
"); if (Match->Status.ShowingAnswers) { /* Get index of the next question */ NxtQstInd = Gam_GetNextQuestionIndexInGame (Match->GamCod, Match->Status.QstInd); if (NxtQstInd) // Not last question /* Put button to show next question */ Gam_PutBigButton (ActNxtMchTch,Match->MchCod, "step-forward.svg",Txt_Continue); else // Last question /* Put button to finish */ Gam_PutBigButton (ActNxtMchTch,Match->MchCod, "flag-checkered.svg",Txt_Finish); } else /* Put button to show answers */ Gam_PutBigButton (ActNxtMchTch,Match->MchCod, "step-forward.svg",Txt_Continue); fprintf (Gbl.F.Out,"
"); } /*****************************************************************************/ /************************** Put a big button to start ************************/ /*****************************************************************************/ static void Gam_PutBigButton (Act_Action_t NextAction,long MchCod, const char *Icon,const char *Txt) { /***** Start container for button *****/ fprintf (Gbl.F.Out,"
"); /***** Start form *****/ Frm_StartForm (NextAction); Gam_PutParamMatchCod (MchCod); /***** Put icon with link *****/ Frm_LinkFormSubmit (Txt,"GAM_PLAY_TCH_CONTINUE ICO_HIGHLIGHT",NULL); fprintf (Gbl.F.Out,"\"%s\"" "
" "%s", Cfg_URL_ICON_PUBLIC,Icon, Txt,Txt, Txt); fprintf (Gbl.F.Out,""); /***** End form *****/ Frm_EndForm (); /***** End container for button *****/ fprintf (Gbl.F.Out,"
"); } /*****************************************************************************/ /*********************** Get number of players in a match ********************/ /*****************************************************************************/ static void Gam_RemoveOldPlayers (void) { /***** Delete matches not being played *****/ DB_QueryDELETE ("can not update matches as not being played", "DELETE FROM gam_mch_being_played" " WHERE TS"); Gam_ShowMatchStatusForStd (&Match); fprintf (Gbl.F.Out,""); } /*****************************************************************************/ /****************** Refresh match for a teacher via AJAX *********************/ /*****************************************************************************/ void Gam_RefreshMatchTch (void) { struct Match Match; if (!Gbl.Session.IsOpen) // If session has been closed, do not write anything return; /***** Get data of the match from database *****/ Match.MchCod = Gbl.Games.MchCodBeingPlayed; Gam_GetDataOfMatchByCod (&Match); /***** Get and show number of players *****/ Gam_GetAndShowNumPlayersInMatch (Match.MchCod); /***** Update match as being played *****/ if (Match.Status.BeingPlayed) Gam_UpdateMatchAsBeingPlayed (Match.MchCod); } /*****************************************************************************/ /*************** Refresh current game for a student via AJAX *****************/ /*****************************************************************************/ void Gam_RefreshMatchStd (void) { struct Match Match; if (!Gbl.Session.IsOpen) // If session has been closed, do not write anything return; /***** Get data of the match from database *****/ Match.MchCod = Gbl.Games.MchCodBeingPlayed; Gam_GetDataOfMatchByCod (&Match); /***** Show current match status *****/ Gam_ShowMatchStatusForStd (&Match); } /*****************************************************************************/ /************ Show current question being played for a student ***************/ /*****************************************************************************/ static void Gam_ShowMatchStatusForStd (struct Match *Match) { bool IBelongToGroups; bool Shuffle = false; // TODO: Read shuffle from question MYSQL_RES *mysql_res; MYSQL_ROW row; int StdAnsInd; unsigned NumOptions; unsigned NumOpt; unsigned Index; bool ErrorInIndex = false; /***** Do I belong to valid groups to play this match? *****/ IBelongToGroups = Gbl.Usrs.Me.IBelongToCurrentCrs && Gam_CheckIfIPlayThisMatchBasedOnGrps (Match->MchCod); if (!IBelongToGroups) Lay_ShowErrorAndExit ("You can not play this match!"); /***** Show current match status *****/ if (Match->Status.Finished) Gam_ShowAlertFinishedMatch (); else // Unfinished match { /***** Update players ******/ Gam_RemoveOldPlayers (); Gam_RegisterMeAsPlayerInMatch (Match->MchCod); if (Match->Status.BeingPlayed) { /***** Show question *****/ /* Write number of question */ fprintf (Gbl.F.Out,"
%u
", Match->Status.QstInd); fprintf (Gbl.F.Out,"
"); /* Write buttons for answers? */ if (Match->Status.ShowingAnswers) { if (Tst_CheckIfQuestionIsValidForGame (Match->Status.QstCod)) { /***** Get student's answer to this question (<0 ==> no answer) *****/ StdAnsInd = Gam_GetQstAnsFromDB (Match->MchCod, Match->Status.QstInd); /***** Get number of options in this question *****/ NumOptions = Tst_GetNumAnswersQst (Match->Status.QstCod); /***** Get answers of question from database *****/ Shuffle = false; NumOptions = Tst_GetAnswersQst (Match->Status.QstCod,&mysql_res,Shuffle); /* row[0] AnsInd row[1] Answer row[2] Feedback row[3] MedCod row[4] Correct */ /***** Start table *****/ Tbl_StartTableWide (8); for (NumOpt = 0; NumOpt < NumOptions; NumOpt++) { /***** Get next answer *****/ row = mysql_fetch_row (mysql_res); /***** Assign index (row[0]). Index is 0,1,2,3... if no shuffle or 1,3,0,2... (example) if shuffle *****/ if (sscanf (row[0],"%u",&Index) == 1) { if (Index >= Tst_MAX_OPTIONS_PER_QUESTION) ErrorInIndex = true; } else ErrorInIndex = true; if (ErrorInIndex) Lay_ShowErrorAndExit ("Wrong index of answer when showing a test."); /***** Start row *****/ // if (NumOpt % 2 == 0) fprintf (Gbl.F.Out,""); /***** Write letter for this option *****/ /* Start table cell */ fprintf (Gbl.F.Out,""); /* Form with button */ Frm_StartForm (ActAnsMchQstStd); Gam_PutParamMatchCod (Match->MchCod); // Current match being played Gam_PutParamQstInd (Match->Status.QstInd); // Current question index shown Gam_PutParamAnswer (Index); // Index for this option fprintf (Gbl.F.Out,"", 'A' + (char) NumOpt, 'a' + (char) NumOpt); Frm_EndForm (); /* End table cell */ fprintf (Gbl.F.Out,""); /***** End row *****/ // if (NumOpt % 2 == 1) fprintf (Gbl.F.Out,""); } /***** End table *****/ Tbl_EndTable (); } else Ale_ShowAlert (Ale_ERROR,"Type of answer not valid in a game."); } fprintf (Gbl.F.Out,"
"); } else // Not being played fprintf (Gbl.F.Out,"
" "\"Please" "
", Cfg_URL_ICON_PUBLIC); } } /*****************************************************************************/ /**** Receive previous question answer in a match question from database *****/ /*****************************************************************************/ static int Gam_GetQstAnsFromDB (long MchCod,unsigned QstInd) { MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumRows; int StdAnsInd = -1; // <0 ==> no answer selected /***** Get student's answer *****/ NumRows = (unsigned) DB_QuerySELECT (&mysql_res,"can not get student's answer to a match question", "SELECT AnsInd FROM gam_answers" " WHERE MchCod=%ld AND UsrCod=%ld AND QstInd=%u", MchCod, Gbl.Usrs.Me.UsrDat.UsrCod, QstInd); if (NumRows) // Answer found... { /***** Get answer index *****/ row = mysql_fetch_row (mysql_res); if (sscanf (row[0],"%d",&StdAnsInd) != 1) Lay_ShowErrorAndExit ("Error when getting student's answer to a match question."); } /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return StdAnsInd; } /*****************************************************************************/ /********* Receive question answer from student when playing a match *********/ /*****************************************************************************/ void Gam_ReceiveQstAnsFromStd (void) { struct Match Match; unsigned QstInd; unsigned StdAnsInd; int PreviousStdAnsInd; /***** Get data of the match from database *****/ Match.MchCod = Gbl.Games.MchCodBeingPlayed; Gam_GetDataOfMatchByCod (&Match); /***** Get question index from form *****/ QstInd = Gam_GetParamQstInd (); /***** Check that question index is the current one being played *****/ if (QstInd == Match.Status.QstInd) // Receiving an answer // to the current question being played { /***** Get answer index *****/ /*-------+--------------+ | Button | Answer index | +--------+--------------+ | a | 0 | | b | 1 | | c | 2 | | d | 3 | | ... | ... | +--------+-------------*/ StdAnsInd = Gam_GetParamAnswer (); /***** Get previous student's answer to this question (<0 ==> no answer) *****/ PreviousStdAnsInd = Gam_GetQstAnsFromDB (Match.MchCod,QstInd); /***** Store student's answer *****/ if (PreviousStdAnsInd == (int) StdAnsInd) DB_QueryDELETE ("can not register your answer to the match question", "DELETE FROM gam_answers" " WHERE MchCod=%ld AND UsrCod=%ld AND QstInd=%u", Match.MchCod,Gbl.Usrs.Me.UsrDat.UsrCod,QstInd); else DB_QueryREPLACE ("can not register your answer to the match question", "REPLACE gam_answers" " (MchCod,UsrCod,QstInd,AnsInd)" " VALUES" " (%ld,%ld,%u,%u)", Match.MchCod,Gbl.Usrs.Me.UsrDat.UsrCod,QstInd,StdAnsInd); } /***** Show current match status *****/ fprintf (Gbl.F.Out,"
"); Gam_ShowMatchStatusForStd (&Match); fprintf (Gbl.F.Out,"
"); } /*****************************************************************************/ /************** Get number of users who have answered a game *****************/ /*****************************************************************************/ static unsigned Gam_GetNumUsrsWhoHaveAnsweredGame (long GamCod) { /***** Get number of games with a field value from database *****/ return (unsigned) DB_QueryCOUNT ("can not get number of users" " who have answered a game", "SELECT COUNT(*) FROM gam_users" " WHERE GamCod=%ld", GamCod); } /*****************************************************************************/ /********************* Get number of courses with games **********************/ /*****************************************************************************/ // Returns the number of courses with games in this location unsigned Gam_GetNumCoursesWithGames (Hie_Level_t Scope) { MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumCourses; /***** Get number of courses with games from database *****/ switch (Scope) { case Hie_SYS: DB_QuerySELECT (&mysql_res,"can not get number of courses with games", "SELECT COUNT(DISTINCT Cod)" " FROM games" " WHERE Scope='%s'", Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_CTY: DB_QuerySELECT (&mysql_res,"can not get number of courses with games", "SELECT COUNT(DISTINCT games.Cod)" " FROM institutions,centres,degrees,courses,games" " WHERE institutions.CtyCod=%ld" " AND institutions.InsCod=centres.InsCod" " AND centres.CtrCod=degrees.CtrCod" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'", Gbl.Hierarchy.Ins.InsCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_INS: DB_QuerySELECT (&mysql_res,"can not get number of courses with games", "SELECT COUNT(DISTINCT games.Cod)" " FROM centres,degrees,courses,games" " WHERE centres.InsCod=%ld" " AND centres.CtrCod=degrees.CtrCod" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'", Gbl.Hierarchy.Ins.InsCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_CTR: DB_QuerySELECT (&mysql_res,"can not get number of courses with games", " FROM degrees,courses,games" " WHERE degrees.CtrCod=%ld" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'", Gbl.Hierarchy.Ctr.CtrCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_DEG: DB_QuerySELECT (&mysql_res,"can not get number of courses with games", "SELECT COUNT(DISTINCT games.Cod)" " FROM courses,games" " WHERE courses.DegCod=%ld" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'", Gbl.Hierarchy.Deg.DegCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_CRS: DB_QuerySELECT (&mysql_res,"can not get number of courses with games", "SELECT COUNT(DISTINCT Cod)" " FROM games" " WHERE Scope='%s' AND Cod=%ld", Sco_GetDBStrFromScope (Hie_CRS), Gbl.Hierarchy.Crs.CrsCod); break; default: Lay_WrongScopeExit (); break; } /***** Get number of games *****/ row = mysql_fetch_row (mysql_res); if (sscanf (row[0],"%u",&NumCourses) != 1) Lay_ShowErrorAndExit ("Error when getting number of courses with games."); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return NumCourses; } /*****************************************************************************/ /**************************** Get number of games ****************************/ /*****************************************************************************/ // Returns the number of games in this location unsigned Gam_GetNumGames (Hie_Level_t Scope) { MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned NumGames; /***** Get number of games from database *****/ switch (Scope) { case Hie_SYS: DB_QuerySELECT (&mysql_res,"can not get number of games", "SELECT COUNT(*)" " FROM games" " WHERE Scope='%s'", Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_CTY: DB_QuerySELECT (&mysql_res,"can not get number of games", "SELECT COUNT(*)" " FROM institutions,centres,degrees,courses,games" " WHERE institutions.CtyCod=%ld" " AND institutions.InsCod=centres.InsCod" " AND centres.CtrCod=degrees.CtrCod" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'", Gbl.Hierarchy.Cty.CtyCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_INS: DB_QuerySELECT (&mysql_res,"can not get number of games", "SELECT COUNT(*)" " FROM centres,degrees,courses,games" " WHERE centres.InsCod=%ld" " AND centres.CtrCod=degrees.CtrCod" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'", Gbl.Hierarchy.Ins.InsCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_CTR: DB_QuerySELECT (&mysql_res,"can not get number of games", "SELECT COUNT(*)" " FROM degrees,courses,games" " WHERE degrees.CtrCod=%ld" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'", Gbl.Hierarchy.Ctr.CtrCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_DEG: DB_QuerySELECT (&mysql_res,"can not get number of games", "SELECT COUNT(*)" " FROM courses,games" " WHERE courses.DegCod=%ld" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'", Gbl.Hierarchy.Deg.DegCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_CRS: DB_QuerySELECT (&mysql_res,"can not get number of games", "SELECT COUNT(*)" " FROM games" " WHERE games.Scope='%s'" " AND CrsCod=%ld", Sco_GetDBStrFromScope (Hie_CRS), Gbl.Hierarchy.Crs.CrsCod); break; default: Lay_WrongScopeExit (); break; } /***** Get number of games *****/ row = mysql_fetch_row (mysql_res); if (sscanf (row[0],"%u",&NumGames) != 1) Lay_ShowErrorAndExit ("Error when getting number of games."); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return NumGames; } /*****************************************************************************/ /************* Get average number of questions per course game ***************/ /*****************************************************************************/ float Gam_GetNumQstsPerCrsGame (Hie_Level_t Scope) { MYSQL_RES *mysql_res; MYSQL_ROW row; float NumQstsPerGame; /***** Get number of questions per game from database *****/ switch (Scope) { case Hie_SYS: DB_QuerySELECT (&mysql_res,"can not get number of questions per game", "SELECT AVG(NumQsts) FROM" " (SELECT COUNT(gam_questions.QstCod) AS NumQsts" " FROM games,gam_questions" " WHERE games.Scope='%s'" " AND games.GamCod=gam_questions.GamCod" " GROUP BY gam_questions.GamCod) AS NumQstsTable", Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_CTY: DB_QuerySELECT (&mysql_res,"can not get number of questions per game", "SELECT AVG(NumQsts) FROM" " (SELECT COUNT(gam_questions.QstCod) AS NumQsts" " FROM institutions,centres,degrees,courses,games,gam_questions" " WHERE institutions.CtyCod=%ld" " AND institutions.InsCod=centres.InsCod" " AND centres.CtrCod=degrees.CtrCod" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'" " AND games.GamCod=gam_questions.GamCod" " GROUP BY gam_questions.GamCod) AS NumQstsTable", Gbl.Hierarchy.Cty.CtyCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_INS: DB_QuerySELECT (&mysql_res,"can not get number of questions per game", "SELECT AVG(NumQsts) FROM" " (SELECT COUNT(gam_questions.QstCod) AS NumQsts" " FROM centres,degrees,courses,games,gam_questions" " WHERE centres.InsCod=%ld" " AND centres.CtrCod=degrees.CtrCod" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'" " AND games.GamCod=gam_questions.GamCod" " GROUP BY gam_questions.GamCod) AS NumQstsTable", Gbl.Hierarchy.Ins.InsCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_CTR: DB_QuerySELECT (&mysql_res,"can not get number of questions per game", "SELECT AVG(NumQsts) FROM" " (SELECT COUNT(gam_questions.QstCod) AS NumQsts" " FROM degrees,courses,games,gam_questions" " WHERE degrees.CtrCod=%ld" " AND degrees.DegCod=courses.DegCod" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'" " AND games.GamCod=gam_questions.GamCod" " GROUP BY gam_questions.GamCod) AS NumQstsTable", Gbl.Hierarchy.Ctr.CtrCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_DEG: DB_QuerySELECT (&mysql_res,"can not get number of questions per game", "SELECT AVG(NumQsts) FROM" " (SELECT COUNT(gam_questions.QstCod) AS NumQsts" " FROM courses,games,gam_questions" " WHERE courses.DegCod=%ld" " AND courses.CrsCod=games.Cod" " AND games.Scope='%s'" " AND games.GamCod=gam_questions.GamCod" " GROUP BY gam_questions.GamCod) AS NumQstsTable", Gbl.Hierarchy.Deg.DegCod, Sco_GetDBStrFromScope (Hie_CRS)); break; case Hie_CRS: DB_QuerySELECT (&mysql_res,"can not get number of questions per game", "SELECT AVG(NumQsts) FROM" " (SELECT COUNT(gam_questions.QstCod) AS NumQsts" " FROM games,gam_questions" " WHERE games.Scope='%s' AND games.Cod=%ld" " AND games.GamCod=gam_questions.GamCod" " GROUP BY gam_questions.GamCod) AS NumQstsTable", Sco_GetDBStrFromScope (Hie_CRS),Gbl.Hierarchy.Crs.CrsCod); break; default: Lay_WrongScopeExit (); break; } /***** Get number of courses *****/ row = mysql_fetch_row (mysql_res); NumQstsPerGame = Str_GetFloatNumFromStr (row[0]); /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return NumQstsPerGame; }