2016-11-16 23:19:52 +01:00
|
|
|
|
// swad_notification.h: notifications about events, sent by email
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
|
|
|
|
#ifndef _SWAD_NTF
|
|
|
|
|
#define _SWAD_NTF
|
|
|
|
|
/*
|
|
|
|
|
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.
|
2017-01-13 01:51:23 +01:00
|
|
|
|
Copyright (C) 1999-2017 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 constants *****************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2017-03-08 14:12:33 +01:00
|
|
|
|
#define Ntf_MAX_BYTES_NOTIFY_EVENT (32 - 1) // 31
|
2017-01-15 18:02:52 +01:00
|
|
|
|
|
2017-03-08 14:12:33 +01:00
|
|
|
|
#define Ntf_MAX_CHARS_NOTIFY_LOCATION (128 - 1) // 127
|
|
|
|
|
#define Ntf_MAX_BYTES_NOTIFY_LOCATION (2048 + (Ntf_MAX_CHARS_NOTIFY_LOCATION + 1) * Str_MAX_BYTES_PER_CHAR - 1) // 4095
|
|
|
|
|
|
|
|
|
|
#define Ntf_MAX_CHARS_SUMMARY (256 - 1) // 255
|
|
|
|
|
#define Ntf_MAX_BYTES_SUMMARY ((Ntf_MAX_CHARS_SUMMARY + 1) * Str_MAX_BYTES_PER_CHAR - 1) // 4095
|
2017-01-15 18:02:52 +01:00
|
|
|
|
|
2014-12-01 23:55:08 +01:00
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/******************************** Public types *******************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2017-01-15 18:02:52 +01:00
|
|
|
|
#define Ntf_NUM_NOTIFY_EVENTS (1 + 19)
|
2014-12-01 23:55:08 +01:00
|
|
|
|
// If the numbers assigned to each event type change,
|
2016-04-22 09:47:25 +02:00
|
|
|
|
// it is necessary to change old numbers to new ones
|
|
|
|
|
// in database tables notif, sta_notif and usr_data
|
2014-12-01 23:55:08 +01:00
|
|
|
|
typedef enum
|
|
|
|
|
{
|
2016-01-23 19:11:07 +01:00
|
|
|
|
Ntf_EVENT_UNKNOWN = 0,
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
|
|
|
|
/* Course tab */
|
|
|
|
|
|
|
|
|
|
/* Assessment tab */
|
2017-03-30 11:20:06 +02:00
|
|
|
|
Ntf_EVENT_ASSIGNMENT = 4,
|
2017-04-27 10:15:07 +02:00
|
|
|
|
Ntf_EVENT_SURVEY = 19, // TODO: Change numbers (also in database)!!!!!!!!!!!!!!
|
2017-04-27 10:54:45 +02:00
|
|
|
|
Ntf_EVENT_EXAM_ANNOUNCEMENT = 5,
|
2017-04-27 10:15:07 +02:00
|
|
|
|
|
|
|
|
|
/* Files tab */
|
|
|
|
|
Ntf_EVENT_DOCUMENT_FILE = 1, // TODO: Change numbers (also in database)!!!!!!!!!!!!!!
|
|
|
|
|
Ntf_EVENT_TEACHERS_FILE = 2, // TODO: Change numbers (also in database)!!!!!!!!!!!!!!
|
|
|
|
|
Ntf_EVENT_SHARED_FILE = 3, // TODO: Change numbers (also in database)!!!!!!!!!!!!!!
|
2017-04-27 10:54:45 +02:00
|
|
|
|
Ntf_EVENT_MARKS_FILE = 6, // TODO: Change numbers (also in database)!!!!!!!!!!!!!!
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
2015-12-29 10:38:46 +01:00
|
|
|
|
/* Users tab */
|
2017-03-30 11:20:06 +02:00
|
|
|
|
Ntf_EVENT_ENROLMENT_STUDENT = 7,
|
|
|
|
|
Ntf_EVENT_ENROLMENT_TEACHER = 8,
|
|
|
|
|
Ntf_EVENT_ENROLMENT_REQUEST = 9,
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
2015-12-30 20:11:50 +01:00
|
|
|
|
/* Social tab */
|
2017-03-30 11:20:06 +02:00
|
|
|
|
Ntf_EVENT_TIMELINE_COMMENT = 10, // New comment to one of my social publishings (notes or comments)
|
|
|
|
|
Ntf_EVENT_TIMELINE_FAV = 11, // New fav of one of my social publishings (notes or comments)
|
|
|
|
|
Ntf_EVENT_TIMELINE_SHARE = 12, // New sharing of one of my social notes
|
|
|
|
|
Ntf_EVENT_TIMELINE_MENTION = 13, // New mention
|
|
|
|
|
Ntf_EVENT_FOLLOWER = 14,
|
|
|
|
|
Ntf_EVENT_FORUM_POST_COURSE = 15, // New post in forums of my courses
|
|
|
|
|
Ntf_EVENT_FORUM_REPLY = 16, // New reply to one of my posts in any forum
|
2015-12-30 20:11:50 +01:00
|
|
|
|
|
2014-12-01 23:55:08 +01:00
|
|
|
|
/* Messages tab */
|
2017-03-30 11:20:06 +02:00
|
|
|
|
Ntf_EVENT_NOTICE = 17,
|
|
|
|
|
Ntf_EVENT_MESSAGE = 18,
|
2014-12-01 23:55:08 +01:00
|
|
|
|
|
|
|
|
|
/* Statistics tab */
|
|
|
|
|
|
2015-12-30 20:11:50 +01:00
|
|
|
|
/* Profile tab */
|
2015-03-24 00:01:40 +01:00
|
|
|
|
|
2014-12-01 23:55:08 +01:00
|
|
|
|
} Ntf_NotifyEvent_t;
|
|
|
|
|
|
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
Ntf_STATUS_BIT_EMAIL = (1 << 0), // User want to receive notification by email
|
|
|
|
|
Ntf_STATUS_BIT_SENT = (1 << 1), // Email has been sent
|
|
|
|
|
Ntf_STATUS_BIT_READ = (1 << 2), // User has seen the event which caused the notification
|
|
|
|
|
Ntf_STATUS_BIT_REMOVED = (1 << 3), // The event which caused the notification has been removed
|
|
|
|
|
} Ntf_Status_Bits_t;
|
|
|
|
|
typedef unsigned Ntf_Status_t;
|
|
|
|
|
|
|
|
|
|
#define Ntf_NUM_STATUS_TXT 4
|
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
Ntf_STATUS_NO_EMAIL = 0, // ---0 !(Status & Ntf_STATUS_BIT_EMAIL)
|
|
|
|
|
Ntf_STATUS_EMAIL_PENDING = 1, // 0001 (Status & Ntf_STATUS_BIT_EMAIL) && !(Status & Ntf_STATUS_BIT_SENT) && !(Status & (Ntf_STATUS_BIT_READ | Ntf_STATUS_BIT_REMOVED))
|
|
|
|
|
Ntf_STATUS_EMAIL_CANCELLED = 2, // XX01 (Status & Ntf_STATUS_BIT_EMAIL) && !(Status & Ntf_STATUS_BIT_SENT) && (Status & (Ntf_STATUS_BIT_READ | Ntf_STATUS_BIT_REMOVED))
|
|
|
|
|
Ntf_STATUS_EMAIL_SENT = 3, // --11 (Status & Ntf_STATUS_BIT_EMAIL) && (Status & Ntf_STATUS_BIT_SENT)
|
|
|
|
|
} Ntf_StatusTxt_t;
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/****************************** Public prototypes ****************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
void Ntf_ShowMyNotifications (void);
|
2016-01-25 14:40:57 +01:00
|
|
|
|
|
|
|
|
|
Ntf_NotifyEvent_t Ntf_GetParamNotifyEvent (void);
|
|
|
|
|
|
2014-12-01 23:55:08 +01:00
|
|
|
|
Ntf_StatusTxt_t Ntf_GetStatusTxtFromStatusBits (Ntf_Status_t Status);
|
2017-03-08 14:12:33 +01:00
|
|
|
|
void Ntf_GetNotifSummaryAndContent (char SummaryStr[Ntf_MAX_BYTES_SUMMARY + 1],
|
2017-01-13 10:49:56 +01:00
|
|
|
|
char **ContentStr,
|
2016-01-22 12:05:25 +01:00
|
|
|
|
Ntf_NotifyEvent_t NotifyEvent,
|
|
|
|
|
long Cod,long CrsCod,long UsrCod,
|
2017-03-06 13:01:16 +01:00
|
|
|
|
bool GetContent);
|
2016-01-20 21:18:38 +01:00
|
|
|
|
void Ntf_MarkNotifAsSeen (Ntf_NotifyEvent_t NotifyEvent,long Cod,long CrsCod,long ToUsrCod);
|
2016-01-04 01:56:28 +01:00
|
|
|
|
void Ntf_MarkNotifAsRemoved (Ntf_NotifyEvent_t NotifyEvent,long Cod);
|
|
|
|
|
void Ntf_MarkNotifToOneUsrAsRemoved (Ntf_NotifyEvent_t NotifyEvent,long Cod,long ToUsrCod);
|
2016-12-28 18:18:24 +01:00
|
|
|
|
void Ntf_MarkNotifInCrsAsRemoved (long ToUsrCod,long CrsCod);
|
2016-01-04 01:56:28 +01:00
|
|
|
|
void Ntf_MarkNotifOneFileAsRemoved (const char *Path);
|
|
|
|
|
void Ntf_MarkNotifChildrenOfFolderAsRemoved (const char *Path);
|
|
|
|
|
void Ntf_MarkNotifFilesInGroupAsRemoved (long GrpCod);
|
2014-12-01 23:55:08 +01:00
|
|
|
|
unsigned Ntf_StoreNotifyEventsToAllUsrs (Ntf_NotifyEvent_t NotifyEvent,long Cod);
|
|
|
|
|
void Ntf_StoreNotifyEventToOneUser (Ntf_NotifyEvent_t NotifyEvent,
|
|
|
|
|
struct UsrData *UsrDat,
|
|
|
|
|
long Cod,Ntf_Status_t Status);
|
|
|
|
|
void Ntf_SendPendingNotifByEMailToAllUsrs (void);
|
|
|
|
|
Ntf_NotifyEvent_t Ntf_GetNotifyEventFromDB (const char *Str);
|
|
|
|
|
void Ntf_ShowAlertNumUsrsToBeNotifiedByEMail (unsigned NumUsrsToBeNotifiedByEMail);
|
|
|
|
|
void Ntf_MarkAllNotifAsSeen (void);
|
|
|
|
|
void Ntf_PutFormChangeNotifSentByEMail (void);
|
|
|
|
|
void Ntf_ChangeNotifyEvents (void);
|
|
|
|
|
|
|
|
|
|
void Ntf_WriteNumberOfNewNtfs (void);
|
|
|
|
|
void Ntf_RemoveUsrNtfs (long ToUsrCod);
|
|
|
|
|
|
|
|
|
|
#endif
|