This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Collaboration diagram for ilCharSelectorConfig:

Public Member Functions
	__construct (string $a_context=self::CONTEXT_NONE)

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

	setAvailability (int $a_availability)

	getAvailability ()

	setAddedBlocks (array $a_blocks=array())

	getAddedBlocks ()

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

	getCustomItems ()
	set the custom items More...

	setDefinition (string $a_definition='')

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

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

	getBlockTitle (string $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 array	$unicode_blocks

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

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

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

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

	codepointToUtf8 (int $codepoint)
	Return the UTF-8 sequence for a given Unicode code point. More...

	utf8ToCodepoint (string $char)
	Determine the Unicode codepoint of a single-character UTF-8 sequence. More...

Private Attributes
string	$context = self::CONTEXT_NONE

int	$availability = self::INHERIT

array	$added_blocks = array()

array	$custom_items = array()

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning

Definition at line 19 of file ilCharSelectorConfig.php.

Constructor & Destructor Documentation

◆ __construct()

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

Definition at line 287 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;
        }
    }

References CONTEXT_ADMIN, CONTEXT_NONE, CONTEXT_TEST, and CONTEXT_USER.

Member Function Documentation

◆ _getCurrentConfig()

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

static

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

Definition at line 303 of file ilCharSelectorConfig.php.

                                                                          : self
    {
        global $ilSetting, $ilUser;
 
        // check configuration from administration settings
        $admin_config = new self(self::CONTEXT_ADMIN);
        $admin_config->setAvailability((int) $ilSetting->get('char_selector_availability'));
        $admin_config->setDefinition((string) $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);
            $test_config->setAvailability((int) $a_test_obj->getCharSelectorAvailability());
            $test_config->setDefinition((string) $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);
        $user_config->setAvailability((int) $ilUser->getPref('char_selector_availability'));
        $user_config->setDefinition((string) $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;
        }
    }

References $ilSetting, $ilUser, CONTEXT_ADMIN, CONTEXT_TEST, CONTEXT_USER, INACTIVE, and INHERIT.

Referenced by ilCharSelectorGUI\_getCurrentGUI().

Here is the caller graph for this function:

◆ codepointToUtf8()

ilCharSelectorConfig::codepointToUtf8 ( int $codepoint )

private

Return the UTF-8 sequence for a given Unicode code point.

Returns an empty string if the codepoint is not known.

See also: http://www.mediawiki.org/; http://www.gnu.org/copyleft/gpl.html

Definition at line 596 of file ilCharSelectorConfig.php.

                                                    : string
    {
        if ($codepoint < 0x80) {
            return chr($codepoint);
        }
        if ($codepoint < 0x800) {
            return chr($codepoint >> 6&0x3f|0xc0) .
                chr($codepoint&0x3f|0x80);
        }
        if ($codepoint < 0x10000) {
            return chr($codepoint >> 12&0x0f|0xe0) .
                chr($codepoint >> 6&0x3f|0x80) .
                chr($codepoint&0x3f|0x80);
        }
        if ($codepoint < 0x110000) {
            return chr($codepoint >> 18&0x07|0xf0) .
                chr($codepoint >> 12&0x3f|0x80) .
                chr($codepoint >> 6&0x3f|0x80) .
                chr($codepoint&0x3f|0x80);
        }
 
        return '';
    }

Referenced by getItemParsedCallback().

Here is the caller graph for this function:

◆ extractUnicodeBlock()

ilCharSelectorConfig::extractUnicodeBlock ( string $a_item = '' )

private

Extract the unicode block name from a definition item.

Parameters

string $a_item definition item

Returns: string unicode block name

Definition at line 493 of file ilCharSelectorConfig.php.

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

Referenced by setDefinition().

Here is the caller graph for this function:

◆ getAddedBlocks()

ilCharSelectorConfig::getAddedBlocks ( )

Definition at line 381 of file ilCharSelectorConfig.php.

                                    : array
    {
        return $this->added_blocks;
    }

References $added_blocks.

◆ getAvailability()

ilCharSelectorConfig::getAvailability ( )

Definition at line 363 of file ilCharSelectorConfig.php.

                                     : int
    {
        return $this->availability;
    }

References $availability.

◆ getBlockOptions()

ilCharSelectorConfig::getBlockOptions ( )

get the options for a block selection

Definition at line 458 of file ilCharSelectorConfig.php.

                                     : array
    {
        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;
    }

References $lng, and getBlockTitle().

Here is the call graph for this function:

◆ getBlockTitle()

ilCharSelectorConfig::getBlockTitle ( string $a_block_name )

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

Definition at line 476 of file ilCharSelectorConfig.php.

                                                       : string
    {
        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];
        }
    }

References $lng.

Referenced by getBlockOptions(), and getCharPages().

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 511 of file ilCharSelectorConfig.php.

                                  : array
    {
        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]);
                $page[] = array($start, $end);
            } else {
                // handle normal item
                $page[] = $this->getItemParsed($item);
            }
        }
        if (count($page) > 1) {
            $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));
            $pages[] = $page;
        }
 
        return $pages;
    }

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

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)

Definition at line 344 of file ilCharSelectorConfig.php.

                                : string
    {
        return $this->context;
    }

References $context.

◆ getCustomItems()

ilCharSelectorConfig::getCustomItems ( )

set the custom items

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

Definition at line 399 of file ilCharSelectorConfig.php.

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

◆ getDefinition()

ilCharSelectorConfig::getDefinition ( )

Set the definition of the available characters.

See also: self::setDefinition()

Definition at line 446 of file ilCharSelectorConfig.php.

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

◆ getItemCodepoint()

ilCharSelectorConfig::getItemCodepoint ( string $a_item )

private

get the unicode index of an item

Definition at line 555 of file ilCharSelectorConfig.php.

                                                     : string
    {
        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
            return $this->utf8ToCodepoint($a_item);
        }
    }

References utf8ToCodepoint().

Referenced by getCharPages().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getItemParsed()

ilCharSelectorConfig::getItemParsed ( string $a_item )

private

replace unicode notations with their utf8 chars in a string

Definition at line 568 of file ilCharSelectorConfig.php.

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

Referenced by getCharPages().

Here is the caller graph for this function:

◆ getItemParsedCallback()

ilCharSelectorConfig::getItemParsedCallback ( array $matches )

private

callback for replacement of unicode notations

Parameters

array $matches preg matches

Returns: string replacement string

Definition at line 582 of file ilCharSelectorConfig.php.

                                                          : string
    {
        return $this->codepointToUtf8((int) hexdec(substr($matches[0], 2)));
    }

References codepointToUtf8().

Here is the call graph for this function:

◆ setAddedBlocks()

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

Parameters

array $a_blocks list of block names

Definition at line 371 of file ilCharSelectorConfig.php.

                                                             : void
    {
        $this->added_blocks = array();
        foreach ($a_blocks as $block_name) {
            if ($block_name === "all" || array_key_exists($block_name, self::$unicode_blocks)) {
                $this->added_blocks[] = $block_name;
            }
        }
    }

◆ setAvailability()

ilCharSelectorConfig::setAvailability ( int $a_availability )

Definition at line 349 of file ilCharSelectorConfig.php.

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

References DISABLED, ENABLED, INACTIVE, and INHERIT.

◆ setCustomItems()

ilCharSelectorConfig::setCustomItems ( string $a_items = '' )

set the custom items

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

Definition at line 390 of file ilCharSelectorConfig.php.

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

◆ setDefinition()

ilCharSelectorConfig::setDefinition ( string $a_definition = '' )

Definition at line 420 of file ilCharSelectorConfig.php.

                                                            : void
    {
        // 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 (($block_name = $this->extractUnicodeBlock($item)) !== '') {
                $this->added_blocks[] = $block_name;
            } elseif ($item !== '') {
                $this->custom_items[] = trim($item);
            }
        }
    }

References extractUnicodeBlock().

Here is the call graph for this function:

◆ utf8ToCodepoint()

ilCharSelectorConfig::utf8ToCodepoint ( string $char )

private

Determine the Unicode codepoint of a single-character UTF-8 sequence.

Does not check for invalid input data.

See also: http://www.mediawiki.org/; http://www.gnu.org/copyleft/gpl.html

Definition at line 629 of file ilCharSelectorConfig.php.

                                                  : int
    {
        # Find the length
        $z = ord($char[0]);
        if ($z&0x80) {
            $length = 0;
            while ($z&0x80) {
                $length++;
                $z <<= 1;
            }
        } else {
            $length = 1;
        }
 
        if ($length != strlen($char)) {
            return false;
        }
        if ($length == 1) {
            return ord($char);
        }
 
        # Mask off the length-determining bits and shift back to the original location
        $z &= 0xff;
        $z >>= $length;
 
        # Add in the free bits from subsequent bytes
        for ($i = 1; $i < $length; $i++) {
            $z <<= 6;
            $z |= ord($char[$i])&0x3f;
        }
 
        return $z;
    }

References $i.

Referenced by getItemCodepoint().

Here is the caller graph for this function:

Field Documentation

◆ $added_blocks

array ilCharSelectorConfig::$added_blocks = array()

private

Definition at line 282 of file ilCharSelectorConfig.php.

Referenced by getAddedBlocks(), and getCharPages().

◆ $availability

int ilCharSelectorConfig::$availability = self::INHERIT

private

Definition at line 279 of file ilCharSelectorConfig.php.

Referenced by getAvailability().

◆ $context

string ilCharSelectorConfig::$context = self::CONTEXT_NONE

private

Definition at line 276 of file ilCharSelectorConfig.php.

Referenced by getContext().

◆ $custom_items

array ilCharSelectorConfig::$custom_items = array()

private

Definition at line 285 of file ilCharSelectorConfig.php.

◆ $unicode_blocks

array ilCharSelectorConfig::$unicode_blocks

static

Definition at line 42 of file ilCharSelectorConfig.php.

◆ CONTEXT_ADMIN

const ilCharSelectorConfig::CONTEXT_ADMIN = 'admin'

Definition at line 34 of file ilCharSelectorConfig.php.

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

◆ CONTEXT_NONE

const ilCharSelectorConfig::CONTEXT_NONE = ''

Configuration contexts.

Definition at line 33 of file ilCharSelectorConfig.php.

Referenced by __construct().

◆ CONTEXT_TEST

const ilCharSelectorConfig::CONTEXT_TEST = 'test'

Definition at line 36 of file ilCharSelectorConfig.php.

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

◆ CONTEXT_USER

const ilCharSelectorConfig::CONTEXT_USER = 'user'

Definition at line 35 of file ilCharSelectorConfig.php.

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

◆ DISABLED

const ilCharSelectorConfig::DISABLED = 2

Definition at line 28 of file ilCharSelectorConfig.php.

Referenced by ilCharSelectorGUI\addFormProperties(), and setAvailability().

◆ ENABLED

const ilCharSelectorConfig::ENABLED = 1

Definition at line 27 of file ilCharSelectorConfig.php.

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

◆ INACTIVE

const ilCharSelectorConfig::INACTIVE = 0

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

Definition at line 25 of file ilCharSelectorConfig.php.

Referenced by _getCurrentConfig(), ilCharSelectorGUI\addFormProperties(), and setAvailability().

◆ INHERIT

const ilCharSelectorConfig::INHERIT = 0

Definition at line 26 of file ilCharSelectorConfig.php.

Referenced by _getCurrentConfig(), ilCharSelectorGUI\addFormProperties(), and setAvailability().

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()

◆ codepointToUtf8()

◆ extractUnicodeBlock()

◆ getAddedBlocks()

◆ getAvailability()

◆ getBlockOptions()

◆ getBlockTitle()

◆ getCharPages()

◆ getContext()

◆ getCustomItems()

◆ getDefinition()

◆ getItemCodepoint()

◆ getItemParsed()

◆ getItemParsedCallback()

◆ setAddedBlocks()

◆ setAvailability()

◆ setCustomItems()

◆ setDefinition()

◆ utf8ToCodepoint()

Field Documentation

◆ $added_blocks

◆ $availability

◆ $context

◆ $custom_items

◆ $unicode_blocks

◆ CONTEXT_ADMIN

◆ CONTEXT_NONE

◆ CONTEXT_TEST

◆ CONTEXT_USER

◆ DISABLED

◆ ENABLED

◆ INACTIVE

◆ INHERIT