Upgrading the Plug-in:The Echo360 Atto plugin can now be installed via the Install Plugins page in Moodle UI. Use the below instructions to upgrade to the newer version. As before, upgrading will overwrite the existing plugin file. BE CERTAIN that you have write permissions on the plugins directory on the Moodle server (/var/www/html/moodle/lib/editor/atto/plugins). Otherwise installation/upgrade will fail.
In addition, if you are upgrading the plug in to at least version 1.0.17, to allow students to embed videos and assignment responses from Echo360, you MUST install the new plugin and the accompanying filter file. This version and higher removes the need to configure the trusted sites or alter the Student role permissions in any way. It also provides authenticated embedded video views, allowing Echo360 to provide unique viewer analytic data for embedded videos.
Echo360 provides an Atto plugin that once installed, generates an Echo360 button in the content editor for easy-access to embedding Echo360 videos. This plugin allows Instructors (and Students if configured) to embed videos from their Echo360 library directly into a Moodle page or content window. Installing the filter that accompanies the plugin allows students to submit Echo360 videos as assignment responses (or more accurately, allows instructors to view those videos within the assignment pages). Student videos submitted as Assignment responses are locked down in Echo360 and cannot be edited or deleted by the student.
Administrators can use the Echo360 embed button to embed any video in the system to which they have access (as visible in the Captures page of Echo360).
LMS-embedded videos provide view data such as view counts and heatmap data, as shown in the Analytics tab of the media details page of the video. Furthermore, as long as the user is logged into the LMS, and you are using version 1.0.17 or higher of the Atto plugin/filter, the views can be attributed to unique viewers and as such are counted as Unique Views in the analytics data provided.
The LMS Configuration information (Key, Secret, and URL) can be the same as they are for the External Tool you may already have configured in Moodle for Echo360.
These procedures must be performed by the Moodle/Echo360 administrator. Please also note that the Moodle instructions below are provided as a guide; please refer to the Moodle documentation for further details if necessary.
To install the Echo360 Atto Plugin and Filter
- Log into Echo360 as an Administrator and navigate to the Downloads page (Settings > Downloads).
- Scroll to the bottom and 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 as shown below. Extract the two zip files contained in the downloaded file to a known location, but leave the enclosed zip files as they are.
- 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.
If you are installing the Echo360 Plugin for the FIRST TIME, there is one more set of configuration procedures necessary. If you are upgrading, these steps should not be necessary, however if the Echo360 embed button does not appear for a content window, review the below steps to see if you need to make a change to the Atto plugin settings.
To complete Echo360 embed plugin and filter installation in Moodle
- In Moodle, navigate to Site Administration > Plugins.
- Scroll down to the Text editors section and click on the Text editors link.
- In the Text editors list, make sure the Atto plugin is at the top. If it is not, use the up-arrow next to it to move it to the top.
If you must change the order of the editors shown, you will be taken into the Manage Editors page; you will need to click Text Editors from the breadcrumbs links at the top to return to the Text Editors page and continue as described below.
- Below the Text Editors list, click Category: Atto HTML editor.
- Scroll down the list of plugins to find the Echo360 plugin, shown in the below figure, then select and copy the plugin name (Ctrl+c or Command+c).
- Scroll farther down the page to the Toolbar config section, then scroll to the bottom of the config list to find Other.
- Paste the Echo360 plugin name (Ctrl+v or Command+v) into the Other value in the Toolbar config list (adding it to whatever is already there). Alternately you can type in the name of the plugin which should be echo360attoplugin.
- Scroll down farther on the page to the Collapse toolbar settings section, and increase the Show first (n) groups when collapsed value to ensure the Echo360 button will appear by default for all users. The below figure shows this value set to 20, which is the maximum.
- Scroll to the bottom of the page and click Save changes.
The Content window toolbar should now provide the Echo360 button for embedding videos. Instructors and Students can embed any videos they own (appear in their library). Administrators can embed any video they have access to in the system. Remember that the Public Links for instructors in Echo360 toggle must be enabled for the institution in order for Instructors to embed links to their videos.