Restoring file aliases

From MoodleDocs

Course and activity backup files can contain an alias or shortcut, as described in the section 'Creating an alias/shortcut' in Working with files. The referenced file can be an external file (such as a file stored in Dropbox) or a file stored in Moodle (such as a file in another activity or course or in a 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:

  • Is the restore happening on the same site that 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 it's just not possible to restore aliases and so they 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, in other words in all the following situations: