2021-02-08 16:24:29 +01:00
|
|
|
|
// swad_timeline.h: social timeline
|
2019-03-12 21:25:55 +01:00
|
|
|
|
|
|
|
|
|
#ifndef _SWAD_TL
|
|
|
|
|
#define _SWAD_TL
|
|
|
|
|
/*
|
|
|
|
|
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.
|
2021-02-09 12:43:45 +01:00
|
|
|
|
Copyright (C) 1999-2021 Antonio Ca<EFBFBD>as Vargas
|
2019-03-12 21:25:55 +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 **********************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2021-02-11 00:58:53 +01:00
|
|
|
|
#include "swad_form.h"
|
|
|
|
|
#include "swad_media.h"
|
|
|
|
|
#include "swad_notification.h"
|
|
|
|
|
#include "swad_user.h"
|
|
|
|
|
|
2019-03-12 21:25:55 +01:00
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/****************************** Public constants *****************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
#define TL_TIMELINE_SECTION_ID "timeline"
|
|
|
|
|
|
2021-02-08 16:24:29 +01:00
|
|
|
|
#define TL_ICON_ELLIPSIS "ellipsis-h.svg"
|
|
|
|
|
|
|
|
|
|
#define TL_DEF_USRS_SHOWN 5 // Default maximum number of users shown who have share/fav a note
|
|
|
|
|
#define TL_MAX_USRS_SHOWN 1000 // Top maximum number of users shown who have share/fav a note
|
|
|
|
|
|
2021-02-11 00:58:53 +01:00
|
|
|
|
/*
|
|
|
|
|
Timeline images will be saved with:
|
|
|
|
|
<EFBFBD> maximum width of TL_IMAGE_SAVED_MAX_HEIGHT
|
|
|
|
|
<EFBFBD> maximum height of TL_IMAGE_SAVED_MAX_HEIGHT
|
|
|
|
|
<EFBFBD> maintaining the original aspect ratio (aspect ratio recommended: 3:2)
|
|
|
|
|
*/
|
|
|
|
|
#define TL_IMAGE_SAVED_MAX_WIDTH 768
|
|
|
|
|
#define TL_IMAGE_SAVED_MAX_HEIGHT 768
|
|
|
|
|
#define TL_IMAGE_SAVED_QUALITY 90 // 1 to 100
|
|
|
|
|
// in timeline posts, the quality should not be high in order to speed up the loading of images
|
|
|
|
|
|
2019-03-12 21:25:55 +01:00
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/******************************** Public types *******************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
#define TL_NUM_TOP_MESSAGES (1 + 6)
|
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
TL_TOP_MESSAGE_NONE = 0,
|
|
|
|
|
TL_TOP_MESSAGE_COMMENTED = 1,
|
2019-11-21 11:39:30 +01:00
|
|
|
|
TL_TOP_MESSAGE_FAVED = 2,
|
2019-03-12 21:25:55 +01:00
|
|
|
|
TL_TOP_MESSAGE_UNFAVED = 3,
|
|
|
|
|
TL_TOP_MESSAGE_SHARED = 4,
|
|
|
|
|
TL_TOP_MESSAGE_UNSHARED = 5,
|
|
|
|
|
TL_TOP_MESSAGE_MENTIONED = 6,
|
|
|
|
|
} TL_TopMessage_t;
|
|
|
|
|
|
2021-02-08 22:33:41 +01:00
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
TL_TIMELINE_USR, // Show the timeline of a user
|
|
|
|
|
TL_TIMELINE_GBL, // Show the timeline of the users follwed by me
|
|
|
|
|
} TL_UsrOrGbl_t;
|
|
|
|
|
|
|
|
|
|
#define TL_NUM_WHAT_TO_GET 3
|
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
TL_GET_RECENT_TIMELINE, // Recent timeline is shown when the user clicks on action menu,...
|
|
|
|
|
// or after editing timeline
|
2021-02-09 13:57:17 +01:00
|
|
|
|
TL_GET_ONLY_NEW_PUBS, // New publications are retrieved via AJAX
|
|
|
|
|
// automatically from time to time
|
2021-02-08 22:33:41 +01:00
|
|
|
|
TL_GET_ONLY_OLD_PUBS, // Old publications are retrieved via AJAX
|
|
|
|
|
// when the user clicks on link at bottom of timeline
|
|
|
|
|
} TL_WhatToGet_t;
|
|
|
|
|
|
2020-04-09 21:36:21 +02:00
|
|
|
|
struct TL_Timeline
|
|
|
|
|
{
|
2021-02-08 22:33:41 +01:00
|
|
|
|
TL_UsrOrGbl_t UsrOrGbl;
|
2020-04-09 21:36:21 +02:00
|
|
|
|
Usr_Who_t Who;
|
2021-02-08 22:33:41 +01:00
|
|
|
|
TL_WhatToGet_t WhatToGet;
|
2021-02-10 14:51:05 +01:00
|
|
|
|
struct
|
|
|
|
|
{
|
|
|
|
|
unsigned Num; // Number of publications
|
|
|
|
|
struct TL_Publication *Lst; // List of publications
|
|
|
|
|
} Pubs;
|
2020-04-09 21:36:21 +02:00
|
|
|
|
long NotCod; // Used as parameter about social note to be edited, removed...
|
|
|
|
|
long PubCod; // Used as parameter about social publishing to be edited, removed...
|
|
|
|
|
};
|
|
|
|
|
|
2021-02-08 16:24:29 +01:00
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
TL_SHOW_FEW_USRS, // Show a few first favers/sharers
|
|
|
|
|
TL_SHOW_ALL_USRS, // Show all favers/sharers
|
|
|
|
|
} TL_HowManyUsrs_t;
|
|
|
|
|
|
2021-02-08 18:33:16 +01:00
|
|
|
|
#define TL_NUM_PUB_TYPES 4
|
|
|
|
|
// If the numbers assigned to each event type change,
|
|
|
|
|
// it is necessary to change old numbers to new ones in database table tl_notes
|
|
|
|
|
typedef enum
|
|
|
|
|
{
|
|
|
|
|
TL_PUB_UNKNOWN = 0,
|
|
|
|
|
TL_PUB_ORIGINAL_NOTE = 1,
|
|
|
|
|
TL_PUB_SHARED_NOTE = 2,
|
|
|
|
|
TL_PUB_COMMENT_TO_NOTE = 3,
|
|
|
|
|
} TL_PubType_t;
|
|
|
|
|
|
|
|
|
|
struct TL_Publication
|
|
|
|
|
{
|
|
|
|
|
long PubCod;
|
|
|
|
|
long NotCod;
|
|
|
|
|
long PublisherCod; // Sharer or writer of the publication
|
|
|
|
|
TL_PubType_t PubType;
|
|
|
|
|
TL_TopMessage_t TopMessage; // Used to show feedback on the action made
|
|
|
|
|
};
|
|
|
|
|
|
2021-02-08 16:24:29 +01:00
|
|
|
|
struct TL_PostContent
|
|
|
|
|
{
|
|
|
|
|
char Txt[Cns_MAX_BYTES_LONG_TEXT + 1];
|
2021-02-11 00:58:53 +01:00
|
|
|
|
struct Med_Media Media;
|
2021-02-08 16:24:29 +01:00
|
|
|
|
};
|
|
|
|
|
|
2021-02-11 00:58:53 +01:00
|
|
|
|
typedef enum
|
2021-02-08 16:24:29 +01:00
|
|
|
|
{
|
2021-02-11 00:58:53 +01:00
|
|
|
|
TL_DONT_HIGHLIGHT,
|
|
|
|
|
TL_HIGHLIGHT,
|
|
|
|
|
} TL_Highlight_t;
|
2021-02-08 16:24:29 +01:00
|
|
|
|
|
2021-02-11 00:58:53 +01:00
|
|
|
|
typedef enum
|
2021-02-08 16:24:29 +01:00
|
|
|
|
{
|
2021-02-11 00:58:53 +01:00
|
|
|
|
TL_DONT_SHOW_ALONE,
|
|
|
|
|
TL_SHOW_ALONE,
|
|
|
|
|
} TL_ShowAlone_t;
|
2021-02-08 16:24:29 +01:00
|
|
|
|
|
2019-03-12 21:25:55 +01:00
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/****************************** Public prototypes ****************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2021-02-11 00:58:53 +01:00
|
|
|
|
void TL_InitTimelineGbl (struct TL_Timeline *Timeline);
|
|
|
|
|
|
2020-04-11 00:57:25 +02:00
|
|
|
|
void TL_ResetTimeline (struct TL_Timeline *Timeline);
|
2021-02-11 00:58:53 +01:00
|
|
|
|
|
2020-04-11 00:57:25 +02:00
|
|
|
|
void TL_ShowTimelineGbl (void);
|
2021-02-11 00:58:53 +01:00
|
|
|
|
void TL_ShowNoteAndTimelineGbl (struct TL_Timeline *Timeline);
|
|
|
|
|
void TL_ShowTimelineGblHighlightingNot (struct TL_Timeline *Timeline,
|
|
|
|
|
long NotCod);
|
2020-04-11 00:57:25 +02:00
|
|
|
|
|
|
|
|
|
void TL_ShowTimelineUsr (struct TL_Timeline *Timeline);
|
2021-02-11 00:58:53 +01:00
|
|
|
|
void TL_ShowTimelineUsrHighlightingNot (struct TL_Timeline *Timeline,
|
|
|
|
|
long NotCod);
|
2019-03-12 21:25:55 +01:00
|
|
|
|
|
|
|
|
|
void TL_RefreshNewTimelineGbl (void);
|
|
|
|
|
|
|
|
|
|
void TL_RefreshOldTimelineGbl (void);
|
|
|
|
|
void TL_RefreshOldTimelineUsr (void);
|
|
|
|
|
|
|
|
|
|
void TL_MarkMyNotifAsSeen (void);
|
|
|
|
|
|
2021-02-11 00:58:53 +01:00
|
|
|
|
void TL_FormStart (const struct TL_Timeline *Timeline,
|
|
|
|
|
Act_Action_t ActionGbl,
|
|
|
|
|
Act_Action_t ActionUsr);
|
|
|
|
|
|
2020-04-11 00:57:25 +02:00
|
|
|
|
void TL_GetParamWho (void);
|
|
|
|
|
Usr_Who_t TL_GetGlobalWho (void);
|
|
|
|
|
|
2021-02-11 00:58:53 +01:00
|
|
|
|
void TL_WriteTopMessage (TL_TopMessage_t TopMessage,long PublisherCod);
|
|
|
|
|
|
|
|
|
|
void TL_WriteDateTime (time_t TimeUTC);
|
|
|
|
|
|
|
|
|
|
void TL_GetAndWritePost (long PstCod);
|
2019-03-12 21:25:55 +01:00
|
|
|
|
|
2021-02-11 00:58:53 +01:00
|
|
|
|
void TL_PublishPubInTimeline (struct TL_Publication *Pub);
|
|
|
|
|
|
|
|
|
|
void TL_PutTextarea (const char *Placeholder,const char *ClassTextArea);
|
2021-02-08 18:33:16 +01:00
|
|
|
|
|
2019-03-12 21:25:55 +01:00
|
|
|
|
void TL_ReceivePostUsr (void);
|
2019-03-29 01:23:33 +01:00
|
|
|
|
void TL_ReceivePostGbl (void);
|
2019-03-12 21:25:55 +01:00
|
|
|
|
|
2021-02-11 00:58:53 +01:00
|
|
|
|
void TL_Com_ShowHiddenCommentsUsr (void);
|
|
|
|
|
void TL_Com_ShowHiddenCommentsGbl (void);
|
2019-11-18 08:38:34 +01:00
|
|
|
|
|
2019-03-12 21:25:55 +01:00
|
|
|
|
void TL_PutHiddenParamPubCod (long PubCod);
|
2021-02-08 16:24:29 +01:00
|
|
|
|
long TL_GetParamPubCod (void);
|
2019-03-12 21:25:55 +01:00
|
|
|
|
|
2021-02-08 16:24:29 +01:00
|
|
|
|
void TL_CreateNotifToAuthor (long AuthorCod,long PubCod,
|
|
|
|
|
Ntf_NotifyEvent_t NotifyEvent);
|
|
|
|
|
|
2019-03-12 21:25:55 +01:00
|
|
|
|
void TL_RemoveUsrContent (long UsrCod);
|
|
|
|
|
|
2021-02-08 16:24:29 +01:00
|
|
|
|
void TL_ShowNumSharersOrFavers (unsigned NumUsrs);
|
|
|
|
|
void TL_ShowSharersOrFavers (MYSQL_RES **mysql_res,
|
|
|
|
|
unsigned NumUsrs,unsigned NumFirstUsrs);
|
2021-02-08 20:16:00 +01:00
|
|
|
|
void TL_PutFormToSeeAllFaversSharers (Act_Action_t ActionGbl,Act_Action_t ActionUsr,
|
|
|
|
|
const char *ParamFormat,long ParamCod,
|
|
|
|
|
TL_HowManyUsrs_t HowManyUsrs);
|
|
|
|
|
void TL_FormFavSha (Act_Action_t ActionGbl,Act_Action_t ActionUsr,
|
|
|
|
|
const char *ParamFormat,long ParamCod,
|
|
|
|
|
const char *Icon,const char *Title);
|
2021-02-08 16:24:29 +01:00
|
|
|
|
|
2019-03-12 21:25:55 +01:00
|
|
|
|
void TL_ClearOldTimelinesDB (void);
|
|
|
|
|
|
|
|
|
|
void TL_GetNotifPublication (char SummaryStr[Ntf_MAX_BYTES_SUMMARY + 1],
|
|
|
|
|
char **ContentStr,
|
|
|
|
|
long PubCod,bool GetContent);
|
|
|
|
|
|
|
|
|
|
unsigned long TL_GetNumPubsUsr (long UsrCod);
|
|
|
|
|
|
|
|
|
|
#endif
|