.. include:: /shortcuts.rstext .. index:: single: Content; Files single: Parent folder icon .. _files_area: Files ------ *Content → Files* The *Files* area is a repository, i.e. a document storage for folders and files, that you can use within your portfolio. Both folders and files are considered artefacts and as such can be added to a page. You may create any number of folders or sub folders. To view which sub folders and files sit within a folder, click on the folder name. Use the *Home* link to return to the top level folder directory. You can arrange files and folders by dragging and dropping **the icon in front of the file / folder name** onto another folder icon. A suitably named and organised filing structure will help you with the long-term organisation and retrieval of your artefacts. If you want to move a file or folder out of a sub folder, move it onto the *parent folder* icon |parentfolder|. You will find that some folders are automatically created by the system such as *viewfiles* or *images*. The *viewfiles* folder includes files from imported pages whereas the *images* folder includes :ref:`your uploaded profile pictures `. As with any other file, you can move them out of this folder and store them in a different folder. .. note:: You can move files and folders to your heart's content without having to re-link them in the pages where you use them. Also renaming them will not have a negative impact on links. .. index:: single: File; Upload a file single: New in Mahara 1.6; Resize images on upload - per file upload .. _upload_file: Upload a file ~~~~~~~~~~~~~~ Before you upload a file, make sure that you are allowed to do so. For any artefacts that you publish in your portfolio, you must have the sufficient rights. That means: * the artefact is your own **or** * you are allowed to reproduce and distribute it, i.e. it does not violate any copyright legislation **and** * the artefact also adheres to the Terms and Conditions of the Mahara site you are using .. note:: It can be that you have to agree to an upload agreement before you can upload any files to your *files area*. The site administrator decides about that in *Administration → Extensions → Plugin administration* → :ref:`Plugin type: artefact: file `. .. figure:: /images/upload_file.* :alt: Upload a file Upload a file #. **Upload file**: Upload a file by clicking on the *Browse* button to search for the file on your computer. Make sure that it is not larger than the maximum upload size that is shown in the parentheses. #. |new in Mahara 1.6| If the site administrator turned on the :ref:`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. #. Type the folder name and click the *Create folder* button if you want to create a folder before uploading files. #. **Name**: You see all your folders and files that are not in folders listed in this table to access them easily. #. **Description**: View the description of your folders or files to know quickly what the content of them is. #. **Size**: The size of your files is displayed here. #. **Date**: The date you created a folder or uploaded a file is shown. #. Click the *Edit* button |edit| to edit folder or file properties. Continue with :ref:`editing a file `. #. Click the *Delete* button |delete| to delete a file or folder. If you use a file in a journal entry and / or on a page, you are warned before deleting the file so that you don’t delete it by accident. #. If a folder or file is an artefact in a page that has been :ref:`submitted `, you are not able to edit or delete it. .. note:: You can move your file to a folder by clicking on the icon before the file's name and then dragging and dropping it onto a folder icon. Similarly, you can click on a folder icon and drag it onto another folder icon to move the folder into the second one. .. index:: single: File; Upload multiple files single: Upload multiple files Upload multiple files ~~~~~~~~~~~~~~~~~~~~~~ You can upload multiple files at once in two different ways: * You can upload multiple files when you are browsing for them. Hold down the `Ctrl` key (or `Command` key on a Mac) and click on all the files that you wish to upload at once. * You can also place all files into a compressed file, a *.zip file*, and upload that to Mahara. This method allows you to upload multiple files from different folders on your computer at once. You can create a zip file from any number of files that you have selected in your document management program by making a right mouse click and selecting *Compress...* (or something similar). .. figure:: /images/compress_finder.* :alt: Zip files in MacOSX Zip files in the Finder under MacOSX .. figure:: /images/compress_nautilus.* :alt: Zip files in Ubuntu Zip files in Ubuntu's Nautilus .. figure:: /images/compress_explorer.* :alt: Zip files in Windows Zip files in Windows Explorer Once you have uploaded your zip file to Mahara, you can unzip it there. Click on the *Unzip* button |unzip| next to the *Edit* button |edit|. Please follow the on-screen instructions. .. index:: single: File; Edit file .. _edit_file: Edit a file or folder ~~~~~~~~~~~~~~~~~~~~~~~ You can edit the properties of a file or folder at any time. The file does not have to be re-linked in portfolio pages, but the properties you changed will be updated automatically. .. figure:: /images/edit_file.* :alt: Edit a file Edit a file #. Click the *Edit* button |edit| to edit folder or file properties. #. **Name**: Change the name of the file (or folder). It is not necessary to keep the file extension as Mahara stores it internally. However, it can be good to leave it in case somebody has problems opening the file if no default programme is associated with the file after downloading it. This field is mandatory and each file (or folder) must have a name. #. **Description**: Give the file (or folder) a description to find it again more easily. #. **Tags**: Give the file (or folder) one or more tags. You can choose from your existing tags by clicking on the *Show my tags* link and then selecting the tags. If you type your tags, separate them with commas. #. **Allow comments**: Decide if users should be allowed to comment directly on the file artefact page when they view it. #. Click the *Save changes* button to keep your changes or click the *Cancel* button to abort the action. .. index:: single: File; File quota File quota ~~~~~~~~~~~ The site administrator of your Mahara site decides how much space you can have to store files. This can vary across institutions. You can check your file quota in the sidebar in your 'Files' area. .. figure:: /images/file_quota.* :alt: file quota File quota