ilNotificationOSDHandler Class Reference

Notification handler for senden a notification popup to the recipients browser. More...

Inheritance diagram for ilNotificationOSDHandler:

Collaboration diagram for ilNotificationOSDHandler:

Public Member Functions
	notify (ilNotificationObject $notification)
	showSettings ($item)
Public Member Functions inherited from ilNotificationEchoHandler
	notify (ilNotificationObject $notification)
Public Member Functions inherited from ilNotificationHandler
	notify (ilNotificationObject $notification)
	showSettings ($form)

Static Public Member Functions
static	getNotificationsForUser ($user_id, $append_osd_id_to_link=true, $max_age_seconds=0)
static	removeNotification ($notification_osd_id)
	Removes a notifcation and triggers a follow up notification to remove the notification from the browser view of the original recipient. More...
static	cleanup ()
	Remove orphaned notifications. More...
static	cleanupOnRandom ()
	Exec self::clean with a probability of 1%. More...

Static Private Member Functions
static	appendOsdIdToLinks ($subject, $osd_id)
static	appendParamToLink ($link, $param, $value)
	Helper to append an additional parameter to an existing url. More...

Detailed Description

Notification handler for senden a notification popup to the recipients browser.

Definition at line 10 of file class.ilNotificationOSDHandler.php.

Member Function Documentation

appendOsdIdToLinks()

static ilNotificationOSDHandler::appendOsdIdToLinks (   $subject,   $osd_id  )

staticprivate

Definition at line 80 of file class.ilNotificationOSDHandler.php.

References array.

    {
        $matches = array();
        preg_match_all('/href="(.*?)"/', $subject, $matches);
        if ($matches[1]) {
            foreach ($matches[1] as $match) {
                $match_appended = self::appendParamToLink($match, 'osd_id', $osd_id);
                $subject = str_replace($match, $match_appended, $subject);
            }
        }
        return $subject;
    }

appendParamToLink()

static ilNotificationOSDHandler::appendParamToLink (   $link,   $param,   $value  )

staticprivate

Helper to append an additional parameter to an existing url.

Parameters

string	$link
string	$param
scalar	$value

Returns

string

Definition at line 161 of file class.ilNotificationOSDHandler.php.

    {
        if (strpos($link, '?') !== false) {
            $link .= '&' . $param . '=' . $value;
        } else {
            $link .= '?' . $param . '=' . $value;
        }
        return $link;
    }

cleanup()

static ilNotificationOSDHandler::cleanup ( )

static

Remove orphaned notifications.

ilDB $ilDB

Definition at line 135 of file class.ilNotificationOSDHandler.php.

References $ilDB, $query, ilNotificationSetupHelper\$tbl_notification_osd_handler, and time.

    {
        global $ilDB;
        $query = 'DELETE FROM ' . ilNotificationSetupHelper::$tbl_notification_osd_handler . ' WHERE valid_until < ' . $ilDB->quote(time(), 'integer');
        $ilDB->manipulate($query);
    }

cleanupOnRandom()

static ilNotificationOSDHandler::cleanupOnRandom ( )

static

Exec self::clean with a probability of 1%.

Definition at line 145 of file class.ilNotificationOSDHandler.php.

    {
        $rnd = rand(0, 10000);
        if ($rnd == 500) {
            self::cleanup();
        }
    }

getNotificationsForUser()

static ilNotificationOSDHandler::getNotificationsForUser (   $user_id,   $append_osd_id_to_link = true,   $max_age_seconds = 0  )

static

Definition at line 45 of file class.ilNotificationOSDHandler.php.

References $ilDB, $query, $row, ilNotificationSetupHelper\$tbl_notification_osd_handler, array, and time.

Referenced by ilNotificationGUI\getOSDNotificationsObject(), and ilNotificationOSDGUI\render().

    {
        global $ilDB;

        $query = 'SELECT notification_osd_id, serialized, valid_until, visible_for, type FROM ' . ilNotificationSetupHelper::$tbl_notification_osd_handler
            . ' WHERE usr_id = %s AND (valid_until = 0 OR valid_until > ' . $ilDB->quote(time(), 'integer') . ') AND time_added > %s';

        $types = array('integer', 'integer');
        $values = array($user_id, $max_age_seconds ? (time() - $max_age_seconds) : 0);

        $rset = $ilDB->queryF($query, $types, $values);
        $notifications = array();

        while ($row = $ilDB->fetchAssoc($rset)) {
            $row['data'] = unserialize($row['serialized']);
            unset($row['serialized']);

            $row['data']->handlerParams = array('general' => $row['data']->handlerParams[''], 'osd' => $row['data']->handlerParams['osd']);

            if ($append_osd_id_to_link) {
                if ($row['data']->link) {
                    $row['data']->link = self::appendParamToLink($row['data']->link, 'osd_id', $row['notification_osd_id']);
                }

                $row['data']->shortDescription = self::appendOsdIdToLinks($row['data']->shortDescription, $row['notification_osd_id']);
                $row['data']->longDescription = self::appendOsdIdToLinks($row['data']->longDescription, $row['notification_osd_id']);
            }
            $notifications[] = $row;
        }

        self::cleanupOnRandom();

        return $notifications;
    }

Here is the caller graph for this function:

notify()

ilNotificationOSDHandler::notify

(

ilNotificationObject

$notification

)

Definition at line 12 of file class.ilNotificationOSDHandler.php.

References $id, $ilDB, ilNotificationSetupHelper\$tbl_notification_osd_handler, array, and time.

    {
        global $ilDB;

        $id = $ilDB->nextId(ilNotificationSetupHelper::$tbl_notification_osd_handler);

        $ilDB->insert(
            ilNotificationSetupHelper::$tbl_notification_osd_handler,
            array(
                    'notification_osd_id' => array('integer', $id),
                    'usr_id' => array('integer', $notification->user->getId()),
                    'serialized' => array('text', serialize($notification)),
                    'valid_until' => array('integer', $notification->baseNotification->getValidForSeconds() ? ($notification->baseNotification->getValidForSeconds() + time()) : 0),
                    'visible_for' => array('integer', $notification->baseNotification->getVisibleForSeconds() ? $notification->baseNotification->getVisibleForSeconds() : 0),
                    'type' => array('text', $notification->baseNotification->getType()),
                    'time_added' => array('integer', time()),
                )
        );
    }

removeNotification()

static ilNotificationOSDHandler::removeNotification (   $notification_osd_id )

static

Removes a notifcation and triggers a follow up notification to remove the notification from the browser view of the original recipient.

ilDB $ilDB

Parameters

integer

$notification_osd_id

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

References $ilDB, $query, $row, ilNotificationSetupHelper\$tbl_notification_osd_handler, and array.

Referenced by ilPublicUserProfileGUI\executeCommand(), and ilNotificationGUI\removeOSDNotificationsObject().

    {
        global $ilDB;

        $query = 'SELECT usr_id FROM ' . ilNotificationSetupHelper::$tbl_notification_osd_handler . ' WHERE notification_osd_id = %s';
        $types = array('integer');
        $values = array($notification_osd_id);

        $rset = $ilDB->queryF($query, $types, $values);

        if ($row = $ilDB->fetchAssoc($rset)) {
            $query = 'DELETE FROM ' . ilNotificationSetupHelper::$tbl_notification_osd_handler . ' WHERE notification_osd_id = %s';
            $types = array('integer');
            $values = array($notification_osd_id);

            $ilDB->manipulateF($query, $types, $values);

            // sends a "delete the given notification" notification using the
            // osd_maint channel
            /*$deletedNotification = new ilNotificationConfig('osd_maint');
            $deletedNotification->setValidForSeconds(120);
            $deletedNotification->setTitleVar('deleted');
            $deletedNotification->setShortDescriptionVar($notification_osd_id);
            $deletedNotification->setLongDescriptionVar('dummy');

            require_once 'Services/Notifications/classes/class.ilNotificationSystem.php';
            ilNotificationSystem::sendNotificationToUsers($deletedNotification, array($row['usr_id']));*/
        }
    }

Here is the caller graph for this function:

showSettings()

ilNotificationOSDHandler::showSettings

(

$item

)

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

References $lng, $txt, and array.

    {
        global $lng;
        $txt = new ilTextInputGUI($lng->txt('polling_intervall'), 'osd_polling_intervall');
        $txt->setRequired(true);
        $txt->setInfo($lng->txt('polling_in_seconds'));
        $txt->setValue('300');

        $item->addSubItem($txt);

        return array('osd_polling_intervall');
    }

---

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

• Services/Notifications/classes/class.ilNotificationOSDHandler.php