[ Index ]

PHP Cross Reference of moodle-2.8

title

Body

[close]

/mod/lti/ -> locallib.php (summary)

This file contains the library of functions and constants for the lti module

Author: Marc Alier
Author: Jordi Piguillem
Author: Nikolas Galanis
Author: Chris Scribner
Copyright: 2009 Marc Alier, Jordi Piguillem, Nikolas Galanis
Copyright: 2009 Universitat Politecnica de Catalunya http://www.upc.edu
License: http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
File Size: 2018 lines (67 kb)
Included or required:0 times
Referenced: 10 times
Includes or requires: 0 files

Defines 60 functions

  lti_view()
  lti_register()
  lti_build_sourcedid()
  lti_build_request()
  lti_build_request_lti2()
  lti_build_standard_request()
  lti_build_custom_parameters()
  lti_get_tool_table()
  lti_get_tool_proxy_table()
  lti_split_custom_parameters()
  lti_get_custom_parameters()
  lti_parse_custom_parameter()
  lti_map_keyname()
  lti_get_ims_role()
  lti_get_type_config()
  lti_get_tools_by_url()
  lti_get_tools_by_domain()
  lti_filter_get_types()
  lti_filter_tool_types()
  lti_get_types_for_add_instance()
  lti_get_domain_from_url()
  lti_get_tool_by_url_match()
  lti_get_url_thumbprint()
  lti_get_best_tool_by_url()
  lti_get_shared_secrets_by_key()
  lti_delete_type()
  lti_set_state_for_type()
  lti_get_config()
  lti_get_type_config_from_instance()
  lti_get_type_type_config()
  lti_prepare_type_for_save()
  lti_update_type()
  lti_add_type()
  lti_filter_tool_proxy_types()
  lti_get_tool_proxy_from_guid()
  lti_get_tool_proxy()
  lti_get_tool_proxy_config()
  lti_add_tool_proxy()
  lti_update_tool_proxy()
  lti_delete_tool_proxy()
  lti_add_config()
  lti_update_config()
  lti_get_tool_settings()
  lti_set_tool_settings()
  lti_sign_parameters()
  lti_post_launch_html()
  lti_get_type()
  lti_get_launch_container()
  lti_request_is_using_ssl()
  lti_ensure_url_is_https()
  lti_should_log_request()
  lti_log_request()
  lti_get_type_config_by_instance()
  lti_force_type_config_settings()
  lti_get_capabilities()
  lti_get_services()
  lti_get_service_by_name()
  lti_get_service_by_resource_id()
  lti_get_contexts()
  lti_get_fqid()

Functions
Functions that are not part of a class:

lti_view($instance)   X-Ref
Prints a Basic LTI activity

$param int $basicltiid       Basic LTI activity id

lti_register($toolproxy)   X-Ref
Prepares an LTI registration request message

$param object $instance       Tool Proxy instance object

lti_build_sourcedid($instanceid, $userid, $servicesalt, $typeid = null, $launchid = null)   X-Ref
Build source ID

param: int $instanceid
param: int $userid
param: string $servicesalt
param: null|int $typeid
param: null|int $launchid
return: stdClass

lti_build_request($instance, $typeconfig, $course, $typeid = null, $islti2 = false)   X-Ref
This function builds the request that must be sent to the tool producer

param: object    $instance       Basic LTI instance object
param: array     $typeconfig     Basic LTI tool configuration
param: object    $course         Course object
param: int|null  $typeid         Basic LTI tool ID
param: boolean   $islti2         True if an LTI 2 tool is being launched
return: array                    Request details

lti_build_request_lti2($tool, $params)   X-Ref
This function builds the request that must be sent to an LTI 2 tool provider

param: object    $tool           Basic LTI tool object
param: array     $params         Custom launch parameters
return: array                    Request details

lti_build_standard_request($instance, $orgid, $islti2)   X-Ref
This function builds the standard parameters for an LTI 1 or 2 request that must be sent to the tool producer

param: object    $instance       Basic LTI instance object
param: string    $orgid          Organisation ID
param: boolean   $islti2         True if an LTI 2 tool is being launched
return: array                    Request details

lti_build_custom_parameters($toolproxy, $tool, $instance, $params, $customstr, $instructorcustomstr, $islti2)   X-Ref
This function builds the custom parameters

param: object    $toolproxy      Tool proxy instance object
param: object    $tool           Tool instance object
param: object    $instance       Tool placement instance object
param: array     $params         LTI launch parameters
param: string    $customstr      Custom parameters defined for tool
param: string    $instructorcustomstr      Custom parameters defined for this placement
param: boolean   $islti2         True if an LTI 2 tool is being launched
return: array                    Custom parameters

lti_get_tool_table($tools, $id)   X-Ref
No description

lti_get_tool_proxy_table($toolproxies, $id)   X-Ref
This function builds the tab for a category of tool proxies

param: object    $toolproxies    Tool proxy instance objects
param: string    $id             Category ID
return: string                   HTML for tab

lti_split_custom_parameters($toolproxy, $tool, $params, $customstr, $islti2 = false)   X-Ref
Splits the custom parameters field to the various parameters

param: object    $toolproxy      Tool proxy instance object
param: object    $tool           Tool instance object
param: array     $params         LTI launch parameters
param: string    $customstr      String containing the parameters
param: boolean   $islti2         True if an LTI 2 tool is being launched
return: Array of custom parameters

lti_get_custom_parameters($toolproxy, $tool, $params, $parameters)   X-Ref
Adds the custom parameters to an array

param: object    $toolproxy      Tool proxy instance object
param: object    $tool           Tool instance object
param: array     $params         LTI launch parameters
param: array     $parameters     Array containing the parameters
return: array    Array of custom parameters

lti_parse_custom_parameter($toolproxy, $tool, $params, $value, $islti2)   X-Ref
Parse a custom parameter to replace any substitution variables

param: object    $toolproxy      Tool proxy instance object
param: object    $tool           Tool instance object
param: array     $params         LTI launch parameters
param: string    $value          Custom parameter value
param: boolean   $islti2         True if an LTI 2 tool is being launched
return: Parsed value of custom parameter

lti_map_keyname($key)   X-Ref
Used for building the names of the different custom parameters

param: string $key   Parameter name
return: string       Processed name

lti_get_ims_role($user, $cmid, $courseid, $islti2)   X-Ref
Gets the IMS role string for the specified user and LTI course module.

param: mixed    $user      User object or user id
param: int      $cmid      The course module id of the LTI activity
param: int      $courseid  The course id of the LTI activity
param: boolean  $islti2    True if an LTI 2 tool is being launched
return: string A role string suitable for passing with an LTI launch

lti_get_type_config($typeid)   X-Ref
Returns configuration details for the tool

param: int $typeid   Basic LTI tool typeid
return: array        Tool Configuration

lti_get_tools_by_url($url, $state, $courseid = null)   X-Ref
No description

lti_get_tools_by_domain($domain, $state = null, $courseid = null)   X-Ref
No description

lti_filter_get_types($course)   X-Ref
Returns all basicLTI tools configured by the administrator


lti_filter_tool_types(array $tools, $state)   X-Ref
Given an array of tools, filter them based on their state

param: array $tools An array of lti_types records
param: int $state One of the LTI_TOOL_STATE_* constants
return: array

lti_get_types_for_add_instance()   X-Ref
No description

lti_get_domain_from_url($url)   X-Ref
No description

lti_get_tool_by_url_match($url, $courseid = null, $state = LTI_TOOL_STATE_CONFIGURED)   X-Ref
No description

lti_get_url_thumbprint($url)   X-Ref
No description

lti_get_best_tool_by_url($url, $tools, $courseid = null)   X-Ref
No description

lti_get_shared_secrets_by_key($key)   X-Ref
No description

lti_delete_type($id)   X-Ref
Delete a Basic LTI configuration

param: int $id   Configuration id

lti_set_state_for_type($id, $state)   X-Ref
No description

lti_get_config($ltiobject)   X-Ref
Transforms a basic LTI object to an array

param: object $ltiobject    Basic LTI object
return: array Basic LTI configuration details

lti_get_type_config_from_instance($id)   X-Ref
Generates some of the tool configuration based on the instance details

param: int $id
return: Instance configuration

lti_get_type_type_config($id)   X-Ref
Generates some of the tool configuration based on the admin configuration details

param: int $id
return: Configuration details

lti_prepare_type_for_save($type, $config)   X-Ref
No description

lti_update_type($type, $config)   X-Ref
No description

lti_add_type($type, $config)   X-Ref
No description

lti_filter_tool_proxy_types(array $toolproxies, $state)   X-Ref
Given an array of tool proxies, filter them based on their state

param: array $toolproxies An array of lti_tool_proxies records
param: int $state One of the LTI_TOOL_PROXY_STATE_* constants
return: array

lti_get_tool_proxy_from_guid($toolproxyguid)   X-Ref
Get the tool proxy instance given its GUID

param: string  $toolproxyguid   Tool proxy GUID value
return: object

lti_get_tool_proxy($id)   X-Ref
Generates some of the tool proxy configuration based on the admin configuration details

param: int $id
return: Tool Proxy details

lti_get_tool_proxy_config($id)   X-Ref
Generates some of the tool proxy configuration based on the admin configuration details

param: int $id
return: Tool Proxy details

lti_add_tool_proxy($config)   X-Ref
Update the database with a tool proxy instance

param: object   $config    Tool proxy definition
return: int  Record id number

lti_update_tool_proxy($toolproxy)   X-Ref
Updates a tool proxy in the database

param: object  $toolproxy   Tool proxy
return: int    Record id number

lti_delete_tool_proxy($id)   X-Ref
Delete a Tool Proxy

param: int $id   Tool Proxy id

lti_add_config($config)   X-Ref
Add a tool configuration in the database

param: object $config   Tool configuration
return: int Record id number

lti_update_config($config)   X-Ref
Updates a tool configuration in the database

param: object  $config   Tool configuration
return: Record id number

lti_get_tool_settings($toolproxyid, $courseid = null, $instanceid = null)   X-Ref
Gets the tool settings

param: int  $toolproxyid   Id of tool proxy record
param: int  $courseid      Id of course (null if system settings)
param: int  $instanceid    Id of course module (null if system or context settings)
return: array  Array settings

lti_set_tool_settings($settings, $toolproxyid, $courseid = null, $instanceid = null)   X-Ref
Sets the tool settings (

param: array  $settings      Array of settings
param: int    $toolproxyid   Id of tool proxy record
param: int    $courseid      Id of course (null if system settings)
param: int    $instanceid    Id of course module (null if system or context settings)

lti_sign_parameters($oldparms, $endpoint, $method, $oauthconsumerkey, $oauthconsumersecret)   X-Ref
Signs the petition to launch the external tool using OAuth

param: $oldparms     Parameters to be passed for signing
param: $endpoint     url of the external tool
param: $method       Method for sending the parameters (e.g. POST)
param: $oauth_consumoer_key          Key
param: $oauth_consumoer_secret       Secret

lti_post_launch_html($newparms, $endpoint, $debug=false)   X-Ref
Posts the launch petition HTML

param: $newparms     Signed parameters
param: $endpoint     URL of the external tool
param: $debug        Debug (true/false)

lti_get_type($typeid)   X-Ref
No description

lti_get_launch_container($lti, $toolconfig)   X-Ref
No description

lti_request_is_using_ssl()   X-Ref
No description

lti_ensure_url_is_https($url)   X-Ref
No description

lti_should_log_request($rawbody)   X-Ref
Determines if we should try to log the request

param: string $rawbody
return: bool

lti_log_request($rawbody)   X-Ref
Logs the request to a file in temp dir

param: string $rawbody

lti_get_type_config_by_instance($instance)   X-Ref
Fetches LTI type configuration for an LTI instance

param: stdClass $instance
return: array Can be empty if no type is found

lti_force_type_config_settings($instance, array $typeconfig)   X-Ref
Enforce type config settings onto the LTI instance

param: stdClass $instance
param: array $typeconfig

lti_get_capabilities()   X-Ref
Initializes an array with the capabilities supported by the LTI module

return: array List of capability names (without a dollar sign prefix)

lti_get_services()   X-Ref
Initializes an array with the services supported by the LTI module

return: array List of services

lti_get_service_by_name($servicename)   X-Ref
Initializes an instance of the named service

param: string $servicename Name of service
return: mod_lti\local\ltiservice\service_base Service

lti_get_service_by_resource_id($services, $resourceid)   X-Ref
Finds a service by id

param: array  $services    Array of services
param: string $resourceid  ID of resource
return: mod_lti\local\ltiservice\service_base Service

lti_get_contexts($json)   X-Ref
Extracts the named contexts from a tool proxy

param: object $json
return: array Contexts

lti_get_fqid($contexts, $id)   X-Ref
Converts an ID to a fully-qualified ID

param: array $contexts
param: string $id
return: string Fully-qualified ID



Generated: Fri Nov 28 20:29:05 2014 Cross-referenced by PHPXref 0.7.1