News settings for containers. More...

Collaboration diagram for ilContainerNewsSettingsGUI:

Public Member Functions
	__construct (ilObjectGUI $a_parent_gui)
	Constructor. More...

	executeCommand ()
	Execute command. More...

	show ()
	Show. More...

	initForm ()
	Init settings form. More...

	save ()
	Save settings form. More...

	initDefaultOptions ()
	Set all possible news options as false;. More...

	setTimeline (bool $a_value)
	Set if the container has timeline or not. More...

	getTimeline ()
	Get if the container has timeline or not. More...

	setCronNotifications (bool $a_value)
	Set if the container has a configurable cron job to send notifications. More...

	getCronNotifications ()
	Get if the container has a configurable cron job to send notifications. More...

	setHideByDate (bool $a_value)
	Set if the container can hide news created before a date. More...

	getHideByDate ()
	Get if the container can hide news created before a date. More...

	setPublicNotification (bool $a_value)
	Set if this repository object has public notifications. More...

	getPublicNotification ()
	Get if this repository object has public notifications available. More...

	setNewsBlockForced (bool $a_value)
	Set if the News block is forced. More...

	getNewsBlockForced ()
	Get if the repository object has the news block forced. More...

Protected Attributes
	$ctrl

	$tpl

	$lng

	$setting

	$parent_gui

	$object

	$has_timeline

	$has_cron_notifications

	$has_hide_by_date

	$has_public_notification

	$has_block_forced

Detailed Description

News settings for containers.

Author: Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

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

Constructor & Destructor Documentation

◆ __construct()

ilContainerNewsSettingsGUI::__construct ( ilObjectGUI $a_parent_gui )

Constructor.

Definition at line 72 of file class.ilContainerNewsSettingsGUI.php.

References $DIC, and initDefaultOptions().

     {
         global $DIC;
 
         $this->ctrl = $DIC->ctrl();
         $this->lng = $DIC->language();
         $this->lng->loadLanguageModule("news");
         $this->tpl = $DIC["tpl"];
         $this->setting = $DIC["ilSetting"];
         $this->parent_gui = $a_parent_gui;
         $this->object = $this->parent_gui->object;
 
         $this->initDefaultOptions();
     }

Here is the call graph for this function:

Member Function Documentation

◆ executeCommand()

ilContainerNewsSettingsGUI::executeCommand ( )

Execute command.

Definition at line 90 of file class.ilContainerNewsSettingsGUI.php.

     {
         $next_class = $this->ctrl->getNextClass($this);
         $cmd = $this->ctrl->getCmd("show");
 
         switch ($next_class) {
             default:
                 if (in_array($cmd, array("show", "save"))) {
                     $this->$cmd();
                 }
         }
     }

◆ getCronNotifications()

ilContainerNewsSettingsGUI::getCronNotifications ( )

Get if the container has a configurable cron job to send notifications.

Returns: mixed

Definition at line 321 of file class.ilContainerNewsSettingsGUI.php.

                                            : bool
     {
         return $this->getCronNotifications();
     }

◆ getHideByDate()

ilContainerNewsSettingsGUI::getHideByDate ( )

Get if the container can hide news created before a date.

Returns: bool

Definition at line 339 of file class.ilContainerNewsSettingsGUI.php.

References $has_hide_by_date.

                                     : bool
     {
         return $this->has_hide_by_date;
     }

◆ getNewsBlockForced()

ilContainerNewsSettingsGUI::getNewsBlockForced ( )

Get if the repository object has the news block forced.

Returns: bool

Definition at line 375 of file class.ilContainerNewsSettingsGUI.php.

References $has_block_forced.

                                          : bool
     {
         return $this->has_block_forced;
     }

◆ getPublicNotification()

ilContainerNewsSettingsGUI::getPublicNotification ( )

Get if this repository object has public notifications available.

Returns: bool

Definition at line 357 of file class.ilContainerNewsSettingsGUI.php.

References $has_public_notification.

     {
         return $this->has_public_notification;
     }

◆ getTimeline()

ilContainerNewsSettingsGUI::getTimeline ( )

Get if the container has timeline or not.

Returns: bool

Definition at line 303 of file class.ilContainerNewsSettingsGUI.php.

References $has_timeline.

                                   : bool
     {
         return $this->has_timeline;
     }

◆ initDefaultOptions()

ilContainerNewsSettingsGUI::initDefaultOptions ( )

Set all possible news options as false;.

Definition at line 282 of file class.ilContainerNewsSettingsGUI.php.

Referenced by __construct().

     {
         $this->has_timeline = false;
         $this->has_cron_notifications = false;
         $this->has_hide_by_date = false;
         $this->has_block_forced = false;
     }

Here is the caller graph for this function:

◆ initForm()

ilContainerNewsSettingsGUI::initForm ( )

Init settings form.

Definition at line 118 of file class.ilContainerNewsSettingsGUI.php.

References ilNewsForContextBlockGUI\$block_type, $form, ilObject\_getAllReferences(), ilBlockSetting\_lookup(), ilObject\_lookupType(), ilMembershipNotifications\addToSettingsForm(), ilNewsForContextBlockGUI\addToSettingsForm(), IL_CAL_DATETIME, ilObjectServiceSettingsGUI\NEWS_VISIBILITY, ilFormPropertyGUI\setInfo(), ilFormPropertyGUI\setRequired(), and ilCheckboxInputGUI\setValue().

Referenced by save(), and show().

     {
         $form = new ilPropertyFormGUI();
         //from crs/grp/cat settings - additional feature - news
 
         if ($this->setting->get('block_activated_news')) {
             $news = new ilCheckboxInputGUI($this->lng->txt('news_news_block'), ilObjectServiceSettingsGUI::NEWS_VISIBILITY);
             $news->setValue(1);
             if ($this->has_block_forced) {
                 $news->setChecked(true);
                 $news->setDisabled(true);
             } else {
                 $news->setChecked($this->object->getNewsBlockActivated());
             }
             $news->setInfo($this->lng->txt('obj_tool_setting_news_info'));
             ilNewsForContextBlockGUI::addToSettingsForm($news);
             $form->addItem($news);
         }
 
         // Timeline (courses and groups)
         if ($this->has_timeline) {
             // timeline
             $cb = new ilCheckboxInputGUI($this->lng->txt("cont_news_timeline"), "news_timeline");
             $cb->setInfo($this->lng->txt("cont_news_timeline_info"));
             $cb->setChecked($this->object->getNewsTimeline());
             $form->addItem($cb);
 
             // ...timeline: auto entries
             $cb2 = new ilCheckboxInputGUI($this->lng->txt("cont_news_timeline_auto_entries"), "news_timeline_auto_entries");
             $cb2->setInfo($this->lng->txt("cont_news_timeline_auto_entries_info"));
             $cb2->setChecked($this->object->getNewsTimelineAutoEntries());
             $cb->addSubItem($cb2);
 
             // ...timeline: landing page
             $cb2 = new ilCheckboxInputGUI($this->lng->txt("cont_news_timeline_landing_page"), "news_timeline_landing_page");
             $cb2->setInfo($this->lng->txt("cont_news_timeline_landing_page_info"));
             $cb2->setChecked($this->object->getNewsTimelineLandingPage());
             $cb->addSubItem($cb2);
         }
 
         // Cron Notifications (courses and groups)
         if ($this->has_cron_notifications) {
             if (in_array(ilObject::_lookupType($this->object->getId()), array('crs', 'grp'))) {
                 $ref_id = array_pop(ilObject::_getAllReferences($this->object->getId()));
                 include_once 'Services/Membership/classes/class.ilMembershipNotifications.php';
                 ilMembershipNotifications::addToSettingsForm($ref_id, $form, null);
             }
         }
 
         $block_id = $this->ctrl->getContextObjId();
 
         // Visibility by date
         $hide_news_per_date = ilBlockSetting::_lookup(
             ilNewsForContextBlockGUI::$block_type,
             "hide_news_per_date",
             0,
             $block_id
         );
         $hide_news_date = ilBlockSetting::_lookup(
             ilNewsForContextBlockGUI::$block_type,
             "hide_news_date",
             0,
             $block_id
         );
 
         if ($hide_news_date != "") {
             $hide_news_date = explode(" ", $hide_news_date);
         }
 
         // Hide news before a date (courses, groups and categories)
         if ($this->has_hide_by_date) {
             //Hide news per date
             $hnpd = new ilCheckboxInputGUI(
                 $this->lng->txt("news_hide_news_per_date"),
                 "hide_news_per_date"
             );
             $hnpd->setInfo($this->lng->txt("news_hide_news_per_date_info"));
             $hnpd->setChecked($hide_news_per_date);
 
             $dt_prop = new ilDateTimeInputGUI($this->lng->txt("news_hide_news_date"), "hide_news_date");
             $dt_prop->setRequired(true);
 
             if ($hide_news_date != "") {
                 $dt_prop->setDate(new ilDateTime($hide_news_date[0] . ' ' . $hide_news_date[1], IL_CAL_DATETIME));
             }
 
             $dt_prop->setShowTime(true);
 
             $hnpd->addSubItem($dt_prop);
 
             $form->addItem($hnpd);
         }
 
         // public notifications (forums)
         if ($this->has_public_notification) {
             $public = ilBlockSetting::_lookup("news", "public_notifications", 0, $block_id);
 
             $ch = new ilCheckboxInputGUI(
                 $this->lng->txt("news_notifications_public"),
                 "public_notifications"
             );
             $ch->setInfo($this->lng->txt("news_notifications_public_info"));
             $ch->setChecked($public);
             $form->addItem($ch);
         }
 
         $form->setTitle($this->lng->txt("cont_news_settings"));
         $form->setFormAction($this->ctrl->getFormAction($this));
         $form->addCommandButton("save", $this->lng->txt("save"));
 
         return $form;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ save()

ilContainerNewsSettingsGUI::save ( )

Save settings form.

Definition at line 234 of file class.ilContainerNewsSettingsGUI.php.

References $_POST, $form, ilObject\_getAllReferences(), ilObject\_lookupType(), ilMembershipNotifications\importFromForm(), initForm(), ilObjectServiceSettingsGUI\NEWS_VISIBILITY, and ilNewsForContextBlockGUI\writeSettings().

     {
         $form = $this->initForm();
         if ($form->checkInput()) {
             include_once("./Services/Object/classes/class.ilObjectServiceSettingsGUI.php");
             //non container objects force this news block (forums etc.)
             if (!$this->has_block_forced) {
                 $this->object->setNewsBlockActivated($form->getInput(ilObjectServiceSettingsGUI::NEWS_VISIBILITY));
             }
             if ($this->has_timeline) {
                 $this->object->setNewsTimeline($form->getInput("news_timeline"));
                 $this->object->setNewsTimelineAutoEntries($form->getInput("news_timeline_auto_entries"));
                 $this->object->setNewsTimelineLandingPage($form->getInput("news_timeline_landing_page"));
             }
             if ($this->setting->get('block_activated_news')) {
                 //save contextblock settings
                 $context_block_settings = array(
                     "public_feed" => $_POST["notifications_public_feed"],
                     "default_visibility" => $_POST["default_visibility"],
                     "hide_news_per_date" => $_POST["hide_news_per_date"],
                     "hide_news_date" => $_POST["hide_news_date"]
                 );
                 if ($this->has_public_notification) {
                     $context_block_settings["public_notifications"] = $_POST['public_notifications'];
                 }
 
                 ilNewsForContextBlockGUI::writeSettings($context_block_settings);
 
                 if (in_array(ilObject::_lookupType($this->object->getId()), array('crs', 'grp'))) {
                     $ref_id = array_pop(ilObject::_getAllReferences($this->object->getId()));
 
                     include_once "Services/Membership/classes/class.ilMembershipNotifications.php";
                     ilMembershipNotifications::importFromForm($ref_id, $form);
                 }
             }
 
             $this->object->update();
             ilUtil::sendSuccess($this->lng->txt("msg_obj_modified"), true);
             $this->ctrl->redirect($this, "");
         } else {
             $form->setValuesByPost();
             $this->tpl->setContent($form->getHtml());
         }
     }

Here is the call graph for this function:

◆ setCronNotifications()

ilContainerNewsSettingsGUI::setCronNotifications ( bool $a_value )

Set if the container has a configurable cron job to send notifications.

Parameters

bool $a_value

Definition at line 312 of file class.ilContainerNewsSettingsGUI.php.

     {
         $this->has_cron_notifications = $a_value;
     }

◆ setHideByDate()

ilContainerNewsSettingsGUI::setHideByDate ( bool $a_value )

Set if the container can hide news created before a date.

Parameters

bool $a_value

Definition at line 330 of file class.ilContainerNewsSettingsGUI.php.

     {
         $this->has_hide_by_date = $a_value;
     }

◆ setNewsBlockForced()

ilContainerNewsSettingsGUI::setNewsBlockForced ( bool $a_value )

Set if the News block is forced.

Parameters

bool $a_value

Definition at line 366 of file class.ilContainerNewsSettingsGUI.php.

     {
         $this->has_block_forced = $a_value;
     }

◆ setPublicNotification()

ilContainerNewsSettingsGUI::setPublicNotification ( bool $a_value )

Set if this repository object has public notifications.

Parameters

bool $a_value

Definition at line 348 of file class.ilContainerNewsSettingsGUI.php.

     {
         $this->has_public_notification = $a_value;
     }

◆ setTimeline()

ilContainerNewsSettingsGUI::setTimeline ( bool $a_value )

Set if the container has timeline or not.

Parameters

bool $a_value

Definition at line 294 of file class.ilContainerNewsSettingsGUI.php.

     {
         $this->has_timeline = $a_value;
     }

◆ show()

ilContainerNewsSettingsGUI::show ( )

Show.

Parameters

Definition at line 109 of file class.ilContainerNewsSettingsGUI.php.

References $form, and initForm().

     {
         $form = $this->initForm();
         $this->tpl->setContent($form->getHTML());
     }

Here is the call graph for this function:

Field Documentation

◆ $ctrl

ilContainerNewsSettingsGUI::$ctrl

protected

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

◆ $has_block_forced

ilContainerNewsSettingsGUI::$has_block_forced

protected

Definition at line 67 of file class.ilContainerNewsSettingsGUI.php.

Referenced by getNewsBlockForced().

◆ $has_cron_notifications

ilContainerNewsSettingsGUI::$has_cron_notifications

protected

Definition at line 52 of file class.ilContainerNewsSettingsGUI.php.

◆ $has_hide_by_date

ilContainerNewsSettingsGUI::$has_hide_by_date

protected

Definition at line 57 of file class.ilContainerNewsSettingsGUI.php.

Referenced by getHideByDate().

◆ $has_public_notification

ilContainerNewsSettingsGUI::$has_public_notification

protected

Definition at line 62 of file class.ilContainerNewsSettingsGUI.php.

Referenced by getPublicNotification().

◆ $has_timeline

ilContainerNewsSettingsGUI::$has_timeline

protected

Definition at line 47 of file class.ilContainerNewsSettingsGUI.php.

Referenced by getTimeline().

◆ $lng

ilContainerNewsSettingsGUI::$lng

protected

Definition at line 27 of file class.ilContainerNewsSettingsGUI.php.

◆ $object

ilContainerNewsSettingsGUI::$object

protected

Definition at line 42 of file class.ilContainerNewsSettingsGUI.php.

◆ $parent_gui

ilContainerNewsSettingsGUI::$parent_gui

protected

Definition at line 37 of file class.ilContainerNewsSettingsGUI.php.

◆ $setting

ilContainerNewsSettingsGUI::$setting

protected

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

◆ $tpl

ilContainerNewsSettingsGUI::$tpl

protected

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

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

Services/Container/classes/class.ilContainerNewsSettingsGUI.php

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ executeCommand()

◆ getCronNotifications()

◆ getHideByDate()

◆ getNewsBlockForced()

◆ getPublicNotification()

◆ getTimeline()

◆ initDefaultOptions()

◆ initForm()

◆ save()

◆ setCronNotifications()

◆ setHideByDate()

◆ setNewsBlockForced()

◆ setPublicNotification()

◆ setTimeline()

◆ show()

Field Documentation

◆ $ctrl

◆ $has_block_forced

◆ $has_cron_notifications

◆ $has_hide_by_date

◆ $has_public_notification

◆ $has_timeline

◆ $lng

◆ $object

◆ $parent_gui

◆ $setting

◆ $tpl