// swad_social.c: social networking /* SWAD (Shared Workspace At a Distance), 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-2015 Antonio Caņas Vargas This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General 3 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 . */ /*****************************************************************************/ /*********************************** Headers *********************************/ /*****************************************************************************/ #include // For PATH_MAX #include // For malloc and free #include // For time_t #include "swad_constant.h" #include "swad_database.h" #include "swad_exam.h" #include "swad_follow.h" #include "swad_global.h" #include "swad_layout.h" #include "swad_notice.h" #include "swad_social.h" /*****************************************************************************/ /****************************** Public constants *****************************/ /*****************************************************************************/ /*****************************************************************************/ /***************************** Private constants *****************************/ /*****************************************************************************/ #define Soc_MAX_BYTES_SUMMARY 100 static const Act_Action_t Soc_DefaultActions[Soc_NUM_SOCIAL_EVENTS] = { ActUnk, // Soc_EVENT_UNKNOWN /* Institution tab */ ActSeeDocIns, // Soc_EVENT_INS_DOC_PUB_FILE ActAdmComIns, // Soc_EVENT_INS_SHA_PUB_FILE /* Centre tab */ ActSeeDocCtr, // Soc_EVENT_CTR_DOC_PUB_FILE ActAdmComCtr, // Soc_EVENT_CTR_SHA_PUB_FILE /* Degree tab */ ActSeeDocDeg, // Soc_EVENT_DEG_DOC_PUB_FILE ActAdmComDeg, // Soc_EVENT_DEG_SHA_PUB_FILE /* Course tab */ ActSeeDocCrs, // Soc_EVENT_CRS_DOC_PUB_FILE ActAdmShaCrs, // Soc_EVENT_CRS_SHA_PUB_FILE /* Assessment tab */ ActSeeExaAnn, // Soc_EVENT_EXAM_ANNOUNCEMENT /* Users tab */ /* Social tab */ ActUnk, // Soc_EVENT_SOCIAL_POST /* Messages tab */ ActShoNot, // Soc_EVENT_NOTICE ActSeeFor, // Soc_EVENT_FORUM_POST /* Statistics tab */ /* Profile tab */ }; /*****************************************************************************/ /****************************** Internal types *******************************/ /*****************************************************************************/ /*****************************************************************************/ /************** External global variables from others modules ****************/ /*****************************************************************************/ extern struct Globals Gbl; /*****************************************************************************/ /************************* Internal global variables *************************/ /*****************************************************************************/ /*****************************************************************************/ /***************************** Private prototypes ****************************/ /*****************************************************************************/ static unsigned long Soc_ShowTimeline (const char *Query); static Soc_SocialEvent_t Soc_GetSocialEventFromDB (const char *Str); static void Soc_WriteEventDate (time_t TimeUTC); static void Soc_StartFormGoToAction (Soc_SocialEvent_t SocialEvent, long CrsCod,long Cod); static void Soc_GetEventSummary (Soc_SocialEvent_t SocialEvent,long Cod, char *SummaryStr,unsigned MaxChars); /*****************************************************************************/ /*********** Show social activity (timeline) of a selected user **************/ /*****************************************************************************/ void Soc_ShowUsrTimeline (long UsrCod) { char Query[512]; /***** Build query to show timeline including the users I am following *****/ sprintf (Query,"SELECT SocialEvent,UsrCod," "CtyCod,InsCod,CtrCod,DegCod,CrsCod," "Cod,UNIX_TIMESTAMP(TimeEvent)" " FROM social" " WHERE UsrCod='%ld'" " ORDER BY SocCod DESC LIMIT 10", UsrCod); /***** Show timeline *****/ Soc_ShowTimeline (Query); } /*****************************************************************************/ /***** Show social activity (timeline) including all the users I follow ******/ /*****************************************************************************/ void Soc_ShowFollowingTimeline (void) { char Query[512]; if (Fol_GetNumFollowing (Gbl.Usrs.Me.UsrDat.UsrCod)) // I follow people { /***** Build query to show timeline including the users I am following *****/ sprintf (Query,"SELECT SocialEvent,UsrCod," "CtyCod,InsCod,CtrCod,DegCod,CrsCod," "Cod,UNIX_TIMESTAMP(TimeEvent)" " FROM social,usr_follow" " WHERE usr_follow.FollowerCod='%ld'" " AND usr_follow.FollowedCod=social.UsrCod" " ORDER BY SocCod DESC LIMIT 10", Gbl.Usrs.Me.UsrDat.UsrCod); /***** Show timeline *****/ if (!Soc_ShowTimeline (Query)) Lay_ShowAlert (Lay_INFO,"No hay actividad pública de los usuarios a los que sigue."); // Need translation!!! } else // I do not follow people Lay_ShowAlert (Lay_INFO,"Usted no sigue a ningún usuario."); // Need translation!!! } /*****************************************************************************/ /*********************** Show social activity (timeline) *********************/ /*****************************************************************************/ static unsigned long Soc_ShowTimeline (const char *Query) { extern const char *Txt_Public_activity; extern const char *Txt_SOCIAL_EVENT[Soc_NUM_SOCIAL_EVENTS]; extern const char *Txt_Forum; extern const char *Txt_Course; extern const char *Txt_Degree; extern const char *Txt_Centre; extern const char *Txt_Institution; extern const char *Txt_Country; MYSQL_RES *mysql_res; MYSQL_ROW row; unsigned long NumEvents; unsigned long NumEvent; Soc_SocialEvent_t SocialEvent; struct UsrData UsrDat; struct Country Cty; struct Institution Ins; struct Centre Ctr; struct Degree Deg; struct Course Crs; long Cod; char ForumName[512]; time_t DateTimeUTC; // Date-time of the event bool ShowPhoto = false; char PhotoURL[PATH_MAX+1]; char *SummaryStr; /***** Get timeline from database *****/ NumEvents = DB_QuerySELECT (Query,&mysql_res,"can not get your notifications"); /***** List my timeline *****/ if (NumEvents) // Events found { /***** Allocate memory for the summary of the notification *****/ if ((SummaryStr = malloc (Cns_MAX_BYTES_TEXT+1)) == NULL) Lay_ShowErrorAndExit ("Not enough memory to store the summary of the notification."); /***** Initialize structure with user's data *****/ Usr_UsrDataConstructor (&UsrDat); /***** List start *****/ Lay_StartRoundFrame ("560px",Txt_Public_activity); fprintf (Gbl.F.Out,"
    "); /***** List events one by one *****/ for (NumEvent = 0; NumEvent < NumEvents; NumEvent++) { /***** Get next social event *****/ row = mysql_fetch_row (mysql_res); /* Get event type (row[0]) */ SocialEvent = Soc_GetSocialEventFromDB ((const char *) row[0]); /* Get (from) user code (row[1]) */ UsrDat.UsrCod = Str_ConvertStrCodToLongCod (row[1]); Usr_ChkUsrCodAndGetAllUsrDataFromUsrCod (&UsrDat); // Get user's data from the database /* Get country code (row[2]) */ Cty.CtyCod = Str_ConvertStrCodToLongCod (row[2]); Cty_GetDataOfCountryByCod (&Cty,Cty_GET_BASIC_DATA); /* Get institution code (row[3]) */ Ins.InsCod = Str_ConvertStrCodToLongCod (row[3]); Ins_GetDataOfInstitutionByCod (&Ins,Ins_GET_BASIC_DATA); /* Get centre code (row[4]) */ Ctr.CtrCod = Str_ConvertStrCodToLongCod (row[4]); Ctr_GetDataOfCentreByCod (&Ctr); /* Get degree code (row[5]) */ Deg.DegCod = Str_ConvertStrCodToLongCod (row[5]); Deg_GetDataOfDegreeByCod (&Deg); /* Get course code (row[6]) */ Crs.CrsCod = Str_ConvertStrCodToLongCod (row[6]); Crs_GetDataOfCourseByCod (&Crs); /* Get file/post... code (row[7]) */ Cod = Str_ConvertStrCodToLongCod (row[7]); /* Get forum type of the post */ if (SocialEvent == Soc_EVENT_FORUM_POST) { Gbl.Forum.ForumType = For_GetForumTypeOfAPost (Cod); For_SetForumName (Gbl.Forum.ForumType, &Ins, &Ctr, &Deg, &Crs, ForumName,Gbl.Prefs.Language,false); // Set forum name in recipient's language Gbl.Forum.Ins.InsCod = Ins.InsCod; Gbl.Forum.Ctr.CtrCod = Ctr.CtrCod; Gbl.Forum.Deg.DegCod = Deg.DegCod; Gbl.Forum.Crs.CrsCod = Crs.CrsCod; } /* Get time of the event (row[8]) */ DateTimeUTC = Dat_GetUNIXTimeFromStr (row[8]); /***** Write row for this social event *****/ fprintf (Gbl.F.Out,"
  • "); /* Left: write author's photo */ fprintf (Gbl.F.Out,"
    "); ShowPhoto = Pho_ShowUsrPhotoIsAllowed (&UsrDat,PhotoURL); Pho_ShowUsrPhoto (&UsrDat,ShowPhoto ? PhotoURL : NULL, "PHOTO60x80",Pho_ZOOM); fprintf (Gbl.F.Out,"
    "); /* Right: author's name, time and summary */ fprintf (Gbl.F.Out,"
    "); /* Write author's full name and nickname */ Str_LimitLengthHTMLStr (UsrDat.FullName,20); fprintf (Gbl.F.Out,"
    " "%s" " @%s" "
    ", UsrDat.FullName,UsrDat.Nickname); /* Write date and time */ Soc_WriteEventDate (DateTimeUTC); /* Write event type and location */ if (SocialEvent != Soc_EVENT_SOCIAL_POST) { fprintf (Gbl.F.Out,"
    "); Soc_StartFormGoToAction (SocialEvent,Crs.CrsCod,Cod); Act_LinkFormSubmit (Txt_SOCIAL_EVENT[SocialEvent],"DAT_N"); fprintf (Gbl.F.Out,"%s", Txt_SOCIAL_EVENT[SocialEvent]); Act_FormEnd (); fprintf (Gbl.F.Out,"
    "); if (SocialEvent == Soc_EVENT_FORUM_POST) fprintf (Gbl.F.Out,"
    %s: %s
    ", Txt_Forum,ForumName); else if (Crs.CrsCod > 0) fprintf (Gbl.F.Out,"
    %s: %s
    ", Txt_Course,Crs.ShortName); else if (Deg.DegCod > 0) fprintf (Gbl.F.Out,"
    %s: %s
    ", Txt_Degree,Deg.ShortName); else if (Ctr.CtrCod > 0) fprintf (Gbl.F.Out,"
    %s: %s
    ", Txt_Centre,Ctr.ShortName); else if (Ins.InsCod > 0) fprintf (Gbl.F.Out,"
    %s: %s
    ", Txt_Institution,Ins.ShortName); else if (Cty.CtyCod > 0) fprintf (Gbl.F.Out,"
    %s: %s
    ", Txt_Country,Cty.Name[Gbl.Prefs.Language]); } /* Write content of the event */ Soc_GetEventSummary (SocialEvent,Cod, SummaryStr,Soc_MAX_BYTES_SUMMARY); fprintf (Gbl.F.Out,"
    %s
    ",SummaryStr); /* End of right part */ fprintf (Gbl.F.Out,"
    "); /* End of list element */ fprintf (Gbl.F.Out,"
    • "); } /***** List end *****/ fprintf (Gbl.F.Out,"
"); Lay_EndRoundFrame (); /***** Free memory used for user's data *****/ Usr_UsrDataDestructor (&UsrDat); /***** Free summary *****/ free ((void *) SummaryStr); } /***** Free structure that stores the query result *****/ DB_FreeMySQLResult (&mysql_res); return NumEvents; } /*****************************************************************************/ /****** Get social event type from string number coming from database ********/ /*****************************************************************************/ static Soc_SocialEvent_t Soc_GetSocialEventFromDB (const char *Str) { unsigned UnsignedNum; if (sscanf (Str,"%u",&UnsignedNum) == 1) if (UnsignedNum < Soc_NUM_SOCIAL_EVENTS) return (Soc_SocialEvent_t) UnsignedNum; return Soc_EVENT_UNKNOWN; } /*****************************************************************************/ /**************** Write the date of creation of a social event ***************/ /*****************************************************************************/ // TimeUTC holds UTC date and time in UNIX format (seconds since 1970) static void Soc_WriteEventDate (time_t TimeUTC) { extern const char *Txt_Today; static unsigned UniqueId = 0; UniqueId++; /***** Start cell *****/ fprintf (Gbl.F.Out,"
", UniqueId); /***** Write date and time *****/ fprintf (Gbl.F.Out,"", UniqueId,(long) TimeUTC,Txt_Today); /***** End cell *****/ fprintf (Gbl.F.Out,"
"); } /*****************************************************************************/ /*********** Put form to go to an action depending on the event **************/ /*****************************************************************************/ static void Soc_StartFormGoToAction (Soc_SocialEvent_t SocialEvent, long CrsCod,long Cod) { extern const Act_Action_t For_ActionsSeeFor[For_NUM_TYPES_FORUM]; struct FileMetadata FileMetadata; long GrpCod = -1L; char PathUntilFileName[PATH_MAX+1]; char FileName[NAME_MAX+1]; Act_Action_t Action = ActUnk; // Initialized to avoid warning /***** Parameters depending on the type of event *****/ switch (SocialEvent) { case Soc_EVENT_INS_DOC_PUB_FILE: case Soc_EVENT_INS_SHA_PUB_FILE: case Soc_EVENT_CTR_DOC_PUB_FILE: case Soc_EVENT_CTR_SHA_PUB_FILE: case Soc_EVENT_DEG_DOC_PUB_FILE: case Soc_EVENT_DEG_SHA_PUB_FILE: case Soc_EVENT_CRS_DOC_PUB_FILE: case Soc_EVENT_CRS_SHA_PUB_FILE: if (Cod > 0) // File code { FileMetadata.FilCod = Cod; Brw_GetFileMetadataByCod (&FileMetadata); Brw_GetCrsGrpFromFileMetadata (FileMetadata.FileBrowser,FileMetadata.Cod,&CrsCod,&GrpCod); Str_SplitFullPathIntoPathAndFileName (FileMetadata.Path, PathUntilFileName, FileName); } switch (SocialEvent) { case Soc_EVENT_INS_DOC_PUB_FILE: Action = (Cod > 0) ? ActReqDatSeeDocIns : ActSeeDocIns; break; case Soc_EVENT_INS_SHA_PUB_FILE: Action = (Cod > 0) ? ActReqDatShaIns : ActAdmComIns; break; case Soc_EVENT_CTR_DOC_PUB_FILE: Action = (Cod > 0) ? ActReqDatSeeDocCtr : ActSeeDocCtr; break; case Soc_EVENT_CTR_SHA_PUB_FILE: Action = (Cod > 0) ? ActReqDatShaCtr : ActAdmComCtr; break; case Soc_EVENT_DEG_DOC_PUB_FILE: Action = (Cod > 0) ? ActReqDatSeeDocDeg : ActSeeDocDeg; break; case Soc_EVENT_DEG_SHA_PUB_FILE: Action = (Cod > 0) ? ActReqDatShaDeg : ActAdmComDeg; break; case Soc_EVENT_CRS_DOC_PUB_FILE: Action = (Cod > 0) ? ActReqDatSeeDocCrs : ActSeeDocCrs; break; case Soc_EVENT_CRS_SHA_PUB_FILE: Action = (Cod > 0) ? ActReqDatShaCrs : ActAdmShaCrs; break; default: // Not aplicable here break; } Act_FormStart (Action); Grp_PutParamGrpCod (-1L); if (Cod > 0) // File code Brw_PutParamsPathAndFile (Brw_IS_FILE,PathUntilFileName,FileName); break; case Soc_EVENT_NOTICE: Act_FormStart (Soc_DefaultActions[SocialEvent]); Not_PutHiddenParamNotCod (Cod); break; case Soc_EVENT_FORUM_POST: Act_FormStart (For_ActionsSeeFor[Gbl.Forum.ForumType]); For_PutAllHiddenParamsForum (); break; default: Act_FormStart (Soc_DefaultActions[SocialEvent]); break; } /***** Parameter to go to another course *****/ if (CrsCod > 0 && // Course specified CrsCod != Gbl.CurrentCrs.Crs.CrsCod) // Not the current course Crs_PutParamCrsCod (CrsCod); // Go to another course } /*****************************************************************************/ /******************* Get social event summary and content ********************/ /*****************************************************************************/ static void Soc_GetEventSummary (Soc_SocialEvent_t SocialEvent,long Cod, char *SummaryStr,unsigned MaxChars) { SummaryStr[0] = '\0'; switch (SocialEvent) { case Soc_EVENT_UNKNOWN: break; case Soc_EVENT_INS_DOC_PUB_FILE: case Soc_EVENT_INS_SHA_PUB_FILE: case Soc_EVENT_CTR_DOC_PUB_FILE: case Soc_EVENT_CTR_SHA_PUB_FILE: case Soc_EVENT_DEG_DOC_PUB_FILE: case Soc_EVENT_DEG_SHA_PUB_FILE: case Soc_EVENT_CRS_DOC_PUB_FILE: case Soc_EVENT_CRS_SHA_PUB_FILE: Brw_GetSummaryAndContentOrSharedFile (SummaryStr,NULL,Cod,MaxChars,false); break; case Soc_EVENT_EXAM_ANNOUNCEMENT: Exa_GetSummaryAndContentExamAnnouncement (SummaryStr,NULL,Cod,MaxChars,false); break; case Soc_EVENT_SOCIAL_POST: // TODO: Implement social posts break; case Soc_EVENT_NOTICE: Not_GetSummaryAndContentNotice (SummaryStr,NULL,Cod,MaxChars,false); break; case Soc_EVENT_FORUM_POST: For_GetSummaryAndContentForumPst (SummaryStr,NULL,Cod,MaxChars,false); break; } } /*****************************************************************************/ /********************* Store a social event into database ********************/ /*****************************************************************************/ void Soc_StoreSocialEvent (Soc_SocialEvent_t SocialEvent,long Cod) { char Query[512]; long CtyCod; long InsCod; long CtrCod; long DegCod; long CrsCod; if (SocialEvent == Soc_EVENT_FORUM_POST) { // CtyCod = Gbl.Forum.Cty.CtyCod; // InsCod = Gbl.Forum.Ins.InsCod; // CtrCod = Gbl.Forum.Ctr.CtrCod; // DegCod = Gbl.Forum.Deg.DegCod; // CrsCod = Gbl.Forum.Crs.CrsCod; CtyCod = -1L; InsCod = -1L; CtrCod = -1L; DegCod = -1L; CrsCod = -1L; } else { CtyCod = Gbl.CurrentCty.Cty.CtyCod; InsCod = Gbl.CurrentIns.Ins.InsCod; CtrCod = Gbl.CurrentCtr.Ctr.CtrCod; DegCod = Gbl.CurrentDeg.Deg.DegCod; CrsCod = Gbl.CurrentCrs.Crs.CrsCod; } /***** Store notify event *****/ sprintf (Query,"INSERT INTO social (SocialEvent,UsrCod," "CtyCod,InsCod,CtrCod,DegCod,CrsCod," "Cod,TimeEvent)" " VALUES ('%u','%ld'," "'%ld','%ld','%ld','%ld','%ld'," "'%ld',NOW())", (unsigned) SocialEvent,Gbl.Usrs.Me.UsrDat.UsrCod, CtyCod,InsCod,CtrCod,DegCod,CrsCod, Cod); DB_QueryINSERT (Query,"can not create new social event"); }