Collaboration diagram for ilNotification:

Static Public Member Functions
static	hasNotification ($type, $user_id, $id)
	Check notification status for object and user. More...

static	hasOptOut ($obj_id)
	Is opt out (disable notification) allowed? More...

static	getNotificationsForObject ($type, $id, $page_id=null, $ignore_threshold=false)
	Get all users for given object. More...

static	setNotification ($type, $user_id, $id, $status=true)
	Set notification status for object and user. More...

static	updateNotificationTime ($type, $id, array $user_ids, $page_id=false)
	Update the last mail timestamp for given object and users. More...

static	removeForObject ($type, $id)
	Remove all notifications for given object. More...

static	removeForUser ($user_id)
	Remove all notifications for given user. More...

Data Fields
const	TYPE_EXERCISE_SUBMISSION = 1

const	TYPE_WIKI = 2

const	TYPE_WIKI_PAGE = 3

const	TYPE_BLOG = 4

const	TYPE_DATA_COLLECTION = 5

const	TYPE_POLL = 6

const	TYPE_LM_BLOCKED_USERS = 7

const	THRESHOLD = 180

Detailed Description

Class ilNotification.

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Id: class.ilObjExerciseGUI.php 24003 2010-05-26 14:35:42Z akill

ilNotification:

Definition at line 15 of file class.ilNotification.php.

Member Function Documentation

◆ getNotificationsForObject()

static ilNotification::getNotificationsForObject	(	$type,
		$id,
		$page_id = `null`,
		$ignore_threshold = `false`
	)

static

Get all users for given object.

Parameters

int	$type
int	$id
int	$page_id
bool	$ignore_threshold

Returns: array

Definition at line 119 of file class.ilNotification.php.

References $DIC, $id, $ilDB, $row, $type, ilObject\_getAllReferences(), ilGroupParticipants\_getInstanceByObjId(), ilCourseParticipants\_getInstanceByObjId(), ilObject\_lookupObjectId(), array, date, ilObjNotificationSettings\MODE_DEF_OFF_USER_ACTIVATION, ilObjNotificationSettings\MODE_DEF_ON_NO_OPT_OUT, and ilObjNotificationSettings\MODE_DEF_ON_OPT_OUT.

Referenced by ilObjDataCollection\doUpdate(), ilExSubmissionBaseGUI\handleNewUpload(), ilLMPageGUI\processAnswer(), ilWikiUtil\sendNotification(), ilObjBlog\sendNotification(), and ilObjPollGUI\sendNotifications().

     {
         global $DIC;
 
         $ilDB = $DIC->database();
         $tree = $DIC->repositoryTree();
 
         include_once("./Services/Notification/classes/class.ilObjNotificationSettings.php");
 
         // currently done for blog
         $recipients = array();
         $setting = new ilObjNotificationSettings($id);
         if ($setting->getMode() != ilObjNotificationSettings::MODE_DEF_OFF_USER_ACTIVATION) {
             foreach (ilObject::_getAllReferences($id) as $ref_id) {
                 $grp_ref_id = $tree->checkForParentType($ref_id, 'grp');
                 if ($grp_ref_id > 0) {
                     include_once("./Modules/Group/classes/class.ilGroupParticipants.php");
                     $p = ilGroupParticipants::_getInstanceByObjId(ilObject::_lookupObjectId($grp_ref_id));
                     foreach ($p->getMembers() as $user_id) {
                         if (!in_array($user_id, $recipients)) {
                             $recipients[$user_id] = $user_id;
                         }
                     }
                 }
                 $crs_ref_id = $tree->checkForParentType($ref_id, 'crs');
                 if ($crs_ref_id > 0) {
                     include_once("./Modules/Course/classes/class.ilCourseParticipants.php");
                     $p = ilCourseParticipants::_getInstanceByObjId(ilObject::_lookupObjectId($crs_ref_id));
                     foreach ($p->getMembers() as $user_id) {
                         if (!in_array($user_id, $recipients)) {
                             $recipients[$user_id] = $user_id;
                         }
                     }
                 }
             }
         }
 
         // remove all users that deactivated the feature
         if ($setting->getMode() == ilObjNotificationSettings::MODE_DEF_ON_OPT_OUT) {
             $sql = "SELECT user_id FROM notification" .
                 " WHERE type = " . $ilDB->quote($type, "integer") .
                 " AND id = " . $ilDB->quote($id, "integer") .
                 " AND activated = " . $ilDB->quote(0, "integer") .
                 " AND " . $ilDB->in("user_id", $recipients, false, "integer");
             $set = $ilDB->query($sql);
             while ($rec = $ilDB->fetchAssoc($set)) {
                 unset($recipients[$rec["user_id"]]);
             }
         }
 
         // remove all users that got a mail
         if ($setting->getMode() != ilObjNotificationSettings::MODE_DEF_OFF_USER_ACTIVATION && !$ignore_threshold) {
             $sql = "SELECT user_id FROM notification" .
                 " WHERE type = " . $ilDB->quote($type, "integer") .
                 " AND id = " . $ilDB->quote($id, "integer") .
                 " AND activated = " . $ilDB->quote(1, "integer") .
                 " AND " . $ilDB->in("user_id", $recipients, false, "integer");
             $sql .= " AND (last_mail > " . $ilDB->quote(date(
                 "Y-m-d H:i:s",
                 strtotime("-" . self::THRESHOLD . "minutes")
             ), "timestamp");
             if ($page_id) {
                 $sql .= " AND page_id = " . $ilDB->quote($page_id, "integer");
             }
             $sql .= ")";
 
             $set = $ilDB->query($sql);
             while ($rec = $ilDB->fetchAssoc($set)) {
                 unset($recipients[$rec["user_id"]]);
             }
         }
 
         // get single subscriptions
         if ($setting->getMode() != ilObjNotificationSettings::MODE_DEF_ON_NO_OPT_OUT) {
             $sql = "SELECT user_id FROM notification" .
                 " WHERE type = " . $ilDB->quote($type, "integer") .
                 " AND id = " . $ilDB->quote($id, "integer") .
                 " AND activated = " . $ilDB->quote(1, "integer");
             if (!$ignore_threshold) {
                 $sql .= " AND (last_mail < " . $ilDB->quote(date(
                     "Y-m-d H:i:s",
                     strtotime("-" . self::THRESHOLD . "minutes")
                 ), "timestamp") .
                     " OR last_mail IS NULL";
                 if ($page_id) {
                     $sql .= " OR page_id <> " . $ilDB->quote($page_id, "integer");
                 }
                 $sql .= ")";
             }
             $set = $ilDB->query($sql);
             while ($row = $ilDB->fetchAssoc($set)) {
                 $recipients[$row["user_id"]] = $row["user_id"];
             }
         }
 
         return $recipients;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasNotification()

static ilNotification::hasNotification	(	$type,
		$user_id,
		$id
	)

static

Check notification status for object and user.

Parameters

int	$type
int	$user_id
int	$id

Returns: bool

Definition at line 35 of file class.ilNotification.php.

References $DIC, $id, $ilDB, $type, ilObject\_getAllReferences(), ilGroupParticipants\_isParticipant(), ilParticipants\_isParticipant(), ilObjNotificationSettings\MODE_DEF_OFF_USER_ACTIVATION, ilObjNotificationSettings\MODE_DEF_ON_NO_OPT_OUT, and ilObjNotificationSettings\MODE_DEF_ON_OPT_OUT.

Referenced by ilWikiPageGUI\addHeaderAction(), ilObjDataCollectionGUI\addHeaderAction(), ilObjExerciseGUI\getEditFormCustomValues(), ilPollBlockGUI\getHTML(), ilObjContentObjectGUI\getPropertiesFormValues(), and ilObjBlogGUI\initHeaderAction().

     {
         global $DIC;
 
         $ilDB = $DIC->database();
         $tree = $DIC->repositoryTree();
 
         $notification = false;
 
         include_once("./Services/Notification/classes/class.ilObjNotificationSettings.php");
         $setting = new ilObjNotificationSettings($id);
         if ($setting->getMode() != ilObjNotificationSettings::MODE_DEF_OFF_USER_ACTIVATION) {
             // check membership, members should be notidifed...
             foreach (ilObject::_getAllReferences($id) as $ref_id) {
                 $grp_ref_id = $tree->checkForParentType($ref_id, 'grp');
                 if ($grp_ref_id > 0) {
                     include_once("./Modules/Group/classes/class.ilGroupParticipants.php");
                     if (ilGroupParticipants::_isParticipant($grp_ref_id, $user_id)) {
                         $notification = true;
                     }
                 }
                 $crs_ref_id = $tree->checkForParentType($ref_id, 'crs');
                 if ($crs_ref_id > 0) {
                     include_once("./Modules/Course/classes/class.ilCourseParticipants.php");
                     if (ilCourseParticipants::_isParticipant($crs_ref_id, $user_id)) {
                         $notification = true;
                     }
                 }
             }
 
             if ($notification && $setting->getMode() == ilObjNotificationSettings::MODE_DEF_ON_OPT_OUT) {
                 $set = $ilDB->query("SELECT user_id FROM notification" .
                     " WHERE type = " . $ilDB->quote($type, "integer") .
                     " AND user_id = " . $ilDB->quote($user_id, "integer") .
                     " AND id = " . $ilDB->quote($id, "integer") .
                     " AND activated = " . $ilDB->quote(0, "integer"));
                 $rec = $ilDB->fetchAssoc($set);
                 // ... except when the opted out
                 if ($rec["user_id"] == $user_id) {
                     return false;
                 }
                 return true;
             }
 
             if ($notification && $setting->getMode() == ilObjNotificationSettings::MODE_DEF_ON_NO_OPT_OUT) {
                 return true;
             }
         }
 
 
         $set = $ilDB->query("SELECT user_id FROM notification" .
             " WHERE type = " . $ilDB->quote($type, "integer") .
             " AND user_id = " . $ilDB->quote($user_id, "integer") .
             " AND id = " . $ilDB->quote($id, "integer") .
             " AND activated = " . $ilDB->quote(1, "integer"));
 
         return (bool) $ilDB->numRows($set);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasOptOut()

static ilNotification::hasOptOut ( $obj_id )

static

Is opt out (disable notification) allowed?

Parameters

int $obj_id

Returns: bool

Definition at line 100 of file class.ilNotification.php.

References ilObjNotificationSettings\MODE_DEF_ON_NO_OPT_OUT.

Referenced by ilWikiPageGUI\addHeaderAction(), and ilObjBlogGUI\initHeaderAction().

     {
         include_once("./Services/Notification/classes/class.ilObjNotificationSettings.php");
         $setting = new ilObjNotificationSettings($obj_id);
         if ($setting->getMode() == ilObjNotificationSettings::MODE_DEF_ON_NO_OPT_OUT) {
             return false;
         }
         return true;
     }

Here is the caller graph for this function:

◆ removeForObject()

static ilNotification::removeForObject	(	$type,
		$id
	)

static

Remove all notifications for given object.

Parameters

int	$type
int	$id

Definition at line 273 of file class.ilNotification.php.

References $DIC, $id, $ilDB, and $type.

Referenced by ilObjExercise\delete(), ilWikiPage\delete(), ilObjWiki\delete(), and ilObjBlog\doDelete().

     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $ilDB->query("DELETE FROM notification" .
                 " WHERE type = " . $ilDB->quote($type, "integer") .
                 " AND id = " . $ilDB->quote($id, "integer"));
     }

Here is the caller graph for this function:

◆ removeForUser()

static ilNotification::removeForUser ( $user_id )

static

Remove all notifications for given user.

Parameters

int $user_id

Definition at line 289 of file class.ilNotification.php.

References $DIC, and $ilDB.

Referenced by ilObjUser\delete().

     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $ilDB->query("DELETE FROM notification" .
                 " WHERE user_id = " . $ilDB->quote($user_id, "integer"));
     }

Here is the caller graph for this function:

◆ setNotification()

static ilNotification::setNotification	(	$type,
		$user_id,
		$id,
		$status = `true`
	)

static

Set notification status for object and user.

Parameters

int	$type
int	$user_id
int	$id
bool	$status

Definition at line 225 of file class.ilNotification.php.

References $DIC, $id, $ilDB, $type, and array.

Referenced by ilWikiPageGUI\executeCommand(), ilObjContentObjectGUI\saveProperties(), ilObjBlogGUI\setNotification(), ilObjPollGUI\subscribe(), ilObjBibliographicGUI\toggleNotification(), ilObjDataCollectionGUI\toggleNotification(), ilObjPollGUI\unsubscribe(), and ilObjExerciseGUI\updateCustom().

     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $fields = array(
             "type" => array("integer", $type),
             "user_id" => array("integer", $user_id),
             "id" => array("integer", $id)
         );
         $ilDB->replace("notification", $fields, array("activated" => array("integer", (int) $status)));
     }

Here is the caller graph for this function:

◆ updateNotificationTime()

static ilNotification::updateNotificationTime	(		$type,
			$id,
		array	$user_ids,
			$page_id = `false`
	)

static

Update the last mail timestamp for given object and users.

Parameters

int	$type
int	$id
array	$user_ids
int	$page_id

Definition at line 247 of file class.ilNotification.php.

References $DIC, $id, $ilDB, $type, and date.

Referenced by ilObjDataCollection\doUpdate(), ilWikiUtil\sendNotification(), ilObjBlog\sendNotification(), and ilObjPollGUI\sendNotifications().

     {
         global $DIC;
 
         $ilDB = $DIC->database();
 
         $sql = "UPDATE notification" .
                 " SET last_mail = " . $ilDB->quote(date("Y-m-d H:i:s"), "timestamp");
 
         if ($page_id) {
             $sql .= ", page_id = " . $ilDB->quote($page_id, "integer");
         }
 
         $sql .= " WHERE type = " . $ilDB->quote($type, "integer") .
                 " AND id = " . $ilDB->quote($id, "integer") .
                 " AND " . $ilDB->in("user_id", $user_ids, false, "integer");
 
         $ilDB->query($sql);
     }

Here is the caller graph for this function:

Field Documentation

◆ THRESHOLD

const ilNotification::THRESHOLD = 180

Definition at line 25 of file class.ilNotification.php.

◆ TYPE_BLOG

const ilNotification::TYPE_BLOG = 4

Definition at line 20 of file class.ilNotification.php.

Referenced by ilObjBlog\doDelete(), ilObjBlogGUI\initHeaderAction(), ilObjBlog\sendNotification(), and ilObjBlogGUI\setNotification().

◆ TYPE_DATA_COLLECTION

const ilNotification::TYPE_DATA_COLLECTION = 5

Definition at line 21 of file class.ilNotification.php.

Referenced by ilObjDataCollectionGUI\addHeaderAction(), ilObjDataCollection\doUpdate(), ilObjBibliographicGUI\toggleNotification(), and ilObjDataCollectionGUI\toggleNotification().

◆ TYPE_EXERCISE_SUBMISSION

const ilNotification::TYPE_EXERCISE_SUBMISSION = 1

Definition at line 17 of file class.ilNotification.php.

Referenced by ilObjExercise\delete(), ilObjExerciseGUI\getEditFormCustomValues(), ilExSubmissionBaseGUI\handleNewUpload(), and ilObjExerciseGUI\updateCustom().

◆ TYPE_LM_BLOCKED_USERS

const ilNotification::TYPE_LM_BLOCKED_USERS = 7

Definition at line 23 of file class.ilNotification.php.

Referenced by ilObjContentObjectGUI\getPropertiesFormValues(), ilLMPageGUI\processAnswer(), and ilObjContentObjectGUI\saveProperties().

◆ TYPE_POLL

const ilNotification::TYPE_POLL = 6

Definition at line 22 of file class.ilNotification.php.

Referenced by ilPollBlockGUI\getHTML(), ilObjPollGUI\sendNotifications(), ilObjPollGUI\subscribe(), and ilObjPollGUI\unsubscribe().

◆ TYPE_WIKI

const ilNotification::TYPE_WIKI = 2

Definition at line 18 of file class.ilNotification.php.

Referenced by ilWikiPageGUI\addHeaderAction(), ilWikiPage\create(), ilObjWiki\delete(), ilWikiPageGUI\executeCommand(), and ilWikiUtil\sendNotification().

◆ TYPE_WIKI_PAGE

const ilNotification::TYPE_WIKI_PAGE = 3

Definition at line 19 of file class.ilNotification.php.

Referenced by ilWikiPageGUI\addHeaderAction(), ilWikiPage\delete(), ilWikiPageGUI\executeCommand(), ilWikiPageGUI\observeNoteAction(), ilWikiUtil\sendNotification(), and ilWikiPage\update().

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

Services/Notification/classes/class.ilNotification.php

Static Public Member Functions

Data Fields

Detailed Description

Member Function Documentation

◆ getNotificationsForObject()

◆ hasNotification()

◆ hasOptOut()

◆ removeForObject()

◆ removeForUser()

◆ setNotification()

◆ updateNotificationTime()

Field Documentation

◆ THRESHOLD

◆ TYPE_BLOG

◆ TYPE_DATA_COLLECTION

◆ TYPE_EXERCISE_SUBMISSION

◆ TYPE_LM_BLOCKED_USERS

◆ TYPE_POLL

◆ TYPE_WIKI

◆ TYPE_WIKI_PAGE