This shows a character selector. More...

Collaboration diagram for ilCharSelectorGUI:

Public Member Functions
	__construct ($a_context=ilCharSelectorConfig::CONTEXT_NONE)
	Constructor. More...

	setConfig (ilCharSelectorConfig $a_config)
	Set the configuraton object. More...

	getConfig ()
	Get the configuraton object. More...

	addFormProperties (ilPropertyFormGUI $a_form)
	add the configuration elements to a property form More...

	setFormValues (ilPropertyFormGUI $a_form)
	Set the values in a property form based on the configuration. More...

	getFormValues (ilPropertyFormGUI $a_form)
	Set the configuration based on the values of a property form. More...

	addToPage ()
	Adds the the character selector to the ilias page Initializes the selector according to the state saved in the user session. More...

	getSelectorHTML ()
	Get the HTML code of the selector panel. More...

	saveState ()
	Save the selector panel state in the user session (This keeps the panel state between page moves) More...

	executeCommand ()
	execute command More...

Static Public Member Functions
static	_isAllowed ()
	Check if the CharSelector is allowed for the current GUI. More...

static	_getCurrentGUI (ilObjTest $a_test_obj=null)
	Get the GUI that is used for the currently available selector (other GUI instances may exist for configuration in property forms) More...

Protected Attributes
	$lng

	$ctrl

	$tpl

Private Attributes
	$config = null

	$added_to_page = false

Static Private Attributes
static	$allowed_guis
	list of command classes for which the char selector is allowed (can also be a parent class of the actual command class) More...

static	$current_gui
	ilCharSelectorGUI instance used for the current selector More...

Detailed Description

This shows a character selector.

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

Constructor & Destructor Documentation

◆ __construct()

ilCharSelectorGUI::__construct ( $a_context = ilCharSelectorConfig::CONTEXT_NONE )

Constructor.

Parameters

string configuration context

Definition at line 59 of file class.ilCharSelectorGUI.php.

References $DIC.

     {
         global $DIC;
 
         $this->lng = $DIC->language();
         $this->ctrl = $DIC->ctrl();
         $this->tpl = $DIC["tpl"];
         $this->config = new ilCharSelectorConfig($a_context);
     }

Member Function Documentation

◆ _getCurrentGUI()

static ilCharSelectorGUI::_getCurrentGUI ( ilObjTest $a_test_obj = null )

static

Get the GUI that is used for the currently available selector (other GUI instances may exist for configuration in property forms)

Parameters

object (optional) current running test

Returns: object

Definition at line 105 of file class.ilCharSelectorGUI.php.

References ilCharSelectorConfig\_getCurrentConfig().

Referenced by ilPropertyFormGUI\getContent(), and ilTestPlayerAbstractGUI\populateCharSelectorIfRequired().

     {
         if (!isset(self::$current_gui)) {
             self::$current_gui = new ilCharSelectorGUI();
             self::$current_gui->setConfig(ilCharSelectorConfig::_getCurrentConfig($a_test_obj));
         }
         return self::$current_gui;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _isAllowed()

static ilCharSelectorGUI::_isAllowed ( )

static

Check if the CharSelector is allowed for the current GUI.

Returns: boolean CharSelector is allowed

Definition at line 73 of file class.ilCharSelectorGUI.php.

References $DIC, and $ilCtrl.

Referenced by ilPropertyFormGUI\getContent().

     {
         global $DIC;
 
         $ilCtrl = $DIC->ctrl();
         
         // get the command class
         // with correct case for checking parent classes
         foreach ($ilCtrl->getCallHistory() as $call) {
             if ($call['mode'] == 'execComm') {
                 $class = $call['class'];
             }
         }
 
         // check the class and her parent classes
         while ($class != false) {
             if (in_array($class, self::$allowed_guis)) {
                 return true;
             }
             $class = get_parent_class($class);
         }
 
         return false;
     }

Here is the caller graph for this function:

◆ addFormProperties()

ilCharSelectorGUI::addFormProperties ( ilPropertyFormGUI $a_form )

add the configuration elements to a property form

Parameters

object property form

Definition at line 136 of file class.ilCharSelectorGUI.php.

References $lng, $tpl, ilPropertyFormGUI\addItem(), ilCharSelectorConfig\CONTEXT_ADMIN, ilCharSelectorConfig\CONTEXT_TEST, ilCharSelectorConfig\CONTEXT_USER, ilCharSelectorConfig\DISABLED, ilCharSelectorConfig\ENABLED, ilCharSelectorConfig\INACTIVE, ilCharSelectorConfig\INHERIT, and ilFormPropertyGUI\setInfo().

Referenced by ilObjAdvancedEditingGUI\initCharSelectorSettingsForm().

     {
         $lng = $this->lng;
         $lng->loadLanguageModule('adve');
 
         require_once('Services/UIComponent/CharSelector/classes/class.ilCharSelectorRadioGroupInputGUI.php');
         $availability = new ilCharSelectorRadioGroupInputGUI($lng->txt('char_selector_' . $this->config->getContext()), 'char_selector_availability');
         $inactive = new ilRadioOption($lng->txt('char_selector_inactive_' . $this->config->getContext()), ilCharSelectorConfig::INACTIVE);
         $inactive->setInfo($lng->txt('char_selector_inactive_info_' . $this->config->getContext()));
         $inherit = new ilRadioOption($lng->txt('char_selector_inherit_' . $this->config->getContext()), ilCharSelectorConfig::INHERIT);
         $inherit->setInfo($lng->txt('char_selector_inherit_info_' . $this->config->getContext()));
         $enabled = new ilRadioOption($lng->txt('char_selector_enabled_' . $this->config->getContext()), ilCharSelectorConfig::ENABLED);
         $enabled->setInfo($lng->txt('char_selector_enabled_info_' . $this->config->getContext()));
         $disabled = new ilRadioOption($lng->txt('char_selector_disabled_' . $this->config->getContext()), ilCharSelectorConfig::DISABLED);
         $disabled->setInfo($lng->txt('char_selector_disabled_info_' . $this->config->getContext()));
 
         $blocks = new ilSelectInputGUI($lng->txt('char_selector_blocks'), 'char_selector_blocks');
         $blocks->setInfo($lng->txt('char_selector_blocks_info'));
         $blocks->setOptions($this->config->getBlockOptions());
         $blocks->setMulti(true);
         $enabled->addSubItem($blocks);
 
         $custom_items = new ilTextAreaInputGUI($lng->txt('char_selector_custom_items'), 'char_selector_custom_items');
         $tpl = new ilTemplate("tpl.char_selector_custom_info.html", true, true, "Services/UIComponent/CharSelector");
         $tpl->setVariable('1', $lng->txt('char_selector_custom_items_info1'));
         $tpl->setVariable('2a', $lng->txt('char_selector_custom_items_info2a'));
         $tpl->setVariable('2b', $lng->txt('char_selector_custom_items_info2b'));
         $tpl->setVariable('3a', $lng->txt('char_selector_custom_items_info3a'));
         $tpl->setVariable('3b', $lng->txt('char_selector_custom_items_info3b'));
         $tpl->setVariable('4a', $lng->txt('char_selector_custom_items_info4a'));
         $tpl->setVariable('4b', $lng->txt('char_selector_custom_items_info4b'));
         $tpl->setVariable('5a', $lng->txt('char_selector_custom_items_info5a'));
         $tpl->setVariable('5b', $lng->txt('char_selector_custom_items_info5b'));
         $tpl->setVariable('6a', $lng->txt('char_selector_custom_items_info6a'));
         $tpl->setVariable('6b', $lng->txt('char_selector_custom_items_info6b'));
         $custom_items->setInfo($tpl->get());
         $enabled->addSubItem($custom_items);
         
         switch ($this->config->getContext()) {
             case ilCharSelectorConfig::CONTEXT_ADMIN:
                 $availability->addOption($inactive);
                 $availability->addOption($enabled);
                 $availability->addOption($disabled);
                 $a_form->addItem($availability);
                 break;
             
             case ilCharSelectorConfig::CONTEXT_USER:
             case ilCharSelectorConfig::CONTEXT_TEST:
                 $availability->addOption($inherit);
                 $availability->addOption($enabled);
                 $availability->addOption($disabled);
                 $a_form->addItem($availability);
                 break;
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addToPage()

ilCharSelectorGUI::addToPage ( )

Adds the the character selector to the ilias page Initializes the selector according to the state saved in the user session.

See also: self::saveState()

Definition at line 223 of file class.ilCharSelectorGUI.php.

References $_SESSION, $ctrl, $ilCtrl, $lng, $tpl, getSelectorHTML(), and ilUtil\getStyleSheetLocation().

     {
         $ilCtrl = $this->ctrl;
         $tpl = $this->tpl;
         $lng = $this->lng;
         
         // don't add the panel twice
         if ($this->added_to_page) {
             return;
         }
         
         $lng->loadLanguageModule('adve');
         
         // prepare the configuration for the js script
         $this->jsconfig = new stdClass();
         $this->jsconfig->pages = $this->config->getCharPages();
         $this->jsconfig->ajax_url = $ilCtrl->getLinkTargetByClass("ilcharselectorgui", "saveState", "", true);
         $this->jsconfig->open = (int) $_SESSION['char_selector_open'];
         $this->jsconfig->current_page = (int) $_SESSION['char_selector_current_page'];
         $this->jsconfig->current_subpage = (int) $_SESSION['char_selector_current_subpage'];
         
         // provide texts to be dynamically rendered in the js script
         $this->jstexts = new stdClass();
         $this->jstexts->page = $lng->txt('page');
         // fau: testNav - add texts for open/close char selector actions in the question menu
         $this->jstexts->open = $lng->txt('char_selector_menu_open');
         $this->jstexts->close = $lng->txt('char_selector_menu_close');
         // fau.
 
         // add everything neded to the page
         // addLightbox() is just used to add the panel template outside the body
         // The panel template is added as <script> to be not included in the DOM by default
         // It will be included by js below the main header when the selector is switched on
         $tpl->addCss(ilUtil::getStyleSheetLocation('', 'char_selector_style.css', 'Services/UIComponent/CharSelector'));
         $tpl->addJavascript('./Services/UIComponent/CharSelector/js/ilCharSelector.js');
         $tpl->addLightbox($this->getSelectorHTML(), 2);
         $tpl->addOnLoadCode('il.CharSelector.init(' . json_encode($this->jsconfig) . ',' . json_encode($this->jstexts) . ')');
         $this->added_to_page = true;
     }

Here is the call graph for this function:

◆ executeCommand()

ilCharSelectorGUI::executeCommand ( )

execute command

Definition at line 315 of file class.ilCharSelectorGUI.php.

References $ctrl, and $ilCtrl.

     {
         $ilCtrl = $this->ctrl;
         $cmd = $ilCtrl->getCmd("saveState");
         switch ($cmd) {
             case 'saveState':
                 $this->$cmd();
                 break;
             default:
                 return;
         }
     }

◆ getConfig()

ilCharSelectorGUI::getConfig ( )

Get the configuraton object.

Returns: ilCharSelectorConfig

Definition at line 127 of file class.ilCharSelectorGUI.php.

References $config.

     {
         return $this->config;
     }

◆ getFormValues()

ilCharSelectorGUI::getFormValues ( ilPropertyFormGUI $a_form )

Set the configuration based on the values of a property form.

Parameters

object	property form
string	context of the form

Definition at line 211 of file class.ilCharSelectorGUI.php.

References ilPropertyFormGUI\getInput().

     {
         $this->config->setAvailability($a_form->getInput('char_selector_availability'));
         $this->config->setAddedBlocks($a_form->getInput('char_selector_blocks'));
         $this->config->setCustomItems($a_form->getInput('char_selector_custom_items'));
     }

Here is the call graph for this function:

◆ getSelectorHTML()

ilCharSelectorGUI::getSelectorHTML ( )

Get the HTML code of the selector panel.

Returns: string panel html code

Definition at line 267 of file class.ilCharSelectorGUI.php.

References $index, $lng, and $tpl.

Referenced by addToPage().

     {
         $lng = $this->lng;
         $tpl = new ilTemplate("tpl.char_selector_panel.html", true, true, "Services/UIComponent/CharSelector");
         
         if (count($this->jsconfig->pages) > 1) {
             $index = 0;
             foreach ($this->jsconfig->pages as $page) {
                 $tpl->setCurrentBlock('page_option');
                 $tpl->setVariable("PAGE_INDEX", $index);
                 $tpl->setVariable("PAGE_NAME", $page[0]);
                 $tpl->parseCurrentBlock();
                 $index++;
             }
         }
 
         $tpl->setVariable('TXT_PREVIOUS_PAGE', $lng->txt('previous'));
         $tpl->setVariable('TXT_NEXT_PAGE', $lng->txt('next'));
         $tpl->setVariable('TXT_PAGE', $lng->txt('page'));
 
         $tpl->touchBlock('chars');
         return '<script type="text/html" id="ilCharSelectorTemplate">' . $tpl->get() . '</script>';
     }

Here is the caller graph for this function:

◆ saveState()

ilCharSelectorGUI::saveState ( )

Save the selector panel state in the user session (This keeps the panel state between page moves)

See also: self::addToPage()

Definition at line 297 of file class.ilCharSelectorGUI.php.

References $_GET, $_SESSION, and exit.

     {
         $_SESSION['char_selector_open'] = (int) $_GET['open'];
         $_SESSION['char_selector_current_page'] = (int) $_GET['current_page'];
         $_SESSION['char_selector_current_subpage'] = (int) $_GET['current_subpage'];
         
         // debugging output (normally ignored by the js part)
         echo json_encode(array(
             'open' => $_SESSION['char_selector_open'],
             'current_page' => $_SESSION['char_selector_current_page'],
             'current_subpage' => $_SESSION['char_selector_current_subpage'],
         ));
         exit;
     }

◆ setConfig()

ilCharSelectorGUI::setConfig ( ilCharSelectorConfig $a_config )

Set the configuraton object.

Parameters

ilCharSelectorConfig

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

     {
         $this->config = $a_config;
     }

◆ setFormValues()

ilCharSelectorGUI::setFormValues ( ilPropertyFormGUI $a_form )

Set the values in a property form based on the configuration.

Parameters

object	property form
string	context of the form

Definition at line 198 of file class.ilCharSelectorGUI.php.

References ilPropertyFormGUI\getItemByPostVar().

     {
         $a_form->getItemByPostVar('char_selector_availability')->setValue($this->config->getAvailability());
         $a_form->getItemByPostVar('char_selector_blocks')->setValue($this->config->getAddedBlocks());
         $a_form->getItemByPostVar('char_selector_custom_items')->setValue($this->config->getCustomItems());
     }

Here is the call graph for this function:

Field Documentation

◆ $added_to_page

ilCharSelectorGUI::$added_to_page = false

private

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

◆ $allowed_guis

ilCharSelectorGUI::$allowed_guis

staticprivate

Initial value:

= array(
        'assQuestionGUI',
        'ilAssQuestionFeedbackEditingGUI',
        'ilAssQuestionHintGUI',
        'ilObjTestSettingsGeneralGUI',
        'ilTestScoringGUI'
    )

list of command classes for which the char selector is allowed (can also be a parent class of the actual command class)

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