Class handles translation mode for an object. More...

Collaboration diagram for ilMultilingualism:

Public Member Functions
	setObjId ($a_val)
	Set object id. More...

	getObjId ()
	Get object id. More...

	setLanguages (array $a_val)
	Set languages. More...

	getLanguages ()
	Get languages. More...

	getType ()

	setType ($type)

	getDefaultLanguage ()

	addLanguage ($a_lang, $a_title, $a_description, $a_default, $a_force=false)
	Add language. More...

	getDefaultTitle ()
	Get default title. More...

	setDefaultTitle ($a_title)
	Set default title. More...

	getDefaultDescription ()
	Get default description. More...

	setDefaultDescription ($a_description)
	Set default description. More...

	removeLanguage ($a_lang)
	Remove language. More...

	read ()
	Read. More...

	delete ()
	Delete. More...

	save ()
	Save. More...

	copy ($a_obj_id)
	Copy multilinguality settings. More...

	toXml (ilXmlWriter $writer)
	Export. More...

	fromXML (SimpleXMLElement $root)
	xml import More...

Static Public Member Functions
static	getInstance ($a_obj_id, $a_type)
	Get instance. More...

Protected Attributes
	$lng

	$db

	$obj_id

	$languages = array()

	$type = ""

Static Protected Attributes
static	$instances = array()

Private Member Functions
	__construct ($a_obj_id, $a_type)
	Constructor. More...

Detailed Description

Class handles translation mode for an object.

Objects may not use any translations at all

use translations for title/description only or
use translation for (the page editing) content, too.

Currently supported by container objects and ILIAS learning modules.

Content master lang vs. default language

If no translation mode for the content is active no master lang will be set and no record in table obj_content_master_lng will be saved. For the title/descriptions the default will be marked by field lang_default in table object_translation.
If translation for content is activated a master language must be set (since concent may already exist the language of this content is defined through setting the master language (in obj_content_master_lng). Modules that use this mode will not get informed about this, so they can not internally assign existing content to the master lang

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

Version: $Id$

Definition at line 29 of file class.ilMultilingualism.php.

Constructor & Destructor Documentation

◆ __construct()

ilMultilingualism::__construct	(	$a_obj_id,
		$a_type
	)

private

Constructor.

Parameters

int	$a_obj_id	object id
string	$a_type	id type

Exceptions

ilObjectException

Definition at line 49 of file class.ilMultilingualism.php.

    {
        global $DIC;
 
        $this->lng = $DIC->language();
        $ilDB = $DIC->database();
 
        $this->db = $ilDB;
 
        $this->setObjId($a_obj_id);
        $this->setType($a_type);
 
        if ($this->getObjId() <= 0) {
            include_once("./Services/Object/exceptions/class.ilObjectException.php");
            throw new ilObjectException("ilObjectTranslation: No object ID passed.");
        }
 
        $this->read();
    }

References $a_type, $DIC, $ilDB, getObjId(), read(), setObjId(), and setType().

Here is the call graph for this function:

Member Function Documentation

◆ addLanguage()

ilMultilingualism::addLanguage	(	$a_lang,
		$a_title,
		$a_description,
		$a_default,
		$a_force = `false`
	)

Add language.

Parameters

string	$a_lang	language
string	$a_title	title
string	$a_description	description
bool	$a_default	default language?

Definition at line 163 of file class.ilMultilingualism.php.

    {
        if ($a_lang != "" && (!isset($this->languages[$a_lang]) || $a_force)) {
            if ($a_default) {
                foreach ($this->languages as $k => $l) {
                    $this->languages[$k]["lang_default"] = false;
                }
            }
            $this->languages[$a_lang] = array("lang_code" => $a_lang, "lang_default" => $a_default,
                "title" => $a_title, "description" => $a_description);
        }
    }

Referenced by fromXML(), and read().

Here is the caller graph for this function:

◆ copy()

ilMultilingualism::copy ( $a_obj_id )

Copy multilinguality settings.

Parameters

string	$a_type	parent object type
int	$a_obj_id	parent object id

Returns: ilObjectTranslation target multilang object

Definition at line 302 of file class.ilMultilingualism.php.

    {
        $target_ml = new self($a_obj_id, $this->getType());
        $target_ml->setLanguages($this->getLanguages());
        $target_ml->save();
        return $target_ml;
    }

References getLanguages(), and getType().

Here is the call graph for this function:

◆ delete()

ilMultilingualism::delete ( )

Delete.

Definition at line 266 of file class.ilMultilingualism.php.

    {
        $this->db->manipulate(
            "DELETE FROM il_translations " .
            " WHERE id = " . $this->db->quote($this->getObjId(), "integer") .
            " AND id_type = " . $this->db->quote($this->getType(), "text")
        );
    }

References getType().

Here is the call graph for this function:

◆ fromXML()

ilMultilingualism::fromXML ( SimpleXMLElement $root )

xml import

Parameters

SimpleXMLElement $root

Returns: mixed

Definition at line 338 of file class.ilMultilingualism.php.

    {
        if ($root->translations) {
            $root = $root->translations;
        }
        
        foreach ($root->translation as $trans) {
            $this->addLanguage(
                (string) trim($trans["language"]),
                (string) trim($trans->title),
                (string) trim($trans->description),
                (int) $trans["default"] != 0?true:false
                );
        }
    }

References addLanguage().

Here is the call graph for this function:

◆ getDefaultDescription()

ilMultilingualism::getDefaultDescription ( )

Get default description.

Returns: string description of default language

Definition at line 210 of file class.ilMultilingualism.php.

    {
        foreach ($this->languages as $l) {
            if ($l["lang_default"]) {
                return $l["description"];
            }
        }
        return "";
    }

◆ getDefaultLanguage()

ilMultilingualism::getDefaultLanguage ( )

Definition at line 141 of file class.ilMultilingualism.php.

    {
        $lng = $this->lng;
        
        foreach ($this->languages as $k => $v) {
            if ($v["lang_default"]) {
                return $k;
            }
        }
        
        return $lng->getDefaultLanguage();
    }

References $lng.

Referenced by removeLanguage().

Here is the caller graph for this function:

◆ getDefaultTitle()

ilMultilingualism::getDefaultTitle ( )

Get default title.

Returns: string title of default language

Definition at line 181 of file class.ilMultilingualism.php.

    {
        foreach ($this->languages as $l) {
            if ($l["lang_default"]) {
                return $l["title"];
            }
        }
        return "";
    }

◆ getInstance()

static ilMultilingualism::getInstance	(	$a_obj_id,
		$a_type
	)

static

Get instance.

Parameters

integer $a_obj_id (repository) object id

Returns: ilMultilingualism translation object

Definition at line 75 of file class.ilMultilingualism.php.

    {
        if (!isset(self::$instances[$a_type][$a_obj_id])) {
            self::$instances[$a_type][$a_obj_id] = new self($a_obj_id, $a_type);
        }
 
        return self::$instances[$a_type][$a_obj_id];
    }

References $a_type.

Referenced by ilMultilingualismGUI\__construct(), ilDidacticTemplateSetting\getTranslationObject(), and ilDidacticTemplateImport\parseSettings().

Here is the caller graph for this function:

◆ getLanguages()

ilMultilingualism::getLanguages ( )

Get languages.

Returns: array array of language codes

Definition at line 120 of file class.ilMultilingualism.php.

    {
        return $this->languages;
    }

References $languages.

Referenced by copy(), save(), and toXml().

Here is the caller graph for this function:

◆ getObjId()

ilMultilingualism::getObjId ( )

Get object id.

Returns: int object id

Definition at line 100 of file class.ilMultilingualism.php.

    {
        return $this->obj_id;
    }

References $obj_id.

Referenced by __construct().

Here is the caller graph for this function:

◆ getType()

ilMultilingualism::getType ( )

Returns: string

Definition at line 128 of file class.ilMultilingualism.php.

    {
        return $this->type;
    }

References $type.

Referenced by copy(), delete(), and save().

Here is the caller graph for this function:

◆ read()

ilMultilingualism::read ( )

Read.

Definition at line 250 of file class.ilMultilingualism.php.

    {
        $this->setLanguages(array());
        $set = $this->db->query(
            "SELECT * FROM il_translations " .
            " WHERE id = " . $this->db->quote($this->getObjId(), "integer") .
            " AND id_type = " . $this->db->quote($this->getType(), "text")
        );
        while ($rec = $this->db->fetchAssoc($set)) {
            $this->addLanguage($rec["lang_code"], $rec["title"], $rec["description"], $rec["lang_default"]);
        }
    }

References addLanguage(), and setLanguages().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeLanguage()

ilMultilingualism::removeLanguage ( $a_lang )

Remove language.

Parameters

string $a_lang language code

Definition at line 240 of file class.ilMultilingualism.php.

    {
        if ($a_lang != $this->getDefaultLanguage()) {
            unset($this->languages[$a_lang]);
        }
    }

References getDefaultLanguage().

Here is the call graph for this function:

◆ save()

ilMultilingualism::save ( )

Save.

Definition at line 278 of file class.ilMultilingualism.php.

    {
        $this->delete();
 
        foreach ($this->getLanguages() as $l => $trans) {
            $this->db->manipulate($t = "INSERT INTO il_translations " .
                "(id, id_type, title, description, lang_code, lang_default) VALUES (" .
                $this->db->quote($this->getObjId(), "integer") . "," .
                $this->db->quote($this->getType(), "text") . "," .
                $this->db->quote($trans["title"], "text") . "," .
                $this->db->quote($trans["description"], "text") . "," .
                $this->db->quote($l, "text") . "," .
                $this->db->quote($trans["lang_default"], "integer") .
                ")");
        }
    }

References getLanguages(), and getType().

Here is the call graph for this function:

◆ setDefaultDescription()

ilMultilingualism::setDefaultDescription ( $a_description )

Set default description.

Parameters

string $a_description description

Definition at line 225 of file class.ilMultilingualism.php.

    {
        foreach ($this->languages as $k => $l) {
            if ($l["lang_default"]) {
                $this->languages[$k]["description"] = $a_description;
            }
        }
    }

◆ setDefaultTitle()

ilMultilingualism::setDefaultTitle ( $a_title )

Set default title.

Parameters

string $a_title title

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

    {
        foreach ($this->languages as $k => $l) {
            if ($l["lang_default"]) {
                $this->languages[$k]["title"] = $a_title;
            }
        }
    }

◆ setLanguages()

ilMultilingualism::setLanguages ( array $a_val )

Set languages.

Parameters

array $a_val array of language codes

Definition at line 110 of file class.ilMultilingualism.php.

    {
        $this->languages = $a_val;
    }

Referenced by read().

Here is the caller graph for this function:

◆ setObjId()

ilMultilingualism::setObjId ( $a_val )

Set object id.

Parameters

int $a_val object id

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

    {
        $this->obj_id = $a_val;
    }

Referenced by __construct().

Here is the caller graph for this function:

◆ setType()

ilMultilingualism::setType ( $type )

Parameters

string $type

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

    {
        $this->type = $type;
    }

References $type.

Referenced by __construct().

Here is the caller graph for this function:

◆ toXml()

ilMultilingualism::toXml ( ilXmlWriter $writer )

Export.

Parameters

ilXmlWriter $writer

Returns: ilXmlWriter

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

    {
        $writer->xmlStartTag('translations');
        
        foreach ($this->getLanguages() as $k => $v) {
            $writer->xmlStartTag('translation', array('language' => $k, 'default' => $v['lang_default'] ? 1 : 0));
            $writer->xmlElement('title', array(), $v['title']);
            $writer->xmlElement('description', array(), $v['description']);
            $writer->xmlEndTag('translation');
        }
        $writer->xmlEndTag('translations');
 
        return $writer;
    }

References getLanguages(), ilXmlWriter\xmlElement(), ilXmlWriter\xmlEndTag(), and ilXmlWriter\xmlStartTag().

Here is the call graph for this function:

Field Documentation

◆ $db

ilMultilingualism::$db

protected

Definition at line 36 of file class.ilMultilingualism.php.

◆ $instances

ilMultilingualism::$instances = array()

staticprotected

Definition at line 40 of file class.ilMultilingualism.php.

◆ $languages

ilMultilingualism::$languages = array()

protected

Definition at line 38 of file class.ilMultilingualism.php.

Referenced by getLanguages().

◆ $lng

ilMultilingualism::$lng

protected

Definition at line 34 of file class.ilMultilingualism.php.

Referenced by getDefaultLanguage().

◆ $obj_id

ilMultilingualism::$obj_id

protected

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

Referenced by getObjId().

◆ $type

ilMultilingualism::$type = ""

protected

Definition at line 39 of file class.ilMultilingualism.php.

Referenced by getType(), and setType().

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

Services/Multilingualism/classes/class.ilMultilingualism.php

Public Member Functions

Static Public Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addLanguage()

◆ copy()

◆ delete()

◆ fromXML()

◆ getDefaultDescription()

◆ getDefaultLanguage()

◆ getDefaultTitle()

◆ getInstance()

◆ getLanguages()

◆ getObjId()

◆ getType()

◆ read()

◆ removeLanguage()

◆ save()

◆ setDefaultDescription()

◆ setDefaultTitle()

◆ setLanguages()

◆ setObjId()

◆ setType()

◆ toXml()

Field Documentation

◆ $db

◆ $instances

◆ $languages

◆ $lng

◆ $obj_id

◆ $type