npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

adapt-contrib-xapi

v1.1.6

Published

An extension to track learner activity via xAPI

Downloads

75

Readme

adapt-contrib-xapi

xAPI is an extension intended for use with the Adapt framework version 3.0 or greater to pass Experience API (xAPI) statements between the Adapt content and a Learning Record Store (LRS), such as Learning Locker®. It is compatible with both the Adapt Framework and the Adapt Authoring Tool.

From this point on, the README assumes a certain level of familiarity with the xAPI and the philosophy behind it. If the xAPI specification is new to you, please start with the documentation at xapi.com before continuing.

Configuration

Some setup is required in order to configure the xAPI extension. If using a standalone Adapt Framework, refer to example.json for a JSON snippet which should be added to your course's config.json. If using the Authoring tool you can configure the following attributes:

|Setting|Default|Help| |--|--|--| |Is Enabled| false | Set to true to enable the extension |Specification | xApi | This must be set |Endpoint| | URL to the LRS endpoint |User (or Key)| | This can be configured in your LRS, or omit if using ADL Launch mechanism |Password (or Secret)| | (as above) |Verb language | en-US| Indicates the language of the verbs which will be passed to the LRS |Auto generate IDs for statements | false | It is recommended this is not enabled, so that the LRS will generate unique identifiers |Track state| false | Lets the LRS manage the course state via the State API |Use registration| false | Uses the registration parameter defined by the launch mechanism for calls to the State API |LRS connection failure behaviour | Show errors | Indicates what should happen when the course cannot connect to the LRS |Component blacklist | blank,graphic | A comma-separated list of components which should not send statements. Set this to an empty string if all components should send a statement.

By default the xAPI extension listens for the following core events. Those without an asterisk (*) can be toggled via configuration:

| Object |Event | |--|--| | Adapt | tracking:complete* | | Adapt | router:page | | Adapt | router:menu | | Adapt | assessments:complete | | Adapt | questionView:recordInteraction | | contentObjects |change:_isComplete | | articles | change:_isComplete | | blocks | change:_isComplete | | components | change:_isComplete |

Statements

In response to the course, the statements based on the following ADL verbs may be sent:

  • launched
  • initialized
  • attempted
  • failed
  • passed
  • completed
  • suspended
  • terminated

In response to activity on navigating via pages and menus:

  • experienced

In response to completion of non-question components, blocks, articles or contentObjects:

  • completed

In response to completion of question components, along with details of the interaction the following verb will be sent:

  • answered

Note that the xAPI extension works well with the core Assessment extension. The Assessment is responsible for defining pass or fail criteria, while the xAPI extension merely reports on it.

Events

The following events are triggered by the xAPI extension:

| Event | Description | Parameter(s) | |--|--|--| |xapi:lrs:initialize:error|Triggered when the plugin fails to initialize| An error object| |xapi:lrs:initialize:success|Triggered when the plugin successfully establishes connectivity with the LRS | - | |xapi:preSendStatement|Triggered just prior to sending a single statement to the LRS | The statement as an object | |xapi:lrs:sendStatement:error | Triggered on an error with sending a statement to the LRS | The error object | |xapi:lrs:sendStatement:success | Triggered when a statement is successfully sent to the LRS | - | |xapi:preSendStatements| Triggered just prior to sending multiple statements ot the LRS | An array of statement objects | |xapi:lrs:sendState:error| Triggered when state cannot be saved to the LRS | The error object | |xapi:lrs:sendState:success| Triggered when state is successfully saved to the LRS | An object representing newState | |xapi:stateLoaded| Triggered when state has been successfully loaded from the LRS | - |

Attachments

Attachments can be added by plugins, by listening for the xapi:preSendStatement event. The statement is passed to the callback and can be augmented with an attachments array, where each item is an object with the following properties:

type (object): The attachment's metadata, which contains values for contentType, usageType, display and description.

contentType (string): The mime type of the attachment e.g. "application/pdf".

usageType (string): A URI (IRI) to describe why the file is being attached.

display (string): A language map giving a readable name for the attachment.

[language] (string): A readable name for the attachment.

description (string): [optional] A language map similar to display but giving a more detailed description of the purpose of the attachment or other information about it.

[language] (string): A readable description for the attachment.

The attachment object must contain either a value or a url property.

value (string): The correctly encoded string value of the attachment

url (string): The url of the file to be attached. adapt-contrib-xapi will handle the string encoding.

Example implementation:

The following example attaches a certificate to the course completion statement

Adapt.on('xapi:preSendStatement', function(statement) {
  // Only handle course completion
  if (statement.object.definition.type !== ADL.activityTypes.course
    || !(statement.verb.id === ADL.verbs.completed.id && statement.result.completion)) {
    return;
  }

  var attachment = {
    type: {
      contentType: 'application/pdf',
      usageType: 'http://id.tincanapi.com/attachment/certificate-of-completion',
      display: {
        'en-US': 'Completion of course: ' + Adapt.course.get('title');
      }
    },
    value: '{{fileContentsAsString}}'
  };

   statement.attachments = [attachment];
});

Version number: 1.0.1 Framework versions: 5.19.1+