Note: You are currently viewing documentation for Moodle 3.9. Up-to-date documentation for the latest stable version of Moodle may be available here: File resource settings.

File resource settings: Difference between revisions

From MoodleDocs
(→‎See also: Adding MoodleBites YouTube video link)
(Added a line about "Display Resource Description")
(16 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{File}}
{{File}}
==Adding a file==
A teacher can add a file in a course when editing is turned on by dragging and dropping it or by clicking an 'Add an activity or resource' link (or, if not present, the "Add an activity" drop down menu) and selecting File.


To add a file to your course
===Dragging and dropping files===
[[File:dragandrop.png|thumb|Quick method of adding a file]]
*If you are using a modern browser, you can simply click, hold and drag and drop a file directly onto your course page. You will know if drag and drop is available to you because you will (briefly) see a message at the top of your screen:
Quick method: (''Note'' - ''does not work with Internet Explorer 9 or lower'')
[[File:dragdropmessage.png]]
# Click the 'Turn editing on' button at the top right of the course page
 
# Drag and drop the file onto the course section where you'd like it to appear
To drag and drop a folder, you must first compress/zip it using whichever program your computer has. See the documentation [[Folder]] for more information.
# If necessary, edit the title of the file by clicking the pencil icon, or edit other options (see below) by clicking the editing icon


Longer method:
===Uploading files===
# Click the 'Turn editing on' button at the top right of the course page
*Instead of drag and drop, you can click the link 'Add an activity or resource' and  select either [[File]] or [[Folder]] from the activity chooser (or choose from the 'Add a resource' drop down menu, if this is present instead.)
# Click 'Add an activity or resource' link, then in the activity chooser, select file then click the Add button (or select file from the "Add a resource" dropdown menu) All settings may expanded by clicking the "Expand all" link top right.
*Give your file a name and, if desired, a description (which you can display on the course page) and then upload your file by clicking the 'Add' button in the Select files box. Clicking on this button takes you to the [[File picker]] which is the name given to the file storage and access area within Moodle.
#Select your options as below:
*There is also a block (with an arrow) into which you can drag and drop a file straight from your desktop into Moodle.
[[File:31File.png|thumb|center|400px|Settings for uploading a file]]


==General==
==Viewing and editing uploaded files==
{|
|[[File:filegeneral25.png|thumb|General settings expanded by default]]
|}


===Name===
* Once uploaded, files appear as thumbnails in the file manager for easy recognition.
Whatever you type here will form the link learners click on to view the file so it is helpful to give it a name that suggests its purpose.
* Files view can be easily toggled between icons view or a table view with sizes and dates, or a hierarchical list view. See the documentation on the [[File picker]] for more information.
===Description===
*Clicking on the name of an uploaded file opens up a pop up dialogue box which allows file details quickly to be altered.
Add a description of your file here if desired (or required.) Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.
===Display description on the course page===
If this box is ticked, the description will appear on the course page just below the name of the file.


==Content==
{|
|[[File:filecontent25.png|thumb|Content settings expanded by default]]
|}


Either drag and drop your file onto the arrow if you are using an appropriate browser, or click on "Add" and use the [[File picker]] to upload your file.
[[File:popupdialogue.png|thumb|400px|center|File info popup dialogue]]


(Note that if legacy files were used there will be a setting "Migration of old course file")
==Creating an alias/shortcut==


==Appearance==
*When an uploaded file - or a file from the Private files, Dropbox, File system or EQUELLA repositories - is re-used elsewhere on Moodle, the teacher has the option to make a copy (a new, unconnected version) or to create a shortcut or ''alias''.
(These settings are collapsed by default)
*If an alias is created, then when the original file is updated, it will change in all instances of the alias. So a teacher might add course notes to their private files for example, and then add them into a number of courses. When the teacher makes an alteration in the file in their private files, this alteration will be reflected in all instances of the course notes.
*An alias can be recognised by its thumbnail. See the difference in the screenshot below between the original file (left) and the alias (right):
*To update a file, go to its original location (for example Private files) and upload your new version ''with the same name'' . You will be prompted to override or rename the file. Choose "override" and this file will replace your original file and the alisas/shortcuts will remain and all be updated to your latest version.
{|
{|
|[[File:fileappearance25.png|thumb|Appearance settings expanded]]
| [[File:alias.png|thumb|Creating an alias]]
| [[File:shortcut1.png|frame]]
|}
|}


'''''Note:''' Aliases cannot be made in the following areas:
''
* an assignment submission
* a forum post attachment
* a workshop submission
* a quiz essay
* a database activity file field
This is to prevent cases such as a student uploading an item for assessment and then subsequently changing the original in their private files. When a student uses a file from their private files in one of these instances, they do not see the options to "copy" or "create an alias".
==File resource course settings==
===Display===
===Display===
* ''Automatic'' - Make the best guess at what should happen (probably what is wanted 99% of the time).
* ''Automatic'' - Make the best guess at what should happen (probably what is wanted 99% of the time).
Line 64: Line 68:
* Do you want to use a horrible bit of non-strict HTML that should never be allowed in polite company? - In frame
* Do you want to use a horrible bit of non-strict HTML that should never be allowed in polite company? - In frame


===Show size.type===
===Show size or type===


To show the file size and/or type on the course page and also on the resource page, simply tick the appropriate checkboxes.
To show the file size and/or type on the course page and also on the resource page, simply tick the appropriate checkboxes.
====Display resource name/description====
To show the resource name and/or description when clicking to access the file, simply tick the appropriate checkboxes.


===Pop-up width/height===
[[File:files showing size and type.png]]
(This setting is visible when "Show more" is clicked.)
 
===Show upload/modified date===
 
If enabled, this setting will display the date the resource was uploaded. If several resources are uploaded, then date the main file was uploaded will be displayed.
[[File:UploadedModified.png|thumb|500px|center]]
 
===Display Resource Description===


If your file is to be displayed in a pop-up, specify the width and height here.
If enabled, this setting will display any content from the description box beneath the file (bottom of the page), provided that the Display is set to Embed.


===Use filters on file content===
===Use filters on file content===
Line 80: Line 88:
If you wish  included media such as images and mp3 to appear embedded in the files then select "all files" or "HTML files only", according to your file types. (Note that this  setting may cause problems for some Flash and Java applets.)
If you wish  included media such as images and mp3 to appear embedded in the files then select "all files" or "HTML files only", according to your file types. (Note that this  setting may cause problems for some Flash and Java applets.)


==Common module settings==
Depending on what is enabled for your site and course, you may also need to explore [[Common module settings]], [[Conditional activities| Restrict access]] and [[Activity completion]]
See [[Common module settings]]  
 
==Restrict access/Activity completion==
If your File doesn't display as you wish, check the site settings below:
(These settings are collapsed by default)
 
==Extract or unzip a zipped archive file ==
 
If you uploaded a zip file into a File or Folder Resource, you can uncompress and expand it into its various files. To do this, go into Edit settings for the resource, right click on the file icon in the Select files area, and then click on the Unzip file button.


These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.
[[File:file_resource_unzip.png|Unzip button]]


==Displaying a website index page==
==Displaying a website index page==
[[File:Setmainfile.png|thumb|Setting the main file]]
 
The file module may be used if you have a folder with linked files such as a website with an index.html file or a flash activity with xml/swf and index file.
The file module may be used if you have a folder with linked files such as a website with an index.html file or a flash activity with xml/swf and index file.
[[File:file resource.png|thumb|Website index page set as main file]]
{|
| [[File:Setmainfile.png|thumb|Setting the main file]]
| [[File:file resource.png|thumb|Website index page set as main file]]
|}
 
# Click the 'Turn editing on' button at the top right of the course page
# Click the 'Turn editing on' button at the top right of the course page
# Drag and drop the zipped folder onto the course section where you'd like it to appear, answer 'Create file resource' to the popup dialogue, then click the upload button  
# Drag and drop the zipped folder onto the course section where you'd like it to appear, answer 'Create file resource' to the popup dialogue, then click the upload button  
Line 97: Line 112:
# Click the button 'Save and display' at the bottom of the page
# Click the button 'Save and display' at the bottom of the page


==File module capabilities==
==Site settings==
 
* [[Capabilities/mod/resource:view|View file resource]]
* [[Capabilities/mod/resource:addinstance|Add a new file resource]]
 
==Site administration settings==


The file module has additional settings which may be changed by an administrator in ''Site administration > Plugins > Activity modules > File''.
The file module has additional settings which may be changed by an administrator in ''Site administration > Plugins > Activity modules > File''.


===Frame height===
*Frame height allows you to specify the height of the top frame (containing the navigation) if you choose the  "in frame" display option.  Note: If your theme has a large header then the ''resource_framesize'' variable should be increased to prevent horizontal and vertical scrollbars.
Here you can specify the height of the top frame (containing the navigation) if you choose the  "in frame" display option.  Note: If your theme has a large header then the ''resource_framesize'' variable should be increased to prevent horizontal and vertical scrollbars.
*Available display options:  By default Moodle doesn't enable "New window" or "In frame", so you need to set them available here if required, and you can also disable other options if not applicable.


===Require activity description===
The following capabilities relate to the file resource:
This setting allows you to turn off the requirement for users to type something into the description box.
* [[Capabilities/mod/resource:view|View file resource]]
 
* [[Capabilities/mod/resource:addinstance|Add a new file resource]]
===Available display options===
[[File:FileOptions.jpg|thumb|Setting the Admin File Display Options]]
This setting allows you to add different ways the resource may be displayed on the course page.  By default Moodle doesn't enable "New window" or "In frame", so you need to set them available here if required, and you can also disable other options if not applicable.
 
===Default values for activity settings===
 
Here you can set the defaults for this resource. You can also choose which setting(s) to class as "Advanced". These settings will only then appear if the user clicks "Show More" in the settings.
 
==See also==
*[http://youtu.be/a_HoneIa-rY Moodle 2.0 Adding Resources - File]  MoodleBites video on YouTube
*[http://youtu.be/ZPaVskLCRb4 Moodle 2 file management] MoodleBites video on YouTube


[[de:Datei konfigurieren]]
[[de:Datei konfigurieren]]
[[es:Configuraciones del recurso archivo]]
[[es:Configuraciones del recurso archivo]]

Revision as of 20:43, 18 March 2020

A teacher can add a file in a course when editing is turned on by dragging and dropping it or by clicking an 'Add an activity or resource' link (or, if not present, the "Add an activity" drop down menu) and selecting File.

Dragging and dropping files

  • If you are using a modern browser, you can simply click, hold and drag and drop a file directly onto your course page. You will know if drag and drop is available to you because you will (briefly) see a message at the top of your screen:

dragdropmessage.png

To drag and drop a folder, you must first compress/zip it using whichever program your computer has. See the documentation Folder for more information.

Uploading files

  • Instead of drag and drop, you can click the link 'Add an activity or resource' and select either File or Folder from the activity chooser (or choose from the 'Add a resource' drop down menu, if this is present instead.)
  • Give your file a name and, if desired, a description (which you can display on the course page) and then upload your file by clicking the 'Add' button in the Select files box. Clicking on this button takes you to the File picker which is the name given to the file storage and access area within Moodle.
  • There is also a block (with an arrow) into which you can drag and drop a file straight from your desktop into Moodle.
Settings for uploading a file

Viewing and editing uploaded files

  • Once uploaded, files appear as thumbnails in the file manager for easy recognition.
  • Files view can be easily toggled between icons view or a table view with sizes and dates, or a hierarchical list view. See the documentation on the File picker for more information.
  • Clicking on the name of an uploaded file opens up a pop up dialogue box which allows file details quickly to be altered.


File info popup dialogue

Creating an alias/shortcut

  • When an uploaded file - or a file from the Private files, Dropbox, File system or EQUELLA repositories - is re-used elsewhere on Moodle, the teacher has the option to make a copy (a new, unconnected version) or to create a shortcut or alias.
  • If an alias is created, then when the original file is updated, it will change in all instances of the alias. So a teacher might add course notes to their private files for example, and then add them into a number of courses. When the teacher makes an alteration in the file in their private files, this alteration will be reflected in all instances of the course notes.
  • An alias can be recognised by its thumbnail. See the difference in the screenshot below between the original file (left) and the alias (right):
  • To update a file, go to its original location (for example Private files) and upload your new version with the same name . You will be prompted to override or rename the file. Choose "override" and this file will replace your original file and the alisas/shortcuts will remain and all be updated to your latest version.
Creating an alias
shortcut1.png

Note: Aliases cannot be made in the following areas:

  • an assignment submission
  • a forum post attachment
  • a workshop submission
  • a quiz essay
  • a database activity file field

This is to prevent cases such as a student uploading an item for assessment and then subsequently changing the original in their private files. When a student uses a file from their private files in one of these instances, they do not see the options to "copy" or "create an alias".

File resource course settings

Display

  • Automatic - Make the best guess at what should happen (probably what is wanted 99% of the time).
  • Embed - Show the Moodle page with heading, blocks and footer. Show the title/description of the item and display the file directly in the page as well (good for images, flash animations, videos?, PDFs).
  • Force download - user clicks on the file, then the web browser pops up with the 'where do you want to save this file' box.
  • Open - No Moodle heading, blocks, footer or description - just show the file in the web browser (e.g. shows image, PDF, flash animation, taking up the whole browser window)
  • In pop-up - Same as 'Open', but opens a new browser window to show this file (without the Moodle heading, blocks, etc) - this browser window also does not have all the menus and address bar in it.
  • The following additional options are only there if you enable them via Site administration > Plugins > Activity modules > File:
  • In frame - show the Moodle heading and the file description, with the file displayed in a resizable area below (images, PDF, flash, etc. supported).
  • New window - very much like 'in pop-up', but the new window is a full browser window, with menus and address bar, etc.

All of the above is true of items that can be displayed inside the browser directly (e.g. images, text files, PDFs (with plugin)). If the file cannot be displayed within the browser (e.g. word documents, without a suitable plugin, or other files that need to be loaded by an external program), then the pop-ups or frames, etc. will be created, but then the browser will take over and ask if you want to save the file.

To summarise:

  • Do you want Moodle to sort it all out for you? - Automatic
  • Do you want to force the user to save the file (or open it in a program on their desktop)? - Force download
  • Do you want to show the file as part of the Moodle page (images, PDFs, videos)? - Embed
  • Do you want to show the file in the browser, but without the Moodle page decorations (images, PDFs, videos)? - Open
  • Do you want that, but in a new window? - In Pop-up (or possibly 'New window')
  • Do you want to use a horrible bit of non-strict HTML that should never be allowed in polite company? - In frame

Show size or type

To show the file size and/or type on the course page and also on the resource page, simply tick the appropriate checkboxes.

files showing size and type.png

Show upload/modified date

If enabled, this setting will display the date the resource was uploaded. If several resources are uploaded, then date the main file was uploaded will be displayed.

UploadedModified.png

Display Resource Description

If enabled, this setting will display any content from the description box beneath the file (bottom of the page), provided that the Display is set to Embed.

Use filters on file content

(This setting is visible when "Show more" is clicked.)

If you wish included media such as images and mp3 to appear embedded in the files then select "all files" or "HTML files only", according to your file types. (Note that this setting may cause problems for some Flash and Java applets.)

Depending on what is enabled for your site and course, you may also need to explore Common module settings, Restrict access and Activity completion

If your File doesn't display as you wish, check the site settings below:

Extract or unzip a zipped archive file

If you uploaded a zip file into a File or Folder Resource, you can uncompress and expand it into its various files. To do this, go into Edit settings for the resource, right click on the file icon in the Select files area, and then click on the Unzip file button.

Unzip button

Displaying a website index page

The file module may be used if you have a folder with linked files such as a website with an index.html file or a flash activity with xml/swf and index file.

Setting the main file
Website index page set as main file
  1. Click the 'Turn editing on' button at the top right of the course page
  2. Drag and drop the zipped folder onto the course section where you'd like it to appear, answer 'Create file resource' to the popup dialogue, then click the upload button
  3. Clicking the editing icon (hand with a pen) then click on the zip file and unzip it
  4. Click on the index.html file or the file you want to start displaying your linked files from then in the popup dialogue click the button 'Set main file'. This ensures this file is the one that appears on the course page for students to click on. The main file is then indicated with a title in bold.
  5. Click the button 'Save and display' at the bottom of the page

Site settings

The file module has additional settings which may be changed by an administrator in Site administration > Plugins > Activity modules > File.

  • Frame height allows you to specify the height of the top frame (containing the navigation) if you choose the "in frame" display option. Note: If your theme has a large header then the resource_framesize variable should be increased to prevent horizontal and vertical scrollbars.
  • Available display options: By default Moodle doesn't enable "New window" or "In frame", so you need to set them available here if required, and you can also disable other options if not applicable.

The following capabilities relate to the file resource: