Admin tools: Ally

tool_ally
Maintained by Picture of Moodlerooms Development Moodlerooms Development, Picture of Nicolaas Matthijs Nicolaas Matthijs, Picture of Guy Thomas Guy Thomas
Ally webservices plugin
14 sites
162 downloads

Ally admin tool


The Ally admin tool (tool_ally) provides a web service facilitating communication between Moodle and Ally. It also
contains all the main settings required for Ally to function. Ally is an accessibility tool providing analysis / remedy
of accessibility issues for files hosted within moodle. It can provide a detailed course level report illustrating the
level of accessibility for files throughtout the course.

Installation


You can download the admin tool plugin from:

https://github.com/moodlerooms/moodle-tool_ally

This plugin should be located and named as:
[yourmoodledir]/admin/tool/ally

Configuring the Ally admin tool


Open the settings for the Ally admin tool:

Site Administration > Plugins > Admin Tools > Ally

The Secret, Key, Launch URL, File updates URL and Client id fields should be populated with values provided to you by an Ally representative. You can contact an Ally representative online via the Ally  webpage https://www.blackboard.com/accessibility/blackboard-ally.aspx.

You will also need to make the Moodle Ally web service available to Ally. The easiest way to do this is to click the
link entitled "Auto configure Ally web service" at the bottom of the settings page and then by clicking continue. You
will be able to test that the Ally web service is working by following the link at the bottom of the page. Please note,
this URL must be accessible from the internet for Ally to function. Following this link should open a new page starting
with the following text:
{"tool_ally":{"version":...
If successful, you will need to copy this link and provide it to your Ally representative. They will contact you once
everything is set up at their end.

Additional plugins


The Ally admin tool isn't useful on its own. The main functionality of Ally is provided by two other plugins which you
should download and install:

Ally filter

The Ally filter can be downloaded from:

https://github.com/moodlerooms/moodle-filter_ally

The filter should be located and named as:
[yourmoodledir]/filter/ally

Ally accessibility report

The Ally accessibility report can be downloaded from:

https://github.com/moodlerooms/moodle-report_allylti

The report should be located and named as:
[yourmoodledir]/report/allylti

License for Ally admin tool


© Blackboard Inc 2017

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see <http://www.gnu.org/licenses/>;.

Screenshots

Screenshot #0

Contributors

Picture of Moodlerooms Development
Moodlerooms Development (Lead maintainer)
Picture of Nicolaas Matthijs
Nicolaas Matthijs
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Picture of Plugins bot
    Sat, 7 Oct 2017, 1:30 AM
    Approval issue created: CONTRIB-7074
  • Picture of David Mudrák
    Tue, 10 Oct 2017, 2:47 AM

    Thanks for sharing the plugin (and the two others) with the Moodle community. Please find some early feedback and comments in the tracker.

  • Picture of Krisha Moeller
    Wed, 29 Nov 2017, 7:00 AM
    Hello! I'm having a bit of trouble installing this. I keep getting the following error message:

    Downloading tool_ally ... OK
    Validating tool_ally ... Error
    [Error] Extracted file not found [{"file":"ally\/webservice\/"}]
    Installation aborted due to validation failure

    What am I doing wrong?

    Thank you for your help!
  • Picture of Guy Thomas
    Wed, 29 Nov 2017, 11:49 PM
    Hi Krisha. I've tested to make sure that it is possible to install the admin plugin via the following steps and it works fine for me.

    1) Download the zip file from https://github.com/moodlerooms/moodle-tool_ally/archive/master.zip

    2) Open site administration > plugins > install plugins

    3) Click 'choose file'

    4) Select the zip file downloaded in step 1

    5) Click 'Install the plugin from the zip file'

    6) You should get a "Validation successful, installation can continue" message on the next page - click 'continue'

    7) You should be redirected to the upgrade settings page. Click 'upgrade'

    That's it!

    Note - these steps will only work if your web server has the rights to write into the Moodle admin/tool folder.
Please login to post comments