ToolSettings.php

Go to the documentation of this file.

<?php

namespace IMSGlobal\LTI\ToolProvider\Service;

class ToolSettings extends Service
{

    const MODE_CURRENT_LEVEL = 1;
    const MODE_ALL_LEVELS = 2;
    const MODE_DISTINCT_NAMES = 3;

    private static $LEVEL_NAMES = array('ToolProxy' => 'system',
                                        'ToolProxyBinding' => 'context',
                                        'LtiLink' => 'link');

    private $source;
    private $simple;

    public function __construct($source, $endpoint, $simple = true)
    {

        if (is_a($source, 'IMSGlobal\LTI\ToolProvider\ToolConsumer')) {
            $consumer = $source;
        } else {
            $consumer = $source->getConsumer();
        }
        if ($simple) {
            $mediaType = 'application/vnd.ims.lti.v2.toolsettings.simple+json';
        } else {
            $mediaType = 'application/vnd.ims.lti.v2.toolsettings+json';
        }
        parent::__construct($consumer, $endpoint, $mediaType);
        $this->source = $source;
        $this->simple = $simple;

    }

    public function get($mode = self::MODE_CURRENT_LEVEL) {

        $parameter = array();
        if ($mode === self::MODE_ALL_LEVELS) {
            $parameter['bubble'] = 'all';
        } else if ($mode === self::MODE_DISTINCT_NAMES) {
            $parameter['bubble'] = 'distinct';
        }
        $http = $this->send('GET', $parameter);
        if (!$http->ok) {
            $response = false;
        } else if ($this->simple) {
            $response = json_decode($http->response, true);
        } else if (isset($http->responseJson->{'@graph'})) {
            $response = array();
            foreach ($http->responseJson->{'@graph'} as $level) {
                $settings = json_decode(json_encode($level->custom), true);
                unset($settings['@id']);
                $response[self::$LEVEL_NAMES[$level->{'@type'}]] = $settings;
            }
        }

        return $response;

    }

    public function set($settings) {

        if (!$this->simple) {
            if (is_a($this->source, 'ToolConsumer')) {
                $type = 'ToolProxy';
            } else if (is_a($this->source, 'ToolConsumer')) {
                $type = 'ToolProxyBinding';
            } else {
                $type = 'LtiLink';
            }
            $obj = new \stdClass();
            $obj->{'@context'} = 'http://purl.imsglobal.org/ctx/lti/v2/ToolSettings';
            $obj->{'@graph'} = array();
            $level = new \stdClass();
            $level->{'@type'} = $type;
            $level->{'@id'} = $this->endpoint;
            $level->{'custom'} = $settings;
            $obj->{'@graph'}[] = $level;
            $body = json_encode($obj);
        } else {
            $body = json_encode($settings);
        }

        $response = parent::send('PUT', null, $body);

        return $response->ok;

    }

}