Who can do this?
This can be done by a Moodle Administrator who is also an Echo360 Administrator. The Moodle Administrator MUST have write permissions on the plugins directory on the Moodle server (/var/www/html/moodle/lib/editor/atto/plugins). Otherwise upgrade will fail.
Upgrading your Echo360 atto plugin for Moodle involves downloading the new plugin and filter from Echo360, then installing them via the Plugins page in Moodle. You must upgrade the plugin FIRST then upgrade the filter. Due to dependencies between the two, trying to upgrade the filter first will result in an error.
The newest version of the plugin contains updated functionality, including authentication for all users viewing embedded media, which allows Echo360 to provide detailed viewing data and unique viewer statistics for embedded media. It also provides the ability to embed interactive media (videos with embedded polling questions) into Moodle courses. As of this publishing, the newest version is 1.0.25.
Note please that these instructions are provided as a guide, and your Moodle interface may vary depending on the version you are using. Refer to the Moodle documentation for additional assistance if necessary.
As noted above, BE CERTAIN that you have write permissions on the plugins directory on the Moodle server (/var/www/html/moodle/lib/editor/atto/plugins). Otherwise upgrade will fail.
To upgrade the Echo360 atto plugin and filter
- Log into Echo360 as an Administrator and navigate to the Downloads page (Settings > Downloads).
- Scroll down to the Moodle plugin entry, then click the Download link for the Moodle Plugin, and save the .zip file to your local drive.
The Downloaded zip file contains two zip files within it; one for the plugin and one for the filter. These are shown in the below figure.
- EXTRACT the contents of the downloaded .zip file, and SAVE the two enclosed .zip files to a known location. Leave the extracted .zip files as they are. DO NOT extract the files from these sub-zip files. Moodle will do that for you.
- Log into Moodle as an Admin and click Site Administration.
- Navigate to Plugins and select Install Plugins.
- Click Choose a file and find the echo360attoplugin-###.zip file extracted from the download.
You MUST install the atto plugin before installing the filter.
- When the zip file has been uploaded, click Install plugin from the ZIP file.
- Verify that the validation step shows no errors, and click Continue.
If the installation fails, check any errors listed in the Validation log shown; you MUST have write permissions on the Plugins directory on the Moodle server. If the error indicates that you do not have these permissions, contact your System Administrator or another Moodle Administrator to obtain these permissions.
- On the Plugins check page, click Upgrade Moodle database now.
- REPEAT the above installation steps but instead select the filter_echo360-###.zip file.
The most common cause of failure to install the filter is due to a dependency the filter has on the atto plugin; you MUST install/upgrade the echo360attoplugin BEFORE trying to install or upgrade the filter.
- In the Plugins check page for the Filter, click Upgrade Moodle database now.
- When the success message appears, click Continue.
- Navigate to Site Administration > Plugins > Filters > Manage filters.
- Find the Echo360 LTI Launch Filter and ensure that it is turned ON and that it is set to apply to Content, as shown below.
IMPORTANT: You MAY need to increase the priority of the Echo360 filter in the list in order to embed videos in Moodle Labels.
- If you are not prompted for LTI settings during the installation process, navigate to Site Administration > Plugins and scroll down to Text Editors and click on the Echo360 Plugin (Atto) Settings link. In the below figure, the breadcrumbs are highlighted to help you navigate to the appropriate page.
- Open a new tab or browser window, and log into Echo360 as an Administrator.
- Select the Settings icon in the upper-right of the screen, then select Configurations.
The LMS Configurations page appears by default.
- Find your existing Moodle LMS configuration.
- Copy the Consumer Key, Shared Secret, and Host URL values from Echo360 into the Echo360 Atto plugin settings in Moodle.
TIP: In Echo360, select some of each field then use Ctrl+A/Command+A to "select all" of the field, then Ctrl+C/Command+C to be sure to copy the whole field. In Moodle, place your cursor in the field and press Ctrl+V/Command+V to paste the value.
- Click Save changes.
Your Echo360 plugin is now upgraded and provides all the available functionality, including authenticating all users for viewing embedding media, providing access to interactive media for embedding, and tracking viewing analytics for all embeds.