Class ilLearningModuleNotification class. More...

Collaboration diagram for ilLearningModuleNotification:

Public Member Functions
	__construct (string $a_action, int $a_type, ilObjLearningModule $a_learning_module, int $a_page_id, string $a_comment="")

	send ()

Data Fields
const	ACTION_COMMENT = "comment"

const	ACTION_UPDATE = "update"

Protected Member Functions
	getLink ()

	getPageTitle ()

	getMailSubject (ilLanguage $ulng)

	getMailBody (ilLanguage $a_ulng, int $a_user_id)

	getPreviewText (ilLanguage $a_ulng)

Protected Attributes
ilObjUser	$ilUser

ilAccessHandler	$ilAccess

ilLanguage	$lng

ilSetting	$lm_set

string	$action

int	$type

ilObjLearningModule	$learning_module

int	$page_id

string	$comment

string	$link

int	$lm_ref_id

string	$pg_title

Detailed Description

Class ilLearningModuleNotification class.

//TODO create an interface for notifications contract.(ilnotification?).Similar code in ilwikipage, ilblogposting

Author: Jesús López lopez.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 28 of file class.ilLearningModuleNotification.php.

Constructor & Destructor Documentation

◆ __construct()

ilLearningModuleNotification::__construct	(	string	$a_action,
		int	$a_type,
		ilObjLearningModule	$a_learning_module,
		int	$a_page_id,
		string	$a_comment = `""`
	)

Parameters

int $a_type Notification type e.g. ilNotification::TYPE_LM_PAGE

Definition at line 49 of file class.ilLearningModuleNotification.php.

      {
        global $DIC;
 
        $this->ilUser = $DIC->user();
        $this->ilAccess = $DIC->access();
        $this->lng = $DIC->language();
        $this->lng->loadLanguageModule("content");
        $this->lm_set = new ilSetting("lm");
        $this->action = $a_action;
        $this->type = $a_type;
        $this->learning_module = $a_learning_module;
        $this->page_id = $a_page_id;
        $this->comment = $a_comment;
        $this->lm_ref_id = $this->learning_module->getRefId();
        $this->link = $this->getLink();
        $this->pg_title = $this->getPageTitle();
    }

References $DIC, ILIAS\UI\examples\Symbol\Glyph\Comment\comment(), getLink(), getPageTitle(), ILIAS\Repository\link(), and ILIAS\Repository\lng().

Here is the call graph for this function:

Member Function Documentation

◆ getLink()

ilLearningModuleNotification::getLink ( )

protected

Definition at line 120 of file class.ilLearningModuleNotification.php.

                                : string
    {
        // #15192 - should always be present
        if ($this->page_id) {
            // #18804 - see ilWikiPageGUI::preview()
            return ilLink::_getLink(null, "pg", [], $this->page_id . "_" . $this->lm_ref_id);
        }
 
        return ilLink::_getLink($this->lm_ref_id);
    }

Referenced by __construct().

Here is the caller graph for this function:

◆ getMailBody()

ilLearningModuleNotification::getMailBody	(	ilLanguage	$a_ulng,
		int	$a_user_id
	)

protected

Definition at line 153 of file class.ilLearningModuleNotification.php.

                                                                      : string
    {
        $message = sprintf($a_ulng->txt('cont_change_notification_salutation'), ilObjUser::_lookupFullname($a_user_id)) . "\n\n";
        $message .= $a_ulng->txt('cont_notification_' . $this->action . "_lm") . ":\n\n";
        $message .= $a_ulng->txt('learning module') . ": " . $this->learning_module->getTitle() . "\n";
        $message .= $a_ulng->txt('page') . ": " . $this->pg_title . "\n";
        if ($this->action == self::ACTION_COMMENT) {
            // include comment/note text
            $message .= $a_ulng->txt('cont_commented_by') . ": " . ilUserUtil::getNamePresentation($this->ilUser->getId()) . "\n";
            $message .= "\n" . $a_ulng->txt('comment') . ":\n\"" . trim($this->comment) . "\"\n";
        } else {
            $message .= $this->getPreviewText($a_ulng);
        }
 
        $message .= "\n" . $a_ulng->txt('url') . ": " . $this->link;
 
        return $message;
    }

References $link, $message, ilObjUser\_lookupFullname(), ILIAS\UI\examples\Symbol\Glyph\Comment\comment(), ilUserUtil\getNamePresentation(), getPreviewText(), and ilLanguage\txt().

Referenced by send().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMailSubject()

ilLearningModuleNotification::getMailSubject ( ilLanguage $ulng )

protected

Definition at line 144 of file class.ilLearningModuleNotification.php.

                                                       : string
    {
        if ($this->action == self::ACTION_COMMENT) {
            return sprintf($ulng->txt('cont_notification_comment_subject_lm'), $this->learning_module->getTitle(), $this->pg_title);
        }
 
        return sprintf($ulng->txt('cont_change_notification_subject_lm'), $this->learning_module->getTitle(), $this->pg_title);
    }

References ilLanguage\txt().

Referenced by send().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPageTitle()

ilLearningModuleNotification::getPageTitle ( )

protected

Definition at line 131 of file class.ilLearningModuleNotification.php.

                                     : string
    {
        return ilLMPageObject::_getPresentationTitle(
            $this->page_id,
            $this->learning_module->getPageHeader(),
            $this->learning_module->isActiveNumbering(),
            (bool) $this->lm_set->get("time_scheduled_page_activation"),
            false,
            0,
            $this->lng->getLangKey()
        );
    }

References ilLMPageObject\_getPresentationTitle().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPreviewText()

ilLearningModuleNotification::getPreviewText ( ilLanguage $a_ulng )

protected

Definition at line 172 of file class.ilLearningModuleNotification.php.

                                                         : string
    {
        $page = new ilLMPageGUI($this->page_id);
        $page->setRawPageContent(true);
        $page->setAbstractOnly(true);
        $page->setFileDownloadLink(".");
        $page->setFullscreenLink(".");
        $page->setSourcecodeDownloadScript(".");
        $str = $page->showPage();
        $str = ilPageObject::truncateHTML($str, 500, "...");
        // making things more readable
        $str = str_replace('<br/>', "\n", $str);
        $str = str_replace('<br />', "\n", $str);
        $str = str_replace('</p>', "\n", $str);
        $str = str_replace('</div>', "\n", $str);
        $str = trim(strip_tags($str));
 
        $content = "\n" . $a_ulng->txt('content') . "\n" .
            "----------------------------------------\n" .
            $str . "\n" .
            "----------------------------------------\n";
 
        return $content;
    }

References $page, ilPageObject\truncateHTML(), and ilLanguage\txt().

Referenced by getMailBody().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ send()

ilLearningModuleNotification::send ( )

Definition at line 74 of file class.ilLearningModuleNotification.php.

                          : void
    {
        $lm_id = $this->learning_module->getId();
 
        // #11138  //only comment implemented so always true.
        $ignore_threshold = ($this->action == self::ACTION_COMMENT);
 
        $users = ilNotification::getNotificationsForObject(ilNotification::TYPE_LM, $lm_id, null, $ignore_threshold);
 
        if ($this->type == ilNotification::TYPE_LM_PAGE) {
            $page_users = ilNotification::getNotificationsForObject($this->type, $this->page_id, null, $ignore_threshold);
            $users = array_merge($users, $page_users);
            ilNotification::updateNotificationTime(ilNotification::TYPE_LM_PAGE, $this->page_id, $users);
        }
 
        if (!sizeof($users)) {
            return;
        }
 
        ilNotification::updateNotificationTime(ilNotification::TYPE_LM, $lm_id, $users, $this->page_id);
 
 
        foreach (array_unique($users) as $idx => $user_id) {
            if ($user_id != $this->ilUser->getId() &&
                $this->ilAccess->checkAccessOfUser($user_id, 'read', '', $this->lm_ref_id)) {
                // use language of recipient to compose message
                $ulng = ilLanguageFactory::_getLanguageOfUser($user_id);
                $ulng->loadLanguageModule('content');
 
                $subject = $this->getMailSubject($ulng);
                $message = $this->getMailBody($ulng, $user_id);
 
                $mail_obj = new ilMail(ANONYMOUS_USER_ID);
                $mail_obj->appendInstallationSignature(true);
                $mail_obj->enqueue(
                    ilObjUser::_lookupLogin($user_id),
                    "",
                    "",
                    $subject,
                    $message,
                    MailAttachments::empty()
                );
            }
        }
    }