mirror of
https://github.com/acanas/swad-core.git
synced 2024-09-08 00:00:25 +02:00
378 lines
14 KiB
C
378 lines
14 KiB
C
// swad_privacy.c: users' photo and public profile visibility
|
|
|
|
/*
|
|
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-2024 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 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 ***********************************/
|
|
/*****************************************************************************/
|
|
|
|
#define _GNU_SOURCE // For asprintf
|
|
#include <stdio.h> // For asprintf
|
|
#include <stdlib.h> // For free
|
|
#include <string.h>
|
|
|
|
#include "swad_action.h"
|
|
#include "swad_action_list.h"
|
|
#include "swad_alert.h"
|
|
#include "swad_box.h"
|
|
#include "swad_enrolment_database.h"
|
|
#include "swad_error.h"
|
|
#include "swad_figure.h"
|
|
#include "swad_form.h"
|
|
#include "swad_global.h"
|
|
#include "swad_HTML.h"
|
|
#include "swad_parameter.h"
|
|
#include "swad_privacy.h"
|
|
#include "swad_theme.h"
|
|
#include "swad_user_database.h"
|
|
|
|
/*****************************************************************************/
|
|
/************** External global variables from others modules ****************/
|
|
/*****************************************************************************/
|
|
|
|
extern struct Globals Gbl;
|
|
|
|
/*****************************************************************************/
|
|
/****************************** Public constants *****************************/
|
|
/*****************************************************************************/
|
|
|
|
/***** Visibility (who can see user's photo or public profile) *****/
|
|
const char *Pri_VisibilityDB[Pri_NUM_OPTIONS_PRIVACY] =
|
|
{
|
|
[Pri_VISIBILITY_UNKNOWN] = "unknown",
|
|
[Pri_VISIBILITY_USER ] = "user",
|
|
[Pri_VISIBILITY_COURSE ] = "course",
|
|
[Pri_VISIBILITY_SYSTEM ] = "system",
|
|
[Pri_VISIBILITY_WORLD ] = "world",
|
|
};
|
|
|
|
/*****************************************************************************/
|
|
/***************************** Private constants *****************************/
|
|
/*****************************************************************************/
|
|
|
|
#define Pri_PRIVACY_ID "privacy"
|
|
|
|
/*****************************************************************************/
|
|
/***************************** Private prototypes ****************************/
|
|
/*****************************************************************************/
|
|
|
|
static void Pri_PutIconsPrivacy (__attribute__((unused)) void *Args);
|
|
|
|
static void Pri_PutFormVisibility (const char *TxtLabel,
|
|
Act_Action_t Action,const char *ParName,
|
|
Pri_Visibility_t CurrentVisibilityInDB,
|
|
unsigned MaskAllowedVisibility);
|
|
|
|
static void Pri_GetAndShowNumUsrsPerPrivacyForAnObject (const char *TxtObject,
|
|
const char *FldName,
|
|
unsigned MaskAllowedVisibility);
|
|
|
|
/*****************************************************************************/
|
|
/******************************* Edit my privacy *****************************/
|
|
/*****************************************************************************/
|
|
|
|
void Pri_EditMyPrivacy (void)
|
|
{
|
|
extern const char *Hlp_PROFILE_Settings_privacy;
|
|
extern const char *Txt_Please_check_your_privacy_settings;
|
|
extern const char *Txt_Privacy;
|
|
extern const char *Txt_Photo;
|
|
extern const char *Txt_Basic_public_profile;
|
|
extern const char *Txt_Extended_public_profile;
|
|
extern const char *Txt_Timeline;
|
|
|
|
/***** Begin section with settings on privacy *****/
|
|
HTM_SECTION_Begin (Pri_PRIVACY_ID);
|
|
|
|
/***** If any of my settings about privacy is unknown *****/
|
|
if (Gbl.Usrs.Me.UsrDat.PhotoVisibility == Pri_VISIBILITY_UNKNOWN ||
|
|
Gbl.Usrs.Me.UsrDat.BaPrfVisibility == Pri_VISIBILITY_UNKNOWN ||
|
|
Gbl.Usrs.Me.UsrDat.ExPrfVisibility == Pri_VISIBILITY_UNKNOWN)
|
|
Ale_ShowAlert (Ale_WARNING,Txt_Please_check_your_privacy_settings);
|
|
|
|
/***** Begin box and table *****/
|
|
Box_BoxTableBegin (Txt_Privacy,Pri_PutIconsPrivacy,NULL,
|
|
Hlp_PROFILE_Settings_privacy,Box_NOT_CLOSABLE,2);
|
|
|
|
/***** Edit photo visibility *****/
|
|
Pri_PutFormVisibility (Txt_Photo,
|
|
ActChgPriPho,"VisPho",
|
|
Gbl.Usrs.Me.UsrDat.PhotoVisibility,
|
|
Pri_PHOTO_ALLOWED_VIS);
|
|
|
|
/***** Edit basic public profile visibility *****/
|
|
Pri_PutFormVisibility (Txt_Basic_public_profile,
|
|
ActChgBasPriPrf,"VisBasPrf",
|
|
Gbl.Usrs.Me.UsrDat.BaPrfVisibility,
|
|
Pri_BASIC_PROFILE_ALLOWED_VIS);
|
|
|
|
/***** Edit extended public profile visibility *****/
|
|
Pri_PutFormVisibility (Txt_Extended_public_profile,
|
|
ActChgExtPriPrf,"VisExtPrf",
|
|
Gbl.Usrs.Me.UsrDat.ExPrfVisibility,
|
|
Pri_EXTENDED_PROFILE_ALLOWED_VIS);
|
|
|
|
/***** Edit public activity (timeline) visibility *****/
|
|
Pri_PutFormVisibility (Txt_Timeline,
|
|
ActUnk,"VisTml",
|
|
Pri_VISIBILITY_SYSTEM,
|
|
Pri_TIMELINE_ALLOWED_VIS);
|
|
|
|
/***** End table and box *****/
|
|
Box_BoxTableEnd ();
|
|
|
|
/***** End section with settings on privacy *****/
|
|
HTM_SECTION_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/****************** Put contextual icons in privacy setting ******************/
|
|
/*****************************************************************************/
|
|
|
|
static void Pri_PutIconsPrivacy (__attribute__((unused)) void *Args)
|
|
{
|
|
/***** Put icon to show a figure *****/
|
|
Fig_PutIconToShowFigure (Fig_PRIVACY);
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************** Select photo visibility **************************/
|
|
/*****************************************************************************/
|
|
|
|
static void Pri_PutFormVisibility (const char *TxtLabel,
|
|
Act_Action_t Action,const char *ParName,
|
|
Pri_Visibility_t CurrentVisibilityInDB,
|
|
unsigned MaskAllowedVisibility)
|
|
{
|
|
extern const char *Txt_PRIVACY_OPTIONS[Pri_NUM_OPTIONS_PRIVACY];
|
|
Pri_Visibility_t Visibility;
|
|
Cns_Checked_t Checked;
|
|
HTM_Disabled_t Disabled;
|
|
|
|
HTM_TR_Begin (NULL);
|
|
|
|
/***** Select visibility *****/
|
|
HTM_TD_TxtColon (TxtLabel);
|
|
|
|
/***** Form with list of options *****/
|
|
HTM_TD_Begin ("class=\"LT\"");
|
|
if (Action != ActUnk)
|
|
Frm_BeginFormAnchor (Action,Pri_PRIVACY_ID);
|
|
HTM_UL_Begin ("class=\"PRI_LIST LIST_LEFT\"");
|
|
|
|
for (Visibility = Pri_VISIBILITY_USER;
|
|
Visibility <= Pri_VISIBILITY_WORLD;
|
|
Visibility++)
|
|
if (MaskAllowedVisibility & (1 << Visibility))
|
|
{
|
|
if (Visibility == CurrentVisibilityInDB)
|
|
HTM_LI_Begin ("class=\"DAT_STRONG_%s BG_HIGHLIGHT\"",
|
|
The_GetSuffix ());
|
|
else
|
|
HTM_LI_Begin ("class=\"DAT_%s\"",
|
|
The_GetSuffix ());
|
|
HTM_LABEL_Begin (NULL);
|
|
Checked = (Visibility == CurrentVisibilityInDB) ? Cns_CHECKED :
|
|
Cns_UNCHECKED;
|
|
Disabled = (Action == ActUnk) ? HTM_DISABLED :
|
|
HTM_ENABLED;
|
|
HTM_INPUT_RADIO (ParName,
|
|
Checked,Disabled,HTM_READWRITE,HTM_NOT_REQUIRED,
|
|
(Action == ActUnk) ? HTM_DONT_SUBMIT_ON_CLICK :
|
|
HTM_SUBMIT_ON_CLICK,
|
|
"value=\"%u\"",(unsigned) Visibility);
|
|
HTM_Txt (Txt_PRIVACY_OPTIONS[Visibility]);
|
|
HTM_LABEL_End ();
|
|
HTM_LI_End ();
|
|
}
|
|
|
|
/***** End list and form *****/
|
|
HTM_UL_End ();
|
|
if (Action != ActUnk)
|
|
Frm_EndForm ();
|
|
HTM_TD_End ();
|
|
|
|
HTM_TR_End ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/************************ Get visibility from string *************************/
|
|
/*****************************************************************************/
|
|
|
|
Pri_Visibility_t Pri_GetVisibilityFromStr (const char *Str)
|
|
{
|
|
Pri_Visibility_t Visibility;
|
|
|
|
for (Visibility = (Pri_Visibility_t) 0;
|
|
Visibility <= (Pri_Visibility_t) (Pri_NUM_OPTIONS_PRIVACY - 1);
|
|
Visibility++)
|
|
if (!strcasecmp (Str,Pri_VisibilityDB[Visibility]))
|
|
return Visibility;
|
|
|
|
return Pri_VISIBILITY_UNKNOWN;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/**************** Get parameter with visibility from form ********************/
|
|
/*****************************************************************************/
|
|
|
|
Pri_Visibility_t Pri_GetParVisibility (const char *ParName,
|
|
unsigned MaskAllowedVisibility)
|
|
{
|
|
Pri_Visibility_t Visibility;
|
|
|
|
Visibility = (Pri_Visibility_t) Par_GetParUnsignedLong (ParName,
|
|
0,
|
|
Pri_NUM_OPTIONS_PRIVACY - 1,
|
|
(unsigned long) Pri_VISIBILITY_UNKNOWN);
|
|
return (MaskAllowedVisibility & (1 << Visibility)) ? Visibility :
|
|
Pri_VISIBILITY_UNKNOWN;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/*********** Check if user's photo or public profile can be shown ************/
|
|
/*****************************************************************************/
|
|
|
|
Usr_Can_t Pri_CheckIfICanView (Pri_Visibility_t Visibility,
|
|
struct Usr_Data *UsrDat)
|
|
{
|
|
/***** I always can see my things *****/
|
|
if (Usr_ItsMe (UsrDat->UsrCod) == Usr_ME)
|
|
return Usr_CAN;
|
|
|
|
/***** System admins always can see others' profiles *****/
|
|
if (Gbl.Usrs.Me.Role.Logged == Rol_SYS_ADM)
|
|
return Usr_CAN;
|
|
|
|
/***** Check if I can see the other's photo *****/
|
|
switch (Visibility)
|
|
{
|
|
case Pri_VISIBILITY_UNKNOWN:
|
|
return Usr_CAN_NOT; // It's not me
|
|
case Pri_VISIBILITY_USER: // Only visible
|
|
// by me and my teachers if I am a student
|
|
// or me and my students if I am a teacher
|
|
// Do both users share the same course but whit different role?
|
|
return Enr_DB_CheckIfUsrSharesAnyOfMyCrsWithDifferentRole (UsrDat->UsrCod) ? Usr_CAN :
|
|
Usr_CAN_NOT;
|
|
case Pri_VISIBILITY_COURSE: // Visible by users sharing courses with me
|
|
// Do both users share the same course?
|
|
return Enr_CheckIfUsrSharesAnyOfMyCrs (UsrDat) ? Usr_CAN :
|
|
Usr_CAN_NOT;
|
|
case Pri_VISIBILITY_SYSTEM: // Visible by any user logged in platform
|
|
return Gbl.Usrs.Me.Logged ? Usr_CAN :
|
|
Usr_CAN_NOT;
|
|
case Pri_VISIBILITY_WORLD: // Public, visible by everyone, even unlogged visitors
|
|
return Usr_CAN;
|
|
}
|
|
|
|
return Usr_CAN_NOT; // Never reached. To avoid warning
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********** Get and show number of users who have chosen a privacy ***********/
|
|
/*****************************************************************************/
|
|
|
|
void Pri_GetAndShowNumUsrsPerPrivacy (void)
|
|
{
|
|
extern const char *Hlp_ANALYTICS_Figures_privacy;
|
|
extern const char *Txt_Photo;
|
|
extern const char *Txt_Basic_public_profile;
|
|
extern const char *Txt_Extended_public_profile;
|
|
extern const char *Txt_FIGURE_TYPES[Fig_NUM_FIGURES];
|
|
|
|
/***** Begin box and table *****/
|
|
Box_BoxTableBegin (Txt_FIGURE_TYPES[Fig_PRIVACY],NULL,NULL,
|
|
Hlp_ANALYTICS_Figures_privacy,Box_NOT_CLOSABLE,2);
|
|
|
|
/***** Privacy for photo *****/
|
|
Pri_GetAndShowNumUsrsPerPrivacyForAnObject (Txt_Photo,
|
|
"PhotoVisibility",
|
|
Pri_PHOTO_ALLOWED_VIS);
|
|
|
|
/***** Privacy for public profile *****/
|
|
Pri_GetAndShowNumUsrsPerPrivacyForAnObject (Txt_Basic_public_profile,
|
|
"BaPrfVisibility",
|
|
Pri_BASIC_PROFILE_ALLOWED_VIS);
|
|
Pri_GetAndShowNumUsrsPerPrivacyForAnObject (Txt_Extended_public_profile,
|
|
"ExPrfVisibility",
|
|
Pri_EXTENDED_PROFILE_ALLOWED_VIS);
|
|
|
|
/***** End table and box *****/
|
|
Box_BoxTableEnd ();
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
/********** Get and show number of users who have chosen a privacy ***********/
|
|
/*****************************************************************************/
|
|
|
|
static void Pri_GetAndShowNumUsrsPerPrivacyForAnObject (const char *TxtObject,
|
|
const char *FldName,
|
|
unsigned MaskAllowedVisibility)
|
|
{
|
|
extern const char *Pri_VisibilityDB[Pri_NUM_OPTIONS_PRIVACY];
|
|
extern const char *Txt_Number_of_users;
|
|
extern const char *Txt_PERCENT_of_users;
|
|
extern const char *Txt_PRIVACY_OPTIONS[Pri_NUM_OPTIONS_PRIVACY];
|
|
Pri_Visibility_t Visibility;
|
|
char *SubQuery;
|
|
unsigned NumUsrs[Pri_NUM_OPTIONS_PRIVACY];
|
|
unsigned NumUsrsTotal = 0;
|
|
|
|
/***** Heading row *****/
|
|
HTM_TR_Begin (NULL);
|
|
HTM_TH (TxtObject ,HTM_HEAD_LEFT);
|
|
HTM_TH (Txt_Number_of_users ,HTM_HEAD_RIGHT);
|
|
HTM_TH (Txt_PERCENT_of_users,HTM_HEAD_RIGHT);
|
|
HTM_TR_End ();
|
|
|
|
/***** For each privacy option... *****/
|
|
for (Visibility = (Pri_Visibility_t) 0;
|
|
Visibility <= (Pri_Visibility_t) (Pri_NUM_OPTIONS_PRIVACY - 1);
|
|
Visibility++)
|
|
if (MaskAllowedVisibility & (1 << Visibility))
|
|
{
|
|
/* Get the number of users who have chosen this privacy option from database */
|
|
if (asprintf (&SubQuery,"usr_data.%s='%s'",
|
|
FldName,Pri_VisibilityDB[Visibility]) < 0)
|
|
Err_NotEnoughMemoryExit ();
|
|
NumUsrs[Visibility] = Usr_DB_GetNumUsrsWhoChoseAnOption (SubQuery);
|
|
free (SubQuery);
|
|
|
|
/* Update total number of users */
|
|
NumUsrsTotal += NumUsrs[Visibility];
|
|
}
|
|
|
|
/***** Write number of users who have chosen each privacy option *****/
|
|
for (Visibility = (Pri_Visibility_t) 0;
|
|
Visibility <= (Pri_Visibility_t) (Pri_NUM_OPTIONS_PRIVACY - 1);
|
|
Visibility++)
|
|
if (MaskAllowedVisibility & (1 << Visibility))
|
|
{
|
|
HTM_TR_Begin (NULL);
|
|
HTM_TD_Txt_Left (Txt_PRIVACY_OPTIONS[Visibility]);
|
|
HTM_TD_Unsigned (NumUsrs[Visibility]);
|
|
HTM_TD_Percentage (NumUsrs[Visibility],NumUsrsTotal);
|
|
HTM_TR_End ();
|
|
}
|
|
}
|