Note: This documentation is for Moodle 2.7. For up-to-date documentation see File resource settings.

File resource settings: Difference between revisions

From MoodleDocs
(drag and drop clarification→‎Adding a file)
(→‎See also: Updating MoodleBites video)
 
(18 intermediate revisions by 5 users not shown)
Line 4: Line 4:
To add a file to your course
To add a file to your course
[[File:dragandrop.png|thumb|Quick method of adding a file]]
[[File:dragandrop.png|thumb|Quick method of adding a file]]
{{New features}}Quick method: (''Note'' - ''does not work with Internet Explorer'')
Quick method: (''Note'' - ''does not work with Internet Explorer 9 or lower'')
# 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 file onto the course section where you'd like it to appear
# Drag and drop the file onto the course section where you'd like it to appear
Line 11: Line 11:
Longer method:
Longer method:
# 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
# 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)  
# 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.
# Enter a link name and a description (which may be required or optional according to the admin settings)
#Select your options as below:
# Either drag and drop a file into the box with an arrow or click the Add button to open the [[File picker]] menu in order to choose a file from your computer or a repository
 
# Select display and other options as required (see below)
==General==
# Click the button 'Save and display' at the bottom of the page
{|
|[[File:filegeneral25.png|thumb|General settings expanded by default]]
|}
 
===Name===
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.
===Description===
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.
 
(Note that if legacy files were used there will be a setting "Migration of old course file")


==Course administration settings==
==Appearance==
===Display options===
(These settings are collapsed by default)
{|
|[[File:fileappearance25.png|thumb|Appearance settings expanded]]
|}


===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).
* ''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).
* ''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).
Line 42: Line 64:
* 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


===Additional options===
===Show size.type===


{{New features}}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.


[[File:files showing size and type.png]]
===Pop-up width/height===
(This setting is visible when "Show more" is clicked.)


There is also an option to display the file description on the course page below the link to the file.
If your file is to be displayed in a pop-up, specify the width and height here.


There are the usual [[Common module settings]] and  - if admin has enabled them - the Restrict access settings [[Conditional activities]].
===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.)
 
==Common module settings==
See [[Common module settings]]  
==Restrict access/Activity completion==
(These settings are collapsed by default)
 
These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.


==Displaying a website index page==
==Displaying a website index page==
Line 69: Line 104:
==Site administration settings==
==Site administration settings==


The file module has additional settings which may be changed by an administrator in ''Settings > 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===
Line 78: Line 113:


===Available display options===
===Available display options===
This setting allows you to add different ways the resource may be displayed on the course page.
[[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===
===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 advanced" in the 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==
*HQ Youtube video tutorial: [https://www.youtube.com/watch?v=Vr41LtX8Mlc&index=21&list=PLxcO_MFWQBDdQjcGsbROYKwEIM-IlXmpR Dragging and dropping files into Moodle]
*HQ Youtube video tutorial: [https://www.youtube.com/watch?v=07MpjfRIpXY&list=PLxcO_MFWQBDdQjcGsbROYKwEIM-IlXmpR&index=21 Uploading files to Moodle]
* [http://youtu.be/Rg2Xwe4HOFQ The Moodle File Resource] 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]]

Latest revision as of 23:58, 24 August 2014

Adding a file

To add a file to your course

Quick method of adding a file

Quick method: (Note - does not work with Internet Explorer 9 or lower)

  1. Click the 'Turn editing on' button at the top right of the course page
  2. Drag and drop the file onto the course section where you'd like it to appear
  3. 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:

  1. Click the 'Turn editing on' button at the top right of the course page
  2. 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.
  3. Select your options as below:

General

General settings expanded by default

Name

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.

Description

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

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.

(Note that if legacy files were used there will be a setting "Migration of old course file")

Appearance

(These settings are collapsed by default)

Appearance settings expanded

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.type

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

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

If your file is to be displayed in a pop-up, specify the width and height here.

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.)

Common module settings

See Common module settings

Restrict access/Activity completion

(These settings are collapsed by default)

These settings are visible if Conditional activities and Activity completion have been enabled in the site and the course.

Displaying a website index page

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.

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

File module capabilities

Site administration settings

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

Frame height

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.

Require activity description

This setting allows you to turn off the requirement for users to type something into the description box.

Available display options

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