Home - adaptlearning/adapt-contrib-resources GitHub Wiki

Resources

Resources is an extension bundled with the Adapt framework.

Resources in action

Resources provides a way to present extra materials to the learner that is outside of content flow. Resources takes advantage of the Drawer—a panel that slides out from the right-hand side of the page. It is always accessible to the learner through an icon in the navigation bar. Resources organises links to documents such as PDFs, links to media, and links to other web resources.

Visit the page dedicated to Usage and Tips.

Installation

As one of Adapt's core components, Resources is included with the installation of the Adapt framework and the installation of the Adapt authoring tool.

  • If Resources has been uninstalled from the Adapt framework, it may be reinstalled. With the Adapt CLI installed, run the following from the command line:
    adapt install adapt-contrib-resources

  • If Resources has been uninstalled from the Adapt authoring tool, it may be reinstalled using the Plug-in Manager.

Back to Top

Settings

The attributes listed below are used in course.json to configure Resources, and are properly formatted as JSON in example.json. Visit the Resources wiki for more information about how they appear in the authoring tool.

The relationship between Resources's properties and the way they are presented in the authoring tool’s interface is governed by properties.schema.

Resources (_resources): The Resources object that contains values for title, description, Filter Buttons, Aria Labels, and Resources Items.

title (title): This text is displayed (along with the description) in the Drawer as part of a button that gives access to the resources.

description (description): This text is displayed (along with the title) in the Drawer as part of a button that gives access to the resources.

Filter Buttons (_filterButtons): This attribute group maintains the labels for the four buttons that filter resources by type. It contains values for all, document, media, and link.

all (all): This text appears on the button that returns all Resources Items.

document (document): This text appears on the filter button that returns Resources Items that have document for its Type.

media (media): This text appears on the filter button that returns Resources Items that have media for its Type.

link (link): This text appears on the filter button that returns Resources Items that have link for its Type.

Aria Labels (_filterAria): This attribute group maintains the Aria labels for the four buttons that filter resources by Type. It contains values for All, Document, Media, and Links.

All (allAria): This text is associated with the button that returns all Resources Items and is read by assistive technologies.

Documents (documentAria): This text is associated with the button that returns Resources Items that have document for its Type. The text is read by assistive technologies.

Media (mediaAria): This text is associated with the button that returns Resources Items that have media for its Type. The text is read by assistive technologies.

Links (linkAria): This text is associated with the button that returns Resources Items that have link for its Type. The text is read by assistive technologies.

Resources Items (_resourcesItems): This object stores properties for each resource item. Multiple resource items may be created. Each contains values for Type, Title, Description (optional), and Link.

Type (_type): This text is used to filter resources. If the resource is to be returned in a filtered group, this value must be one of the following: document, media, or link. (Note: There is no file type validation as part of Resources.)

Title (title): This text appears (along with description) as a label on the button that links to the item.

Description (description): This optional text appears (along with title) as a label on the button that links to the item.

Link (_link): This value is the URI that accesses the resource item, e.g., course/en/pdf/diagram.pdf.

Back to Top

Limitations

No known limitations.

⚠️ **GitHub.com Fallback** ⚠️