Messages, emails and actions

Alternative Files

Resources are intended to be a single entity but sometimes you just need a variation and all the resource data is the same. This is when you need to use Alternative Files. Not to be confused with Related Resources. Rather than using related resources which are identical or even collections, this method allows users to search for something and easily access multiple variations from a single point. An example might be when you have a licensed image in your installation which requires special treatment. You can attach the necessary license to that resource and keep it all together.

It is important that you add information to the alternative files as it helps describe the file to people viewing the resource and they may not know to look at it.

How To Add An Alternative File

  1. Browse to the Resource you wish to add the Alternative File(s) to,
  2. Click "Manage Alternative Files" under Resource Tools,
  3. Under "Add Alternative File" enter a Name for your alternative file and click Create.
  4. Enter Information for your Alternative File and click Save.

How To Add Alternative Files (Batch)

  • Like the main upload page, select the files you wish to upload by clicking "add files" and "start upload" when you are ready.
  • Browse back to the manage alternative files using the navigation at the top.
  • For each file you have uploaded, click edit on the row and specify information.

How to add resource and its alternative files (Batch)

You can upload a resource and all of its alternative files in one go. For this to work, your ResourceSpace system needs to be configured to look for a specific suffix at file names of the files uploaded. An example:

$upload_alternatives_suffix = '-alt';

All your files need to be renamed and match the original file name plus the suffix so that the system can recognise it as an alternative of that resource. For example, if we have a resource file named projectA.ext, all of its alternatives will need to be named projectA-alt.ext.

Note: when uploading, the first file MUST be the resource otherwise the upload will fail for not being able to get a resource ID for which the alternatives to be added for.