# 6.1. Files, images and video¶

These artefacts are internal Mahara ones to display:

• folders that contain files
• show images
• embed audio and video files

1. Block title: Choose a title for your files block.

2. Files area: Choose from which files area you would like to select a file:

• My files: You see all the folders and files that you have created.
• Group files: You see all the folders and files that you are allowed to publish.
• Institution files: If you are an institution administrator, you will see institution folders and files.
• Site files: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder public in the Site files.

• Licensor: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
• Original URL: If you are uploading somebody else’s file, provide a link to the original Internet address so that others can go there and view the original file.
4. 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.

5. If the site administrator turned on the image resizing option, you can decide whether you want to have your images resized if they are larger than the specified dimensions. This option is recommended to save space in your portfolio.

6. Folder path: The breadcrumbs show in which folder you are currently.

7. You can still edit any component of the file, i.e. its file name, description and tags by clicking the Edit button.

8. Choose the file or files you wish to display by clicking the Select button.

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.

9. You can also still select files (within folders) that have been submitted in another portfolio page.

10. Click the Remove button to not display a specific file in this block anymore.

11. Retractable: Tick this checkbox if you want to allow users to reduce the block to its heading on a page. The user can click the Retractable icon to just show the heading.

12. Automatically retract: Tick this checkbox if you want to show only the block’s heading when a user views the page. The user can click the Retracted icon to view the entire block.

13. 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 for the first time.

14. You can also click the Close button in the top right-hand corner to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.

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.

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

• file name
• file description
• size
• a link to more details

If you choose to retract your block, you only see the block’s heading and the Retracted icon . When you click on it, you can see the block’s content.

When users click on the Details link, they are taken to the details page for that particular file and see some more metadata.

1. The title of the page in which the artefact appears is linked.
2. The author of the page is displayed and a link to the profile page provided.
3. If the file has been made available within the Folder blocktype, the folder is linked so you can view the other files as well.
4. The name of the file is displayed.
5. The name of the file is displayed again but with a link and a file icon.
7. If the owner of the file allowed comments, you can place feedback directly on the file.
8. You can also report this file if it contains objectionable content by clicking on the Report objectionable material link.
10. You can add the page in which the artefact appears to your watchlist by clicking on the Add page to watchlist link.
11. View the number of comments left on this artefact.

## 6.1.2. Folder¶

Select a folder to display all files within it as links on your page.

1. Block title: If you do not set a title, the name 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 folder:

• My files: You see all the folders and files that you have created.
• Group files: You see all the folders and files that you are allowed to publish.
• Institution files: If you are an institution administrator, you will see institution folders and files.
• Site files: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder public in the 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. You can also still select folders that have been submitted in another portfolio page.

7. Click the Download folder content as zip file link in order to get a zip file which contains all files and folders of the current folder.

Site administrators decide in the Artefact type: File settings for how long the zip file is kept on the server.

8. Click the Remove button if you wish to revert your choice.

9. Sort order of files: Decide on the sort order of files in the block when they are displayed on the page. You can choose between:

• Ascending
• Descending

Site administrators decide on the default sort order of content within folder in the Blocktype: File / folder settings.

11. Retractable: Tick this checkbox if you want to allow users to reduce the block to its heading on a page. The user can click the Retractable icon to just show the heading.

12. Automatically retract: Tick this checkbox if you want to show only the block’s heading when a user views the page. The user can click the Retracted icon to view the entire block.

13. 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 for the first time.

14. You can also click the Close button in the top right-hand corner to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.

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¶

Display the content of an HTML file in a page.

1. Block title: Choose a title for your block.

2. Files area: Choose from which files area you would like to select an HTML file:

• My files: You see all the folders and files that you have created.
• Group files: You see all the folders and files that you are allowed to publish.
• Institution files: If you are an institution administrator, you will see institution folders and files.
• Site files: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder public in the Site files.

• Licensor: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
• Original URL: If you are uploading somebody else’s file, provide a link to the original Internet address so that others can go there and view the original file.
4. 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.

5. Folder path: The breadcrumbs show in which folder you are currently.

6. Click the Edit button to change any component of a folder or file, i.e. its name, description and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit them.

7. Click the Select button to choose the HTML file you wish to display in the block.

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.

8. You can also still select files that have been submitted in another portfolio page if they are HTML files.

9. Retractable: Tick this checkbox if you want to allow users to reduce the block to its heading on a page. The user can click the Retractable icon to just show the heading.

10. Automatically retract: Tick this checkbox if you want to show only the block’s heading when a user views the page. The user can click the Retracted icon to view the entire block.

11. Click the Remove button if you want to revert your selection.

12. 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 for the first time.

13. You can also click the Close button in the top right-hand corner to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.

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.

## 6.1.5. Image¶

Display a single image in a block.

1. Block title: Choose a title for your block.

2. Files area: Choose from which files area you would like to select an image:

• My files: You see all the folders and files that you have created.
• Group files: You see all the folders and files that you are allowed to publish.
• Institution files: If you are an institution administrator, you will see institution folders and files.
• Site files: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder public in the Site files.

• Licensor: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
• Original URL: If you are uploading somebody else’s file, provide a link to the original Internet address so that others can go there and view the original file.
4. 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.

5. If the site administrator turned on the image resizing option, you can decide whether you want to have your images resized if they are larger than the specified dimensions. This option is recommended to save space in your portfolio.

6. Folder path: The breadcrumbs show in which folder you are currently.

7. Click the Edit button to change any component of a folder or file, i.e. its name, description and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit them.

8. Click the Select button to choose the image file you wish to display in the block.

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.

9. Click the Remove button if you want to revert your selection.

10. Show description: Tick this checkbox if you wish to display the description of your photo. It could contain the source of it for example.

11. Width: Choose the width (in pixels) for your image. If you do not provide a number, the image will be scaled to the width of the block.

12. Retractable: Tick this checkbox if you want to allow users to reduce the block to its heading on a page. The user can click the Retractable icon to just show the heading.

13. Automatically retract: Tick this checkbox if you want to show only the block’s heading when a user views the page. The user can click the Retracted icon to view the entire block.

14. 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 for the first time.

15. You can also click the Close button in the top right-hand corner to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.

## 6.1.6. Embedded media¶

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.

1. Block title: Choose a title for your block.

2. Files area: Choose from which files area you would like to select a media file:

• My files: You see all the folders and files that you have created.
• Group files: You see all the folders and files that you are allowed to publish.
• Institution files: If you are an institution administrator, you will see institution folders and files.
• Site files: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder public in the Site files.

• Licensor: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
• Original URL: If you are uploading somebody else’s file, provide a link to the original Internet address so that others can go there and view the original file.
4. 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.

5. Folder path: The breadcrumbs show in which folder you are currently.

6. Click the Edit button to change any component of a folder or file, i.e. its name, description and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit them.

7. Click the Select button to choose the media file you wish to display in the block.

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.

8. You can also still select files that have been submitted in another portfolio page.

9. Click the Remove button if you want to revert your selection.

10. Width: Choose the width (in pixels) for your video.

11. Height: Choose the height (in pixels) for your video.

12. Retractable: Tick this checkbox if you want to allow users to reduce the block to its heading on a page. The user can click the Retractable icon to just show the heading.

13. Automatically retract: Tick this checkbox if you want to show only the block’s heading when a user views the page. The user can click the Retracted icon to view the entire block.

14. 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 for the first time.

15. You can also click the Close button in the top right-hand corner to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.

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.

## 6.1.7. PDF¶

Embed PDFs into a page.

Note

1. Block title: Choose a title for your PDF block.

2. Files area: Choose from which files area you would like to select a file:

• My files: You see all the folders and files that you have created.
• Group files: You see all the folders and files that you are allowed to publish.
• Institution files: If you are an institution administrator, you will see institution folders and files.
• Site files: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder public in the Site files.

• Licensor: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
• Original URL: If you are uploading somebody else’s file, provide a link to the original Internet address so that others can go there and view the original file.
4. 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.

5. Folder path: The breadcrumbs show in which folder you are currently.

6. You can still edit any component of the file, i.e. its file name, description and tags by clicking on the Edit button.

7. Choose the file or files you wish to display by clicking on the Select button.

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.

8. You can also still select files (within folders) that have been submitted in another portfolio page.

9. Click the Remove button to not display a specific file in this block anymore.

10. Retractable: Tick this checkbox if you want to allow users to reduce the block to its heading on a page. The user can click the Retractable icon to just show the heading.

11. Automatically retract: Tick this checkbox if you want to show only the block’s heading when a user views the page. The user can click the Retracted icon to view the entire block.

12. 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 for the first time.

13. You can also click the Close button in the top right-hand corner to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.

Once the PDF is embedded on a page, you can scroll through it and also download it for example. The PDF is displayed in its best possible fit to show one page completely.

1. Title of the block.
2. Toggle to the sidebar where you can jump from one slide to another either in the thumbnail or document outline view.
3. You can move to the previous page.
4. You can move to the next page.
5. The number of the current page is displayed. You can put a different number in and hit the Enter or Tab key and jump to that directly.
6. The total number of pages is shown.
7. Decrease the page size by clicking the Minus.
8. Increase the page size by clicking the Plus. The block size does not increase.
9. Click the Print button to print the PDF.
11. Use the scrollbar to move through the document.

If you have trouble embedding a PDF file, you might have come across an issue that others have also experienced. The mimetype of the PDF may not be recognized correctly. The correct “mimetype” is “pdf”, but programmes can circumvent using this mimetype for PDFs to ensure that their file is downloaded instead of viewed in the browser for example. There is not an easy fix to this issue, and the discussion of possible solutions has started.

In the meantime, you can delete the incorrect mimetypes from your browser and ensure that only “PDF” is left.

Follow these steps to delete the incorrect mimetypes:

1. Close Firefox.
3. Open the mimeTypes.rdf file in a text editor.
4. Search for pdf.
5. Leave only the entry that is application/pdf.
6. Delete all other PDF references by deleting everything for that entry from <RDF:Description ...> to </RDF:Description>.
7. Open Firefox and go to Preferences → Applications.
8. Search for pdf. You should now only see one entry that reads “Portable Document Format (PDF)”.