ILIAS  trunk Revision v11.0_alpha-1866-gfa368f7776e
All Data Structures Namespaces Files Functions Variables Enumerations Enumerator Modules Pages
ilGroupParticipants Class Reference
+ Inheritance diagram for ilGroupParticipants:
+ Collaboration diagram for ilGroupParticipants:

Public Member Functions

 __construct (int $a_obj_id)
 Constructor. More...
 
 add (int $a_usr_id, int $a_role)
 
 addSubscriber (int $a_usr_id)
 
 sendNotification (int $a_type, int $a_usr_id, bool $a_force_sending_mail=false)
 
- Public Member Functions inherited from ilParticipants
 __construct (string $a_component_name, int $a_ref_id)
 
 getObjId ()
 
 getType ()
 
 getNotificationRecipients ()
 Get admin, tutor which have notification enabled. More...
 
 getCountMembers ()
 Get number of members (not participants) More...
 
 getCountParticipants ()
 Get number of participants. More...
 
 getParticipants ()
 Get all participants ids. More...
 
 getMembers ()
 Get all members ids (admins and tutors are not members) Use get participants to fetch all. More...
 
 getAdmins ()
 Get all admins ids. More...
 
 getCountAdmins ()
 
 getTutors ()
 Get all tutors ids. More...
 
 isAdmin (int $a_usr_id)
 check if user is admin More...
 
 isTutor (int $a_usr_id)
 is user tutor More...
 
 isMember (int $a_usr_id)
 is user member More...
 
 isAssigned (int $a_usr_id)
 check if user is assigned More...
 
 isLastAdmin (int $a_usr_id)
 Check if user is last admin. More...
 
 getRoles ()
 Get object roles. More...
 
 getAssignedRoles (int $a_usr_id)
 Get assigned roles. More...
 
 updateRoleAssignments ($a_usr_id, $a_roles)
 Update role assignments public. More...
 
 checkLastAdmin (array $a_usr_ids)
 Check if users for deletion are last admins public. More...
 
 isBlocked (int $a_usr_id)
 Check if user is blocked. More...
 
 hasPassed (int $a_usr_id)
 Check if user has passed object. More...
 
 delete (int $a_usr_id)
 Drop user from all roles. More...
 
 updateBlocked (int $a_usr_id, bool $a_blocked)
 Update blocked status. More...
 
 updateContact (int $a_usr_id, bool $a_contact)
 
 getContacts ()
 get user ids which are confirgured as contact More...
 
 updateNotification (int $a_usr_id, bool $a_notification)
 Update notification status. More...
 
 add (int $a_usr_id, int $a_role)
 
 deleteParticipants (array $a_user_ids)
 
 addRecommendation (int $a_usr_id)
 Add desktop item public. More...
 
 isNotificationEnabled (int $a_usr_id)
 
 isContact (int $a_usr_id)
 
 getAutoGeneratedRoleId (int $a_role_type)
 
 isGroupingMember (int $a_usr_id, string $a_field='')
 Check membership for. More...
 
 getSubscribers ()
 get all subscribers int[] More...
 
 getCountSubscribers ()
 
 getSubscriberData (int $a_usr_id)
 
 assignSubscribers (array $a_usr_ids)
 
 assignSubscriber (int $a_usr_id)
 
 autoFillSubscribers ()
 
 addSubscriber (int $a_usr_id)
 
 updateSubscriptionTime (int $a_usr_id, int $a_subtime)
 
 updateSubject (int $a_usr_id, string $a_subject)
 
 deleteSubscriber (int $a_usr_id)
 
 deleteSubscribers (array $a_usr_ids)
 
 isSubscriber (int $a_usr_id)
 
 setRoleOrderPosition (int $a_user_id)
 Set role order position. More...
 

Static Public Member Functions

static _getInstanceByObjId (int $a_obj_id)
 Get singleton instance. More...
 
static getMemberRoles (int $a_ref_id)
 Get member roles (not auto generated) More...
 
static _isParticipant (int $a_ref_id, int $a_usr_id)
 Static function to check if a user is a participant of the container object. More...
 
- Static Public Member Functions inherited from ilParticipants
static getInstance (int $a_ref_id)
 
static getInstanceByObjId (int $a_obj_id)
 Get instance by obj type. More...
 
static hasParticipantListAccess (int $a_obj_id, ?int $a_usr_id=null)
 Check if (current) user has access to the participant list. More...
 
static canSendMailToMembers (int|ilObject $ref_id_or_instance, ?int $usr_id=null, ?int $mail_obj_ref_id=null)
 This method was introduced as a band-aid fix for #22764. More...
 
static getUserMembershipAssignmentsByType (array $a_user_ids, array $a_type, bool $a_only_member_roles)
 Get user membership assignments by type. More...
 
static _getMembershipByType (int $a_usr_id, array $a_type, bool $a_only_member_role=false)
 get membership by type Get course or group membership More...
 
static _isParticipant (int $a_ref_id, int $a_usr_id)
 Static function to check if a user is a participant of the container object. More...
 
static lookupNumberOfParticipants (int $a_ref_id)
 Lookup the number of participants (crs admins, tutors, members, grp admins, members) More...
 
static lookupNumberOfMembers (int $a_ref_id)
 Lookup number of members. More...
 
static _isBlocked (int $a_obj_id, int $a_usr_id)
 Check if user is blocked. More...
 
static _hasPassed (int $a_obj_id, int $a_usr_id)
 Check if user has passed course. More...
 
static _deleteAllEntries (int $a_obj_id)
 Delete all entries Normally called in case of object deletion. More...
 
static _deleteUser (int $a_usr_id)
 Delete user data. More...
 
static getDefaultMemberRole (int $a_ref_id)
 
static lookupSubscribers (int $a_obj_id)
 
static _isSubscriber (int $a_obj_id, int $a_usr_id)
 
static lookupSubscribersData (int $a_obj_id)
 
static _getAllSupportContactsOfUser (int $a_usr_id, string $a_type)
 Get all support contacts for a user. More...
 

Protected Attributes

const COMPONENT_NAME = 'components/ILIAS/Group'
 
- Protected Attributes inherited from ilParticipants
string $component = ''
 
int $ref_id = 0
 
int $obj_id = 0
 
string $type = ''
 
array $roles = []
 
array $role_data = []
 
array $roles_sorted = []
 
array $role_assignments = []
 
array $participants = []
 
array $participants_status = []
 
array $members = []
 
array $tutors = []
 
array $admins = []
 
array $subscribers = []
 
ilAppEventHandler $eventHandler
 
ilRbacReview $rbacReview
 
ilRbacAdmin $rbacAdmin
 
ilObjectDataCache $objectDataCache
 
ilDBInterface $ilDB
 
ilLanguage $lng
 
ilLogger $logger
 
ilErrorHandling $error
 
ilRecommendedContentManager $recommended_content_manager
 

Static Protected Attributes

static array $instances = []
 

Additional Inherited Members

- Data Fields inherited from ilParticipants
const IL_CRS_ADMIN = 1
 
const IL_CRS_TUTOR = 3
 
const IL_CRS_MEMBER = 2
 
const IL_GRP_ADMIN = 4
 
const IL_GRP_MEMBER = 5
 
const IL_SESS_MEMBER = 6
 
const IL_LSO_ADMIN = 7
 
const IL_LSO_MEMBER = 8
 
const IL_ROLE_POSITION_ADMIN = 1
 
const IL_ROLE_POSITION_TUTOR = 2
 
const IL_ROLE_POSITION_MEMBER = 3
 
- Protected Member Functions inherited from ilParticipants
 getComponent ()
 Get component name Used for raising events. More...
 
 readParticipants ()
 
 readParticipantsStatus ()
 Read status of participants (blocked, notification, passed) More...
 
 readSubscribers ()
 
 readSubscriberData (int $a_usr_id)
 

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

ilGroupParticipants::__construct ( int  $a_obj_id)

Constructor.

protected

Parameters
intobj_id of container

Definition at line 40 of file class.ilGroupParticipants.php.

References $DIC, ILIAS\GlobalScreen\Provider\__construct(), ilObject\_getAllReferences(), and ILIAS\Repository\logger().

41  {
42  global $DIC;
43 
44  $this->logger = $DIC->logger()->grp();
45 
46  // ref based constructor
47  $refs = ilObject::_getAllReferences($a_obj_id);
48  parent::__construct(self::COMPONENT_NAME, array_pop($refs));
49  }
static _getAllReferences(int $id)
get all reference ids for object ID
global $DIC
Definition: shib_login.php:22
__construct(Container $dic, ilPlugin $plugin)
+ Here is the call graph for this function:

Member Function Documentation

◆ _getInstanceByObjId()

static ilGroupParticipants::_getInstanceByObjId ( int  $a_obj_id)
static

Get singleton instance.

Definition at line 54 of file class.ilGroupParticipants.php.

Referenced by ilGroupEditParticipantsTableGUI\__construct(), ilGroupXMLWriter\__construct(), ilObjCourseGrouping\_checkGroupingDependencies(), ilCourseParticipantsGroupsGUI\add(), ilObjGroupGUI\afterSave(), ilPortfolioAccessHandler\checkAccessOfUser(), ilWorkspaceAccessHandler\checkAccessOfUser(), ilGroupMembershipMailNotification\createGroupStatus(), ilParticipants\getInstanceByObjId(), ilGroupLP\getMembers(), ilLPStatusCollection\getMembers(), ilNotification\getNotificationsForObject(), ilMembershipNotifications\getParticipants(), ilForumSettingsGUI\getParticipants(), ilBadgeHandler\getUserIds(), ilSoapGroupAdministration\groupExists(), ilObjSessionGUI\initContainer(), ilCourseParticipantsGroupsTableGUI\initGroups(), ilMemberExport\initGroups(), ilMemberExport\initMembers(), ilGroupRegistrationGUI\initParticipants(), ilObjGroup\initParticipants(), ilLPStatusCollection\isMember(), ilObjGroupGUI\leaveObject(), ilObjGroupAccess\lookupRegistrationInfo(), ilGroupParticipantsTableGUI\parse(), ilObjGroup\read(), ilECSCmsCourseMemberCommandQueueHandler\refreshAssignmentStatus(), ilObjGroup\register(), and ilCourseParticipantsGroupsGUI\remove().

55  {
56  if (isset(self::$instances[$a_obj_id]) && self::$instances[$a_obj_id]) {
57  return self::$instances[$a_obj_id];
58  }
59  return self::$instances[$a_obj_id] = new ilGroupParticipants($a_obj_id);
60  }
+ Here is the caller graph for this function:

◆ _isParticipant()

static ilGroupParticipants::_isParticipant ( int  $a_ref_id,
int  $a_usr_id 
)
static

Static function to check if a user is a participant of the container object.

Definition at line 117 of file class.ilGroupParticipants.php.

References $DIC.

Referenced by ilObjGroupAccess\_checkAccess(), ilObjGroupGUI\getTabs(), ilNotification\hasNotification(), ilObjGroupGUI\initHeaderAction(), and ilStartUpGUI\processIndexPHP().

117  : bool
118  {
119  global $DIC;
120 
121  $rbacreview = $DIC->rbac()->review();
122  $local_roles = $rbacreview->getRolesOfRoleFolder($a_ref_id, false);
123  return $rbacreview->isAssignedToAtLeastOneGivenRole($a_usr_id, $local_roles);
124  }
global $DIC
Definition: shib_login.php:22
+ Here is the caller graph for this function:

◆ add()

ilGroupParticipants::add ( int  $a_usr_id,
int  $a_role 
)

Definition at line 88 of file class.ilGroupParticipants.php.

References ILIAS\UI\examples\Symbol\Glyph\Add\add(), and ilParticipants\addRecommendation().

Referenced by ilGroupXMLParser\assignMembers().

88  : bool
89  {
90  if (parent::add($a_usr_id, $a_role)) {
91  $this->addRecommendation($a_usr_id);
92  return true;
93  }
94  return false;
95  }
add()
description: > Example for rendring an add glyph.
Definition: add.php:41
addRecommendation(int $a_usr_id)
Add desktop item public.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ addSubscriber()

ilGroupParticipants::addSubscriber ( int  $a_usr_id)

Definition at line 97 of file class.ilGroupParticipants.php.

References ilParticipants\getObjId(), and ILIAS\Repository\logger().

97  : void
98  {
99  parent::addSubscriber($a_usr_id);
100 
101  $this->logger->info('Raise new event: Modules/Group addSubscriber.');
102  $this->eventHandler->raise(
103  "components/ILIAS/Group",
104  'addSubscriber',
105  array(
106  'obj_id' => $this->getObjId(),
107  'usr_id' => $a_usr_id
108  )
109  );
110  }
+ Here is the call graph for this function:

◆ getMemberRoles()

static ilGroupParticipants::getMemberRoles ( int  $a_ref_id)
static

Get member roles (not auto generated)

Definition at line 65 of file class.ilGroupParticipants.php.

References $DIC, ilParticipants\$roles, and ilObject\_lookupTitle().

65  : array
66  {
67  global $DIC;
68 
69  $rbacreview = $DIC['rbacreview'];
70 
71  $lrol = $rbacreview->getRolesOfRoleFolder($a_ref_id, false);
72 
73  $roles = array();
74  foreach ($lrol as $role) {
75  $title = ilObject::_lookupTitle($role);
76  switch (substr($title, 0, 8)) {
77  case 'il_grp_a':
78  case 'il_grp_m':
79  continue 2;
80 
81  default:
82  $roles[$role] = $role;
83  }
84  }
85  return $roles;
86  }
static _lookupTitle(int $obj_id)
global $DIC
Definition: shib_login.php:22
+ Here is the call graph for this function:

◆ sendNotification()

ilGroupParticipants::sendNotification ( int  $a_type,
int  $a_usr_id,
bool  $a_force_sending_mail = false 
)

Definition at line 126 of file class.ilGroupParticipants.php.

References ilParticipants\getNotificationRecipients(), ilGroupMembershipMailNotification\TYPE_ACCEPTED_SUBSCRIPTION_MEMBER, ilGroupMembershipMailNotification\TYPE_ADMISSION_MEMBER, ilGroupMembershipMailNotification\TYPE_DISMISS_MEMBER, ilGroupMembershipMailNotification\TYPE_NOTIFICATION_REGISTRATION, ilGroupMembershipMailNotification\TYPE_NOTIFICATION_REGISTRATION_REQUEST, ilGroupMembershipMailNotification\TYPE_NOTIFICATION_UNSUBSCRIBE, ilGroupMembershipMailNotification\TYPE_REFUSED_SUBSCRIPTION_MEMBER, ilGroupMembershipMailNotification\TYPE_STATUS_CHANGED, ilGroupMembershipMailNotification\TYPE_SUBSCRIBE_MEMBER, ilGroupMembershipMailNotification\TYPE_UNSUBSCRIBE_MEMBER, and ilGroupMembershipMailNotification\TYPE_WAITING_LIST_MEMBER.

126  : void
127  {
128  $mail = new ilGroupMembershipMailNotification();
129  $mail->forceSendingMail($a_force_sending_mail);
130 
131  switch ($a_type) {
133 
135  $mail->setRefId($this->ref_id);
136  $mail->setRecipients(array($a_usr_id));
137  $mail->send();
138  break;
139 
141 
143  $mail->setRefId($this->ref_id);
144  $mail->setRecipients(array($a_usr_id));
145  $mail->send();
146  break;
147 
149 
151  $mail->setAdditionalInformation(array('usr_id' => $a_usr_id));
152  $mail->setRefId($this->ref_id);
153  $mail->setRecipients($this->getNotificationRecipients());
154  $mail->send();
155  break;
156 
158 
160  $mail->setRefId($this->ref_id);
161  $mail->setRecipients(array($a_usr_id));
162  $mail->send();
163  break;
164 
166 
168  $mail->setAdditionalInformation(array('usr_id' => $a_usr_id));
169  $mail->setRefId($this->ref_id);
170  $mail->setRecipients($this->getNotificationRecipients());
171  $mail->send();
172  break;
173 
175 
177  $mail->setRefId($this->ref_id);
178  $mail->setRecipients(array($a_usr_id));
179  $mail->send();
180  break;
181 
183 
185  $mail->setAdditionalInformation(array('usr_id' => $a_usr_id));
186  $mail->setRefId($this->ref_id);
187  $mail->setRecipients($this->getNotificationRecipients());
188  $mail->send();
189  break;
190 
192 
194  $mail->setRefId($this->ref_id);
195  $mail->setRecipients(array($a_usr_id));
196  $mail->send();
197  break;
198 
200 
202  $mail->setRefId($this->ref_id);
203  $mail->setRecipients(array($a_usr_id));
204  $mail->send();
205  break;
206 
208 
209  $wl = new ilGroupWaitingList($this->obj_id);
210  $pos = $wl->getPosition($a_usr_id);
211 
213  $mail->setRefId($this->ref_id);
214  $mail->setRecipients(array($a_usr_id));
215  $mail->setAdditionalInformation(array('position' => $pos));
216  $mail->send();
217  break;
218 
220 
222  $mail->setRefId($this->ref_id);
223  $mail->setRecipients(array($a_usr_id));
224  $mail->send();
225  break;
226  }
227  }
Waiting list for groups.
getNotificationRecipients()
Get admin, tutor which have notification enabled.
+ Here is the call graph for this function:

Field Documentation

◆ $instances

array ilGroupParticipants::$instances = []
staticprotected

Definition at line 32 of file class.ilGroupParticipants.php.

◆ COMPONENT_NAME

const ilGroupParticipants::COMPONENT_NAME = 'components/ILIAS/Group'
protected

Definition at line 30 of file class.ilGroupParticipants.php.


The documentation for this class was generated from the following file: