2021-09-27 20:42:48 +02:00
|
|
|
|
// swad_message_database.h: messages between users, operations with database
|
|
|
|
|
|
|
|
|
|
#ifndef _SWAD_MSG_DB
|
|
|
|
|
#define _SWAD_MSG_DB
|
|
|
|
|
/*
|
|
|
|
|
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.
|
|
|
|
|
Copyright (C) 1999-2021 Antonio Ca<EFBFBD>as Vargas
|
|
|
|
|
|
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
|
|
|
it under the terms of the GNU Affero General Public License as
|
|
|
|
|
published by the Free Software Foundation, either version 3 of the
|
|
|
|
|
License, or (at your option) any later version.
|
|
|
|
|
|
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
GNU Affero General Public License for more details.
|
|
|
|
|
|
|
|
|
|
You should have received a copy of the GNU Affero General Public License
|
|
|
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
*/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/********************************** Headers **********************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
#include <mysql/mysql.h> // To access MySQL databases
|
|
|
|
|
|
2021-09-27 23:59:50 +02:00
|
|
|
|
#include "swad_hierarchy_level.h"
|
2021-09-27 20:42:48 +02:00
|
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/****************************** Public constants *****************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2021-09-29 18:41:25 +02:00
|
|
|
|
#define Msg_DB_MAX_BYTES_MESSAGES_QUERY (4 * 1024 - 1)
|
2021-09-27 20:42:48 +02:00
|
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/******************************** Public types *******************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/****************************** Public prototypes ****************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2021-09-27 23:59:50 +02:00
|
|
|
|
long Msg_DB_CreateNewMsg (const char *Subject,const char *Content,long MedCod);
|
|
|
|
|
void Msg_DB_CreateSntMsg (long MsgCod);
|
|
|
|
|
void Msg_DB_CreateRcvMsg (long MsgCod,long UsrCod,bool NotifyByEmail);
|
|
|
|
|
void Msg_DB_SetRcvMsgAsReplied (long MsgCod);
|
2021-09-27 20:42:48 +02:00
|
|
|
|
void Msg_DB_ExpandSntMsg (long MsgCod);
|
|
|
|
|
void Msg_DB_ExpandRcvMsg (long MsgCod);
|
|
|
|
|
void Msg_DB_ContractSntMsg (long MsgCod);
|
|
|
|
|
void Msg_DB_ContractRcvMsg (long MsgCod);
|
2021-09-27 23:59:50 +02:00
|
|
|
|
void Msg_DB_SetRcvMsgAsOpen (long MsgCod,long UsrCod);
|
2021-09-30 23:17:10 +02:00
|
|
|
|
void Msg_DB_CopyRcvMsgToDeleted (long MsgCod,long UsrCod);
|
|
|
|
|
void Msg_DB_CopySntMsgToDeleted (long MsgCod);
|
2021-09-27 20:42:48 +02:00
|
|
|
|
|
2021-09-29 14:40:42 +02:00
|
|
|
|
unsigned Msg_DB_GetDistinctCrssInMyRcvMsgs (MYSQL_RES **mysql_res);
|
|
|
|
|
unsigned Msg_DB_GetDistinctCrssInMySntMsgs (MYSQL_RES **mysql_res);
|
2021-09-27 20:42:48 +02:00
|
|
|
|
void Msg_DB_MakeFilterFromToSubquery (const struct Msg_Messages *Messages,
|
2021-09-29 18:41:25 +02:00
|
|
|
|
char FilterFromToSubquery[Msg_DB_MAX_BYTES_MESSAGES_QUERY + 1]);
|
|
|
|
|
unsigned Msg_DB_GetNumUnreadMsgs (const struct Msg_Messages *Messages,
|
|
|
|
|
const char FilterFromToSubquery[Msg_DB_MAX_BYTES_MESSAGES_QUERY + 1]);
|
2021-09-27 20:42:48 +02:00
|
|
|
|
unsigned Msg_DB_GetSntOrRcvMsgs (MYSQL_RES **mysql_res,
|
|
|
|
|
const struct Msg_Messages *Messages,
|
|
|
|
|
long UsrCod,
|
2021-09-29 18:41:25 +02:00
|
|
|
|
const char FilterFromToSubquery[Msg_DB_MAX_BYTES_MESSAGES_QUERY + 1]);
|
2021-09-27 20:42:48 +02:00
|
|
|
|
unsigned Msg_DB_GetSubjectAndContent (MYSQL_RES **mysql_res,long MsgCod);
|
|
|
|
|
void Msg_DB_GetMsgSubject (long MsgCod,char Subject[Cns_MAX_BYTES_SUBJECT + 1]);
|
2021-09-29 14:40:42 +02:00
|
|
|
|
unsigned Msg_DB_GetMsgContent (MYSQL_RES **mysql_res,long MsgCod);
|
|
|
|
|
unsigned Msg_DB_GetMsgSntData (MYSQL_RES **mysql_res,long MsgCod,bool *Deleted);
|
2021-09-27 20:42:48 +02:00
|
|
|
|
bool Msg_DB_GetStatusOfSntMsg (long MsgCod);
|
|
|
|
|
void Msg_DB_GetStatusOfRcvMsg (long MsgCod,
|
|
|
|
|
bool *Open,bool *Replied,bool *Expanded);
|
2021-09-27 23:59:50 +02:00
|
|
|
|
bool Msg_DB_CheckIfSntMsgIsDeleted (long MsgCod);
|
|
|
|
|
bool Msg_DB_CheckIfRcvMsgIsDeletedForAllItsRecipients (long MsgCod);
|
2021-09-29 14:40:42 +02:00
|
|
|
|
unsigned Msg_DB_GetNumRecipients (long MsgCod);
|
|
|
|
|
unsigned Msg_DB_GetKnownRecipients (MYSQL_RES **mysql_res,long MsgCod);
|
2021-09-27 23:59:50 +02:00
|
|
|
|
unsigned Msg_DB_GetNumSntMsgs (HieLvl_Level_t Scope,Msg_Status_t MsgStatus);
|
|
|
|
|
unsigned Msg_DB_GetNumRcvMsgs (HieLvl_Level_t Scope,Msg_Status_t MsgStatus);
|
|
|
|
|
unsigned Msg_DB_GetNumMsgsSentByTchsCrs (long CrsCod);
|
|
|
|
|
unsigned Msg_DB_GetNumMsgsSentByUsr (long UsrCod);
|
|
|
|
|
|
|
|
|
|
void Msg_DB_RemoveRcvMsg (long MsgCod,long UsrCod);
|
|
|
|
|
void Msg_DB_RemoveSntMsg (long MsgCod);
|
|
|
|
|
void Msg_DB_RemoveAllRecAndSntMsgsUsr (long UsrCod);
|
2021-09-29 18:41:25 +02:00
|
|
|
|
void Msg_DB_MoveMsgContentToDeleted (long MsgCod);
|
2021-09-27 23:59:50 +02:00
|
|
|
|
void Msg_DB_MoveUnusedMsgsContentToDeleted (void);
|
|
|
|
|
|
|
|
|
|
//--------------------------- Users banned ------------------------------------
|
2021-09-29 14:40:42 +02:00
|
|
|
|
void Msg_DB_CreateUsrsPairIntoBanned (long FromUsrCod,long ToUsrCod);
|
|
|
|
|
unsigned Msg_DB_GetNumUsrsBannedBy (long UsrCod);
|
|
|
|
|
unsigned Msg_DB_GetUsrsBannedBy (MYSQL_RES **mysql_res,long UsrCod);
|
2021-09-27 23:59:50 +02:00
|
|
|
|
bool Msg_DB_CheckIfUsrIsBanned (long FromUsrCod,long ToUsrCod);
|
|
|
|
|
|
2021-09-29 14:40:42 +02:00
|
|
|
|
void Msg_DB_RemoveUsrsPairFromBanned (long FromUsrCod,long ToUsrCod);
|
2021-09-27 23:59:50 +02:00
|
|
|
|
void Msg_DB_RemoveUsrFromBanned (long UsrCod);
|
2021-09-27 20:42:48 +02:00
|
|
|
|
|
|
|
|
|
#endif
|