Looking for up-to-date Help documentation? Documentation for the latest releases of Totara is now available at totara.help!

Visit the new Help site

All pages

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space TL25PMS and version 2.9

The following admin tools can be managed by a Site Administrator in Site administration > Plugins > Admin tools > Manage admin tools.


Acceptance testing

This is used to automatically test Totara Learn functions using the Behat a Behat tool. Behat is a behavioural driven development (BDD) tool written in PHP, it can parse a human-readable list of sentences (called steps) and execute actions in a browser using Selenium or other tools to simulate user interactions.


Add-on installer

This lets you install third party addons from ZIP files or from Totara Learn site. 

Totara Learn does not provide support for third party plugins.

Assignment upgrade helper

A Site Administrator tool for upgrading assignments in Totara Learn 2.2 and older to the new assignment module in Totara Learn 2.4 onward.


Availability condition management

Availability conditions allow trainers to restrict an activity or section so that only certain users can access it. 


Capability overview

A Site Administrator can generate a capability overview report in Site administration > Users > Permissions > Capability reportThe report allows the administrator to select a capability and one or more roles. The report will show the role and its permission level for that capability.


Check user timezones

This tool checks the timezones specified in the profiles of your users. In order for timezones to work correctly a location-based timezone should be specified, e.g. America/New_York, Europe/London, Asia/Singapore. Some timezone abbreviations (e.g. CET, EST) and UTC offsets (e.g +/-4.5) will not calculate daylight savings changes correctly. This tool will allow you to change unsupported timezones to an approved format.


Convert to InnoDB

This only applies to Site Administrators using Totara Learn with a MySQL database as it's about migrating the MySQL storage engine


Course upload

A Site Administrator can upload multiple courses via text file in Administration > Site administration > Courses > Upload courses. In addition to creating new courses, this functionality may also be used to update or delete courses, or import content from another course. For information on using this functionality to create course templates, see Uploading multiple courses.


Database transfer

The database transfer tool enables an administrator to migrate their Totara Learn site from one database to another, for example from MySQL to Postgres. The tool is currently classed as an experimental feature and may be found in Site administration > Development > Experimental > Database migration. There is also a command line script in admin/tool/dbtransfer/cli/migrate.php.


DB search and replace

Admins can search and replace text. For example, URLs in their Totara Learn database using the search and replace tool at http://yourtotarasite.org/admin/tool/replace/index.php (replacing yourtotara.org with the address of your Totara site). This is useful when a Totara site is moved from one server to another. 

A database backup is highly recommended before running the search and replace.

Development data generator

 Populates test site with data to help test Totara Learn functions.


Event monitor

Allows Site Administrators and Trainers to receive notification when certain events happen. To do this, a rule needs to be created for the event to be monitored and then a user, such as the Site Administrator or Trainer need to subscribe to it to be notified.


File types

Allows file types to be defined so it is recognised by Totara Learn.


Health center

The health center is a tool for detecting miscellaneous problems on your site. It may be accessed by browsing to the URL yourtotarasite.com/admin/tool/health/

The health center tool is no longer maintained, and may give misleading results.

HR import

Used to import data from external system into Totara user, position, and organisation hierarchies.


Inbound message configuration

If incoming mail processing is enabled, users are able to reply to forum posts via email and send files to their private files as email attachments. 


Language customisation

Words or phrases (in any language) used on the site may be easily changed by an administrator using the language customisation feature.


Language packs

Language packs are available for an administrator to install on your Totara Learn site via Administration > Site administration > Language > Language packsSimply select the languages you require from the list of available language packs and click on the Install selected language pack button.


Log store manager 

When you view a course, complete a quiz, or grade a learner a log of that activity is recorded in the logstore. See the Logging page for more information.

It is highly recommended that you use HTTPS for secure transfer of information when using logstore.

Multilang upgrade

Used to add multilang content uses HTML tags.


PHPUnit tests

PHPUnit by Sebastian Bergmann is an advanced unit testing framework for PHP. It is installed as Composer dependency and is not part of Totara Learn installation. 

To run PHPUnit tests, you have to manually install it on your development computer or test server. Read the excellent guide at PHPUnit Manual.

Profiling runs

PHP has two significant profilers: XDebug and xhprofXDebug is well known and understood and its trace output is supported by tools like KCachegrindXhprof is a profiler released by Facebook's engineering team, designed for capturing profile traces on live servers.


Question engine upgrade helper

The question engine upgrade helper is an admin tool for sites which have been upgraded from a pre-Totara Learn 2.2 version. Totara Learn 2.2 onward uses a new question engine. A Site Administrator can run the question engine upgrade helper in Site administration > question engine upgrade helper

You can reset any quiz that has been converted and then re-do it, but you should only do that if you have a good reason to do so and you don't have to.

Scheduled task configuration

A Site Administrator can schedule routine tasks very precisely from Administration > Site administration > Server > Scheduled tasks. Site Administrators can specify the minute/hour/day/month or day of the week the task is to be run. It is also possible to reset the task to its default setting or disable it completely.


Spam cleaner

Use the spam cleaner report in Administration> Site administration > Reports > Spam cleaner to locate user accounts responsible for spam and other nasty stuff and help you delete them. In addition to user profile descriptions, comments, blog posts, and messages are also searched for keywords.


Template library

The template library is a tool designed to help theme designers and developers build themes as well as easily customisable plugins.


Timezones updater

The update timezones page provides Site Administrators with the option to update their local database with new information about world timezones. This is important because of daylight saving changes that many countries use. If the update is completed with success, Totara will inform you how many entries were updated and which location was used as a source. The timezones updater can be found at Administration > Site administration > Location > Update timezones.


Unsupported role assignments

Unsupported role assignments are role assignments in contexts that make no sense for that role, such as the course creator role in the course or activity context, or the trainer role in the user context.


User upload

A Site Administrator can upload multiple user accounts via text file in Administration > Site administration > Users > Accounts > Upload users. There are many robust options for uploading information (fields associated with a user) with this method; from enrolling users in multiple courses with course specific roles, to updating user information in the User profile to deleting users from the site. 

Totara Sync can be used to replace user upload as most user information can be uploaded and audiences can be used to enrol users in courses.

XMLDB editor

The XMLDB editor is a tool for making the .xml files that specify how Totara Learn should set up its database tables. Previously, developers had to make separate .sql install files for mysql and postgres, but now only database-neutral file is needed, which supports many more databases. 

To be able to handle files properly, the web server needs write access to all db directories where the install.xml files reside (and to the files themselves, of course). If you cannot click either the load or create link, that means that you either have not created the /db directory, or that it is not writable by the webserver.
titleOn this page

Table of Contents