Collaboration diagram for ilCharSelectorConfig:

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

	getContext ()
	get the context of the configuration (the context is set at initialisation and can't be changed) More...

	setAvailability ($a_availability)
	set the availability of the selector More...

	getAvailability ()
	get the availability of the selector More...

	setAddedBlocks ($a_blocks=array())
	set the added unicode blocks More...

	getAddedBlocks ()
	set the added unicode blocks More...

	setCustomItems ($a_items='')
	set the custom items More...

	getCustomItems ()
	set the custom items More...

	setDefinition ($a_definition='')

	getDefinition ()
	Set the definition of the available characters. More...

	getBlockOptions ()
	get the options for a block selection More...

	getBlockTitle ($a_block_name)
	Get the title of a unicode block for display or selection A translation is used if it exists. More...

	getCharPages ()
	Get the character pages. More...

Static Public Member Functions
static	_getCurrentConfig (ilObjTest $a_test_obj=null)
	Get the configuration that should be used for the current selector. More...

Data Fields
const	INACTIVE = 0
	Availabilities INACTIVE/INHERIT corresponds to an unconfigured selector (no database entries) More...

const	INHERIT = 0

const	ENABLED = 1

const	DISABLED = 2

const	CONTEXT_NONE = ''
	Configuration contexts. More...

const	CONTEXT_ADMIN = 'admin'

const	CONTEXT_USER = 'user'

const	CONTEXT_TEST = 'test'

Static Public Attributes
static	$unicode_blocks

Private Member Functions
	extractUnicodeBlock ($a_item='')
	Extract the unicode block name from a definition item. More...

	getItemCodepoint ($a_item)
	get the unicode index of an item More...

	getItemParsed ($a_item)
	replace unicode notations with their utf8 chars in a string More...

	getItemParsedCallback ($matches)
	callback for replacement of unicode notations More...

Private Attributes
	$context = self::CONTEXT_NONE

	$availability = self::INHERIT

	$added_blocks = array()

	$custom_items = array()

Detailed Description

Definition at line 4 of file ilCharSelectorConfig.php.

Constructor & Destructor Documentation

◆ __construct()

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

Constructor.

Parameters

string	context identifier
bool	read the settings for the given context

Definition at line 283 of file ilCharSelectorConfig.php.

     {
         switch ($a_context) {
             case self::CONTEXT_ADMIN:
             case self::CONTEXT_TEST:
             case self::CONTEXT_USER:
                 $this->context = $a_context;
                 break;
             default:
                 $this->context = self::CONTEXT_NONE;
         }
     }

Member Function Documentation

◆ _getCurrentConfig()

static ilCharSelectorConfig::_getCurrentConfig ( ilObjTest $a_test_obj = null )

static

Get the configuration that should be used for the current selector.

Parameters

object (optional) current running test

Returns: ilCharSelectorConfig

Definition at line 301 of file ilCharSelectorConfig.php.

References $ilSetting, and $ilUser.

Referenced by ilCharSelectorGUI\_getCurrentGUI().

     {
         global $ilSetting, $ilUser;
         
         // check configuration from administration settings
         $admin_config = new self(self::CONTEXT_ADMIN, true);
         $admin_config->setAvailability($ilSetting->get('char_selector_availability'));
         $admin_config->setDefinition($ilSetting->get('char_selector_definition'));
         if ($admin_config->getAvailability() == self::INACTIVE) {
             // a globally inactive selector can't be overwritten by users or tests
             return $admin_config;
         }
         
         // a test configuration is relevant for test runs
         if (isset($a_test_obj)) {
             $test_config = new self(self::CONTEXT_TEST, false);
             $test_config->setAvailability($a_test_obj->getCharSelectorAvailability());
             $test_config->setDefinition($a_test_obj->getCharSelectorDefinition());
             if ($test_config->getAvailability() != self::INHERIT) {
                 // a specific test configuration has precedence over user configuration
                 return $test_config;
             }
         }
         
         // check configuration from user settings
         $user_config = new self(self::CONTEXT_USER, true);
         $user_config->setAvailability($ilUser->getPref('char_selector_availability'));
         $user_config->setDefinition($ilUser->getPref('char_selector_definition'));
         if ($user_config->getAvailability() != self::INHERIT) {
             // take user specific config
             return $user_config;
         } else {
             // take admin config as default
             return $admin_config;
         }
     }

Here is the caller graph for this function:

◆ extractUnicodeBlock()

ilCharSelectorConfig::extractUnicodeBlock ( $a_item = '' )

private

Extract the unicode block name from a definition item.

Parameters

string definition item

Returns: string unicode block name

Definition at line 519 of file ilCharSelectorConfig.php.

References array.

Referenced by setDefinition().

     {
         $a_item = trim($a_item);
         $matches = array();
         if (preg_match('/^\[(.+)\]$/', $a_item, $matches)) {
             $block_name = $matches[1];
             if ($block_name == 'all'
                 or in_array($block_name, array_keys(self::$unicode_blocks))) {
                 return $block_name;
             }
         }
         return '';
     }

Here is the caller graph for this function:

◆ getAddedBlocks()

ilCharSelectorConfig::getAddedBlocks ( )

set the added unicode blocks

Returns: array list of block names

Definition at line 397 of file ilCharSelectorConfig.php.

References $added_blocks.

     {
         return $this->added_blocks;
     }

◆ getAvailability()

ilCharSelectorConfig::getAvailability ( )

get the availability of the selector

Returns: int availability

Definition at line 373 of file ilCharSelectorConfig.php.

References $availability.

     {
         return $this->availability;
     }

◆ getBlockOptions()

ilCharSelectorConfig::getBlockOptions ( )

get the options for a block selection

Returns: array options

Definition at line 479 of file ilCharSelectorConfig.php.

References $lng, $options, array, and getBlockTitle().

     {
         global $lng;
         
         $options = array(
             '' => $lng->txt('please_select'),
             'all' => $lng->txt('char_selector_unicode_all')
         );
         foreach (array_keys(self::$unicode_blocks) as $block_name) {
             $options[$block_name] = $this->getBlockTitle($block_name);
         }
         return $options;
     }

Here is the call graph for this function:

◆ getBlockTitle()

ilCharSelectorConfig::getBlockTitle ( $a_block_name )

Get the title of a unicode block for display or selection A translation is used if it exists.

Parameters

string block name

Returns: string title

Definition at line 501 of file ilCharSelectorConfig.php.

References $lng.

Referenced by getBlockOptions(), and getCharPages().

     {
         global $lng;
         
         $langvar = 'char_selector_unicode_' . $a_block_name;
         if ($lng->txt($langvar) != '-' . $langvar . '-') {
             return $lng->txt($langvar);
         } else {
             return self::$unicode_blocks[$a_block_name][0];
         }
     }

Here is the caller graph for this function:

◆ getCharPages()

ilCharSelectorConfig::getCharPages ( )

Get the character pages.

Returns: array [["page1", "A", "BC", [123,456], ...], ["page2], "X", ...], ...]

Definition at line 539 of file ilCharSelectorConfig.php.

References $added_blocks, $end, $lng, array, getBlockTitle(), getItemCodepoint(), and getItemParsed().

     {
         global $lng;
         
         $pages = array();
         
         // add custom block
         //
         $page = array($lng->txt('char_selector_custom_items'));
         foreach ($this->custom_items as $item) {
             if (strpos($item, '-') > 0) {
                 // handle range
                 $subitems = explode('-', $item);
                 $start = $this->getItemCodepoint($subitems[0]);
                 $end = $this->getItemCodepoint($subitems[1]);
                 array_push($page, array($start, $end));
             } else {
                 // handle normal item
                 array_push($page, $this->getItemParsed($item));
             }
         }
         if (count($page) > 1) {
             array_push($pages, $page);
         }
     
         // add unicode blocks
         //
         $blocks = in_array('all', $this->added_blocks) ?
             array_keys(self::$unicode_blocks) :
             $this->added_blocks;
         
         foreach ($blocks as $block_name) {
             $start = hexdec(self::$unicode_blocks[$block_name][1]);
             $end = hexdec(self::$unicode_blocks[$block_name][2]);
             $page = array($this->getBlockTitle($block_name), array($start, $end));
             array_push($pages, $page);
         }
         
         return $pages;
     }

Here is the call graph for this function:

◆ getContext()

ilCharSelectorConfig::getContext ( )

get the context of the configuration (the context is set at initialisation and can't be changed)

Returns: string context identifier

Definition at line 344 of file ilCharSelectorConfig.php.

References $context.

     {
         return $this->context;
     }

◆ getCustomItems()

ilCharSelectorConfig::getCustomItems ( )

set the custom items

Returns: array list of strings

See also: self::setDefinition() for item syntax

Definition at line 417 of file ilCharSelectorConfig.php.

     {
         return implode(' ', $this->custom_items);
     }

◆ getDefinition()

ilCharSelectorConfig::getDefinition ( )

Set the definition of the available characters.

Returns: string

See also: self::setDefinition()

Definition at line 465 of file ilCharSelectorConfig.php.

     {
         $definition = implode(' ', $this->custom_items);
         foreach ($this->added_blocks as $block_name) {
             $definition = $definition . ' [' . $block_name . ']';
         }
         return trim($definition);
     }

◆ getItemCodepoint()

ilCharSelectorConfig::getItemCodepoint ( $a_item )

private

get the unicode index of an item

Parameters

string $a_item

Definition at line 585 of file ilCharSelectorConfig.php.

References utf8ToCodepoint().

Referenced by getCharPages().

     {
         if (preg_match('/^[uU]\+[0-9a-fA-F]+$/', $a_item)) {
             return (int) hexdec(substr($a_item, 2));
         } else {
             //take the codepoint of the first character
             require_once "include/Unicode/UtfNormalUtil.php";
             return (int) utf8ToCodepoint($a_item);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getItemParsed()

ilCharSelectorConfig::getItemParsed ( $a_item )

private

replace unicode notations with their utf8 chars in a string

Parameters

string $a_item

Returns: string parsed string

Definition at line 601 of file ilCharSelectorConfig.php.

References array.

Referenced by getCharPages().

     {
         return preg_replace_callback(
             '/[uU]\+[0-9a-fA-F]+/',
             array($this,'getItemParsedCallback'),
             $a_item
         );
     }

Here is the caller graph for this function:

◆ getItemParsedCallback()

ilCharSelectorConfig::getItemParsedCallback ( $matches )

private

callback for replacement of unicode notations

Parameters

array preg matches

Returns: string replacement string

Definition at line 615 of file ilCharSelectorConfig.php.

References codepointToUtf8().

     {
         require_once "include/Unicode/UtfNormalUtil.php";
         return codepointToUtf8(hexdec(substr($matches[0], 2)));
     }

Here is the call graph for this function:

◆ setAddedBlocks()

ilCharSelectorConfig::setAddedBlocks ( $a_blocks = array() )

set the added unicode blocks

Parameters

array list of block names

Definition at line 382 of file ilCharSelectorConfig.php.

References array.

     {
         $this->added_blocks = array();
         foreach ($a_blocks as $block_name) {
             if ($block_name == "all" or
                 in_array($block_name, array_keys(self::$unicode_blocks))) {
                 array_push($this->added_blocks, $block_name);
             }
         }
     }

◆ setAvailability()

ilCharSelectorConfig::setAvailability ( $a_availability )

set the availability of the selector

Parameters

int	availability

Definition at line 354 of file ilCharSelectorConfig.php.

     {
         switch ((int) $a_availability) {
             case self::INACTIVE:
             case self::INHERIT:
             case self::ENABLED:
             case self::DISABLED:
                 $this->availability = (int) $a_availability;
                 break;
             default:
                 $this->availability = self::INHERIT;
         }
     }

◆ setCustomItems()

ilCharSelectorConfig::setCustomItems ( $a_items = '' )

set the custom items

Parameters

array list of strings

See also: self::setDefinition() for item syntax

Definition at line 407 of file ilCharSelectorConfig.php.

     {
         $this->custom_items = explode(' ', $a_items);
     }

◆ setDefinition()

ilCharSelectorConfig::setDefinition ( $a_definition = '' )

Definition at line 438 of file ilCharSelectorConfig.php.

References array, and extractUnicodeBlock().

     {
         // first reset all previous settings
         $this->added_blocks = array();
         $this->custom_items = array();
 
         // set the default definition to all unicode blocks
         if (trim($a_definition) == '') {
             $a_definition = "[all]";
         }
         
         // analyze definition items
         $items = explode(' ', $a_definition);
         foreach ($items as $item) {
             if (strlen($block_name = $this->extractUnicodeBlock($item))) {
                 array_push($this->added_blocks, $block_name);
             } elseif ($item != '') {
                 array_push($this->custom_items, trim($item));
             }
         }
     }

Here is the call graph for this function:

Field Documentation

◆ $added_blocks

ilCharSelectorConfig::$added_blocks = array()

private

Definition at line 270 of file ilCharSelectorConfig.php.

Referenced by getAddedBlocks(), and getCharPages().

◆ $availability

ilCharSelectorConfig::$availability = self::INHERIT

private

Definition at line 265 of file ilCharSelectorConfig.php.

Referenced by getAvailability().

◆ $context

ilCharSelectorConfig::$context = self::CONTEXT_NONE

private

Definition at line 260 of file ilCharSelectorConfig.php.

Referenced by getContext().

◆ $custom_items

ilCharSelectorConfig::$custom_items = array()

private

Definition at line 275 of file ilCharSelectorConfig.php.

◆ $unicode_blocks

ilCharSelectorConfig::$unicode_blocks

static

Definition at line 27 of file ilCharSelectorConfig.php.

◆ CONTEXT_ADMIN

const ilCharSelectorConfig::CONTEXT_ADMIN = 'admin'

Definition at line 19 of file ilCharSelectorConfig.php.

Referenced by ilCharSelectorGUI\addFormProperties(), ilObjAdvancedEditingGUI\saveCharSelectorSettingsObject(), and ilObjAdvancedEditingGUI\showCharSelectorSettingsObject().

◆ CONTEXT_NONE

const ilCharSelectorConfig::CONTEXT_NONE = ''

Configuration contexts.

Definition at line 18 of file ilCharSelectorConfig.php.

◆ CONTEXT_TEST

const ilCharSelectorConfig::CONTEXT_TEST = 'test'

Definition at line 21 of file ilCharSelectorConfig.php.

Referenced by ilCharSelectorGUI\addFormProperties(), ilObjTestSettingsGeneralGUI\addQuestionBehaviourProperties(), and ilObjTestSettingsGeneralGUI\saveQuestionBehaviourProperties().

◆ CONTEXT_USER

const ilCharSelectorConfig::CONTEXT_USER = 'user'

Definition at line 20 of file ilCharSelectorConfig.php.

Referenced by ilCharSelectorGUI\addFormProperties(), ilPersonalSettingsGUI\initGeneralSettingsForm(), and ilPersonalSettingsGUI\saveGeneralSettings().

◆ DISABLED

const ilCharSelectorConfig::DISABLED = 2

Definition at line 13 of file ilCharSelectorConfig.php.

Referenced by ilCharSelectorGUI\addFormProperties().

◆ ENABLED

const ilCharSelectorConfig::ENABLED = 1

Definition at line 12 of file ilCharSelectorConfig.php.

Referenced by ilCharSelectorGUI\addFormProperties(), ilCharSelectorRadioGroupInputGUI\checkInput(), ilPropertyFormGUI\getContent(), and ilTestPlayerAbstractGUI\populateCharSelectorIfRequired().

◆ INACTIVE

const ilCharSelectorConfig::INACTIVE = 0

Availabilities INACTIVE/INHERIT corresponds to an unconfigured selector (no database entries)

Definition at line 10 of file ilCharSelectorConfig.php.

Referenced by ilCharSelectorGUI\addFormProperties().

◆ INHERIT

const ilCharSelectorConfig::INHERIT = 0

Definition at line 11 of file ilCharSelectorConfig.php.

Referenced by ilCharSelectorGUI\addFormProperties().

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

Services/UIComponent/CharSelector/classes/ilCharSelectorConfig.php

Public Member Functions

Static Public Member Functions

Data Fields

Static Public Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ _getCurrentConfig()

◆ extractUnicodeBlock()

◆ getAddedBlocks()

◆ getAvailability()

◆ getBlockOptions()

◆ getBlockTitle()

◆ getCharPages()

◆ getContext()

◆ getCustomItems()

◆ getDefinition()

◆ getItemCodepoint()

◆ getItemParsed()

◆ getItemParsedCallback()

◆ setAddedBlocks()

◆ setAvailability()

◆ setCustomItems()

◆ setDefinition()

Field Documentation

◆ $added_blocks

◆ $availability

◆ $context

◆ $custom_items

◆ $unicode_blocks

◆ CONTEXT_ADMIN

◆ CONTEXT_NONE

◆ CONTEXT_TEST

◆ CONTEXT_USER

◆ DISABLED

◆ ENABLED

◆ INACTIVE

◆ INHERIT