ilMultilingualismGUI Class Reference

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

Collaboration diagram for ilMultilingualismGUI:

Public Member Functions
	__construct (int $a_obj_id, string $a_type)
	setTitleDescrOnlyMode (bool $a_val)
	Set enable title/description only mode. More...
	getTitleDescrOnlyMode ()
	Get enable title/description only mode. More...
	executeCommand ()
	listTranslations (bool $a_get_post_values=false, bool $a_add=false)
	addToolbar ()
	saveTranslations (bool $delete_checked=false)
	deleteTranslations ()
	getMultiLangForm (bool $a_add=false)
	Get multi language form. More...
	confirmDeactivateContentMultiLang ()
	Confirm page translation creation. More...
	addLanguages (ilPropertyFormGUI $form=null)
	Add language. More...
	saveLanguages ()
	confirmRemoveLanguages ()
	Confirm remove languages. More...
	removeLanguages ()
	Remove languages. More...
	setStartValues (string $a_title, string $a_description)

Protected Attributes
ILIAS Multilingualism StandardGUIRequest	$request
ilLanguage	$lng
ilCtrl	$ctrl
ilGlobalTemplateInterface	$tpl
ilToolbarGUI	$toolbar
ilObjUser	$user
ilMultilingualism	$obj_trans
bool	$title_descr_only = true
string	$start_title = ""
string	$start_description = ""

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 GUI class for object translation handling.

Author

Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de ilMultilingualismeGUI: ilDidacticTemplateSettingsGUI

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

Constructor & Destructor Documentation

__construct()

ilMultilingualismGUI::__construct	(	int	$a_obj_id,
		string	$a_type
	)

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

References $DIC, ILIAS\Repository\ctrl(), ilMultilingualism\getInstance(), ILIAS\Repository\lng(), ILIAS\Repository\toolbar(), and ILIAS\Repository\user().

      {
        global $DIC;

        $this->toolbar = $DIC->toolbar();
        $this->user = $DIC->user();
        $this->lng = $DIC->language();
        $this->lng->loadLanguageModule('obj');
        $this->ctrl = $DIC->ctrl();
        $this->tpl = $DIC->ui()->mainTemplate();

        $this->obj_trans = ilMultilingualism::getInstance($a_obj_id, $a_type);
        $this->request = new \ILIAS\Multilingualism\StandardGUIRequest(
            $DIC->http(),
            $DIC->refinery()
        );
    }

Here is the call graph for this function:

Member Function Documentation

addLanguages()

ilMultilingualismGUI::addLanguages

(

ilPropertyFormGUI

$form = null

)

Add language.

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

References $tpl, getMultiLangForm(), and ilGlobalTemplateInterface\setContent().

Referenced by saveLanguages().

                                                                : void
    {
        $tpl = $this->tpl;

        if (!$form instanceof ilPropertyFormGUI) {
            $form = $this->getMultiLangForm(true);
        }
        $tpl->setContent($form->getHTML());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

addToolbar()

ilMultilingualismGUI::addToolbar

(

)

Definition at line 135 of file class.ilMultilingualismGUI.php.

References $toolbar, ilToolbarGUI\addButton(), ILIAS\Repository\ctrl(), getTitleDescrOnlyMode(), and ILIAS\Repository\lng().

Referenced by listTranslations().

                                : void
    {
        $ilToolbar = $this->toolbar;
        if ($this->getTitleDescrOnlyMode()) {
            $ilToolbar->addButton(
                $this->lng->txt("obj_add_languages"),
                $this->ctrl->getLinkTarget($this, "addLanguages")
            );
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

confirmDeactivateContentMultiLang()

ilMultilingualismGUI::confirmDeactivateContentMultiLang

(

)

Confirm page translation creation.

Definition at line 275 of file class.ilMultilingualismGUI.php.

References $ctrl, $lng, $tpl, getTitleDescrOnlyMode(), ilGlobalTemplateInterface\setContent(), and ilLanguage\txt().

                                                       : void
    {
        $ilCtrl = $this->ctrl;
        $tpl = $this->tpl;
        $lng = $this->lng;

        $cgui = new ilConfirmationGUI();
        $cgui->setFormAction($ilCtrl->getFormAction($this));
        if ($this->getTitleDescrOnlyMode()) {
            $cgui->setHeaderText($lng->txt("obj_deactivate_content_transl_conf"));
        } else {
            $cgui->setHeaderText($lng->txt("obj_deactivate_multilang_conf"));
        }

        $cgui->setCancel($lng->txt("cancel"), "listTranslations");
        $cgui->setConfirm($lng->txt("confirm"), "deactivateContentMultiLang");
        $tpl->setContent($cgui->getHTML());
    }

Here is the call graph for this function:

confirmRemoveLanguages()

ilMultilingualismGUI::confirmRemoveLanguages

(

)

Confirm remove languages.

Definition at line 347 of file class.ilMultilingualismGUI.php.

References $ctrl, $lng, $tpl, ilLanguage\loadLanguageModule(), ilGlobalTemplateInterface\setContent(), and ilLanguage\txt().

                                            : void
    {
        $ilCtrl = $this->ctrl;
        $tpl = $this->tpl;
        $lng = $this->lng;

        $lng->loadLanguageModule("meta");
        $langs = $this->request->getLanguages();

        if (count($langs) === 0) {
            $this->tpl->setOnScreenMessage('info', $lng->txt("no_checkbox"), true);
            $ilCtrl->redirect($this, "listTranslations");
        } else {
            $cgui = new ilConfirmationGUI();
            $cgui->setFormAction($ilCtrl->getFormAction($this));
            $cgui->setHeaderText($lng->txt("obj_conf_delete_lang"));
            $cgui->setCancel($lng->txt("cancel"), "listTranslations");
            $cgui->setConfirm($lng->txt("remove"), "removeLanguages");

            foreach ($langs as $i) {
                $cgui->addItem("lang[]", $i, $lng->txt("meta_l_" . $i));
            }

            $tpl->setContent($cgui->getHTML());
        }
    }

Here is the call graph for this function:

deleteTranslations()

ilMultilingualismGUI::deleteTranslations

(

)

Definition at line 199 of file class.ilMultilingualismGUI.php.

References $check, listTranslations(), ILIAS\Repository\lng(), and saveTranslations().

                                        : void
    {
        $default = $this->request->getDefault();
        $langs = $this->request->getLanguages();
        $titles = $this->request->getTitles();
        $descs = $this->request->getDescriptions();
        $check = $this->request->getCheck();
        foreach ($titles as $k => $v) {
            if ($check[$k] ?? false) {
                // default translation cannot be deleted
                if ($k != $default) {
                    unset($titles[$k], $descs[$k], $langs[$k]);
                } else {
                    $this->tpl->setOnScreenMessage('failure', $this->lng->txt("msg_no_default_language"));
                    $this->listTranslations();
                    return;
                }
            }
        }
        $this->saveTranslations(true);
    }

Here is the call graph for this function:

executeCommand()

ilMultilingualismGUI::executeCommand

(

)

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

References ILIAS\Repository\ctrl().

                                    : void
    {
        $next_class = $this->ctrl->getNextClass($this);

        switch ($next_class) {
            default:
                $cmd = $this->ctrl->getCmd("listTranslations");
                if (in_array($cmd, array("listTranslations", "saveTranslations",
                    "addTranslation", "deleteTranslations", "activateContentMultilinguality",
                    "confirmRemoveLanguages", "removeLanguages", "confirmDeactivateContentMultiLang", "saveLanguages",
                    "saveContentTranslationActivation", "deactivateContentMultiLang", "addLanguages"))) {
                    $this->$cmd();
                }
                break;
        }
    }

Here is the call graph for this function:

getMultiLangForm()

ilMultilingualismGUI::getMultiLangForm

(

bool

$a_add = false

)

Get multi language form.

Definition at line 228 of file class.ilMultilingualismGUI.php.

References $ctrl, $lng, $user, ilMDLanguageItem\_getLanguages(), getTitleDescrOnlyMode(), ilSelectInputGUI\setOptions(), and ilLanguage\txt().

Referenced by addLanguages(), and saveLanguages().

                                                         : ilPropertyFormGUI
    {
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
        $ilUser = $this->user;

        $form = new ilPropertyFormGUI();

        // master language
        if (!$a_add) {
            $options = ilMDLanguageItem::_getLanguages();
            $si = new ilSelectInputGUI($lng->txt("obj_master_lang"), "master_lang");
            $si->setOptions($options);
            $si->setValue($ilUser->getLanguage());
            $form->addItem($si);
        }

        // additional languages
        if ($a_add) {
            $options = ilMDLanguageItem::_getLanguages();
            $options = array("" => $lng->txt("please_select")) + $options;
            $si = new ilSelectInputGUI($lng->txt("obj_additional_langs"), "additional_langs");
            $si->setOptions($options);
            $si->setMulti(true);
            $form->addItem($si);
        }

        if ($a_add) {
            $form->setTitle($lng->txt("obj_add_languages"));
            $form->addCommandButton("saveLanguages", $lng->txt("save"));
        } else {
            if ($this->getTitleDescrOnlyMode()) {
                $form->setTitle($lng->txt("obj_activate_content_lang"));
            } else {
                $form->setTitle($lng->txt("obj_activate_multilang"));
            }
            $form->addCommandButton("saveContentTranslationActivation", $lng->txt("save"));
        }
        $form->addCommandButton("listTranslations", $lng->txt("cancel"));
        $form->setFormAction($ilCtrl->getFormAction($this));

        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getTitleDescrOnlyMode()

ilMultilingualismGUI::getTitleDescrOnlyMode

(

)

Get enable title/description only mode.

Definition at line 68 of file class.ilMultilingualismGUI.php.

References $title_descr_only.

Referenced by addToolbar(), confirmDeactivateContentMultiLang(), and getMultiLangForm().

                                           : bool
    {
        return $this->title_descr_only;
    }

Here is the caller graph for this function:

listTranslations()

ilMultilingualismGUI::listTranslations	(	bool	$a_get_post_values = false,
		bool	$a_add = false
	)

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

References $data, addToolbar(), and ILIAS\Repository\lng().

Referenced by deleteTranslations(), and saveTranslations().

     : void {
        $this->lng->loadLanguageModule("translation");


        $this->addToolbar();

        $titles = $this->request->getTitles();
        $langs = $this->request->getLanguages();
        $descs = $this->request->getDescriptions();
        $default = $this->request->getDefault();

        $table = new ilMultilingualismTableGUI(
            $this,
            "listTranslations",
            true,
            "Translation"
        );
        if ($a_get_post_values) {
            $vals = array();
            foreach ($titles as $k => $v) {
                $vals[] = array("title" => $v,
                    "desc" => $descs[$k],
                    "lang" => $langs[$k],
                    "default" => ($default == $k));
            }
            $table->setData($vals);
        } else {
            $k = 0;
            $data = $this->obj_trans->getLanguages();
            foreach ($data as $k => $v) {
                $data[$k]["default"] = $v["lang_default"];
                $data[$k]["desc"] = $v["description"];
                $data[$k]["lang"] = $v["lang_code"];
            }
            if ($a_add) {
                $data["Fobject"][++$k]["title"] = "";
            }
            $table->setData($data);
        }
        $this->tpl->setContent($table->getHTML());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

removeLanguages()

ilMultilingualismGUI::removeLanguages

(

)

Remove languages.

Definition at line 377 of file class.ilMultilingualismGUI.php.

References $ctrl, $lng, ilCtrl\redirect(), and ilLanguage\txt().

                                     : void
    {
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;

        $post_langs = $this->request->getLanguages();

        if (count($post_langs) > 0) {
            $langs = $this->obj_trans->getLanguages();
            foreach ($langs as $k => $l) {
                if (in_array($l, $post_langs)) {
                    $this->obj_trans->removeLanguage($l);
                }
            }
            $this->obj_trans->save();
            $this->tpl->setOnScreenMessage('info', $lng->txt("msg_obj_modified"), true);
        }
        $ilCtrl->redirect($this, "listTranslations");
    }

Here is the call graph for this function:

saveLanguages()

ilMultilingualismGUI::saveLanguages

(

)

Definition at line 307 of file class.ilMultilingualismGUI.php.

References $ctrl, $lng, addLanguages(), ilLoggerFactory\getLogger(), getMultiLangForm(), and ilLanguage\txt().

                                   : void
    {
        $ilCtrl = $this->ctrl;
        $lng = $this->lng;

        ilLoggerFactory::getLogger('otpl')->debug('Save languages');

        $form = $this->getMultiLangForm(true);
        if ($form->checkInput()) {
            $ad = $form->getInput("additional_langs");

            ilLoggerFactory::getLogger('otpl')->dump($ad);

            if (is_array($ad)) {
                foreach ($ad as $l) {
                    if ($l != "") {
                        $std = false;

                        //if no other language is set, set this one as standard
                        if (!count($this->obj_trans->getLanguages())) {
                            $std = true;
                        }

                        $this->obj_trans->addLanguage($l, $this->start_title, $this->start_description, $std);
                    }
                }
            }
            $this->obj_trans->save();
            $this->tpl->setOnScreenMessage('info', $lng->txt("msg_obj_modified"), true);
            $ilCtrl->redirect($this, "listTranslations");
        } else {
            $form->setValuesByPost();
            $this->tpl->setOnScreenMessage('failure', $lng->txt('err_check_input'));
            $this->addLanguages($form);
        }
    }

Here is the call graph for this function:

saveTranslations()

ilMultilingualismGUI::saveTranslations

(

bool

$delete_checked = false

)

Definition at line 146 of file class.ilMultilingualismGUI.php.

References $check, ILIAS\Repository\ctrl(), listTranslations(), and ILIAS\Repository\lng().

Referenced by deleteTranslations().

                                                                  : void
    {
        $default = $this->request->getDefault();
        $langs = $this->request->getLanguages();
        $titles = $this->request->getTitles();
        $descs = $this->request->getDescriptions();

        // default language set?
        if ($default === "") {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("msg_no_default_language"));
            $this->listTranslations(true);
            return;
        }

        // all languages set?
        if (array_key_exists("", $langs)) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("msg_no_language_selected"));
            $this->listTranslations(true);
            return;
        }

        // no single language is selected more than once?
        if (count(array_unique($langs)) < count($langs)) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt("msg_multi_language_selected"));
            $this->listTranslations(true);
            return;
        }

        $check = $this->request->getCheck();

        // save the stuff
        $this->obj_trans->setLanguages(array());

        foreach ($titles as $k => $v) {
            // update object data if default
            $is_default = ($default == $k);
            if ($delete_checked && !$is_default && isset($check[$k])) {
                continue;
            }

            $this->obj_trans->addLanguage(
                $langs[$k],
                $v,
                $descs[$k],
                $is_default
            );
        }
        $this->obj_trans->save();

        $this->tpl->setOnScreenMessage('success', $this->lng->txt("msg_obj_modified"), true);
        $this->ctrl->redirect($this, "listTranslations");
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setStartValues()

ilMultilingualismGUI::setStartValues	(	string	$a_title,
		string	$a_description
	)

Definition at line 397 of file class.ilMultilingualismGUI.php.

Referenced by ilDidacticTemplateSettingsGUI\executeCommand().

     : void {
        $this->start_title = $a_title;
        $this->start_description = $a_description;
    }

Here is the caller graph for this function:

setTitleDescrOnlyMode()

ilMultilingualismGUI::setTitleDescrOnlyMode

(

bool

$a_val

)

Set enable title/description only mode.

Definition at line 60 of file class.ilMultilingualismGUI.php.

                                                      : void
    {
        $this->title_descr_only = $a_val;
    }

Field Documentation

$ctrl

ilCtrl ilMultilingualismGUI::$ctrl

protected

Definition at line 28 of file class.ilMultilingualismGUI.php.

Referenced by confirmDeactivateContentMultiLang(), confirmRemoveLanguages(), getMultiLangForm(), removeLanguages(), and saveLanguages().

$lng

ilLanguage ilMultilingualismGUI::$lng

protected

Definition at line 27 of file class.ilMultilingualismGUI.php.

Referenced by confirmDeactivateContentMultiLang(), confirmRemoveLanguages(), getMultiLangForm(), removeLanguages(), and saveLanguages().

$obj_trans

ilMultilingualism ilMultilingualismGUI::$obj_trans

protected

Definition at line 32 of file class.ilMultilingualismGUI.php.

$request

ILIAS Multilingualism StandardGUIRequest ilMultilingualismGUI::$request

protected

Definition at line 26 of file class.ilMultilingualismGUI.php.

$start_description

string ilMultilingualismGUI::$start_description = ""

protected

Definition at line 35 of file class.ilMultilingualismGUI.php.

$start_title

string ilMultilingualismGUI::$start_title = ""

protected

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

$title_descr_only

bool ilMultilingualismGUI::$title_descr_only = true

protected

Definition at line 33 of file class.ilMultilingualismGUI.php.

Referenced by getTitleDescrOnlyMode().

$toolbar

ilToolbarGUI ilMultilingualismGUI::$toolbar

protected

Definition at line 30 of file class.ilMultilingualismGUI.php.

Referenced by addToolbar().

$tpl

ilGlobalTemplateInterface ilMultilingualismGUI::$tpl

protected

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

Referenced by addLanguages(), confirmDeactivateContentMultiLang(), and confirmRemoveLanguages().

$user

ilObjUser ilMultilingualismGUI::$user

protected

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

Referenced by getMultiLangForm().

---

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

• Services/Multilingualism/classes/class.ilMultilingualismGUI.php