ilLTIProviderObjectSettingGUI Class Reference

GUI class for LTI provider object settings. More...

Collaboration diagram for ilLTIProviderObjectSettingGUI:

Public Member Functions
	__construct (int $a_ref_id)
	hasSettingsAccess ()
	Check if user has access to lti settings. More...
	setCustomRolesForSelection (array $a_roles)
	Set custom roles for mapping to LTI roles. More...
	offerLTIRolesForSelection (bool $a_stat)
	Offer LTI roles for mapping. More...
	executeCommand ()
	Ctrl execute command. More...

Data Fields
const	ROLE_ADMIN = 'admin'
const	ROLE_TUTOR = 'tutor'
const	ROLE_MEMBER = 'member'

Protected Member Functions
	settings (?ilPropertyFormGUI $form=null)
	Show settings. More...
	initObjectSettingsForm ()
	Init object settings form. More...
	updateSettings ()
	Update settings (activate deactivate lti access) More...
	saveRoleSelection (ilPropertyFormGUI $form, string $global_consumer_id)
	Save role selection for consumer. More...
	getRoleSelection ()
	Get role selection. More...
	checkLocalRole ()
	check for local roles for lti objects which are not grp or crs More...

Protected Attributes
ilCtrl	$ctrl = null
ilLogger	$logger = null
ilLanguage	$lng = null
ilGlobalPageTemplate	$tpl = null
int	$ref_id = null
array	$custom_roles = []
bool	$use_lti_roles = true

Private Attributes
ilRbacSystem	$rbacSystem
ilRbacReview	$rbacReview
ilRbacAdmin	$rbacAdmin

Detailed Description

GUI class for LTI provider object settings.

Author

Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

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

Constructor & Destructor Documentation

__construct()

ilLTIProviderObjectSettingGUI::__construct

(

int

$a_ref_id

)

Parameters

int

ref_id

Definition at line 76 of file class.ilLTIProviderObjectSettingGUI.php.

References $DIC, ILIAS\Repository\ctrl(), ilLoggerFactory\getLogger(), ILIAS\Repository\lng(), and ILIAS\Repository\logger().

    {
        global $DIC;
        $this->ref_id = $a_ref_id;
        $this->logger = ilLoggerFactory::getLogger('ltis');
        $this->ctrl = $DIC->ctrl();
        $this->tpl = $DIC['tpl'];
        $this->rbacSystem = $DIC->rbac()->system();
        $this->rbacReview = $DIC->rbac()->review();
        $this->rbacAdmin = $DIC->rbac()->admin();

        $this->lng = $DIC->language();
        $this->lng->loadLanguageModule('lti');
    }

Here is the call graph for this function:

Member Function Documentation

checkLocalRole()

ilLTIProviderObjectSettingGUI::checkLocalRole ( )

protected

check for local roles for lti objects which are not grp or crs

Definition at line 401 of file class.ilLTIProviderObjectSettingGUI.php.

References $rbacAdmin, $ref_id, ilObject\_getIdsForTitle(), ilRbacReview\_getOperationIdsByName(), ilObject\_lookupObjectId(), and ilObject\_lookupType().

Referenced by setCustomRolesForSelection().

                                       : void
    {
        $a_global_role = ilObject::_getIdsForTitle("il_lti_global_role", "role", false);
        if (is_array($a_global_role) && !empty($a_global_role)) {
            if (count($this->rbacReview->getRolesOfObject($this->ref_id, false)) == 0) {
                $rbacadmin = $this->rbacAdmin;
                $type = ilObject::_lookupType($this->ref_id, true);
                $role = new ilObjRole();
                $role->setTitle("il_lti_learner");
                $role->setDescription("LTI Learner of " . $type . " obj_no." . ilObject::_lookupObjectId($this->ref_id));
                $role->create();
                $rbacadmin->assignRoleToFolder($role->getId(), $this->ref_id, 'y');
                $rbacadmin->grantPermission($role->getId(), ilRbacReview::_getOperationIdsByName(array('visible','read')), $this->ref_id);
                // $rbacadmin->setRolePermission($role->getId(), ilObject::_lookupType($this->ref_id, true), [2,3], $this->ref_id);
                if ($type == "sahs" || $type == "lm" || $type == "svy" || $type == "tst") {
                    $role = new ilObjRole();
                    $role->setTitle("il_lti_instructor");
                    $role->setDescription("LTI Instructor of " . $type . " obj_no." . ilObject::_lookupObjectId($this->ref_id));
                    $role->create();
                    $rbacadmin->assignRoleToFolder($role->getId(), $this->ref_id, 'y');
                    $ops = ilRbacReview::_getOperationIdsByName(array('visible','read','read_learning_progress'));
                    if ($type == "svy") {
                        $ops[] = ilRbacReview::_getOperationIdsByName(array('read_results'))[0];
                    }
                    if ($type == "tst") {
                        $ops[] = ilRbacReview::_getOperationIdsByName(array('tst_results'))[0];
                    }
                    $rbacadmin->grantPermission($role->getId(), $ops, $this->ref_id);
                }
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

executeCommand()

ilLTIProviderObjectSettingGUI::executeCommand

(

)

Ctrl execute command.

Definition at line 132 of file class.ilLTIProviderObjectSettingGUI.php.

References ILIAS\Repository\ctrl().

                                    : void
    {
        $cmd = $this->ctrl->getCmd('settings');
        $next_class = $this->ctrl->getNextClass($this);

        //        switch ($next_class) {
        //            default:
        $this->$cmd();
        //                break;
        //        }
    }

Here is the call graph for this function:

getRoleSelection()

ilLTIProviderObjectSettingGUI::getRoleSelection ( )

protected

Get role selection.

Returns

string[]

Definition at line 387 of file class.ilLTIProviderObjectSettingGUI.php.

References ilObjRole\_getTranslation(), ilObject\_lookupTitle(), and ILIAS\Repository\lng().

Referenced by initObjectSettingsForm().

                                         : array
    {
        $options = [];
        $options[0] = $this->lng->txt('select_one');
        foreach ($this->custom_roles as $role_id) {
            $title = ilObjRole::_getTranslation(ilObjRole::_lookupTitle($role_id));
            $options[$role_id] = $title;
        }
        return $options;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

hasSettingsAccess()

ilLTIProviderObjectSettingGUI::hasSettingsAccess

(

)

Check if user has access to lti settings.

Returns

bool

Definition at line 95 of file class.ilLTIProviderObjectSettingGUI.php.

References ilObject\_lookupType(), ILIAS\Repository\logger(), and ilObjLTIAdministration\lookupLTISettingsRefId().

                                       : bool
    {
        if (!ilObjLTIAdministration::isEnabledForType(ilObject::_lookupType($this->ref_id, true))) {
            $this->logger->debug('No LTI consumers activated for object type: ' . ilObject::_lookupType($this->ref_id, true));
            return false;
        }
        return $this->rbacSystem->checkAccess(
            'release_objects',
            ilObjLTIAdministration::lookupLTISettingsRefId()
        );
    }

Here is the call graph for this function:

initObjectSettingsForm()

ilLTIProviderObjectSettingGUI::initObjectSettingsForm ( )

protected

Init object settings form.

Definition at line 160 of file class.ilLTIProviderObjectSettingGUI.php.

References $ref_id, $url, $version, ilObject\_lookupType(), CLIENT_ID, ILIAS\Repository\ctrl(), ilLTIPlatform\fromGlobalSettingsAndRefId(), getRoleSelection(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), ilSelectInputGUI\setOptions(), and ilRadioOption\setValue().

Referenced by settings(), and updateSettings().

                                               : \ilPropertyFormGUI
    {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this));
        $form->setTitle($this->lng->txt('lti_object_release_settings_form'));

        foreach (ilObjLTIAdministration::getEnabledConsumersForType(ilObject::_lookupType($this->ref_id, true)) as $global_consumer) {
            $object_info = new ilLTIProviderObjectSetting($this->ref_id, $global_consumer->getExtConsumerId());

            $this->logger->debug((string) $object_info->getAdminRole());


            // meta data for external consumers
            $section = new ilFormSectionHeaderGUI();
            $section->setTitle($global_consumer->getTitle());
            $section->setInfo($global_consumer->getDescription());
            $form->addItem($section);

            $connector = new ilLTIDataConnector();

            $active_consumer = ilLTIPlatform::fromGlobalSettingsAndRefId(
                $global_consumer->getExtConsumerId(),
                $this->ref_id,
                $connector
            );
            $active = new ilCheckboxInputGUI($this->lng->txt('lti_obj_active'), 'lti_active_' . $global_consumer->getExtConsumerId());
            $active->setInfo($this->lng->txt('lti_obj_active_info'));
            $active->setValue("1");//check
            if ($active_consumer->getEnabled()) { // and enabled
                $active->setChecked(true);
            }
            if ($this->custom_roles) {
                $admin = new ilSelectInputGUI(
                    $this->lng->txt('lti_admin'),
                    'lti_admin_' . $global_consumer->getExtConsumerId()
                );
                $admin->setOptions($this->getRoleSelection());
                $admin->setValue($object_info->getAdminRole() ? $object_info->getAdminRole() : 0);
                $active->addSubItem($admin);

                $tutor = new ilSelectInputGUI(
                    $this->lng->txt('lti_tutor'),
                    'lti_tutor_' . $global_consumer->getExtConsumerId()
                );
                $tutor->setOptions($this->getRoleSelection());
                $tutor->setValue($object_info->getTutorRole() ? $object_info->getTutorRole() : 0);
                $active->addSubItem($tutor);

                $member = new ilSelectInputGUI(
                    $this->lng->txt('lti_member'),
                    'lti_member_' . $global_consumer->getExtConsumerId()
                );
                $member->setOptions($this->getRoleSelection());
                $member->setValue($object_info->getMemberRole() ? $object_info->getMemberRole() : 0);
                $active->addSubItem($member);
            }
            $form->addItem($active);

            $version = new ilRadioGroupInputGUI($this->lng->txt('lti_obj_version'), 'version_' . $global_consumer->getExtConsumerId());
            $version->setRequired(true);
            if (!is_null($active_consumer->ltiVersion)) {
                $version->setValue($active_consumer->ltiVersion->value);
            }
            //            $version->setInfo($this->lng->txt('lti_obj_version_info'));
            $op1 = new ilRadioOption($this->lng->txt("lti_obj_version_13"), LtiVersion::V1P3->value);
            $sh = new ilNonEditableValueGUI($this->lng->txt('lti_13_step1'), '');
            $sh->setValue($this->lng->txt("lti_13_step1_info"));
            $op1->addSubItem($sh);
            $url = new ilNonEditableValueGUI($this->lng->txt('lti_launch_url'), 'url');
            $url->setValue(ILIAS_HTTP_PATH . '/lti.php?client_id=' . CLIENT_ID);
            $op1->addSubItem($url);
            //                    $url = new ilNonEditableValueGUI($this->lng->txt('lti_13_initiate_url'), 'url');
            //                    $url->setValue(ILIAS_HTTP_PATH . '/lti.php?client_id=' . CLIENT_ID);
            //                    $version->addSubItem($url);
            //                    $url = new ilNonEditableValueGUI($this->lng->txt('lti_13_redirection_url'), 'url');
            //                    $url->setValue(ILIAS_HTTP_PATH . '/lti.php?client_id=' . CLIENT_ID);
            //                    $active->addSubItem($url);
            $sh = new ilNonEditableValueGUI($this->lng->txt('lti_13_step2'), '');
            $sh->setValue($this->lng->txt("lti_13_step2_info"));
            $op1->addSubItem($sh);
            $tf = new ilTextInputGUI($this->lng->txt('lti_13_platform_id'), 'platform_id_' . $global_consumer->getExtConsumerId());
            $tf->setValue($active_consumer->platformId);
            $op1->addSubItem($tf);
            $tf = new ilTextInputGUI($this->lng->txt('lti_13_client_id'), 'client_id_' . $global_consumer->getExtConsumerId());
            $tf->setValue($active_consumer->clientId);
            $op1->addSubItem($tf);
            $tf = new ilTextInputGUI($this->lng->txt('lti_13_deployment_id'), 'deployment_id_' . $global_consumer->getExtConsumerId());
            $tf->setValue($active_consumer->deploymentId);
            $op1->addSubItem($tf);
            $tf = new ilTextInputGUI($this->lng->txt('lti_13_keyset_url'), 'keyset_url_' . $global_consumer->getExtConsumerId());
            $tf->setValue($active_consumer->jku);
            $op1->addSubItem($tf);
            $tf = new ilTextInputGUI($this->lng->txt('lti_13_token_url'), 'token_url_' . $global_consumer->getExtConsumerId());
            $tf->setValue($active_consumer->accessTokenUrl);
            $op1->addSubItem($tf);
            $tf = new ilTextInputGUI($this->lng->txt('lti_13_authentication_url'), 'authentication_url_' . $global_consumer->getExtConsumerId());
            $tf->setValue($active_consumer->authenticationUrl);
            $op1->addSubItem($tf);
            $version->addOption($op1);

            $op0 = new ilRadioOption($this->lng->txt("lti_obj_version_11"), LtiVersion::V1->value);
            $url = new ilNonEditableValueGUI($this->lng->txt('lti_launch_url'), 'url');
            $url->setValue(ILIAS_HTTP_PATH . '/lti.php?client_id=' . CLIENT_ID);
            $op0->addSubItem($url);
            $key = new ilNonEditableValueGUI($this->lng->txt('lti_consumer_key'), 'key_' . $global_consumer->getExtConsumerId());
            if (is_null($active_consumer->getKey())) {
                $active_consumer->setKey(Util::getRandomString(10));//create $id .
            }
            $key->setValue($active_consumer->getKey());
            $op0->addSubItem($key);
            $secret = new ilNonEditableValueGUI($this->lng->txt('lti_consumer_secret'), 'secret_' . $global_consumer->getExtConsumerId());
            if (is_null($active_consumer->getSecret())) {
                $active_consumer->createSecret();
            }
            $secret->setValue($active_consumer->getSecret());
            $op0->addSubItem($secret);
            $version->addOption($op0);

            $active->addSubItem($version);
        }

        $form->addCommandButton('updateSettings', $this->lng->txt('save'));
        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

offerLTIRolesForSelection()

ilLTIProviderObjectSettingGUI::offerLTIRolesForSelection

(

bool

$a_stat

)

Offer LTI roles for mapping.

Definition at line 123 of file class.ilLTIProviderObjectSettingGUI.php.

                                                           : void
    {
        $this->use_lti_roles = $a_stat;
    }

saveRoleSelection()

ilLTIProviderObjectSettingGUI::saveRoleSelection ( ilPropertyFormGUI  $form, string  $global_consumer_id  )

protected

Save role selection for consumer.

Parameters

ilPropertyFormGUI	$form
string	$global_consumer_id

Definition at line 364 of file class.ilLTIProviderObjectSettingGUI.php.

References ilPropertyFormGUI\getInput(), and ILIAS\Repository\int().

Referenced by updateSettings().

                                                                                             : void
    {
        $object_info = new ilLTIProviderObjectSetting($this->ref_id, (int) $global_consumer_id);

        $admin_role = (int) $form->getInput('lti_admin_' . $global_consumer_id);
        if ($admin_role > 0) {
            $object_info->setAdminRole($admin_role);
        }
        $tutor_role = (int) $form->getInput('lti_tutor_' . $global_consumer_id);
        if ($tutor_role > 0) {
            $object_info->setTutorRole($tutor_role);
        }
        $member_role = (int) $form->getInput('lti_member_' . $global_consumer_id);
        if ($member_role > 0) {
            $object_info->setMemberRole($member_role);
        }
        $object_info->save();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setCustomRolesForSelection()

ilLTIProviderObjectSettingGUI::setCustomRolesForSelection

(

array

$a_roles

)

Set custom roles for mapping to LTI roles.

Parameters

array

$a_roles

Definition at line 111 of file class.ilLTIProviderObjectSettingGUI.php.

References checkLocalRole().

Referenced by ilObjContentObjectGUI\checkCtrlPath(), ilObjSAHSLearningModuleGUI\executeCommand(), ilObjGroupGUI\executeCommand(), ilObjWikiGUI\executeCommand(), ilObjSurveyGUI\executeCommand(), and ilObjCourseGUI\executeCommand().

                                                              : void
    {
        if (empty($a_roles)) {
            $this->checkLocalRole();
            $a_roles = $this->rbacReview->getLocalRoles($this->ref_id);
        }
        $this->custom_roles = $a_roles;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

settings()

ilLTIProviderObjectSettingGUI::settings ( ?ilPropertyFormGUI  $form = null )

protected

Show settings.

Parameters

ilPropertyFormGUI

$form

Definition at line 148 of file class.ilLTIProviderObjectSettingGUI.php.

References initObjectSettingsForm().

Referenced by updateSettings().

                                                                : void
    {
        if (!$form instanceof ilPropertyFormGUI) {
            $form = $this->initObjectSettingsForm();
        }
        $this->tpl->setContent($form->getHTML());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

updateSettings()

ilLTIProviderObjectSettingGUI::updateSettings ( )

protected

Update settings (activate deactivate lti access)

Definition at line 288 of file class.ilLTIProviderObjectSettingGUI.php.

References $ref_id, ilObject\_lookupType(), ILIAS\Repository\ctrl(), ILIAS\ResourceStorage\Flavour\Machine\DefaultMachines\from(), ilLTIPlatform\fromGlobalSettingsAndRefId(), initObjectSettingsForm(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), null, saveRoleSelection(), and settings().

                                       : void
    {
        $form = $this->initObjectSettingsForm();
        if (!$form->checkInput()) {
            $form->setValuesByPost();
            $this->settings($form);
            return;
        }

        $connector = new ilLTIDataConnector();
        foreach (ilObjLTIAdministration::getEnabledConsumersForType(ilObject::_lookupType($this->ref_id, true)) as $global_consumer) {
            $this->saveRoleSelection($form, (string) $global_consumer->getExtConsumerId());

            $consumer = ilLTIPlatform::fromGlobalSettingsAndRefId(
                $global_consumer->getExtConsumerId(),
                $this->ref_id,
                $connector
            );
            if (!$form->getInput('lti_active_' . $global_consumer->getExtConsumerId())) {
                // not active anymore
                if ($consumer->getEnabled()) {
                    $this->logger->info('Deleting lti consumer for object reference: ' . $this->ref_id);
                    $consumer->setEnabled(false);
                    $consumer->saveLTI($connector);
                }
            } else {
                $consumer->ltiVersion = LtiVersion::from($form->getInput('version_' . $global_consumer->getExtConsumerId()));
                $this->logger->info('Created new lti release for: ' . $this->ref_id);
                $consumer->setExtConsumerId($global_consumer->getExtConsumerId());
                $consumer->setKey((string) $form->getInput('key_' . $global_consumer->getExtConsumerId()));
                $consumer->setSecret((string) $form->getInput('secret_' . $global_consumer->getExtConsumerId()));
                $consumer->setRefId($this->ref_id);
                $consumer->setEnabled(true);
                if ($form->getInput('platform_id_' . $global_consumer->getExtConsumerId())) {
                    $consumer->platformId = (string) $form->getInput('platform_id_' . $global_consumer->getExtConsumerId());
                } else {
                    $consumer->platformId = null;
                }
                if ($form->getInput('client_id_' . $global_consumer->getExtConsumerId())) {
                    $consumer->clientId = $form->getInput('client_id_' . $global_consumer->getExtConsumerId());
                } else {
                    $consumer->clientId = null;
                }
                if ($form->getInput('deployment_id_' . $global_consumer->getExtConsumerId())) {
                    $consumer->deploymentId = $form->getInput('deployment_id_' . $global_consumer->getExtConsumerId());
                } else {
                    $consumer->deploymentId = null;
                }
                if ($form->getInput('keyset_url_' . $global_consumer->getExtConsumerId())) {
                    $consumer->jku = $form->getInput('keyset_url_' . $global_consumer->getExtConsumerId());
                } else {
                    $consumer->jku = '';
                }
                if ($form->getInput('token_url_' . $global_consumer->getExtConsumerId())) {
                    $consumer->accessTokenUrl = $form->getInput('token_url_' . $global_consumer->getExtConsumerId());
                } else {
                    $consumer->accessTokenUrl = '';
                }
                if ($form->getInput('authentication_url_' . $global_consumer->getExtConsumerId())) {
                    $consumer->authenticationUrl = $form->getInput('authentication_url_' . $global_consumer->getExtConsumerId());
                } else {
                    $consumer->authenticationUrl = '';
                }
                $consumer->saveLTI($connector);
            }
        }

        $this->tpl->setOnScreenMessage('success', $this->lng->txt('settings_saved'), true);
        $this->ctrl->redirect($this, 'settings');
    }

Here is the call graph for this function:

Field Documentation

$ctrl

ilCtrl ilLTIProviderObjectSettingGUI::$ctrl = null

protected

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

$custom_roles

array ilLTIProviderObjectSettingGUI::$custom_roles = []

protected

Definition at line 62 of file class.ilLTIProviderObjectSettingGUI.php.

$lng

ilLanguage ilLTIProviderObjectSettingGUI::$lng = null

protected

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

$logger

ilLogger ilLTIProviderObjectSettingGUI::$logger = null

protected

Definition at line 44 of file class.ilLTIProviderObjectSettingGUI.php.

$rbacAdmin

ilRbacAdmin ilLTIProviderObjectSettingGUI::$rbacAdmin

private

Definition at line 71 of file class.ilLTIProviderObjectSettingGUI.php.

Referenced by checkLocalRole().

$rbacReview

ilRbacReview ilLTIProviderObjectSettingGUI::$rbacReview

private

Definition at line 70 of file class.ilLTIProviderObjectSettingGUI.php.

$rbacSystem

ilRbacSystem ilLTIProviderObjectSettingGUI::$rbacSystem

private

Definition at line 69 of file class.ilLTIProviderObjectSettingGUI.php.

$ref_id

int ilLTIProviderObjectSettingGUI::$ref_id = null

protected

Definition at line 56 of file class.ilLTIProviderObjectSettingGUI.php.

Referenced by checkLocalRole(), initObjectSettingsForm(), and updateSettings().

$tpl

ilGlobalPageTemplate ilLTIProviderObjectSettingGUI::$tpl = null

protected

Definition at line 51 of file class.ilLTIProviderObjectSettingGUI.php.

$use_lti_roles

bool ilLTIProviderObjectSettingGUI::$use_lti_roles = true

protected

Definition at line 67 of file class.ilLTIProviderObjectSettingGUI.php.

ROLE_ADMIN

const ilLTIProviderObjectSettingGUI::ROLE_ADMIN = 'admin'

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

ROLE_MEMBER

const ilLTIProviderObjectSettingGUI::ROLE_MEMBER = 'member'

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

ROLE_TUTOR

const ilLTIProviderObjectSettingGUI::ROLE_TUTOR = 'tutor'

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

---

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

• components/ILIAS/LTIProvider/classes/InternalProvider/class.ilLTIProviderObjectSettingGUI.php