6.1. Files, images and video

These artefacts are internal Mahara ones to display:

  • links to files that you have uploaded
  • folders that contain files
  • show images
  • embed audio and video files

6.1.1. File(s) to download

Files to download

Select files that viewers of your portfolio can download.

Configure the block Files to download

Configure the File(s) to download block

  1. Block title: Choose a title for your document block.
  2. Files area: Choose from which files area you would like to select a file. If you are not a member of a group and not an admin, you may only see My files. If you have access to files elsewhere, these contexts are shown as well, e.g. Group files, Institution files and Site files.
  3. Upload file: You do not have to go back to your Files area in Content in order to upload a file. You can do so directly from this screen.
  4. Folder path: The breadcrumbs show in which folder you are currently.
  5. You can still edit any component of the file, i.e. its file name, description and tags by clicking on the Edit button.
  6. Choose the file or files you wish to display by clicking on the Select button.
  7. Click the Remove button to not display a specific file in this block anymore.
  8. Click the Save button to accept your changes, or click the Cancel button to leave the block’s content as it is. The Remove button is shown only when you place the block into the page and have not yet added any artefacts.

Note

You cannot re-order files once you have selected them. You would need to remove them and select them again in the correct order.

Warning

When you place group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.

When the block is placed on the portfolio page, the following information is displayed:

  • file name
  • file description
  • size
  • upload date
  • a link to more details
File download details

Details about files that can be downloaded.

When a user clicks on the Details link, he is taken to the details page for that particular file and sees some more metadata. He could also report the file, print the page or add the page to his watchlist.

Metadata for a file

More details about a file that can be downloaded.

Note

If you allowed comments on files, a setting that you can add when you edit a file, users could also leave comments on an artefact file directly and not just on a page.

6.1.2. Folder

Display an entire folder

Select files that viewers of your portfolio can download.

Configure the block Folder

Configure the Folder block

  1. Block title: If you leave the title blank, the title of the folder that you choose to display will be used.
  2. Files area: Choose from which files area you would like to select a file. If you are not a member of a group and not an admin, you may only see My files. If you have access to files elsewhere, these contexts are shown as well, e.g. Group files, Institution files and Site files.
  3. Folder path: The breadcrumbs show in which folder you are currently.
  4. You can edit any component of the folder, i.e. its name, description and tags by clicking on the Edit button.
  5. Choose the folder you wish to display by clicking on the Select button.
  6. Click the Remove button if you wish to revert your choice.
  7. Click the Save button to accept your changes, or click the Cancel button to leave the block’s content as it is. The Remove button is shown only when you place the block into the page and have not yet added any artefacts.

Warning

When you place a folder with group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.

6.1.4. Some HTML

Include HTML code

Display the content of an HTML file in a page.

Configure the block Some HTML

Configure the HTML block

  1. Block title: Choose a title for your block.
  2. Files area: Choose from which files area you would like to select a file. If you are not a member of a group and not an admin, you may only see My files. If you have access to files elsewhere, these contexts are shown as well, e.g. Group files, Institution files and Site files.
  3. Upload file: You do not have to go back to your Files area in Content in order to upload a file. You can do so directly from this screen.
  4. Folder path: The breadcrumbs show in which folder you are currently.
  5. You can still edit any component of the file, i.e. its file name, description and tags by clicking on the Edit button.
  6. Choose the file you wish to display by clicking on the Select button.
  7. Click the Remove button to not display that file in this block anymore.
  8. Click the Save button to accept your changes, or click the Cancel button to leave the block’s content as it is. The Remove button is shown only when you place the block into the page and have not yet added any artefacts.

Note

You can only display a self-contained HTML file in a page, but not an entire site because the links to the files are not retained correctly when you upload files.

Warning

When you place group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.

6.1.5. Image

Display an image in a block

Display a single image in a block.

Configure the image block

Configure the Image block

  1. Block title: Choose a title for your block.
  2. Files area: Choose from which files area you would like to select a file. If you are not a member of a group and not an admin, you may only see My files. If you have access to files elsewhere, these contexts are shown as well, e.g. Group files, Institution files and Site files.
  3. Upload file: You do not have to go back to your Files area in Content in order to upload a file. You can do so directly from this screen.
  4. Folder path: The breadcrumbs show in which folder you are currently.
  5. You can still edit any component of the file, i.e. its file name, description and tags by clicking on the Edit button.
  6. Choose the file you wish to display by clicking on the Select button.
  7. Click the Remove button to not display that file in this block anymore.
  8. If your image has a description you can choose to display it. The description could contain the source of the photo for example.
  9. Choose the width (in pixels) for your photo. If you do not provide a number, the image will be scaled to the width of the block.
  10. Click the Save button to accept your changes, or click the Cancel button to leave the block’s content as it is. The Remove button is shown only when you place the block into the page and have not yet added any artefacts.

Warning

When you place group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.

6.1.6. Embedded media

Embed a video or audio file

Display an embedded video or audio file from your uploaded files. You can display mp3, mp4 and flv files per default.

Note

If you wish to display other file types, the site administrator must allow other media formats. These will not be displayed with the built-in media player but require that you have the correct media player installed to display these videos.

Configure the block Embedded media

Configure the Embedded media block

  1. Block title: Choose a title for your block.
  2. Files area: Choose from which files area you would like to select a file. If you are not a member of a group and not an admin, you may only see My files. If you have access to files elsewhere, these contexts are shown as well, e.g. Group files, Institution files and Site files.
  3. Upload file: You do not have to go back to your Files area in Content in order to upload a file. You can do so directly from this screen.
  4. Folder path: The breadcrumbs show in which folder you are currently.
  5. You can still edit any component of the file, i.e. its file name, description and tags by clicking on the Edit button.
  6. Choose the file you wish to display by clicking on the Select button.
  7. Click the Remove button to not display that file in this block anymore.
  8. Width: Choose the width (in pixels) for your video.
  9. Height: Choose the height (in pixels) for your video.
  10. Click the Save button to accept your changes, or click the Cancel button to leave the block’s content as it is. The Remove button is shown only when you place the block into the page and have not yet added any artefacts.

Note

Only the files that you are allowed to embed are displayed. If you uploaded a mp4 file but it does not show here, you may have to check if it has the correct codec. Only H.264 mp4 files can be embedded.

Warning

When you place group, institution or site files into a page, beware that these files may not be available at some point anymore when the person in charge deletes them.