EQUELLA repository
The EQUELLA repository enables users to make aliases (shortcuts) to EQUELLA files. Updating the files in EQUELLA will automatically cause them to update in Moodle. In addition to being able to search the EQUELLA repository, users also have the option to manage their repository and add new files.
Requirements
EQUELLA 5.2 QA2 or higher is required for this repository plug-in to work correctly.
Setup
Warning: This page may be outdated. Please see https://equella.github.io/guides/MoodleIntegrationGuide.html
EQUELLA configuration
A shared secret must be configured in EQUELLA that Moodle will use to authenticate access for users.
- Log in to your EQUELLA site as admin. Your URL might be for instance http:// equella.myequellainstitution.edu
- Select 'Settings' and then 'Administration Console' (1 below) NOTE: You will need up to date Java for this to display.
- Select User Management. Highlight 'Shared Secret' and click 'Configure' at the bottom of the screen (2 below)
- A new name 'Default' will appear with configuration elements to the right (3 below)
- Add a name for the Unique identifier and a shared secret. Any secret will do, but a longer one with a mix of letters and numbers is best.
- Make a note of it to use when configuring Moodle. Add any extra details and save.
For further information, please consult the EQUELLA Moodle Configuration Guide.
Moodle configuration
The EQUELLA repository may be enabled by a site administrator in Administration > Site administration > Plugins > Repositories > Manage repositories. From there, an EQUELLA repository instance can be created.
EQUELLA URL | The URL to your EQUELLA install with "/signon.do" appended. For example, "http:// equella.myinstitution.edu/logon.do" would become "http:// equella.myinstitution.edu/signon.do" |
EQUELLA options | This is an optional advanced setting that can be used to restrict users to a limited set of collections or advanced searches. |
Restrict selection | Choose if users should be restricted to only choosing attached resources, summary pages or no restriction. |
Default role settings | The shared secret ID and shared secret entered here should match those that have been setup in EQUELLA |
{X} role settings | Shared secrets configured under a specific role will take precedence over the default shared secret if a user has that role. The security ACLs in EQUELLA can then be configured to grant or revoke access to additional functionality based on the shared secret that the user was authenticated with. |
Capabilities
There is just one capability, View EQUELLA repository, which is allowed for the default authenticated user role.