Restoring file aliases

Since Moodle 2.3, course and activity backup files can contain aliases - i.e. special files that behave as a reference or a link to another file. The referenced file can be an external file (such as one stored at Dropbox) or a file stored in Moodle (such as a file in other activity/course or in some user's Private files area).

During the restore process, Moodle does its best to try and restore the aliases correctly. However, there are many factors involved, most notably:

• Does the restore happens at the same site the backup comes from?
• What repository type was used to create the alias in the original course? In other words, what is the location of the referenced file.
• Is the referenced file an external file?
• Does the backup file contain the referenced file and if so, is that file selected to be restored, too?

In some situations, aliases just can't be restored safely and are skipped.

The following flowchart documents the implemented behaviour.

File aliases restore flowchart

Note that this logic is applied whenever the restore process is executed. Apart from the obvious case of restoring an MBZ file, the backup and restore is also involved in

• importing course data from another course
• duplicating an activity in a course using the x2 icon
• deploying a community course via the Community finder block

See also

• MDL-33430