Chat with us, powered by LiveChat Skip to main content
Echo360 Status: 

EchoVideo: Upgrading the EchoVideo Atto Plugin in Moodle for Embedding Media

Echo360
  • Updated

Who can do this?
This can be done by a Moodle Administrator who is also an EchoVideo 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, the upgrade will fail.

For instructions on installing and configuring the Atto plugin for newer versions of Moodle, see EchoVideo: Moodle TinyMCE Plug-in.

Upgrading your EchoVideo atto plugin for Moodle involves downloading the new plugin and filter from EchoVideo, 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 EchoVideo 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.30.

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, the upgrade will fail.

To upgrade the EchoVideo atto plugin and filter

  1. Log into EchoVideo as an Administrator and navigate to the Downloads page (Settings > Downloads).
    Admin Settings menu expanded with Downloads identified as described
  2. 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.
    Moodle Atto Plugin download identified as described

    The Downloaded .zip file contains two .zip files; one for the plugin and one for the filter. These are shown in the below figure.

  3. 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.
    Downloaded Moodle zip file with two enclosed zip files shown as described
  4. Log into Moodle as an Admin and click Site Administration.
  5. Navigate to Plugins and select Install Plugins.
    Moodle plugins installation page with options for steps as described
  6. Click Choose a file and find the echo360attoplugin-###.zip file extracted from the download.

    You MUST install the atto plugin before installing the filter.

  7. When the .zip file has been uploaded, click Install plugin from the ZIP file.
  8. 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.

  9. On the Plugins check page, click Upgrade Moodle database now.
    Plugins check page after plugin upgrade for updating moodle database as described
  10. 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.

  11. In the Plugins check page for the Filter, click Upgrade Moodle database now.
    Moodle plugins check page for filter installation with upgrade database button as described
  12. When the success message appears, click Continue.
  13. Navigate to Site Administration > Plugins > Filters > Manage filters.
  14. Find the EchoVideo LTI Launch Filter and ensure that it is turned ON and that it is set to apply to Content, as shown below.

    You MAY need to increase the priority of the EchoVideo filter in the list in order to embed videos in Moodle Labels.

    Moodle manage filters page with Echo360 LTI filter and settings identified
  15. If you are not prompted for LTI settings during the installation process, navigate to Site Administration > Plugins. 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.
    Settings page for the Echo360 plugin with LMS configuration value fields as described
  16. Open a new tab or browser window, and log into EchoVideo as an Administrator.
  17. Select the Settings icon in the upper-right of the screen, then select Institution Settings > Integration > LMS/VLE.

    The LTI 1.1 Configurations page appears by default.


    Setting menu expanded with Institution Settings selected to Integration to LMS/VLE and LTI 1.1 displayed
  18. Find your existing Moodle LMS configuration.
  19. Copy the Consumer Key, Shared Secret, and Host URL values from EchoVideo into the Echo360 Atto plugin settings in Moodle.

    In EchoVideo, use the copy button to select the whole field. In Moodle, place your cursor in the field and press Ctrl + V / Command + V to paste the value.

  20. Click Save changes.

Your EchoVideo 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.

Related to