Settings template application class. More...

Collaboration diagram for ilSettingsTemplate:

Public Member Functions
	__construct ($a_id=0, $config=null)
	Constructor. More...

	setId ($a_val)
	Set id. More...

	getId ()
	Get id. More...

	setTitle ($a_val)
	Set title. More...

	getTitle ()
	Get title. More...

	setType ($a_val)
	Set type. More...

	getType ()
	Get type. More...

	setDescription ($a_val)
	Set description. More...

	getDescription ()
	Get description. More...

	setSetting ($a_setting, $a_value, $a_hide=false)
	Set setting. More...

	removeSetting ($a_setting)
	Remove setting. More...

	removeAllSettings ()
	Remove all settings. More...

	getSettings ()
	Get settings. More...

	addHiddenTab ($a_tab_id)
	Add hidden tab. More...

	removeAllHiddenTabs ()
	Remove all hidden tabs. More...

	getHiddenTabs ()
	Get hidden tabs. More...

	getConfig ()
	Returns the template config associated with this template or NULL if none is given. More...

	setConfig (ilSettingsTemplateConfig $config)
	Sets the template config for this template. More...

	read ()
	Read. More...

	create ()
	Create settings template. More...

	update ()
	Update settings template. More...

	insertHiddenTabs ()
	Insert hidden tabs. More...

	delete ()
	Delete settings template. More...

Static Public Member Functions
static	getAllSettingsTemplates ($a_type)
	Get all settings templates of type. More...

static	lookupTitle ($a_id)
	Lookup title. More...

Static Protected Member Functions
static	lookupProperty ($a_id, $a_prop)
	Lookup property. More...

Private Member Functions
	insertSettings ()
	Insert settings to db. More...

Private Attributes
	$id

	$type

	$title

	$description

	$setting = array()

	$hidden_tab = array()

	$config

Detailed Description

Settings template application class.

Author: Alex Killing <alex.killing>

Version: $Id$

Definition at line 11 of file class.ilSettingsTemplate.php.

Constructor & Destructor Documentation

◆ __construct()

ilSettingsTemplate::__construct	(	$a_id = `0`,
		$config = `null`
	)

Constructor.

Parameters

Definition at line 31 of file class.ilSettingsTemplate.php.

References $config, read(), setConfig(), and setId().

         {
                 if ($a_id > 0)
                 {
                         if ($config)
                             $this->setConfig($config);
                         $this->setId($a_id);
                         $this->read();
                 }
         }

Here is the call graph for this function:

Member Function Documentation

◆ addHiddenTab()

ilSettingsTemplate::addHiddenTab ( $a_tab_id )

Add hidden tab.

Parameters

string tab id

Returns

Definition at line 180 of file class.ilSettingsTemplate.php.

Referenced by read().

         {
                 $this->hidden_tab[$a_tab_id] = $a_tab_id;
         }

Here is the caller graph for this function:

◆ create()

ilSettingsTemplate::create ( )

Create settings template.

Definition at line 263 of file class.ilSettingsTemplate.php.

References getDescription(), getId(), getTitle(), getType(), insertHiddenTabs(), insertSettings(), and setId().

         {
                 global $ilDB;
 
                 $this->setId($ilDB->nextId("adm_settings_template"));
 
                 // write template
                 $ilDB->insert("adm_settings_template", array(
                         "id" => array("integer", $this->getId()),
                         "title" => array("text", $this->getTitle()),
                         "type" => array("text", $this->getType()),
                         "description" => array("clob", $this->getDescription())
                         ));
 
                 // write settings
                 $this->insertSettings();
 
                 // write hidden tabs
                 $this->insertHiddenTabs();
         }

Here is the call graph for this function:

◆ delete()

ilSettingsTemplate::delete ( )

Delete settings template.

Definition at line 353 of file class.ilSettingsTemplate.php.

         {
                 global $ilDB;
 
                 $ilDB->manipulate("DELETE FROM adm_settings_template WHERE "
                         ." id = ".$ilDB->quote($this->getId(), "integer")
                         );
                 $ilDB->manipulate("DELETE FROM adm_set_templ_value WHERE "
                         ." template_id = ".$ilDB->quote($this->getId(), "integer")
                         );
                 $ilDB->manipulate("DELETE FROM adm_set_templ_hide_tab WHERE "
                         ." template_id = ".$ilDB->quote($this->getId(), "integer")
                         );
         }

◆ getAllSettingsTemplates()

static ilSettingsTemplate::getAllSettingsTemplates ( $a_type )

static

Get all settings templates of type.

Parameters

string $a_type object type

Definition at line 373 of file class.ilSettingsTemplate.php.

Referenced by ilSettingsTemplateTableGUI\__construct(), ilObjSurveyGUI\addDidacticTemplateOptions(), ilObjTestGUI\addDidacticTemplateOptions(), and ilObjSurveyGUI\importFileObject().

         {
                 global $ilDB;
 
                 $set = $ilDB->query("SELECT * FROM adm_settings_template ".
                         " WHERE type = ".$ilDB->quote($a_type, "text").
                         " ORDER BY title");
 
                 $settings_template = array();
                 while ($rec = $ilDB->fetchAssoc($set))
                 {
                         $settings_template[] = $rec;
                 }
 
                 return $settings_template;
         }

Here is the caller graph for this function:

◆ getConfig()

ilSettingsTemplate::getConfig ( )

Returns the template config associated with this template or NULL if none is given.

Returns: ilSettingsTemplateConfig

Definition at line 207 of file class.ilSettingsTemplate.php.

References $config.

Referenced by setSetting().

                                     {
             return $this->config;
         }

Here is the caller graph for this function:

◆ getDescription()

ilSettingsTemplate::getDescription ( )

Get description.

Returns: string description

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

References $description.

Referenced by create(), and update().

         {
                 return $this->description;
         }

Here is the caller graph for this function:

◆ getHiddenTabs()

ilSettingsTemplate::getHiddenTabs ( )

Get hidden tabs.

Definition at line 196 of file class.ilSettingsTemplate.php.

References $hidden_tab.

Referenced by insertHiddenTabs().

         {
                 return $this->hidden_tab;
         }

Here is the caller graph for this function:

◆ getId()

ilSettingsTemplate::getId ( )

Get id.

Returns: integer id

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

References $id.

Referenced by create(), and update().

         {
                 return $this->id;
         }

Here is the caller graph for this function:

◆ getSettings()

ilSettingsTemplate::getSettings ( )

Get settings.

Definition at line 169 of file class.ilSettingsTemplate.php.

References $setting.

Referenced by insertSettings().

         {
                 return $this->setting;
         }

Here is the caller graph for this function:

◆ getTitle()

ilSettingsTemplate::getTitle ( )

Get title.

Returns: string title

Definition at line 77 of file class.ilSettingsTemplate.php.

References $title.

Referenced by create(), and update().

         {
                 return $this->title;
         }

Here is the caller graph for this function:

◆ getType()

ilSettingsTemplate::getType ( )

Get type.

Returns: string type

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

References $type.

Referenced by create(), and update().

         {
                 return $this->type;
         }

Here is the caller graph for this function:

◆ insertHiddenTabs()

ilSettingsTemplate::insertHiddenTabs ( )

Insert hidden tabs.

Definition at line 336 of file class.ilSettingsTemplate.php.

References getHiddenTabs().

Referenced by create(), and update().

         {
                 global $ilDB;
 
                 foreach ($this->getHiddenTabs() as $tab_id)
                 {
                         $ilDB->manipulate("INSERT INTO adm_set_templ_hide_tab ".
                                 "(template_id, tab_id) VALUES (".
                                 $ilDB->quote($this->getId(), "integer").",".
                                 $ilDB->quote($tab_id, "text").
                                 ")");
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ insertSettings()

ilSettingsTemplate::insertSettings ( )

private

Insert settings to db.

Definition at line 317 of file class.ilSettingsTemplate.php.

References getSettings().

Referenced by create(), and update().

         {
                 global $ilDB;
 
                 foreach ($this->getSettings() as $s => $set)
                 {
                         $ilDB->manipulate("INSERT INTO adm_set_templ_value ".
                                 "(template_id, setting, value, hide) VALUES (".
                                 $ilDB->quote($this->getId(), "integer").",".
                                 $ilDB->quote($s, "text").",".
                                 $ilDB->quote($set["value"], "text").",".
                                 $ilDB->quote($set["hide"], "integer").
                                 ")");
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ lookupProperty()

static ilSettingsTemplate::lookupProperty	(	$a_id,
		$a_prop
	)

staticprotected

Lookup property.

Parameters

id level id

Returns: mixed property value

Definition at line 396 of file class.ilSettingsTemplate.php.

Referenced by lookupTitle().

         {
                 global $ilDB;
 
                 $set = $ilDB->query("SELECT $a_prop FROM adm_settings_template WHERE ".
                         " id = ".$ilDB->quote($a_id, "integer")
                         );
                 $rec = $ilDB->fetchAssoc($set);
                 return $rec[$a_prop];
         }

Here is the caller graph for this function:

◆ lookupTitle()

static ilSettingsTemplate::lookupTitle ( $a_id )

static

Lookup title.

Parameters

Definition at line 413 of file class.ilSettingsTemplate.php.

References lookupProperty().

Referenced by ilSettingsTemplateGUI\confirmSettingsTemplateDeletion(), and ilObjSurveyGUI\propertiesObject().

         {
                 return ilSettingsTemplate::lookupProperty($a_id, "title");
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ read()

ilSettingsTemplate::read ( )

Read.

Parameters

Definition at line 227 of file class.ilSettingsTemplate.php.

References addHiddenTab(), setDescription(), setSetting(), setTitle(), and setType().

Referenced by __construct().

         {
                 global $ilDB;
 
                 // read template
                 $set = $ilDB->query("SELECT * FROM adm_settings_template WHERE ".
                         " id = ".$ilDB->quote($this->getId(), "integer")
                         );
                 $rec = $ilDB->fetchAssoc($set);
                 $this->setTitle($rec["title"]);
                 $this->setType($rec["type"]);
                 $this->setDescription($rec["description"]);
 
                 // read template setttings
                 $set = $ilDB->query("SELECT * FROM adm_set_templ_value WHERE ".
                         " template_id = ".$ilDB->quote($this->getId(), "integer")
                         );
                 while ($rec = $ilDB->fetchAssoc($set))
                 {
                         $this->setSetting($rec["setting"],
                                 $rec["value"], $rec["hide"]);
                 }
 
                 // read hidden tabs
                 $set = $ilDB->query("SELECT * FROM adm_set_templ_hide_tab WHERE ".
                         " template_id = ".$ilDB->quote($this->getId(), "integer")
                         );
                 while ($rec = $ilDB->fetchAssoc($set))
                 {
                         $this->addHiddenTab($rec["tab_id"]);
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeAllHiddenTabs()

ilSettingsTemplate::removeAllHiddenTabs ( )

Remove all hidden tabs.

Definition at line 188 of file class.ilSettingsTemplate.php.

         {
                 $this->hidden_tab = array();
         }

◆ removeAllSettings()

ilSettingsTemplate::removeAllSettings ( )

Remove all settings.

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

         {
                 $this->setting = array();
         }

◆ removeSetting()

ilSettingsTemplate::removeSetting ( $a_setting )

Remove setting.

Parameters

string setting

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

         {
                 unset($this->setting[$a_setting]);
         }

◆ setConfig()

ilSettingsTemplate::setConfig ( ilSettingsTemplateConfig $config )

Sets the template config for this template.

Parameters

ilSettingsTemplateConfig $config

Definition at line 216 of file class.ilSettingsTemplate.php.

References $config.

Referenced by __construct().

                                                                     {
             $this->config = $config;
         }

Here is the caller graph for this function:

◆ setDescription()

ilSettingsTemplate::setDescription ( $a_val )

Set description.

Parameters

string $a_val description

Definition at line 107 of file class.ilSettingsTemplate.php.

Referenced by read().

         {
                 $this->description = $a_val;
         }

Here is the caller graph for this function:

◆ setId()

ilSettingsTemplate::setId ( $a_val )

Set id.

Parameters

integer id

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

Referenced by __construct(), and create().

         {
                 $this->id = $a_val;
         }

Here is the caller graph for this function:

◆ setSetting()

ilSettingsTemplate::setSetting	(	$a_setting,
		$a_value,
		$a_hide = `false`
	)

Set setting.

Parameters

string	setting
mixed	value
boolean	hide the setting?

Definition at line 129 of file class.ilSettingsTemplate.php.

References ilSettingsTemplateConfig\CHECKBOX, and getConfig().

Referenced by read().

         {
                 if ($this->getConfig()) {
                     $settings = $this->getConfig()->getSettings();
 
                     if ($settings[$a_setting]['type'] == ilSettingsTemplateConfig::CHECKBOX) {
                         if (is_array($a_value))
                             $a_value = serialize($a_value);
                         else
                             $a_value = unserialize($a_value);
                     }
                 }
 
                 $this->setting[$a_setting] = array(
                         "value" => $a_value,
                         "hide" => $a_hide
                 );
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTitle()

ilSettingsTemplate::setTitle ( $a_val )

Set title.

Parameters

string title

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

Referenced by read().

         {
                 $this->title = $a_val;
         }

Here is the caller graph for this function:

◆ setType()

ilSettingsTemplate::setType ( $a_val )

Set type.

Parameters

string $a_val type

Definition at line 87 of file class.ilSettingsTemplate.php.

Referenced by read().

         {
                 $this->type = $a_val;
         }

Here is the caller graph for this function:

◆ update()

ilSettingsTemplate::update ( )

Update settings template.

Definition at line 287 of file class.ilSettingsTemplate.php.

References getDescription(), getId(), getTitle(), getType(), insertHiddenTabs(), and insertSettings().

         {
                 global $ilDB;
 
                 // update template
                 $ilDB->update("adm_settings_template", array(
                         "title" => array("text", $this->getTitle()),
                         "type" => array("text", $this->getType()),
                         "description" => array("clob", $this->getDescription())
                         ), array(
                         "id" => array("integer", $this->getId()),
                         ));
 
                 // delete settings and hidden tabs
                 $ilDB->manipulate("DELETE FROM adm_set_templ_value WHERE "
                         ." template_id = ".$ilDB->quote($this->getId(), "integer")
                         );
                 $ilDB->manipulate("DELETE FROM adm_set_templ_hide_tab WHERE "
                         ." template_id = ".$ilDB->quote($this->getId(), "integer")
                         );
 
                 // insert settings and hidden tabs
                 $this->insertSettings();
                 $this->insertHiddenTabs();
 
         }

Here is the call graph for this function:

Field Documentation

◆ $config

ilSettingsTemplate::$config

private

Definition at line 24 of file class.ilSettingsTemplate.php.

Referenced by __construct(), getConfig(), and setConfig().

◆ $description

ilSettingsTemplate::$description

private

Definition at line 16 of file class.ilSettingsTemplate.php.

Referenced by getDescription().

◆ $hidden_tab

ilSettingsTemplate::$hidden_tab = array()

private

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

Referenced by getHiddenTabs().

◆ $id

ilSettingsTemplate::$id

private

Definition at line 13 of file class.ilSettingsTemplate.php.

Referenced by getId().

◆ $setting

ilSettingsTemplate::$setting = array()

private

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

Referenced by getSettings().

◆ $title

ilSettingsTemplate::$title

private

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

Referenced by getTitle().

◆ $type

ilSettingsTemplate::$type

private

Definition at line 14 of file class.ilSettingsTemplate.php.

Referenced by getType().

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

Services/Administration/classes/class.ilSettingsTemplate.php

Public Member Functions

Static Public Member Functions

Static Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addHiddenTab()

◆ create()

◆ delete()

◆ getAllSettingsTemplates()

◆ getConfig()

◆ getDescription()

◆ getHiddenTabs()

◆ getId()

◆ getSettings()

◆ getTitle()

◆ getType()

◆ insertHiddenTabs()

◆ insertSettings()

◆ lookupProperty()

◆ lookupTitle()

◆ read()

◆ removeAllHiddenTabs()

◆ removeAllSettings()

◆ removeSetting()

◆ setConfig()

◆ setDescription()

◆ setId()

◆ setSetting()

◆ setTitle()

◆ setType()

◆ update()

Field Documentation

◆ $config

◆ $description

◆ $hidden_tab

◆ $id

◆ $setting

◆ $title

◆ $type