You're looking at an older version of Totara Learn.

Please see Totara 13 help for the latest version.

All pages




Search

Repositories enable users to access and upload files from their computers or external repositories, such as Flickr, Dropbox, or Google Drive. Enabled repositories are available in the file picker.


(The video above is taken from the Totara Academy course Plugins and Advanced features).

Enabling repositories

Before they can be used repositories must be enabled by a Site Administrator. 

  1. Go to Site Administration > Plugins > Repositories > Manage repositories.
  2. Alongside the repository you want to enable from the dropdown menu in the Active column select either:
    • Enabled and visible: The repository is available and can be used via the file picker by any user. 
    • Enabled but hidden: The repository is available but users cannot see it in the file picker. 
  3. Click Settings alongside the repository you just enabled. 
  4. Complete any required settings, including adding IDs and secrets/passwords for external repositories. 
  5. Click Save

If you are enabling an external repository you can see more guidance in the additional repositories section.


Standard repositories

Repositories enabled by default include:

RepositoryDescription
Embedded filesGives access to files previously embedded using the text editor. 
Server filesThis gives access to files elsewhere on Totara according to your permissions.
Recent filesThe last files you have uploaded, according to the context. The recent files repository will only show file types appropriate to context of where you are accessing the repository, e.g. it will only show the most recent compatible file types for a particular resource/activity type. See Recent files for details on configurable settings.
Upload a fileYou use this for browsing for and uploading a file from your computer or USB. 
Private filesYour own personal storage area for files. 

Additional repositories 

Additional repositories may be enabled by a Site Administrator. These include:

RepositoryDescription
Google DriveBring in files from your Google Drive account. 
YouTube videosSearch for and display YouTube videos.
FlickrSearch for and display images from your personal Flickr account.
Flickr publicSearch for and display images from Flickr.
Picasa web albumSearch for and display images from your Picasa account. (Picasa has now been retired by Google). 
EQUELLA repositoryBring in files from an EQUELLA repository
URL downloaderDownload files, images from a particular URL.
WikimediaSearch for and display media from Wikimedia.
Amazon S3Link to or copy files from Amazon Simple Storage Service (S3) account.
BoxBring in files from your Box account. 
DropboxBring in files from your Dropbox account. 
File systemAccess files uploaded to a folder on your server (by, eg FTP).
Legacy course fileUse the old system from 1.1 of course files. 
Merlot.orgBring resources in from Merlot.org.
WebDAV repositoryBring in files using webdav.
Open SesameBring in files from Open Sesame.
Microsoft OneDrive
Bring in files from your Microsoft OneDrive account. 

The One Drive repository doesn't work with Office 365 business account as this requires OAuth2 which is only available is Totara Learn 12.6+.

Settings

Each repository type has configurable settings associated with it. These include both settings frequently found across repositories and unique settings only found for certain types. 

To configure the settings for a repository follow these steps:

  1. Go to Site administration > Plugins > Repositories > Manage repositories.
  2. Click the Settings link alongside the repository type you wish to configure. 
  3. Complete any available settings (see below for more details on frequent settings and specific repositories).
  4. Click Save

Frequent settings 

SettingDescriptionNotes
Repository plugin nameYou can give the repository a different name if you prefer or leave it blank to use the default name. All repository types.
Client IDWith an external repository it is likely you will require a client ID which is obtained from that service's developer portal when you set up Totara there. Many external repository types.
Client secretWith an external repository it is likely you will require a client secret (or password) which is obtained from that service's developer portal when you set up Totara there. Many external repository types.
KeyRather than an ID and secret sometimes an external repository will require a key (this could be an API key or a license key). The key can normally be obtained from the external services developer portal. Many external repository types e.g. Merlot, Flickr public, YouTube. 

Recent files 

SettingDescriptionNotes
Repository plugin nameYou can give the repository a different name if you prefer or leave it blank to use the default name. -
Number of recent filesSet the number of recent files you want to display. By default this is 50 files.-

Dropbox

SettingDescriptionNotes
Dropbox API key

You can get your API Key from the Dropbox developers portal. When setting up your key please select Full Dropbox as the Access level.

-
Dropbox secretYou can get your secret from the Dropbox developers portal whilst setting up your API key.-
OAuth 2 redirect URIThis is preset and will be something like https://yoursitename.com/admin/oauth2callback.php-
Cache limitEnter the maximum size of files (in bytes) to be cached on server for Dropbox aliases/shortcuts. Cached files will be served when the source is no longer available. Empty value or zero mean caching of all files regardless of size.-

EQUELLA

SettingDescriptionNotes
Allows you to add an EQUELLA repository on a course. See the EQUELLA page for set-up instructions. 
Allows you to add an EQUELLA repository to a specific user. See the EQUELLA page for set-up instructions. 

File system

There is a lot of setup required to use the file system repository. Please see the file system Help pages for more information. 

SettingDescriptionNotes
Allow admins to add a file system repository instance to a course (configurable only by admins)Allows a Site Administrator to add a File system repository to a course.-
Allows a Site Administrator to add a File system repository to a user.-

Amazon S3

SettingDescriptionNotes
You can give the repository a different name if you prefer or leave it blank to use the default name. -
Enter the access key obtained from the Amazon S3 developer portal. -
Enter the secret key obtained from the Amazon S3 developer portal. -
Configure the endpoint URL. -

Amazon S3 settings

WebDAV

SettingDescriptionNotes
Allows you to add a WebDAV repository to a course. -
Allows you to add a WebDAV repository to a specific user. -

Common repository settings

As a Site Administrator you can configure some site-wide settings for repositories. These are different from frequent settings, which are settings that are found across a number of repository types. 

To configure the common settings follow these steps:

  1. Go to Site administration > Plugins > Repositories > Manage repositories.
  2. Configure the available settings.
  3. Click Save changes when you are done. 

SettingDescriptionNotes
Cache expire

The amount of time that file listings are cached locally (in seconds) when browsing external repositories.

-
Get file timeoutTimeout in seconds for downloading an external file into Totara.-
Sync file timeoutTimeout in seconds for syncronising the external file size.-
Sync image timeoutTimeout in seconds for downloading an image file from external repository during syncronisation.-
Allow external links

This option enables all users to choose whether or not external media is copied into Totara or not. If this is off then media is always copied into Totara (this is usually best for overall data integrity and security). If this is on then users can choose each time they add media to a text.

-
Legacy course files in new courses

By default, legacy course files areas are available in upgraded courses only. Please note that some features such as activity backup and restore are not compatible with this setting.

-
Allow adding to legacy course files

If a course has legacy course files, allow new files and folders to be added to it.

-

Google OAuth

If you wish to integrate Google services (such as Google Drive and Picasa) as repositories (or portfolios) then the first thing you will need to do is register with Google and set up your Google API Console Project.

You will then need to enable the desired API, for example to use Google Drive as a repository you need to enabled the Google Drive API in the Google API Console.

Configuring repositories

Once you have set up your Google API you will need to follow these steps:

  1. From the Administration block go to Site administration > Plugins > Repositories > Manage repositories.
  2. Enable the Google service you want (e.g. Google Drive).
  3. This will then prompt you to enter the Client ID and Secret which you will be able to get from your Google API Console. If you're not automatically prompted for the extra details then you can click the Settings link.
  4. Click Save when you are done. 

You can follow the same steps for portfolios, but go to Site administration > Plugins > Portfolios > Manage portfolios instead.

On this page

The Totara Academy has a whole course dedicated to using Plugins and Advanced Features in Totara Learn. Here you can learn more on how to use Plugins and Advanced Features, see best practice, and give it a go yourself.

Provide feedback about this page using the link in the bottom right of this page. 

Still have questions? Why not post them in the forums of the Totara Community?