2014-12-01 23:55:08 +01:00
|
|
|
|
// swad_statistic.h: statistics
|
|
|
|
|
|
|
|
|
|
#ifndef _SWAD_STA
|
|
|
|
|
#define _SWAD_STA
|
|
|
|
|
/*
|
|
|
|
|
SWAD (Shared Workspace At a Distance in Spanish),
|
|
|
|
|
is a web platform developed at the University of Granada (Spain),
|
|
|
|
|
and used to support university teaching.
|
|
|
|
|
|
|
|
|
|
This file is part of SWAD core.
|
2019-01-07 21:52:19 +01:00
|
|
|
|
Copyright (C) 1999-2019 Antonio Ca<EFBFBD>as Vargas
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
|
|
|
it under the terms of the GNU Affero General Public License as
|
|
|
|
|
published by the Free Software Foundation, either version 3 of the
|
|
|
|
|
License, or (at your option) any later version.
|
|
|
|
|
|
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
GNU Affero General Public License for more details.
|
|
|
|
|
|
|
|
|
|
You should have received a copy of the GNU Affero General Public License
|
|
|
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
*/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/********************************* Headers ***********************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
#include "swad_user.h"
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/************************** Public types and constants ***********************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2017-05-22 20:37:46 +02:00
|
|
|
|
#define Sta_NUM_ROLES_STAT 12
|
2014-12-01 23:55:08 +01:00
|
|
|
|
typedef enum
|
|
|
|
|
{
|
2017-05-23 18:15:59 +02:00
|
|
|
|
Sta_ROLE_IDENTIFIED_USRS = 0,
|
|
|
|
|
Sta_ROLE_ALL_USRS = 1,
|
|
|
|
|
Sta_ROLE_INS_ADMINS = 2,
|
|
|
|
|
Sta_ROLE_CTR_ADMINS = 3,
|
|
|
|
|
Sta_ROLE_DEG_ADMINS = 4,
|
|
|
|
|
Sta_ROLE_TEACHERS = 5,
|
|
|
|
|
Sta_ROLE_NON_EDITING_TEACHERS = 6,
|
|
|
|
|
Sta_ROLE_STUDENTS = 7,
|
|
|
|
|
Sta_ROLE_USERS = 8,
|
|
|
|
|
Sta_ROLE_GUESTS = 9,
|
|
|
|
|
Sta_ROLE_UNKNOWN_USRS = 10,
|
|
|
|
|
Sta_ROLE_ME = 11,
|
2014-12-01 23:55:08 +01:00
|
|
|
|
} Sta_Role_t;
|
2017-05-23 18:15:59 +02:00
|
|
|
|
#define Sta_ROLE_DEFAULT Sta_ROLE_IDENTIFIED_USRS
|
2017-01-29 21:41:08 +01:00
|
|
|
|
|
|
|
|
|
#define Sta_NUM_ACTION_DEFAULT ActAll
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
2015-09-25 01:48:00 +02:00
|
|
|
|
#define Sta_NUM_COUNT_TYPES 5
|
2014-12-01 23:55:08 +01:00
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
Sta_TOTAL_CLICKS = 0,
|
|
|
|
|
Sta_DISTINCT_USRS = 1,
|
|
|
|
|
Sta_CLICKS_PER_USR = 2,
|
|
|
|
|
Sta_GENERATION_TIME = 3,
|
|
|
|
|
Sta_SEND_TIME = 4,
|
|
|
|
|
} Sta_CountType_t;
|
2017-01-29 21:41:08 +01:00
|
|
|
|
#define Sta_COUNT_TYPE_DEFAULT Sta_TOTAL_CLICKS
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
2015-09-25 01:48:00 +02:00
|
|
|
|
#define Sta_NUM_CLICKS_DETAILED_OR_GROUPED 2
|
2014-12-01 23:55:08 +01:00
|
|
|
|
typedef enum
|
|
|
|
|
{
|
2015-09-25 01:48:00 +02:00
|
|
|
|
Sta_CLICKS_DETAILED = 0,
|
|
|
|
|
Sta_CLICKS_GROUPED = 1,
|
|
|
|
|
} Sta_ClicksDetailedOrGrouped_t;
|
2017-01-29 21:41:08 +01:00
|
|
|
|
#define Sta_CLICKS_DETAILED_OR_GROUPED_DEFAULT Sta_CLICKS_GROUPED
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
2018-10-07 14:01:25 +02:00
|
|
|
|
#define Sta_NUM_CLICKS_GROUPED_BY 26
|
2015-09-25 01:48:00 +02:00
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
Sta_CLICKS_CRS_DETAILED_LIST = 0,
|
|
|
|
|
|
|
|
|
|
Sta_CLICKS_CRS_PER_USR = 1,
|
2018-10-07 14:01:25 +02:00
|
|
|
|
Sta_CLICKS_CRS_PER_DAY = 2,
|
|
|
|
|
Sta_CLICKS_CRS_PER_DAY_AND_HOUR = 3,
|
|
|
|
|
Sta_CLICKS_CRS_PER_WEEK = 4,
|
|
|
|
|
Sta_CLICKS_CRS_PER_MONTH = 5,
|
|
|
|
|
Sta_CLICKS_CRS_PER_YEAR = 6,
|
|
|
|
|
Sta_CLICKS_CRS_PER_HOUR = 7,
|
|
|
|
|
Sta_CLICKS_CRS_PER_MINUTE = 8,
|
|
|
|
|
Sta_CLICKS_CRS_PER_ACTION = 9,
|
2015-09-25 01:48:00 +02:00
|
|
|
|
|
2018-10-07 14:01:25 +02:00
|
|
|
|
Sta_CLICKS_GBL_PER_DAY = 10,
|
|
|
|
|
Sta_CLICKS_GBL_PER_DAY_AND_HOUR = 11,
|
|
|
|
|
Sta_CLICKS_GBL_PER_WEEK = 12,
|
|
|
|
|
Sta_CLICKS_GBL_PER_MONTH = 13,
|
|
|
|
|
Sta_CLICKS_GBL_PER_YEAR = 14,
|
|
|
|
|
Sta_CLICKS_GBL_PER_HOUR = 15,
|
|
|
|
|
Sta_CLICKS_GBL_PER_MINUTE = 16,
|
|
|
|
|
Sta_CLICKS_GBL_PER_ACTION = 17,
|
|
|
|
|
Sta_CLICKS_GBL_PER_PLUGIN = 18,
|
|
|
|
|
Sta_CLICKS_GBL_PER_API_FUNCTION = 19,
|
|
|
|
|
Sta_CLICKS_GBL_PER_BANNER = 20,
|
|
|
|
|
Sta_CLICKS_GBL_PER_COUNTRY = 21,
|
|
|
|
|
Sta_CLICKS_GBL_PER_INSTITUTION = 22,
|
|
|
|
|
Sta_CLICKS_GBL_PER_CENTRE = 23,
|
|
|
|
|
Sta_CLICKS_GBL_PER_DEGREE = 24,
|
|
|
|
|
Sta_CLICKS_GBL_PER_COURSE = 25,
|
2015-09-25 01:48:00 +02:00
|
|
|
|
} Sta_ClicksGroupedBy_t;
|
2017-01-29 21:41:08 +01:00
|
|
|
|
#define Sta_CLICKS_GROUPED_BY_DEFAULT Sta_CLICKS_CRS_PER_USR
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
2017-01-29 21:41:08 +01:00
|
|
|
|
#define Sta_MIN_ROWS_PER_PAGE 10
|
|
|
|
|
#define Sta_MAX_ROWS_PER_PAGE (Sta_MIN_ROWS_PER_PAGE * 10000)
|
|
|
|
|
#define Sta_DEF_ROWS_PER_PAGE (Sta_MIN_ROWS_PER_PAGE * 5)
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
|
|
|
|
#define Sta_NUM_COLOR_TYPES 3
|
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
Sta_COLOR,
|
|
|
|
|
Sta_BLACK_TO_WHITE,
|
|
|
|
|
Sta_WHITE_TO_BLACK,
|
|
|
|
|
} Sta_ColorType_t;
|
2017-01-29 21:41:08 +01:00
|
|
|
|
#define Sta_COLOR_TYPE_DEF Sta_COLOR
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
2016-09-12 00:50:24 +02:00
|
|
|
|
struct Sta_Hits
|
|
|
|
|
{
|
2019-11-11 00:15:44 +01:00
|
|
|
|
double Num;
|
|
|
|
|
double Max;
|
|
|
|
|
double Total;
|
2016-09-12 00:50:24 +02:00
|
|
|
|
};
|
|
|
|
|
|
2014-12-01 23:55:08 +01:00
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/***************************** Public prototypes *****************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
void Sta_GetRemoteAddr (void);
|
|
|
|
|
void Sta_LogAccess (const char *Comments);
|
|
|
|
|
void Sta_RemoveOldEntriesRecentLog (void);
|
2015-10-11 17:40:07 +02:00
|
|
|
|
void Sta_AskShowCrsHits (void);
|
|
|
|
|
void Sta_AskShowGblHits (void);
|
2014-12-01 23:55:08 +01:00
|
|
|
|
void Sta_SetIniEndDates (void);
|
|
|
|
|
void Sta_SeeGblAccesses (void);
|
2015-09-30 23:26:48 +02:00
|
|
|
|
void Sta_SeeCrsAccesses (void);
|
2016-09-12 00:50:24 +02:00
|
|
|
|
|
|
|
|
|
void Sta_ComputeMaxAndTotalHits (struct Sta_Hits *Hits,
|
|
|
|
|
unsigned long NumRows,
|
|
|
|
|
MYSQL_RES *mysql_res,unsigned Field,
|
|
|
|
|
unsigned Divisor);
|
|
|
|
|
|
2014-12-01 23:55:08 +01:00
|
|
|
|
void Sta_ComputeTimeToGeneratePage (void);
|
|
|
|
|
void Sta_ComputeTimeToSendPage (void);
|
|
|
|
|
void Sta_WriteTimeToGenerateAndSendPage (void);
|
2018-10-18 02:02:32 +02:00
|
|
|
|
void Sta_WriteTime (char Str[Dat_MAX_BYTES_TIME],long TimeInMicroseconds);
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
2019-02-12 14:46:14 +01:00
|
|
|
|
void Sta_PutLinkToLastClicks (void);
|
2019-01-11 12:32:41 +01:00
|
|
|
|
void Sta_ShowLastClicks (void);
|
|
|
|
|
void Sta_GetAndShowLastClicks (void);
|
|
|
|
|
|
2014-12-01 23:55:08 +01:00
|
|
|
|
#endif
|