2021-02-26 22:20:03 +01:00
|
|
|
|
// swad_timeline_database.h: social timeline operations with database
|
|
|
|
|
|
|
|
|
|
#ifndef _SWAD_TL_DB
|
|
|
|
|
#define _SWAD_TL_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 "swad_database.h"
|
2021-02-27 14:39:16 +01:00
|
|
|
|
#include "swad_file_browser.h"
|
2021-02-28 21:55:33 +01:00
|
|
|
|
#include "swad_timeline_comment.h"
|
2021-03-01 10:42:59 +01:00
|
|
|
|
#include "swad_timeline_favourite.h"
|
2021-02-27 14:12:41 +01:00
|
|
|
|
#include "swad_timeline_note.h"
|
2021-02-26 23:13:06 +01:00
|
|
|
|
#include "swad_timeline_post.h"
|
2021-02-27 22:13:05 +01:00
|
|
|
|
#include "swad_timeline_publication.h"
|
2021-02-26 22:20:03 +01:00
|
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/****************************** Public constants *****************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/******************************** Public types *******************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/****************************** Public prototypes ****************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2021-03-01 16:54:18 +01:00
|
|
|
|
/****************************** Timeline from who ****************************/
|
|
|
|
|
unsigned TL_DB_GetWho (MYSQL_RES **mysql_res);
|
2021-03-01 16:58:32 +01:00
|
|
|
|
void TL_DB_UpdateWho (Usr_Who_t Who);
|
2021-03-01 16:54:18 +01:00
|
|
|
|
|
2021-02-28 21:24:49 +01:00
|
|
|
|
/*********************************** Notes ***********************************/
|
2021-02-27 16:45:29 +01:00
|
|
|
|
unsigned TL_DB_GetDataOfNoteByCod (long NotCod,MYSQL_RES **mysql_res);
|
|
|
|
|
long TL_DB_GetPubCodOfOriginalNote (long NotCod);
|
2021-02-27 14:12:41 +01:00
|
|
|
|
long TL_DB_CreateNewNote (TL_Not_NoteType_t NoteType,long Cod,
|
|
|
|
|
long PublisherCod,long HieCod);
|
2021-02-27 14:25:17 +01:00
|
|
|
|
void TL_DB_MarkNoteAsUnavailable (TL_Not_NoteType_t NoteType,long Cod);
|
2021-02-27 14:39:16 +01:00
|
|
|
|
void TL_DB_MarkNotesChildrenOfFolderAsUnavailable (TL_Not_NoteType_t NoteType,
|
|
|
|
|
Brw_FileBrowser_t FileBrowser,
|
|
|
|
|
long Cod,
|
|
|
|
|
const char *Path);
|
2021-02-27 17:23:22 +01:00
|
|
|
|
void TL_DB_CreateTmpTableJustRetrievedNotes (void);
|
2021-02-28 21:12:44 +01:00
|
|
|
|
void TL_DB_CreateTmpTableVisibleTimeline (void);
|
2021-02-27 14:12:41 +01:00
|
|
|
|
void TL_DB_InsertNoteInJustRetrievedNotes (long NotCod);
|
|
|
|
|
void TL_DB_InsertNoteInVisibleTimeline (long NotCod);
|
2021-02-28 21:12:44 +01:00
|
|
|
|
void TL_DB_AddNotesJustRetrievedToVisibleTimelineOfSession (void);
|
2021-02-27 17:23:22 +01:00
|
|
|
|
void TL_DB_DropTmpTableJustRetrievedNotes (void);
|
|
|
|
|
void TL_DB_DropTmpTableVisibleTimeline (void);
|
|
|
|
|
void TL_DB_ClearOldTimelinesNotesFromDB (void);
|
2021-02-28 21:12:44 +01:00
|
|
|
|
void TL_DB_ClearTimelineNotesOfSessionFromDB (void);
|
2021-02-27 16:16:46 +01:00
|
|
|
|
void TL_DB_RemoveNoteFavs (long NotCod);
|
|
|
|
|
void TL_DB_RemoveNotePubs (long NotCod);
|
2021-02-28 21:12:44 +01:00
|
|
|
|
void TL_DB_RemoveNote (long NotCod);
|
2021-03-01 13:56:58 +01:00
|
|
|
|
void TL_DB_RemoveAllNotesUsr (long UsrCod);
|
2021-02-27 14:12:41 +01:00
|
|
|
|
|
2021-03-01 16:54:18 +01:00
|
|
|
|
/********************************* Posts *************************************/
|
2021-02-27 19:14:11 +01:00
|
|
|
|
unsigned TL_DB_GetPostByCod (long PstCod,MYSQL_RES **mysql_res);
|
2021-02-27 15:09:23 +01:00
|
|
|
|
long TL_DB_GetMedCodFromPost (long PubCod);
|
2021-03-03 21:36:16 +01:00
|
|
|
|
long TL_DB_CreateNewPost (const struct TL_Pst_Content *Content);
|
2021-02-27 16:16:46 +01:00
|
|
|
|
void TL_DB_RemovePost (long PstCod);
|
2021-03-01 14:06:12 +01:00
|
|
|
|
void TL_DB_RemoveAllPostsUsr (long UsrCod);
|
2021-02-27 15:09:23 +01:00
|
|
|
|
|
2021-02-28 21:24:49 +01:00
|
|
|
|
/******************************** Comments ***********************************/
|
2021-03-02 00:54:26 +01:00
|
|
|
|
unsigned TL_DB_GetNumCommsInNote (long NotCod);
|
|
|
|
|
unsigned TL_DB_GetComms (long NotCod,MYSQL_RES **mysql_res);
|
|
|
|
|
unsigned TL_DB_GetInitialComms (long NotCod,
|
|
|
|
|
unsigned NumInitialCommsToGet,
|
|
|
|
|
MYSQL_RES **mysql_res);
|
|
|
|
|
unsigned TL_DB_GetFinalComms (long NotCod,unsigned NumFinalCommsToGet,
|
|
|
|
|
MYSQL_RES **mysql_res);
|
2021-02-27 13:17:15 +01:00
|
|
|
|
unsigned TL_DB_GetDataOfCommByCod (long PubCod,MYSQL_RES **mysql_res);
|
2021-03-02 00:54:26 +01:00
|
|
|
|
void TL_DB_InsertCommContent (long PubCod,
|
2021-03-03 21:36:16 +01:00
|
|
|
|
const struct TL_Pst_Content *Content);
|
2021-03-02 00:54:26 +01:00
|
|
|
|
long TL_DB_GetMedCodFromComm (long PubCod);
|
|
|
|
|
void TL_DB_RemoveCommFavs (long PubCod);
|
|
|
|
|
void TL_DB_RemoveCommContent (long PubCod);
|
|
|
|
|
void TL_DB_RemoveCommPub (long PubCod);
|
|
|
|
|
void TL_DB_RemoveAllCommsInAllNotesOf (long UsrCod);
|
|
|
|
|
void TL_DB_RemoveAllCommsMadeBy (long UsrCod);
|
2021-02-26 22:20:03 +01:00
|
|
|
|
|
2021-02-28 21:24:49 +01:00
|
|
|
|
/****************************** Publications *********************************/
|
2021-02-28 21:12:44 +01:00
|
|
|
|
void TL_DB_CreateSubQueryPublishers (const struct TL_Timeline *Timeline,
|
|
|
|
|
struct TL_Pub_SubQueries *SubQueries);
|
|
|
|
|
void TL_DB_CreateSubQueryAlreadyExists (const struct TL_Timeline *Timeline,
|
|
|
|
|
struct TL_Pub_SubQueries *SubQueries);
|
2021-03-03 22:29:12 +01:00
|
|
|
|
void TL_DB_CreateSubQueryRangeBottom (long Bottom,struct TL_Pub_SubQueries *SubQueries);
|
|
|
|
|
void TL_DB_CreateSubQueryRangeTop (long Top,struct TL_Pub_SubQueries *SubQueries);
|
2021-02-27 22:13:05 +01:00
|
|
|
|
unsigned TL_DB_SelectTheMostRecentPub (const struct TL_Pub_SubQueries *SubQueries,
|
|
|
|
|
MYSQL_RES **mysql_res);
|
2021-03-01 13:26:59 +01:00
|
|
|
|
unsigned TL_DB_GetDataOfPubByCod (long PubCod,MYSQL_RES **mysql_res);
|
2021-02-27 22:13:05 +01:00
|
|
|
|
long TL_DB_GetNotCodFromPubCod (long PubCod);
|
2021-02-28 21:12:44 +01:00
|
|
|
|
long TL_DB_GetPubCodFromSession (const char *FieldName);
|
2021-02-28 19:59:49 +01:00
|
|
|
|
unsigned long TL_DB_GetNumPubsUsr (long UsrCod);
|
2021-02-28 19:55:04 +01:00
|
|
|
|
long TL_DB_CreateNewPub (const struct TL_Pub_Publication *Pub);
|
2021-02-28 21:12:44 +01:00
|
|
|
|
void TL_DB_UpdateFirstPubCodInSession (long FirstPubCod);
|
|
|
|
|
void TL_DB_UpdateLastPubCodInSession (void);
|
|
|
|
|
void TL_DB_UpdateFirstLastPubCodsInSession (long FirstPubCod);
|
2021-03-01 14:46:57 +01:00
|
|
|
|
void TL_DB_RemoveAllPubsPublishedByAnyUsrOfNotesAuthoredBy (long UsrCod);
|
|
|
|
|
void TL_DB_RemoveAllPubsPublishedBy (long UsrCod);
|
2021-02-27 21:23:14 +01:00
|
|
|
|
|
2021-02-28 21:24:49 +01:00
|
|
|
|
/****************************** Favourites ***********************************/
|
2021-03-03 02:15:32 +01:00
|
|
|
|
bool TL_DB_CheckIfFavedByUsr (TL_Usr_FavSha_t FavSha,long Cod,long UsrCod);
|
|
|
|
|
unsigned TL_DB_GetNumFavers (TL_Usr_FavSha_t FavSha,long Cod,long UsrCod);
|
|
|
|
|
unsigned TL_DB_GetFavers (TL_Usr_FavSha_t FavSha,
|
|
|
|
|
long Cod,long UsrCod,unsigned MaxUsrs,
|
|
|
|
|
MYSQL_RES **mysql_res);
|
|
|
|
|
void TL_DB_MarkAsFav (TL_Usr_FavSha_t FavSha,long Cod);
|
|
|
|
|
void TL_DB_UnmarkAsFav (TL_Usr_FavSha_t FavSha,long Cod);
|
|
|
|
|
void TL_DB_RemoveAllFavsMadeByUsr (TL_Usr_FavSha_t FavSha,long UsrCod);
|
|
|
|
|
void TL_DB_RemoveAllFavsToPubsBy (TL_Usr_FavSha_t FavSha,long UsrCod);
|
2021-03-02 00:54:26 +01:00
|
|
|
|
void TL_DB_RemoveAllFavsToAllCommsInAllNotesBy (long UsrCod);
|
2021-02-28 21:24:49 +01:00
|
|
|
|
|
2021-03-01 11:40:03 +01:00
|
|
|
|
/******************************** Shared *************************************/
|
2021-03-03 02:15:32 +01:00
|
|
|
|
bool TL_DB_CheckIfSharedByUsr (long NotCod,long UsrCod);
|
|
|
|
|
unsigned TL_DB_GetNumSharers (long NotCod,long UsrCod);
|
|
|
|
|
unsigned TL_DB_GetSharers (long NotCod,long UsrCod,unsigned MaxUsrs,
|
|
|
|
|
MYSQL_RES **mysql_res);
|
2021-03-01 11:40:03 +01:00
|
|
|
|
void TL_DB_RemoveSharedPub (long NotCod);
|
|
|
|
|
|
2021-02-26 22:20:03 +01:00
|
|
|
|
#endif
|