MoodleDocs - User contributions [en]

admin/setting/themesettingfordson

2016-12-23T06:12:30Z

Derekcx: Add comment

Fordson is a child theme of Boost. It features an enhanced homepage, color choosers for all major elements of the page, preset support, custom header images for both courses and the main site.
There are seven pages for Fordson: Presets, Colours, Heading and Course Image Settings, Content Areas, Social Networking, Icon Navigation, and Marketing Tiles. This page will cover each of these pages.

[[File:enhancedhome.png]]

== Presets ==
'''Fordson Preset Tab'''

Choose from several included presets or upload your own. The Fordson theme has several elements in the layout which are not included with the default Boost theme. These elements are included in the SCSS folder in the styles.scss file. This ensures that basic styling for marketing tiles, icon navigation, and other elements will carry over when using other presets. A listing of these changes should be included here.

[[File:presets.png]]

----

== Colours ==
'''Fordson Colours Tab'''

The colours tab allows you to quickly change the look of the major elements of the page. Text, links, background colors are all included. Along with this, some standard bootstrap elements common to presets are also included. Once you upload a preset you most likely can alter some of the colors using the Fordson Colour tab.

It is recommended you remove all color settings when exploring presets so that the Fordson color choosers do not alter the preset styles.

[[File:colours.png]]

----

== Heading and Course Image Settings ==
'''Fordson Heading and Course Image Settings Tab'''

Upload a default header image, body background image, and/or login image. The default header image is used at the top of every page. The height of the header can be set using the dropdown setting. If a teacher uploads an image file to their course summary files area then it will replace the default image for that course. This allows teachers to customize their course without having to use a new theme.

[[File:courseimages.png]]

----

== Content Areas ==
'''Fordson Content Areas'''

There are four areas for custom content: Frontpage Logged in Textbox, Frontpage Logged Out Textbox, Alert, and Footnote. Using the frontpage textboxes you can provide a message or instructions for visitors based on whether they are authenticated or just visiting. The alert box is useful for maintenance or other notices that users must see. The alert message appears on the site homepage just below the icon navigation area. The footnote appears in the footer of the page.

[[File:contentareas.png]]

----

== Social Networking ==

== Icon Navigation ==
Fordson Icon Navigation Tab

[[File:iconnavigation.png]]

The icon navigation is a unique navigation used in our themes. It is a great way to quickly get learners into main areas of your site. The icons, button, text, and color help draw attention to this style of navigation. There are three settings for each icon and you can create up to eight icons in total. The first element to creating an icon button is the actual icon which comes from Font-Awesome. Use any of these icons found here: http://fontawesome.io/cheatsheet/ just remember to remove the "fa-". Next enter in text which will appear below the icon. Try to keep it to one or two words. Finally, you must provide a link. It can be a link to anywhere. You can link to anywhere including outside websites just enter the proper URL. If your Moodle site is in a subdirectory the default URL will not work. Please adjust the URL to reflect the subdirectory. Example if "moodle" was your subdirectory folder then the URL would need to be changed to /moodle/my/.

In addition to the 8 icons there are two special icons: Course Creator Button and Slide Icon Button. The course creator button will appear when a user has the capability to create courses. If you use LDAP you can make all staff members "Course Creators" when they login to Moodle. If this is the case, this button will appear for them and quickly help them begin creating a new course. The slide icon button is a toggle button that will either show or hide a custom textbox. When pressed, the slide textbox reveals itself by sliding down from the icon navigation bar. This is ideal for featured courses, staff trainings, and other helpful information.

[[File:displayicon.png]]

----

== Marketing Tiles ==
These have fixed heights, which means if the content is too big, you get nice scroll bars as in the 'Staff courses' below.

[[File:marketingtiles.png]]

SCORM FAQ

2016-09-15T00:14:19Z

Derekcx: /* Problems with responsiveness */

{{SCORM}}
==What is SCORM?==

SCORM was developed as a result of collaboration in the public and private sectors. The President of the United States, Bill Clinton issued an Executive Order that created an agency (ADL) to oversee the standard for developing and distributing online learning. All Federal agencies are mandated to use programs that meet those standards. SCORM is one result of that order.

There's a really simple "What is SCORM" introduction here: http://moodle.org/mod/forum/discuss.php?d=3757#p18828

A slightly more detailed introduction here: http://www.rusticisoftware.com/resources/whatisscorm/What%20Is%20SCORM.ht

==Should I make my Moodle courses as SCORM or use Moodle's features?==
It depends how you intend to use it. If you are planning on exporting and using in another LMS then SCORM would make this easier. If you want something shiny, then a SCORM package can fit the bill. However, reporting and grading work better in Moodle and for many educators the standard features do the job perfectly and do not require learning a new program. There is a useful form post discussing the pros and cons of SCORM in Moodle here: http://moodle.org/mod/forum/discuss.php?d=200242

==SCORM Information==

Advanced Distributed Learning (ADL) is the organization that wrote the SCORM standard. You can download documentation and samples form ADL's Web site. Documentation for SCORM 1.2 in several languages is available [http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Forms/AllItems.aspx?RootFolder=%2fTechnologies%2fscorm%2fSCORMSDocuments%2fPrevious%20Versions%2fSCORM%201.2%2fDocumentation%20Suite%20(SCORM%201.2)&FolderCTID=0x0120007F801FCD5325044C89D91240519482D7&View={4D6DFFDE-3CFC-4DD9-A21A-4B687728824A} here].

Philip Hutchison provides an AS3 and JavaScript wrapper, as well as a sample package:
http://pipwerks.com/downloads/

==SCORM Package Contents==

A SCORM package must contains in the root of zip a file named imsmanifest.xml which defines SCORM course structure, resource location and many other things. Other files used in the package, such as HTML files, XML files, multimedia files, and JavaScript for the SCORM API must be listed in this file. The LMS parses the manifest, and provides the files listed there to the content package during runtime.

==AICC Package Contents==

An AICC package is defined by several files (from 4 to 7) with defined extensions as follows:

* CRS - Course Description file (mandatory)
* AU - Assignable Unit file (mandatory)
* DES - Descriptor file (mandatory)
* CST - Course Structure file (mandatory)
* ORE - Objective Relationship file (optional)
* PRE - Prerequisites file (optional)
* CMP - Completition Requirements file (optional)

==Basic Troubleshooting==

* Make sure you are running Moodle 2.1 or higher, a large number of SCORM related bugs are present in previous versions.
*Make sure you (and your users) have JavaScript enabled. SCORM requires JavaScript.
* Make sure your SCORM object is SCORM compliant - check it in an external SCORM player like [https://docs.moodle.org/en/Tools_for_creating_SCORM_content#Reload Reload] to see if it works there.
* Upload a copy of your SCORM object to a [http://en.wikipedia.org/wiki/File_hosting_service File Hosting Service] and post a message asking for help in the forums, linking to your SCORM object explaining exactly what you expect to happen, and what is happening instead.
* Read Dan Marsden's blog post [http://danmarsden.com/blog/2012/08/08/scorm-doesnt-work-in-moodle here] (Maintainer of SCORM Module in Moodle)

==Does Moodle Generate SCORM Content?==

Moodle '''does not''' generate scorm content. Moodle presents the content in SCORM packages to learners, and saves data from learner interactions with the SCORM package.

==Can I add a password for access to my SCORM package?==
No, although there is a tracker request for this: MDL-46403 As a workaround you could add your SCORM package using the single activity course format - see [[Course formats]] - and add an enrolment key to the course.

==Supported Versions==

* SCORM 1.2 is supported in Moodle 2.1(or higher) and passes all the tests in the ADL Conformance test suite 1.2.7 for SCORM 1.2. The best place for information on SCORM 1.2 conformance is the [http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Previous%20Versions/SCORM%201.2/Conformance%20Test%20Suite%20(SCORM%201.2)/SCORM_1.2_ConformanceReq.pdf SCORM Comformance Requirements documentation (PDF 3.4MB)].

* SCORM 2004 is not supported in Moodle. Parts of the API have been implemented, but others such as Navigation and Sequencing have not. Development on native SCORM 2004 support in Moodle [https://moodle.org/mod/forum/discuss.php?d=227906 has stopped]. If you require a fully certified SCORM 2004 Player in Moodle, [http://www.scorm.com Rustici Software] have a [http://support.scorm.com/entries/20394726-scorm-cloud-moodle-module Moodle plugin] which connects to their commercial [http://www.scorm.com/scorm-solved/scorm-cloud/ SCORM Cloud] service turning Moodle into a fully compliant SCORM 2004 LMS.

* AICC objects are supported in Moodle 2.1 and higher.

* Moodle does not support Tin Can at this stage.

==Asking for Help in the SCORM Forum==

When trying to engage the community to help with a problem you are facing, you will get a better response if you follow a few simple guidelines:
* Always start your report with '''version information''' - preferably the information displayed on the Admin -> Environment panel eg. http://localhost/moodle/admin/environment.php where http://localhost/moodle is your particular prefix. With this it will be clear how you are running your Moodle instance, on what platform, and at which version. This will quickly expose issues where a simple upgrade will solve your problem.
* Be prepared to '''provide the SCORM package''' that illustrates your problem - if you don't then it will be very difficult for anyone offering assistance to recreate your situation - a real barrier to help.
* '''Screenshots''' are very helpful. Provide a screenshot of all error messages, and any instance where something seems to go wrong in the interface.
* Nonstandard themes can introduce SCORM issues. Be sure to tell us '''what theme you're using'''.
* If you have admin privileges, and have access to a localhost install or other place where real-time users won't be disturbed, be sure to turn on debugging. Navigate to '''Site Administration > Development > Debugging''' and set '''Debug messages: Developer''' and '''Display debug messages: Yes'''. Access the SCORM content. If there are errors printed to the page, include them in your forum post.
* Use [https://developers.google.com/chrome-developer-tools/docs/console Chrome's JavaScript Console] or [https://developer.mozilla.org/en-US/docs/Tools/Web_Console Firebug's JavaScript console] to check that there are no JavaScript errors on the page when the content loads.
* Run your problematic SCORM package through '''API debugging''' (see below) and include the text of that API log with your post. That way we can see right away if the right function calls are not taking place.
* If you're using a content development suite which publishes to SCORM, such as Articulate, Captivate, Lectora, LessonBuilder, Udutu, or some other product, then include that in your post. Every authoring software has its ticks, and if you've run into one, it's likely that someone else has also dealt with it, and will recognize it. However, please keep in mind that '''this is a place to get help with Moodle issues, not help with your SCORM package authoring suite'''.

==Debugging ==

# Debugging settings are located at Settings > Site Administration > Plugins > Activities > Scorm.
# Check the checkbox for '''Activate API debug...'''
# Set the api mask. You can use the mask to enable debugging under certain conditions. For example, if you are logged in using the admin user (username admin) you can set the api mask to: <cite>admin.*</cite> Users not logged in as admin will not see the debugging log. The "Default" api mask is <cite>.*</cite>

==What does the debugging log mean?==

The SCO commonly sends the following communications through the API:

* '''LMSInitialize();''' opens the connection between the SCO and Moodle
* '''LMSGetValue( 'valuename' );''' gets a value from Moodle
* '''LMSSetValue( 'valuename' , 'value' );''' sends a value to Moodle
* '''LMSCommit();''' saves values sent to Moodle via LMSSetValue() and should be called after every LMSSetValue()
* '''LMSFinish()''' saves values sent to Moodle and closes the connection between the SCO And Moodle

Red lines in the debugging log means there was an error in the communication through the API.

If LMSInitialize() fails, returns an error, then no subsequent values sent to Moodle will be saved.

Click through the entire SCORM package. Then access the scorm report for your attempt, and compare the saved values in the debugging log with Moodle's report of the attempt. If the values set in the debug log do not match the values saved to Moodle, then there may be a problem with Moodle. Otherwise it's likely to be an issue with the SCO or the SCORM activity settings not giving you the functionality you need.

==SCORM and the Gradebook==
Please see [https://docs.moodle.org/en/SCORM_FAQ#My_SCORM_Module_doesn.27t_function_properly FAQ:My SCORM Module doesn't function properly] and [https://docs.moodle.org/en/SCORM_FAQ#Handling_of_Multiple_Attempts FAQ:Handling of Multiple Attempts]

Some SCORM packages report both cmi.core.lesson_status and cmi.core.score.raw. Others report only cmi.core.lesson_status, or only cmi.core.score.raw. The '''Grading Method''' setting for SCORM objects is meant to account for that.

If you have the '''Grading Method''' set to '''Highest grade''', '''Average grade''', or '''Sum grade''', and your learning object does not report a score, only, cmi.core.lesson_status, then there will be no numerical score to pass to the gradebook.

If your SCOs do not report cmi.core.score.raw, then the best '''Grading Method''' setting is '''Learning Objects'''. This reports either a 1 or a 0 as a score for each learning object. The gradebook value for that SCORM activity is the percent of scos in the package for which learners got a 1.

On the other hand, if your SCOs do not report a lesson_status, then select one of the score-based '''Grading Method''' options, such as '''Highest grade''', '''Average grade''', or '''Sum grade''', and not '''Learning Objects'''.

If you do not know what your SCOs are reporting to the LMS, then run them through to completion with debugging on.

Much of the way SCORM objects are graded is controlled inside the SCORM Authoring process before it is packaged for use in an LMS like Moodle - make sure all your grading settings are set correctly.

==SCORM Administration Options==

See [[SCORM settings]]

==Common Solutions==

===Difficulty Displaying a SCORM Package===
If you have difficulty displaying a SCORM, try loading the SCORM in [http://www.reload.ac.uk Reload] and re-saving it, then save the folder as a .zip package and try again.

===Character Display Errors===
When you notice there is a problem displaying characters correctly, it could be a misconfiguration of your server. Make sure that both httpd.conf (when using Apache) and php.ini are set to DefaultCharacterset = utf8 or switch the sending of a default character set off.

===slash arguments warning when I add/update SCORM objects in my course===
Some web servers don't support a function called '''slash arguments''' and so Moodle allows you to turn it off, but SCORM packages require '''slash arguments''' to be enabled on the web server in order to work properly.

See [[Using slash arguments]] for more details.

===SCORM doesn't work on Godaddy Host===
Godaddy hosts give a 404 file not found error - this is because by default they do not allow slash arguments which SCORM requires. The best way to test this is to visit http://yourmoodlesite/admin/tool/health/index.php - but the fix involves adding a php.ini or php5.ini file with the following text:
AcceptPathInfo
cgi.fix_pathinfo=1

===My Flash-Based Content Loads, then Stalls===
This issue is most commonly associated with zlib compression. Classic presentation is that the base HTML file and SWF are loaded into the SCORM player, but the SWF is not able to load any audio or video assets, and therefore stalls. You can watch the loading of SWFs and assets using Chrome's Developer Tools or other.

Check your site's zlib compression settings as an admin by loading up the Server > phpinfo page. zlib compression is not a Moodle setting but a server setting, so you'll need a server admin to disable it. Be sure to Purge All Caches, and clear browser caches, before confirming the change.

===Zlib warning when I add/update SCORM objects in my course===
Zlib is a php compression setting made in a websites PHP configuration - unfortunately some browsers don't handle this well (especially Internet Explorer 6) Some webhosts enable this setting, but it will likely cause issues for your users when they attempt to view/use the SCORM object. You will need to contact your server administrator to turn this off. The setting to change in php configuration is "zlib.output_compression"

===Incorrect file package - missing imsmanifest.xml or AICC structure===
This means that Moodle cannot find a file called imsmanifest.xml inside the SCORM object. Reasons for this could be:
* imsmanifest.xml needs to be immediately inside the scorm directory, NOT inside a directory inside of that. So if the zipped scorm package is package.zip, the unzipped package directory should contain immediately inside of it the imsmanifest.xml. This is a common mistake and normally occurs when a SCORM author creates a package themselves and then selects that folder to compress. This places the content folder inside of another folder, The imsmanifest.xml is there, but it is 2 directories deep. To avoid this problem when zipping scorm content into a package, go INSIDE of the exported scorm folder, select all files inside, and compress them while all are selected. The resultant compressed directory has the imsmanifest.xml file in the first directory, immediately available to the moodle scorm loading process.
* when using linux based systems the filename imsmanifest.xml must be all in lowercase not IMSmanifest.xml or Imsmanifest.XML
* The SCORM authoring tool Articulate sometimes fails to create the imsmanifest.xml -Try exporting the package again and see if the manifest is generated.
* The SCORM authoring tool Articulate Presenter will publish packages where the imsmanifest.xml file is in the correct place, but there are several lines of white space in the manifest file if you do not fill out the Reporting and Tracking Options in Articulate Presenter for Keywords and LMS Description. Moodle will give a "Manifest not found" error when encountering this. To fix this problem select the Reporting and Tracking Options in the Articulate Presenter publish dialog and fill in the LMS Description and Keywords.

===File not found error===
You have this error if the scorm package is created in moodle, and the scorm menu loads, but inside of the viewing area for the scorm content, you get a page with a 404 file not found error, usually showing the current Moodle theme.

What this means is that one of the files listed in the imsmanifest.xml is not in the scorm package or not in the correct directory.

Download and unzip the package, open up imsmanifest.xml. At the bottom of the xml file, below any metadata, you'll find a place where organizations and resources for those organizations are designated:

<code xml>

<organizations default="TOC1">
<organization identifier="TOC1">
<title>SCORM Test</title>
<item identifier="I_SCO0" identifierref="SCO0">
<title>Library Quiz</title>
<adlcp:masteryscore>0</adlcp:masteryscore>
</item>
</organization>
</organizations>
<resources>
<resource identifier="SCO0" type="webcontent" adlcp:scormtype="sco" href="scorm.html">
<file href="scorm.html"/>
<dependency identifierref="ALLRESOURCES" />
</resource>
<resource identifier="ALLRESOURCES" type="webcontent" adlcp:scormtype="asset">
<file href="scorm.html" />
<file href="scorm.js" />
<file href="swfobject.js" />
<file href="scorm.swf" />
<file href="scormwrapper.js" />
</resource>
</resources>
</manifest>
</code>

In this xml, we have a single organization, and in that organization is a single resource, a single sco. There are 5 files necessary for that resource to work correctly. The scorm.html file is loaded first. It loads 3 external js files and a swf.

What you need to do now is go to the directory containing imsmanifest.xml, and check that all of those listed files are available at the correct path from imsmanfiest.xml, as listed in imsmanifest.xml. If any one of those files is missing (especially the html file or the swf), or if the paths in imsmanifest.xml are incorrect, then it's very likely that the scorm object won't be able to load at all.

Sometimes the files aren't missing, but are simply misnamed in the manifest, or placed in the wrong directory. You can fix this by moving the files to the correct places, or updating their names so that the imsmanifest and the actual file names match up. In the case of a misnamed file, change the manifest rather than the actual file names, since the the files also reference one another in other places!

===Unzip issues===
If you get a blank page after filling in the title, description, and selecting a large SCORM file, it's likely you haven't installed the PHP-zip lib which is required for Moodle 2.x for more info see [[admin/environment/php_extension/zip]]

===Clear an Attempt===
To clear attempts by a student:

# Go to the SCORM activity and select the link "View reports for x users"
# Select the attempt or attempts you want to clear using the checkbox
# Select Delete in the drop-down box at the bottom of the page

===Handling of Multiple Attempts===
SCORM is designed to allow a learner to exit and return at a later date to the same point they left from. This means that each time they enter the SCORM they are using the same single attempt. Some SCORM packages are intelligent about handling re-entry, many are not. What this means is that if the learner re-enters an existing attempt, if the SCORM content does not have internal logic to avoid overwriting cmi.core.lesson_status and cmi.core.score.raw, they can be overwritten by a lower score, confusing the learner.

When a SCORM sets the cmi.core.lesson_status value to 'completed', 'passed' or 'failed' then Moodle allows the user to create a new attempt by adding a '''Start new attempt''' checkbox to the entry page. If cmi.core.lesson_status is set to 'incomplete', 'browsed' or 'notattempted' the learner can only re-enter the existing attempt. If you are using the setting 'Student skip content structure page', this checkbox will never be shown to the user.

Moodle provides a range of settings to allow this to be controlled, some of these settings are hidden by default as advanced options.
* Number of attempts
:This allows the teacher to set how many SCORM attempts the learner may create - this is not how many times a learner can re-enter a SCORM attempt.
* Attempts grading
:This allows the teacher to set how multiple SCORM attempts(not re-entries) are graded. It is important to note that a 'failed' cmi.core_lesson_status allows a new attempt to be generated but the attempts grading setting "last completed attempt" only includes 'completed' and 'passed' values in it's calculations.
* Display attempt status
:This displays a users SCORM attempts and how their final grade is calculated on the SCORM entry page and the My Moodle page for the learner.
* Force completed
:This is a setting that can be used to force a SCORM package to report a 'completed' cmi.core.lesson_status if it doesn't currently set the value.
* Force new attempt
:This hides the '''Start new attempt''' checkbox and will force a new attempt if the previous attempt has cmi.core.lesson_status value to 'completed', 'passed' or 'failed' - this setting can also be used to make sure a new attempt is generated when the 'Student skip content structure page' setting is used.
* Lock after final attempt
:This prevents access to the SCORM after the total number of attempts have been used - if this is not set the learner can re-enter their last attempt and potentially change/overwrite their score each time depending on how the SCORM package supports multiple re-entries.

===Reducing Load Time with Captivate===
* Modify the percent that must be downloaded before the content starts to play. In Captivate 4, there's a setting in: Preferences / Project / Start and End / Preload. Reduce that to 50%.
* If you use audio in your Cp file (as background or element attachment), try to put a gap of 0,1 second at the beginning of each element including audio on your slides. If you don't do that, Cp merge all the audio files in one big audio file it need to download before playing the project. This problem have been report many times from the Cp community.

===Moodle changes cmi.core.lesson_status from "completed" or "passed" to "failed"===
Many SCORM authorware suites generate a masteryscore node in the imsmanifest.xml by default. This node is not necessary to the XML file. But when it is there, the SCORM standard designates specific behaviour with regard to the value set there.

This can also be controlled in Moodle using the setting "Mastery score overrides status" If this setting is enabled and a mastery score is provided within your package, when LMSFinish is called and a raw score has been set, if the raw score is lower than the mastery score, the lesson status will be overridden and set to "failed"

Here's what is in the scorm standard, on page 35 of 155 in SCORM_1.2_ConformanceReq.pdf, numbered page 2-19 ([http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Forms/AllItems.aspx?RootFolder=%2fTechnologies%2fscorm%2fSCORMSDocuments%2fPrevious%20Versions%2fSCORM%201%2e2%2fDocumentation%20Suite%20%28SCORM%201%2e2%29&FolderCTID=0x0120007F801FCD5325044C89D91240519482D7&View=%7b4D6DFFDE%2d3CFC%2d4DD9%2dA21A%2d4B687728824A%7d SCORM Version 1.2 Conformance Requirements Version 1.2]):
<blockquote>
If the value for this element is not set to “incomplete” by the SCO, then the LMS shall re-evaluate and change the value based on the following:<ul>
<li>If there is no mastery score in the Manifest, and the SCO sets a score (cmi.core.score.raw) and the lesson_status (cmi.core.lesson_status) then the LMS shall not override the SCO determined status.</li>
<li>If there is a mastery score in the Manifest, the LMS can change the status to either passed or failed depending on the student's score (cmi.core.score.raw) compared to the mastery score.</li>
<li>If the student is taking the SCO for no-credit, (cmi.core.credit = “no-credit”) there is no change to the lesson_status, with one exception. If the lesson_mode (cmi.core.lesson_mode) is "browse", the lesson_status may change to "browsed" even if the cmi.core.credit is set to no-credit.</li>
</ul>
</blockquote>
This can result in some functionality you don't intend. You can fix the problem by removing the mastery score node from your imsmanifest.xml file or by adjusting the Moodle setting "Mastery score overrides status". You may also want to find out what options you have, within your authorware suite, for the writing of that node into the manifest file, and change your authoring process accordingly.

The Rustici SCORM Cloud default operating behaviour for masteryscore is different from Moodle's default operating behaviour - you can see a little bit of the history around the way Rustici handle this here: http://scorm.com/blog/2010/09/anatomy-of-scorm-minutiae-mistake/

===Player Look 'n Feel===
You should be able to adjust height and width settings for the SCORM player window '''so long as''' your theme is based on/not too much of an aberration from one of the standard themes which ship with Moodle 2.

If your site or course theme isn't closely based on one of the standard M2 themes, then it's possible that your theme CSS is overriding local height and width settings for the SCORM player. Have a Web developer (or a Moodle Partner) examine how your theme is interacting with the player layout, and make changes to your theme as needed.

'''Why can't I just change it locally?''' You can change height and width per individual SCORM package, and you can set defaults for these local height and width values ( [[SCORM Admin Options]] ). Other things, such as colors, shading, borders, backgrounds, are controlled by CSS, just like everything else on the site.

=== Courselab 2.4 ===
If you receive a " found more than one record!" error when trying to run your SCORM 1.2 package check the imsmanifest.xml file of your SCORM package and ensure that the values for <organization identifier> and <item identifier> are unique. To change the <organization identifier>, in Courselab, go to File > Course Runtime Settings. The dialog says 'Course identification in LMS' but changing the Identifier field is what sets the <organization identifier>. (see MDL-38060 for more information)

=== SCORM results deleted after package update ===

When uploading a SCORM package over a previous one, if the item identifier in the manifest file is different to the one being overwritten then the tracking data for that SCORM package in Moodle is deleted.

Ensure the item identifier is the same for the new SCORM resource

===Problems with responsiveness===

Sometimes SCORMs fail on responsiveness or the ability to scroll on mobile devices

*Moodle uses iFrames for deploying SCORM. https://community.adaptlearning.org/mod/forum/discuss.php?d=180#p863
*There can be some problems with this as they are not responsive in iOS https://community.adaptlearning.org/mod/forum/discuss.php?d=1446#p6687
*There are some potential work arounds.
#Totara has a new window. #https://community.adaptlearning.org/mod/forum/discuss.php?d=851#p3968
#This comment https://community.adaptlearning.org/mod/forum/discuss.php?d=787#p3661
#Solutions for Adapt: https://github.com/adaptlearning/adapt_framework/issues/210
*The tracker:
#https://tracker.moodle.org/browse/MDL-47500 problems with pages.
#https://tracker.moodle.org/browse/MDL-46563
#https://tracker.moodle.org/browse/MDL-50401
*Why iFrames fail with iOS, one person's view: https://community.adaptlearning.org/mod/forum/discuss.php?d=926#p4714

This seems to be a problem that lies between the browsers (eg faults in iOS) the creation of the SCORM package and the LMS (in this case the iFrames in Moodle).

One quite comprehensive idea for a work around is here: https://community.adaptlearning.org/mod/forum/discuss.php?d=180 but there is really no evidence at the moment of a nicer solution.

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?id=1951 SCORM forum]
* [http://danmarsden.com/blog/2012/08/08/scorm-doesnt-work-in-moodle SCORM doesn't work] blog post from developer Dan Marsden
* [http://danmarsden.com/blog/2009/05/23/scorm-2004-in-moodle/ SCORM 2004 in Moodle] blog post from developer Dan Marsden
* [https://moodle.org/mod/forum/discuss.php?d=276324 Identifiers to change with updated SCORM module]
* [https://docs.moodle.org/dev/SCORM_schema Internal SCORM Schema]
* The official standard: [http://www.adlnet.gov/Technologies/scorm/default.aspx Advanced Distributed Learning - SCORM]

Online resources
* [http://www.scormcourse.com/ SCORMCourse.com] serves the SCORM and ADL community as an educational resource for SCORM technology.
* [http://www.eduworks.com/index.php/Publications/Learning-Object-Tutorial.html Learning Object Tutorial]
* [http://elearningweekly.wordpress.com/2007/04/12/tutorial-build-scorm-compatible-lesson-templates-for-your-lms/ Tutorial: Build SCORM-Compatible Lesson Templates for Your LMS]

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=3757 Simple introduction to SCORM]
*[http://moodle.org/mod/forum/discuss.php?d=57059 Are there any sugestions for scorm authoring with Microsoft word / or any other easy (maybe free) scorm authoring tool?]
*[http://moodle.org/mod/forum/discuss.php?d=95946 Is SCORM worth it?]
*[http://moodle.org/mod/forum/discuss.php?d=207964 Updating an Object]

[[Category:FAQ]]
[[de:Lernpaket FAQ]]

Using SCORM

2016-09-15T00:12:07Z

Derekcx: Adding small comment

{{SCORM}}
{{Improve}}
Like a Moodle course, each SCORM package will vary with the modules used in its construction by the teacher and by the SCORM activity settings established by the teacher.

==Using SCORM and responsiveness on smaller screens==
At present there are some issues with responsiveness, since Moodle uses iFrames.

There are some work arounds described in this post: https://community.adaptlearning.org/mod/forum/discuss.php?d=180

The challenge is that browsers (like Safari on iOS), SCORM packages and the LMS (ie in this case Moodle) need to play together well. Catch 22's include "Use the Popup work around and you mess with the Desktop view" and "use the iFrame approach and you strike non-scrolling problems"

More information here: https://docs.moodle.org/32/en/SCORM_FAQ#Problems_with_responsiveness

==Features of student view==
*Preview and review mode options
*Checkboxes to indicate whether sections have been accessed previously
*Start new attempt
*Reset

==SCORM reports==

A teacher can access 4 report types for the SCORM activity via the reports tab:

* Basic report
* Graph report
* Interactions report
* Objectives report (for SCORM packages that use objective reporting)

[[File:SCORMReports.png|center|]]

Note: By default, users with the roles of manager, teacher and non-editing teacher are listed in SCORM reports. To prevent them being listed, edit the roles in ''Site administration > Users > Permissions > Define roles'' and unset the mod/scorm:savetrack capability.

===Basic report===

The basic report page shows a table of attempts for the SCORM activity. If you have the SCORM activity set up to allow multiple attempts, there may be more than one attempt for some users.

Selected attempts may be deleted by ticking the checkboxes then clicking the 'Delete selected attempts' button.

The basic report may be downloaded in ODS, Excel or text format.

A detailed report of each user's attempts may be obtained by clicking on the number in the attempts column. The track details link provides information on specific SCORM values recorded in Moodle by the SCORM object.

Note that the tracked details depend heavily upon what the SCORM object itself is programmed to report. Many SCORM packages created with authoring suites use the suspend_data field to record important information, instead of the traditional SCORM values. This makes deciphering the recorded data extremely difficult.

{|
| [[File:scorm basic report.png|thumb|Basic report]]
| [[File:scorm attempt.png|thumb|Detailed report for a specific user attempt]]
| [[File:scorm track details.png|thumb|Track details]]
|}

===Graph report===

The graph report displays graphs of percentage obtained against number of participants.

{|
| [[File:scorm graph_report.png|thumb|SCORM graph report]]
| [[File:multiscoes.png|thumb|Graph report for package consisting of multiple SCOs]]
|}

===SCORM interactions report===

The interactions report shows students' responses to questions together with the correct answers.

{|
| [[File:scorm interactions report.png|thumb|SCORM interactions report]]
|}

{{New features}}The interactions report may be downloaded in ODS, Excel or text format and include responses, right answers and (''new in 3.1'') results (whether the response to a question was right or wrong).

===Objectives report===
This report is similar to the interactions report but if a SCORM package is set up to report objectives then this report will display the status and raw.score of any objectives data passed back to Moodle.

[[fr:Voir un SCORM]]
[[ja:SCORMを表示する]]
[[de:Lernpaket nutzen]]
[[es:Uso de SCORM]]

SCORM FAQ

2016-09-07T22:36:23Z

Derekcx:

{{SCORM}}
==What is SCORM?==

SCORM was developed as a result of collaboration in the public and private sectors. The President of the United States, Bill Clinton issued an Executive Order that created an agency (ADL) to oversee the standard for developing and distributing online learning. All Federal agencies are mandated to use programs that meet those standards. SCORM is one result of that order.

There's a really simple "What is SCORM" introduction here: http://moodle.org/mod/forum/discuss.php?d=3757#p18828

A slightly more detailed introduction here: http://www.rusticisoftware.com/resources/whatisscorm/What%20Is%20SCORM.ht

==Should I make my Moodle courses as SCORM or use Moodle's features?==
It depends how you intend to use it. If you are planning on exporting and using in another LMS then SCORM would make this easier. If you want something shiny, then a SCORM package can fit the bill. However, reporting and grading work better in Moodle and for many educators the standard features do the job perfectly and do not require learning a new program. There is a useful form post discussing the pros and cons of SCORM in Moodle here: http://moodle.org/mod/forum/discuss.php?d=200242

==SCORM Information==

Advanced Distributed Learning (ADL) is the organization that wrote the SCORM standard. You can download documentation and samples form ADL's Web site. Documentation for SCORM 1.2 in several languages is available [http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Forms/AllItems.aspx?RootFolder=%2fTechnologies%2fscorm%2fSCORMSDocuments%2fPrevious%20Versions%2fSCORM%201.2%2fDocumentation%20Suite%20(SCORM%201.2)&FolderCTID=0x0120007F801FCD5325044C89D91240519482D7&View={4D6DFFDE-3CFC-4DD9-A21A-4B687728824A} here].

Philip Hutchison provides an AS3 and JavaScript wrapper, as well as a sample package:
http://pipwerks.com/downloads/

==SCORM Package Contents==

A SCORM package must contains in the root of zip a file named imsmanifest.xml which defines SCORM course structure, resource location and many other things. Other files used in the package, such as HTML files, XML files, multimedia files, and JavaScript for the SCORM API must be listed in this file. The LMS parses the manifest, and provides the files listed there to the content package during runtime.

==AICC Package Contents==

An AICC package is defined by several files (from 4 to 7) with defined extensions as follows:

* CRS - Course Description file (mandatory)
* AU - Assignable Unit file (mandatory)
* DES - Descriptor file (mandatory)
* CST - Course Structure file (mandatory)
* ORE - Objective Relationship file (optional)
* PRE - Prerequisites file (optional)
* CMP - Completition Requirements file (optional)

==Basic Troubleshooting==

* Make sure you are running Moodle 2.1 or higher, a large number of SCORM related bugs are present in previous versions.
*Make sure you (and your users) have JavaScript enabled. SCORM requires JavaScript.
* Make sure your SCORM object is SCORM compliant - check it in an external SCORM player like [https://docs.moodle.org/en/Tools_for_creating_SCORM_content#Reload Reload] to see if it works there.
* Upload a copy of your SCORM object to a [http://en.wikipedia.org/wiki/File_hosting_service File Hosting Service] and post a message asking for help in the forums, linking to your SCORM object explaining exactly what you expect to happen, and what is happening instead.
* Read Dan Marsden's blog post [http://danmarsden.com/blog/2012/08/08/scorm-doesnt-work-in-moodle here] (Maintainer of SCORM Module in Moodle)

==Does Moodle Generate SCORM Content?==

Moodle '''does not''' generate scorm content. Moodle presents the content in SCORM packages to learners, and saves data from learner interactions with the SCORM package.

==Can I add a password for access to my SCORM package?==
No, although there is a tracker request for this: MDL-46403 As a workaround you could add your SCORM package using the single activity course format - see [[Course formats]] - and add an enrolment key to the course.

==Supported Versions==

* SCORM 1.2 is supported in Moodle 2.1(or higher) and passes all the tests in the ADL Conformance test suite 1.2.7 for SCORM 1.2. The best place for information on SCORM 1.2 conformance is the [http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Previous%20Versions/SCORM%201.2/Conformance%20Test%20Suite%20(SCORM%201.2)/SCORM_1.2_ConformanceReq.pdf SCORM Comformance Requirements documentation (PDF 3.4MB)].

* SCORM 2004 is not supported in Moodle. Parts of the API have been implemented, but others such as Navigation and Sequencing have not. Development on native SCORM 2004 support in Moodle [https://moodle.org/mod/forum/discuss.php?d=227906 has stopped]. If you require a fully certified SCORM 2004 Player in Moodle, [http://www.scorm.com Rustici Software] have a [http://support.scorm.com/entries/20394726-scorm-cloud-moodle-module Moodle plugin] which connects to their commercial [http://www.scorm.com/scorm-solved/scorm-cloud/ SCORM Cloud] service turning Moodle into a fully compliant SCORM 2004 LMS.

* AICC objects are supported in Moodle 2.1 and higher.

* Moodle does not support Tin Can at this stage.

==Asking for Help in the SCORM Forum==

When trying to engage the community to help with a problem you are facing, you will get a better response if you follow a few simple guidelines:
* Always start your report with '''version information''' - preferably the information displayed on the Admin -> Environment panel eg. http://localhost/moodle/admin/environment.php where http://localhost/moodle is your particular prefix. With this it will be clear how you are running your Moodle instance, on what platform, and at which version. This will quickly expose issues where a simple upgrade will solve your problem.
* Be prepared to '''provide the SCORM package''' that illustrates your problem - if you don't then it will be very difficult for anyone offering assistance to recreate your situation - a real barrier to help.
* '''Screenshots''' are very helpful. Provide a screenshot of all error messages, and any instance where something seems to go wrong in the interface.
* Nonstandard themes can introduce SCORM issues. Be sure to tell us '''what theme you're using'''.
* If you have admin privileges, and have access to a localhost install or other place where real-time users won't be disturbed, be sure to turn on debugging. Navigate to '''Site Administration > Development > Debugging''' and set '''Debug messages: Developer''' and '''Display debug messages: Yes'''. Access the SCORM content. If there are errors printed to the page, include them in your forum post.
* Use [https://developers.google.com/chrome-developer-tools/docs/console Chrome's JavaScript Console] or [https://developer.mozilla.org/en-US/docs/Tools/Web_Console Firebug's JavaScript console] to check that there are no JavaScript errors on the page when the content loads.
* Run your problematic SCORM package through '''API debugging''' (see below) and include the text of that API log with your post. That way we can see right away if the right function calls are not taking place.
* If you're using a content development suite which publishes to SCORM, such as Articulate, Captivate, Lectora, LessonBuilder, Udutu, or some other product, then include that in your post. Every authoring software has its ticks, and if you've run into one, it's likely that someone else has also dealt with it, and will recognize it. However, please keep in mind that '''this is a place to get help with Moodle issues, not help with your SCORM package authoring suite'''.

==Debugging ==

# Debugging settings are located at Settings > Site Administration > Plugins > Activities > Scorm.
# Check the checkbox for '''Activate API debug...'''
# Set the api mask. You can use the mask to enable debugging under certain conditions. For example, if you are logged in using the admin user (username admin) you can set the api mask to: <cite>admin.*</cite> Users not logged in as admin will not see the debugging log. The "Default" api mask is <cite>.*</cite>

==What does the debugging log mean?==

The SCO commonly sends the following communications through the API:

* '''LMSInitialize();''' opens the connection between the SCO and Moodle
* '''LMSGetValue( 'valuename' );''' gets a value from Moodle
* '''LMSSetValue( 'valuename' , 'value' );''' sends a value to Moodle
* '''LMSCommit();''' saves values sent to Moodle via LMSSetValue() and should be called after every LMSSetValue()
* '''LMSFinish()''' saves values sent to Moodle and closes the connection between the SCO And Moodle

Red lines in the debugging log means there was an error in the communication through the API.

If LMSInitialize() fails, returns an error, then no subsequent values sent to Moodle will be saved.

Click through the entire SCORM package. Then access the scorm report for your attempt, and compare the saved values in the debugging log with Moodle's report of the attempt. If the values set in the debug log do not match the values saved to Moodle, then there may be a problem with Moodle. Otherwise it's likely to be an issue with the SCO or the SCORM activity settings not giving you the functionality you need.

==SCORM and the Gradebook==
Please see [https://docs.moodle.org/en/SCORM_FAQ#My_SCORM_Module_doesn.27t_function_properly FAQ:My SCORM Module doesn't function properly] and [https://docs.moodle.org/en/SCORM_FAQ#Handling_of_Multiple_Attempts FAQ:Handling of Multiple Attempts]

Some SCORM packages report both cmi.core.lesson_status and cmi.core.score.raw. Others report only cmi.core.lesson_status, or only cmi.core.score.raw. The '''Grading Method''' setting for SCORM objects is meant to account for that.

If you have the '''Grading Method''' set to '''Highest grade''', '''Average grade''', or '''Sum grade''', and your learning object does not report a score, only, cmi.core.lesson_status, then there will be no numerical score to pass to the gradebook.

If your SCOs do not report cmi.core.score.raw, then the best '''Grading Method''' setting is '''Learning Objects'''. This reports either a 1 or a 0 as a score for each learning object. The gradebook value for that SCORM activity is the percent of scos in the package for which learners got a 1.

On the other hand, if your SCOs do not report a lesson_status, then select one of the score-based '''Grading Method''' options, such as '''Highest grade''', '''Average grade''', or '''Sum grade''', and not '''Learning Objects'''.

If you do not know what your SCOs are reporting to the LMS, then run them through to completion with debugging on.

Much of the way SCORM objects are graded is controlled inside the SCORM Authoring process before it is packaged for use in an LMS like Moodle - make sure all your grading settings are set correctly.

==SCORM Administration Options==

See [[SCORM settings]]

==Common Solutions==

===Difficulty Displaying a SCORM Package===
If you have difficulty displaying a SCORM, try loading the SCORM in [http://www.reload.ac.uk Reload] and re-saving it, then save the folder as a .zip package and try again.

===Character Display Errors===
When you notice there is a problem displaying characters correctly, it could be a misconfiguration of your server. Make sure that both httpd.conf (when using Apache) and php.ini are set to DefaultCharacterset = utf8 or switch the sending of a default character set off.

===slash arguments warning when I add/update SCORM objects in my course===
Some web servers don't support a function called '''slash arguments''' and so Moodle allows you to turn it off, but SCORM packages require '''slash arguments''' to be enabled on the web server in order to work properly.

See [[Using slash arguments]] for more details.

===SCORM doesn't work on Godaddy Host===
Godaddy hosts give a 404 file not found error - this is because by default they do not allow slash arguments which SCORM requires. The best way to test this is to visit http://yourmoodlesite/admin/tool/health/index.php - but the fix involves adding a php.ini or php5.ini file with the following text:
AcceptPathInfo
cgi.fix_pathinfo=1

===My Flash-Based Content Loads, then Stalls===
This issue is most commonly associated with zlib compression. Classic presentation is that the base HTML file and SWF are loaded into the SCORM player, but the SWF is not able to load any audio or video assets, and therefore stalls. You can watch the loading of SWFs and assets using Chrome's Developer Tools or other.

Check your site's zlib compression settings as an admin by loading up the Server > phpinfo page. zlib compression is not a Moodle setting but a server setting, so you'll need a server admin to disable it. Be sure to Purge All Caches, and clear browser caches, before confirming the change.

===Zlib warning when I add/update SCORM objects in my course===
Zlib is a php compression setting made in a websites PHP configuration - unfortunately some browsers don't handle this well (especially Internet Explorer 6) Some webhosts enable this setting, but it will likely cause issues for your users when they attempt to view/use the SCORM object. You will need to contact your server administrator to turn this off. The setting to change in php configuration is "zlib.output_compression"

===Incorrect file package - missing imsmanifest.xml or AICC structure===
This means that Moodle cannot find a file called imsmanifest.xml inside the SCORM object. Reasons for this could be:
* imsmanifest.xml needs to be immediately inside the scorm directory, NOT inside a directory inside of that. So if the zipped scorm package is package.zip, the unzipped package directory should contain immediately inside of it the imsmanifest.xml. This is a common mistake and normally occurs when a SCORM author creates a package themselves and then selects that folder to compress. This places the content folder inside of another folder, The imsmanifest.xml is there, but it is 2 directories deep. To avoid this problem when zipping scorm content into a package, go INSIDE of the exported scorm folder, select all files inside, and compress them while all are selected. The resultant compressed directory has the imsmanifest.xml file in the first directory, immediately available to the moodle scorm loading process.
* when using linux based systems the filename imsmanifest.xml must be all in lowercase not IMSmanifest.xml or Imsmanifest.XML
* The SCORM authoring tool Articulate sometimes fails to create the imsmanifest.xml -Try exporting the package again and see if the manifest is generated.
* The SCORM authoring tool Articulate Presenter will publish packages where the imsmanifest.xml file is in the correct place, but there are several lines of white space in the manifest file if you do not fill out the Reporting and Tracking Options in Articulate Presenter for Keywords and LMS Description. Moodle will give a "Manifest not found" error when encountering this. To fix this problem select the Reporting and Tracking Options in the Articulate Presenter publish dialog and fill in the LMS Description and Keywords.

===File not found error===
You have this error if the scorm package is created in moodle, and the scorm menu loads, but inside of the viewing area for the scorm content, you get a page with a 404 file not found error, usually showing the current Moodle theme.

What this means is that one of the files listed in the imsmanifest.xml is not in the scorm package or not in the correct directory.

Download and unzip the package, open up imsmanifest.xml. At the bottom of the xml file, below any metadata, you'll find a place where organizations and resources for those organizations are designated:

<code xml>

<organizations default="TOC1">
<organization identifier="TOC1">
<title>SCORM Test</title>
<item identifier="I_SCO0" identifierref="SCO0">
<title>Library Quiz</title>
<adlcp:masteryscore>0</adlcp:masteryscore>
</item>
</organization>
</organizations>
<resources>
<resource identifier="SCO0" type="webcontent" adlcp:scormtype="sco" href="scorm.html">
<file href="scorm.html"/>
<dependency identifierref="ALLRESOURCES" />
</resource>
<resource identifier="ALLRESOURCES" type="webcontent" adlcp:scormtype="asset">
<file href="scorm.html" />
<file href="scorm.js" />
<file href="swfobject.js" />
<file href="scorm.swf" />
<file href="scormwrapper.js" />
</resource>
</resources>
</manifest>
</code>

In this xml, we have a single organization, and in that organization is a single resource, a single sco. There are 5 files necessary for that resource to work correctly. The scorm.html file is loaded first. It loads 3 external js files and a swf.

What you need to do now is go to the directory containing imsmanifest.xml, and check that all of those listed files are available at the correct path from imsmanfiest.xml, as listed in imsmanifest.xml. If any one of those files is missing (especially the html file or the swf), or if the paths in imsmanifest.xml are incorrect, then it's very likely that the scorm object won't be able to load at all.

Sometimes the files aren't missing, but are simply misnamed in the manifest, or placed in the wrong directory. You can fix this by moving the files to the correct places, or updating their names so that the imsmanifest and the actual file names match up. In the case of a misnamed file, change the manifest rather than the actual file names, since the the files also reference one another in other places!

===Unzip issues===
If you get a blank page after filling in the title, description, and selecting a large SCORM file, it's likely you haven't installed the PHP-zip lib which is required for Moodle 2.x for more info see [[admin/environment/php_extension/zip]]

===Clear an Attempt===
To clear attempts by a student:

# Go to the SCORM activity and select the link "View reports for x users"
# Select the attempt or attempts you want to clear using the checkbox
# Select Delete in the drop-down box at the bottom of the page

===Handling of Multiple Attempts===
SCORM is designed to allow a learner to exit and return at a later date to the same point they left from. This means that each time they enter the SCORM they are using the same single attempt. Some SCORM packages are intelligent about handling re-entry, many are not. What this means is that if the learner re-enters an existing attempt, if the SCORM content does not have internal logic to avoid overwriting cmi.core.lesson_status and cmi.core.score.raw, they can be overwritten by a lower score, confusing the learner.

When a SCORM sets the cmi.core.lesson_status value to 'completed', 'passed' or 'failed' then Moodle allows the user to create a new attempt by adding a '''Start new attempt''' checkbox to the entry page. If cmi.core.lesson_status is set to 'incomplete', 'browsed' or 'notattempted' the learner can only re-enter the existing attempt. If you are using the setting 'Student skip content structure page', this checkbox will never be shown to the user.

Moodle provides a range of settings to allow this to be controlled, some of these settings are hidden by default as advanced options.
* Number of attempts
:This allows the teacher to set how many SCORM attempts the learner may create - this is not how many times a learner can re-enter a SCORM attempt.
* Attempts grading
:This allows the teacher to set how multiple SCORM attempts(not re-entries) are graded. It is important to note that a 'failed' cmi.core_lesson_status allows a new attempt to be generated but the attempts grading setting "last completed attempt" only includes 'completed' and 'passed' values in it's calculations.
* Display attempt status
:This displays a users SCORM attempts and how their final grade is calculated on the SCORM entry page and the My Moodle page for the learner.
* Force completed
:This is a setting that can be used to force a SCORM package to report a 'completed' cmi.core.lesson_status if it doesn't currently set the value.
* Force new attempt
:This hides the '''Start new attempt''' checkbox and will force a new attempt if the previous attempt has cmi.core.lesson_status value to 'completed', 'passed' or 'failed' - this setting can also be used to make sure a new attempt is generated when the 'Student skip content structure page' setting is used.
* Lock after final attempt
:This prevents access to the SCORM after the total number of attempts have been used - if this is not set the learner can re-enter their last attempt and potentially change/overwrite their score each time depending on how the SCORM package supports multiple re-entries.

===Reducing Load Time with Captivate===
* Modify the percent that must be downloaded before the content starts to play. In Captivate 4, there's a setting in: Preferences / Project / Start and End / Preload. Reduce that to 50%.
* If you use audio in your Cp file (as background or element attachment), try to put a gap of 0,1 second at the beginning of each element including audio on your slides. If you don't do that, Cp merge all the audio files in one big audio file it need to download before playing the project. This problem have been report many times from the Cp community.

===Moodle changes cmi.core.lesson_status from "completed" or "passed" to "failed"===
Many SCORM authorware suites generate a masteryscore node in the imsmanifest.xml by default. This node is not necessary to the XML file. But when it is there, the SCORM standard designates specific behaviour with regard to the value set there.

This can also be controlled in Moodle using the setting "Mastery score overrides status" If this setting is enabled and a mastery score is provided within your package, when LMSFinish is called and a raw score has been set, if the raw score is lower than the mastery score, the lesson status will be overridden and set to "failed"

Here's what is in the scorm standard, on page 35 of 155 in SCORM_1.2_ConformanceReq.pdf, numbered page 2-19 ([http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Forms/AllItems.aspx?RootFolder=%2fTechnologies%2fscorm%2fSCORMSDocuments%2fPrevious%20Versions%2fSCORM%201%2e2%2fDocumentation%20Suite%20%28SCORM%201%2e2%29&FolderCTID=0x0120007F801FCD5325044C89D91240519482D7&View=%7b4D6DFFDE%2d3CFC%2d4DD9%2dA21A%2d4B687728824A%7d SCORM Version 1.2 Conformance Requirements Version 1.2]):
<blockquote>
If the value for this element is not set to “incomplete” by the SCO, then the LMS shall re-evaluate and change the value based on the following:<ul>
<li>If there is no mastery score in the Manifest, and the SCO sets a score (cmi.core.score.raw) and the lesson_status (cmi.core.lesson_status) then the LMS shall not override the SCO determined status.</li>
<li>If there is a mastery score in the Manifest, the LMS can change the status to either passed or failed depending on the student's score (cmi.core.score.raw) compared to the mastery score.</li>
<li>If the student is taking the SCO for no-credit, (cmi.core.credit = “no-credit”) there is no change to the lesson_status, with one exception. If the lesson_mode (cmi.core.lesson_mode) is "browse", the lesson_status may change to "browsed" even if the cmi.core.credit is set to no-credit.</li>
</ul>
</blockquote>
This can result in some functionality you don't intend. You can fix the problem by removing the mastery score node from your imsmanifest.xml file or by adjusting the Moodle setting "Mastery score overrides status". You may also want to find out what options you have, within your authorware suite, for the writing of that node into the manifest file, and change your authoring process accordingly.

The Rustici SCORM Cloud default operating behaviour for masteryscore is different from Moodle's default operating behaviour - you can see a little bit of the history around the way Rustici handle this here: http://scorm.com/blog/2010/09/anatomy-of-scorm-minutiae-mistake/

===Player Look 'n Feel===
You should be able to adjust height and width settings for the SCORM player window '''so long as''' your theme is based on/not too much of an aberration from one of the standard themes which ship with Moodle 2.

If your site or course theme isn't closely based on one of the standard M2 themes, then it's possible that your theme CSS is overriding local height and width settings for the SCORM player. Have a Web developer (or a Moodle Partner) examine how your theme is interacting with the player layout, and make changes to your theme as needed.

'''Why can't I just change it locally?''' You can change height and width per individual SCORM package, and you can set defaults for these local height and width values ( [[SCORM Admin Options]] ). Other things, such as colors, shading, borders, backgrounds, are controlled by CSS, just like everything else on the site.

=== Courselab 2.4 ===
If you receive a " found more than one record!" error when trying to run your SCORM 1.2 package check the imsmanifest.xml file of your SCORM package and ensure that the values for <organization identifier> and <item identifier> are unique. To change the <organization identifier>, in Courselab, go to File > Course Runtime Settings. The dialog says 'Course identification in LMS' but changing the Identifier field is what sets the <organization identifier>. (see MDL-38060 for more information)

=== SCORM results deleted after package update ===

When uploading a SCORM package over a previous one, if the item identifier in the manifest file is different to the one being overwritten then the tracking data for that SCORM package in Moodle is deleted.

Ensure the item identifier is the same for the new SCORM resource

===Problems with responsiveness===

Sometimes SCORMs fail on responsiveness or the ability to scroll on mobile devices

*Moodle uses iFrames for deploying SCORM. https://community.adaptlearning.org/mod/forum/discuss.php?d=180#p863
*There can be some problems with this as they are not responsive in iOS https://community.adaptlearning.org/mod/forum/discuss.php?d=1446#p6687
*There are some potential work arounds.
#Totara has a new window. #https://community.adaptlearning.org/mod/forum/discuss.php?d=851#p3968
#This comment https://community.adaptlearning.org/mod/forum/discuss.php?d=787#p3661
#Solutions for Adapt: https://github.com/adaptlearning/adapt_framework/issues/210
*The tracker:
#https://tracker.moodle.org/browse/MDL-47500 problems with pages.
#https://tracker.moodle.org/browse/MDL-46563
#https://tracker.moodle.org/browse/MDL-50401
*Why iFrames fail with iOS, one person's view: https://community.adaptlearning.org/mod/forum/discuss.php?d=926#p4714

This seems to be a problem that lies between the browsers (eg faults in iOS) the creation of the SCORM package and the LMS (in this case the iFrames in Moodle).

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?id=1951 SCORM forum]
* [http://danmarsden.com/blog/2012/08/08/scorm-doesnt-work-in-moodle SCORM doesn't work] blog post from developer Dan Marsden
* [http://danmarsden.com/blog/2009/05/23/scorm-2004-in-moodle/ SCORM 2004 in Moodle] blog post from developer Dan Marsden
* [https://moodle.org/mod/forum/discuss.php?d=276324 Identifiers to change with updated SCORM module]
* [https://docs.moodle.org/dev/SCORM_schema Internal SCORM Schema]
* The official standard: [http://www.adlnet.gov/Technologies/scorm/default.aspx Advanced Distributed Learning - SCORM]

Online resources
* [http://www.scormcourse.com/ SCORMCourse.com] serves the SCORM and ADL community as an educational resource for SCORM technology.
* [http://www.eduworks.com/index.php/Publications/Learning-Object-Tutorial.html Learning Object Tutorial]
* [http://elearningweekly.wordpress.com/2007/04/12/tutorial-build-scorm-compatible-lesson-templates-for-your-lms/ Tutorial: Build SCORM-Compatible Lesson Templates for Your LMS]

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=3757 Simple introduction to SCORM]
*[http://moodle.org/mod/forum/discuss.php?d=57059 Are there any sugestions for scorm authoring with Microsoft word / or any other easy (maybe free) scorm authoring tool?]
*[http://moodle.org/mod/forum/discuss.php?d=95946 Is SCORM worth it?]
*[http://moodle.org/mod/forum/discuss.php?d=207964 Updating an Object]

[[Category:FAQ]]
[[de:Lernpaket FAQ]]

SCORM FAQ

2016-09-06T01:52:37Z

Derekcx: Adding in comment on iFrames

{{SCORM}}
==What is SCORM?==

SCORM was developed as a result of collaboration in the public and private sectors. The President of the United States, Bill Clinton issued an Executive Order that created an agency (ADL) to oversee the standard for developing and distributing online learning. All Federal agencies are mandated to use programs that meet those standards. SCORM is one result of that order.

There's a really simple "What is SCORM" introduction here: http://moodle.org/mod/forum/discuss.php?d=3757#p18828

A slightly more detailed introduction here: http://www.rusticisoftware.com/resources/whatisscorm/What%20Is%20SCORM.ht

==Should I make my Moodle courses as SCORM or use Moodle's features?==
It depends how you intend to use it. If you are planning on exporting and using in another LMS then SCORM would make this easier. If you want something shiny, then a SCORM package can fit the bill. However, reporting and grading work better in Moodle and for many educators the standard features do the job perfectly and do not require learning a new program. There is a useful form post discussing the pros and cons of SCORM in Moodle here: http://moodle.org/mod/forum/discuss.php?d=200242

==SCORM Information==

Advanced Distributed Learning (ADL) is the organization that wrote the SCORM standard. You can download documentation and samples form ADL's Web site. Documentation for SCORM 1.2 in several languages is available [http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Forms/AllItems.aspx?RootFolder=%2fTechnologies%2fscorm%2fSCORMSDocuments%2fPrevious%20Versions%2fSCORM%201.2%2fDocumentation%20Suite%20(SCORM%201.2)&FolderCTID=0x0120007F801FCD5325044C89D91240519482D7&View={4D6DFFDE-3CFC-4DD9-A21A-4B687728824A} here].

Philip Hutchison provides an AS3 and JavaScript wrapper, as well as a sample package:
http://pipwerks.com/downloads/

==SCORM Package Contents==

A SCORM package must contains in the root of zip a file named imsmanifest.xml which defines SCORM course structure, resource location and many other things. Other files used in the package, such as HTML files, XML files, multimedia files, and JavaScript for the SCORM API must be listed in this file. The LMS parses the manifest, and provides the files listed there to the content package during runtime.

==AICC Package Contents==

An AICC package is defined by several files (from 4 to 7) with defined extensions as follows:

* CRS - Course Description file (mandatory)
* AU - Assignable Unit file (mandatory)
* DES - Descriptor file (mandatory)
* CST - Course Structure file (mandatory)
* ORE - Objective Relationship file (optional)
* PRE - Prerequisites file (optional)
* CMP - Completition Requirements file (optional)

==Basic Troubleshooting==

* Make sure you are running Moodle 2.1 or higher, a large number of SCORM related bugs are present in previous versions.
*Make sure you (and your users) have JavaScript enabled. SCORM requires JavaScript.
* Make sure your SCORM object is SCORM compliant - check it in an external SCORM player like [https://docs.moodle.org/en/Tools_for_creating_SCORM_content#Reload Reload] to see if it works there.
* Upload a copy of your SCORM object to a [http://en.wikipedia.org/wiki/File_hosting_service File Hosting Service] and post a message asking for help in the forums, linking to your SCORM object explaining exactly what you expect to happen, and what is happening instead.
* Read Dan Marsden's blog post [http://danmarsden.com/blog/2012/08/08/scorm-doesnt-work-in-moodle here] (Maintainer of SCORM Module in Moodle)

==Does Moodle Generate SCORM Content?==

Moodle '''does not''' generate scorm content. Moodle presents the content in SCORM packages to learners, and saves data from learner interactions with the SCORM package.

==Can I add a password for access to my SCORM package?==
No, although there is a tracker request for this: MDL-46403 As a workaround you could add your SCORM package using the single activity course format - see [[Course formats]] - and add an enrolment key to the course.

==Supported Versions==

* SCORM 1.2 is supported in Moodle 2.1(or higher) and passes all the tests in the ADL Conformance test suite 1.2.7 for SCORM 1.2. The best place for information on SCORM 1.2 conformance is the [http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Previous%20Versions/SCORM%201.2/Conformance%20Test%20Suite%20(SCORM%201.2)/SCORM_1.2_ConformanceReq.pdf SCORM Comformance Requirements documentation (PDF 3.4MB)].

* SCORM 2004 is not supported in Moodle. Parts of the API have been implemented, but others such as Navigation and Sequencing have not. Development on native SCORM 2004 support in Moodle [https://moodle.org/mod/forum/discuss.php?d=227906 has stopped]. If you require a fully certified SCORM 2004 Player in Moodle, [http://www.scorm.com Rustici Software] have a [http://support.scorm.com/entries/20394726-scorm-cloud-moodle-module Moodle plugin] which connects to their commercial [http://www.scorm.com/scorm-solved/scorm-cloud/ SCORM Cloud] service turning Moodle into a fully compliant SCORM 2004 LMS.

* AICC objects are supported in Moodle 2.1 and higher.

* Moodle does not support Tin Can at this stage.

==Asking for Help in the SCORM Forum==

When trying to engage the community to help with a problem you are facing, you will get a better response if you follow a few simple guidelines:
* Always start your report with '''version information''' - preferably the information displayed on the Admin -> Environment panel eg. http://localhost/moodle/admin/environment.php where http://localhost/moodle is your particular prefix. With this it will be clear how you are running your Moodle instance, on what platform, and at which version. This will quickly expose issues where a simple upgrade will solve your problem.
* Be prepared to '''provide the SCORM package''' that illustrates your problem - if you don't then it will be very difficult for anyone offering assistance to recreate your situation - a real barrier to help.
* '''Screenshots''' are very helpful. Provide a screenshot of all error messages, and any instance where something seems to go wrong in the interface.
* Nonstandard themes can introduce SCORM issues. Be sure to tell us '''what theme you're using'''.
* If you have admin privileges, and have access to a localhost install or other place where real-time users won't be disturbed, be sure to turn on debugging. Navigate to '''Site Administration > Development > Debugging''' and set '''Debug messages: Developer''' and '''Display debug messages: Yes'''. Access the SCORM content. If there are errors printed to the page, include them in your forum post.
* Use [https://developers.google.com/chrome-developer-tools/docs/console Chrome's JavaScript Console] or [https://developer.mozilla.org/en-US/docs/Tools/Web_Console Firebug's JavaScript console] to check that there are no JavaScript errors on the page when the content loads.
* Run your problematic SCORM package through '''API debugging''' (see below) and include the text of that API log with your post. That way we can see right away if the right function calls are not taking place.
* If you're using a content development suite which publishes to SCORM, such as Articulate, Captivate, Lectora, LessonBuilder, Udutu, or some other product, then include that in your post. Every authoring software has its ticks, and if you've run into one, it's likely that someone else has also dealt with it, and will recognize it. However, please keep in mind that '''this is a place to get help with Moodle issues, not help with your SCORM package authoring suite'''.

==Debugging ==

# Debugging settings are located at Settings > Site Administration > Plugins > Activities > Scorm.
# Check the checkbox for '''Activate API debug...'''
# Set the api mask. You can use the mask to enable debugging under certain conditions. For example, if you are logged in using the admin user (username admin) you can set the api mask to: <cite>admin.*</cite> Users not logged in as admin will not see the debugging log. The "Default" api mask is <cite>.*</cite>

==What does the debugging log mean?==

The SCO commonly sends the following communications through the API:

* '''LMSInitialize();''' opens the connection between the SCO and Moodle
* '''LMSGetValue( 'valuename' );''' gets a value from Moodle
* '''LMSSetValue( 'valuename' , 'value' );''' sends a value to Moodle
* '''LMSCommit();''' saves values sent to Moodle via LMSSetValue() and should be called after every LMSSetValue()
* '''LMSFinish()''' saves values sent to Moodle and closes the connection between the SCO And Moodle

Red lines in the debugging log means there was an error in the communication through the API.

If LMSInitialize() fails, returns an error, then no subsequent values sent to Moodle will be saved.

Click through the entire SCORM package. Then access the scorm report for your attempt, and compare the saved values in the debugging log with Moodle's report of the attempt. If the values set in the debug log do not match the values saved to Moodle, then there may be a problem with Moodle. Otherwise it's likely to be an issue with the SCO or the SCORM activity settings not giving you the functionality you need.

==SCORM and the Gradebook==
Please see [https://docs.moodle.org/en/SCORM_FAQ#My_SCORM_Module_doesn.27t_function_properly FAQ:My SCORM Module doesn't function properly] and [https://docs.moodle.org/en/SCORM_FAQ#Handling_of_Multiple_Attempts FAQ:Handling of Multiple Attempts]

Some SCORM packages report both cmi.core.lesson_status and cmi.core.score.raw. Others report only cmi.core.lesson_status, or only cmi.core.score.raw. The '''Grading Method''' setting for SCORM objects is meant to account for that.

If you have the '''Grading Method''' set to '''Highest grade''', '''Average grade''', or '''Sum grade''', and your learning object does not report a score, only, cmi.core.lesson_status, then there will be no numerical score to pass to the gradebook.

If your SCOs do not report cmi.core.score.raw, then the best '''Grading Method''' setting is '''Learning Objects'''. This reports either a 1 or a 0 as a score for each learning object. The gradebook value for that SCORM activity is the percent of scos in the package for which learners got a 1.

On the other hand, if your SCOs do not report a lesson_status, then select one of the score-based '''Grading Method''' options, such as '''Highest grade''', '''Average grade''', or '''Sum grade''', and not '''Learning Objects'''.

If you do not know what your SCOs are reporting to the LMS, then run them through to completion with debugging on.

Much of the way SCORM objects are graded is controlled inside the SCORM Authoring process before it is packaged for use in an LMS like Moodle - make sure all your grading settings are set correctly.

==SCORM Administration Options==

See [[SCORM settings]]

==Common Solutions==

===Difficulty Displaying a SCORM Package===
If you have difficulty displaying a SCORM, try loading the SCORM in [http://www.reload.ac.uk Reload] and re-saving it, then save the folder as a .zip package and try again.

===Character Display Errors===
When you notice there is a problem displaying characters correctly, it could be a misconfiguration of your server. Make sure that both httpd.conf (when using Apache) and php.ini are set to DefaultCharacterset = utf8 or switch the sending of a default character set off.

===slash arguments warning when I add/update SCORM objects in my course===
Some web servers don't support a function called '''slash arguments''' and so Moodle allows you to turn it off, but SCORM packages require '''slash arguments''' to be enabled on the web server in order to work properly.

See [[Using slash arguments]] for more details.

===SCORM doesn't work on Godaddy Host===
Godaddy hosts give a 404 file not found error - this is because by default they do not allow slash arguments which SCORM requires. The best way to test this is to visit http://yourmoodlesite/admin/tool/health/index.php - but the fix involves adding a php.ini or php5.ini file with the following text:
AcceptPathInfo
cgi.fix_pathinfo=1

===My Flash-Based Content Loads, then Stalls===
This issue is most commonly associated with zlib compression. Classic presentation is that the base HTML file and SWF are loaded into the SCORM player, but the SWF is not able to load any audio or video assets, and therefore stalls. You can watch the loading of SWFs and assets using Chrome's Developer Tools or other.

Check your site's zlib compression settings as an admin by loading up the Server > phpinfo page. zlib compression is not a Moodle setting but a server setting, so you'll need a server admin to disable it. Be sure to Purge All Caches, and clear browser caches, before confirming the change.

===Zlib warning when I add/update SCORM objects in my course===
Zlib is a php compression setting made in a websites PHP configuration - unfortunately some browsers don't handle this well (especially Internet Explorer 6) Some webhosts enable this setting, but it will likely cause issues for your users when they attempt to view/use the SCORM object. You will need to contact your server administrator to turn this off. The setting to change in php configuration is "zlib.output_compression"

===Incorrect file package - missing imsmanifest.xml or AICC structure===
This means that Moodle cannot find a file called imsmanifest.xml inside the SCORM object. Reasons for this could be:
* imsmanifest.xml needs to be immediately inside the scorm directory, NOT inside a directory inside of that. So if the zipped scorm package is package.zip, the unzipped package directory should contain immediately inside of it the imsmanifest.xml. This is a common mistake and normally occurs when a SCORM author creates a package themselves and then selects that folder to compress. This places the content folder inside of another folder, The imsmanifest.xml is there, but it is 2 directories deep. To avoid this problem when zipping scorm content into a package, go INSIDE of the exported scorm folder, select all files inside, and compress them while all are selected. The resultant compressed directory has the imsmanifest.xml file in the first directory, immediately available to the moodle scorm loading process.
* when using linux based systems the filename imsmanifest.xml must be all in lowercase not IMSmanifest.xml or Imsmanifest.XML
* The SCORM authoring tool Articulate sometimes fails to create the imsmanifest.xml -Try exporting the package again and see if the manifest is generated.
* The SCORM authoring tool Articulate Presenter will publish packages where the imsmanifest.xml file is in the correct place, but there are several lines of white space in the manifest file if you do not fill out the Reporting and Tracking Options in Articulate Presenter for Keywords and LMS Description. Moodle will give a "Manifest not found" error when encountering this. To fix this problem select the Reporting and Tracking Options in the Articulate Presenter publish dialog and fill in the LMS Description and Keywords.

===File not found error===
You have this error if the scorm package is created in moodle, and the scorm menu loads, but inside of the viewing area for the scorm content, you get a page with a 404 file not found error, usually showing the current Moodle theme.

What this means is that one of the files listed in the imsmanifest.xml is not in the scorm package or not in the correct directory.

Download and unzip the package, open up imsmanifest.xml. At the bottom of the xml file, below any metadata, you'll find a place where organizations and resources for those organizations are designated:

<code xml>

<organizations default="TOC1">
<organization identifier="TOC1">
<title>SCORM Test</title>
<item identifier="I_SCO0" identifierref="SCO0">
<title>Library Quiz</title>
<adlcp:masteryscore>0</adlcp:masteryscore>
</item>
</organization>
</organizations>
<resources>
<resource identifier="SCO0" type="webcontent" adlcp:scormtype="sco" href="scorm.html">
<file href="scorm.html"/>
<dependency identifierref="ALLRESOURCES" />
</resource>
<resource identifier="ALLRESOURCES" type="webcontent" adlcp:scormtype="asset">
<file href="scorm.html" />
<file href="scorm.js" />
<file href="swfobject.js" />
<file href="scorm.swf" />
<file href="scormwrapper.js" />
</resource>
</resources>
</manifest>
</code>

In this xml, we have a single organization, and in that organization is a single resource, a single sco. There are 5 files necessary for that resource to work correctly. The scorm.html file is loaded first. It loads 3 external js files and a swf.

What you need to do now is go to the directory containing imsmanifest.xml, and check that all of those listed files are available at the correct path from imsmanfiest.xml, as listed in imsmanifest.xml. If any one of those files is missing (especially the html file or the swf), or if the paths in imsmanifest.xml are incorrect, then it's very likely that the scorm object won't be able to load at all.

Sometimes the files aren't missing, but are simply misnamed in the manifest, or placed in the wrong directory. You can fix this by moving the files to the correct places, or updating their names so that the imsmanifest and the actual file names match up. In the case of a misnamed file, change the manifest rather than the actual file names, since the the files also reference one another in other places!

===Unzip issues===
If you get a blank page after filling in the title, description, and selecting a large SCORM file, it's likely you haven't installed the PHP-zip lib which is required for Moodle 2.x for more info see [[admin/environment/php_extension/zip]]

===Clear an Attempt===
To clear attempts by a student:

# Go to the SCORM activity and select the link "View reports for x users"
# Select the attempt or attempts you want to clear using the checkbox
# Select Delete in the drop-down box at the bottom of the page

===Handling of Multiple Attempts===
SCORM is designed to allow a learner to exit and return at a later date to the same point they left from. This means that each time they enter the SCORM they are using the same single attempt. Some SCORM packages are intelligent about handling re-entry, many are not. What this means is that if the learner re-enters an existing attempt, if the SCORM content does not have internal logic to avoid overwriting cmi.core.lesson_status and cmi.core.score.raw, they can be overwritten by a lower score, confusing the learner.

When a SCORM sets the cmi.core.lesson_status value to 'completed', 'passed' or 'failed' then Moodle allows the user to create a new attempt by adding a '''Start new attempt''' checkbox to the entry page. If cmi.core.lesson_status is set to 'incomplete', 'browsed' or 'notattempted' the learner can only re-enter the existing attempt. If you are using the setting 'Student skip content structure page', this checkbox will never be shown to the user.

Moodle provides a range of settings to allow this to be controlled, some of these settings are hidden by default as advanced options.
* Number of attempts
:This allows the teacher to set how many SCORM attempts the learner may create - this is not how many times a learner can re-enter a SCORM attempt.
* Attempts grading
:This allows the teacher to set how multiple SCORM attempts(not re-entries) are graded. It is important to note that a 'failed' cmi.core_lesson_status allows a new attempt to be generated but the attempts grading setting "last completed attempt" only includes 'completed' and 'passed' values in it's calculations.
* Display attempt status
:This displays a users SCORM attempts and how their final grade is calculated on the SCORM entry page and the My Moodle page for the learner.
* Force completed
:This is a setting that can be used to force a SCORM package to report a 'completed' cmi.core.lesson_status if it doesn't currently set the value.
* Force new attempt
:This hides the '''Start new attempt''' checkbox and will force a new attempt if the previous attempt has cmi.core.lesson_status value to 'completed', 'passed' or 'failed' - this setting can also be used to make sure a new attempt is generated when the 'Student skip content structure page' setting is used.
* Lock after final attempt
:This prevents access to the SCORM after the total number of attempts have been used - if this is not set the learner can re-enter their last attempt and potentially change/overwrite their score each time depending on how the SCORM package supports multiple re-entries.

===Reducing Load Time with Captivate===
* Modify the percent that must be downloaded before the content starts to play. In Captivate 4, there's a setting in: Preferences / Project / Start and End / Preload. Reduce that to 50%.
* If you use audio in your Cp file (as background or element attachment), try to put a gap of 0,1 second at the beginning of each element including audio on your slides. If you don't do that, Cp merge all the audio files in one big audio file it need to download before playing the project. This problem have been report many times from the Cp community.

===Moodle changes cmi.core.lesson_status from "completed" or "passed" to "failed"===
Many SCORM authorware suites generate a masteryscore node in the imsmanifest.xml by default. This node is not necessary to the XML file. But when it is there, the SCORM standard designates specific behaviour with regard to the value set there.

This can also be controlled in Moodle using the setting "Mastery score overrides status" If this setting is enabled and a mastery score is provided within your package, when LMSFinish is called and a raw score has been set, if the raw score is lower than the mastery score, the lesson status will be overridden and set to "failed"

Here's what is in the scorm standard, on page 35 of 155 in SCORM_1.2_ConformanceReq.pdf, numbered page 2-19 ([http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Forms/AllItems.aspx?RootFolder=%2fTechnologies%2fscorm%2fSCORMSDocuments%2fPrevious%20Versions%2fSCORM%201%2e2%2fDocumentation%20Suite%20%28SCORM%201%2e2%29&FolderCTID=0x0120007F801FCD5325044C89D91240519482D7&View=%7b4D6DFFDE%2d3CFC%2d4DD9%2dA21A%2d4B687728824A%7d SCORM Version 1.2 Conformance Requirements Version 1.2]):
<blockquote>
If the value for this element is not set to “incomplete” by the SCO, then the LMS shall re-evaluate and change the value based on the following:<ul>
<li>If there is no mastery score in the Manifest, and the SCO sets a score (cmi.core.score.raw) and the lesson_status (cmi.core.lesson_status) then the LMS shall not override the SCO determined status.</li>
<li>If there is a mastery score in the Manifest, the LMS can change the status to either passed or failed depending on the student's score (cmi.core.score.raw) compared to the mastery score.</li>
<li>If the student is taking the SCO for no-credit, (cmi.core.credit = “no-credit”) there is no change to the lesson_status, with one exception. If the lesson_mode (cmi.core.lesson_mode) is "browse", the lesson_status may change to "browsed" even if the cmi.core.credit is set to no-credit.</li>
</ul>
</blockquote>
This can result in some functionality you don't intend. You can fix the problem by removing the mastery score node from your imsmanifest.xml file or by adjusting the Moodle setting "Mastery score overrides status". You may also want to find out what options you have, within your authorware suite, for the writing of that node into the manifest file, and change your authoring process accordingly.

The Rustici SCORM Cloud default operating behaviour for masteryscore is different from Moodle's default operating behaviour - you can see a little bit of the history around the way Rustici handle this here: http://scorm.com/blog/2010/09/anatomy-of-scorm-minutiae-mistake/

===Player Look 'n Feel===
You should be able to adjust height and width settings for the SCORM player window '''so long as''' your theme is based on/not too much of an aberration from one of the standard themes which ship with Moodle 2.

If your site or course theme isn't closely based on one of the standard M2 themes, then it's possible that your theme CSS is overriding local height and width settings for the SCORM player. Have a Web developer (or a Moodle Partner) examine how your theme is interacting with the player layout, and make changes to your theme as needed.

'''Why can't I just change it locally?''' You can change height and width per individual SCORM package, and you can set defaults for these local height and width values ( [[SCORM Admin Options]] ). Other things, such as colors, shading, borders, backgrounds, are controlled by CSS, just like everything else on the site.

=== Courselab 2.4 ===
If you receive a " found more than one record!" error when trying to run your SCORM 1.2 package check the imsmanifest.xml file of your SCORM package and ensure that the values for <organization identifier> and <item identifier> are unique. To change the <organization identifier>, in Courselab, go to File > Course Runtime Settings. The dialog says 'Course identification in LMS' but changing the Identifier field is what sets the <organization identifier>. (see MDL-38060 for more information)

=== SCORM results deleted after package update ===

When uploading a SCORM package over a previous one, if the item identifier in the manifest file is different to the one being overwritten then the tracking data for that SCORM package in Moodle is deleted.

Ensure the item identifier is the same for the new SCORM resource

===Problems with responsiveness===

Sometimes SCORMs fail on responsiveness or the ability to scroll on mobile devices

*Moodle uses iFrames for deploying SCORM. https://community.adaptlearning.org/mod/forum/discuss.php?d=180#p863
*There can be some problems with this as they are not responsive in iOS https://community.adaptlearning.org/mod/forum/discuss.php?d=1446#p6687
*There are some potential work arounds.
#Totara has a new window. #https://community.adaptlearning.org/mod/forum/discuss.php?d=851#p3968
#This comment https://community.adaptlearning.org/mod/forum/discuss.php?d=787#p3661
#Solutions for Adapt: https://github.com/adaptlearning/adapt_framework/issues/210
*The tracker:
#https://tracker.moodle.org/browse/MDL-47500 problems with pages.
#https://tracker.moodle.org/browse/MDL-46563
#https://tracker.moodle.org/browse/MDL-50401

This seems to be a problem that lies between the browsers (eg faults in iOS) the creation of the SCORM package and the LMS (in this case the iFrames in Moodle).

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?id=1951 SCORM forum]
* [http://danmarsden.com/blog/2012/08/08/scorm-doesnt-work-in-moodle SCORM doesn't work] blog post from developer Dan Marsden
* [http://danmarsden.com/blog/2009/05/23/scorm-2004-in-moodle/ SCORM 2004 in Moodle] blog post from developer Dan Marsden
* [https://moodle.org/mod/forum/discuss.php?d=276324 Identifiers to change with updated SCORM module]
* [https://docs.moodle.org/dev/SCORM_schema Internal SCORM Schema]
* The official standard: [http://www.adlnet.gov/Technologies/scorm/default.aspx Advanced Distributed Learning - SCORM]

Online resources
* [http://www.scormcourse.com/ SCORMCourse.com] serves the SCORM and ADL community as an educational resource for SCORM technology.
* [http://www.eduworks.com/index.php/Publications/Learning-Object-Tutorial.html Learning Object Tutorial]
* [http://elearningweekly.wordpress.com/2007/04/12/tutorial-build-scorm-compatible-lesson-templates-for-your-lms/ Tutorial: Build SCORM-Compatible Lesson Templates for Your LMS]

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=3757 Simple introduction to SCORM]
*[http://moodle.org/mod/forum/discuss.php?d=57059 Are there any sugestions for scorm authoring with Microsoft word / or any other easy (maybe free) scorm authoring tool?]
*[http://moodle.org/mod/forum/discuss.php?d=95946 Is SCORM worth it?]
*[http://moodle.org/mod/forum/discuss.php?d=207964 Updating an Object]

[[Category:FAQ]]
[[de:Lernpaket FAQ]]

Multimedia plugins filter

2015-09-20T09:24:15Z

Derekcx: Added more links

{{Filters}}
The Multimedia plugins filter finds a link in text that points to a multimedia resource and replaces the link with an appropriate multimedia player code which can play the resource. The actual player resides on each users' computer.

For example, a teacher may put a MP3 audio file as a resource in their course, or have a URL link to an external MP3 file. When the MP3 audio plugin has been turned on, the student will be able to play them in Moodle using a media player on their computer. See also [[Media embedding]].

== Site administration settings ==

A site administrator can enable the multimedia plugins filter in ''Administration > Site administration > Plugins > Filters'' and can enable selected media players in ''Administration > Site administration > Appearance > Media embedding''.

Note: Prior to Moodle 2.3, settings for enabling selected media players could be found as multimedia plugins filter settings.

== Required software on user's computer ==

Although Moodle prepares the media files to be played in the browser, the actual playback is handled by various types of browser plug-in software, primarily Adobe Flash, Quicktime, Windows Media Player and Real Player. If users do not have these installed they may be prompted to go and install them by their browser. These pieces of software are generally free, easily installed and widely used so this will only be an issue for small numbers of users.

== See also ==

* [[Multimedia plugins FAQ]]
* [[Video| Video]]
* [[Audio| Audio]]

Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=98698 swf filter security]
* [http://moodle.org/mod/forum/discuss.php?d=125619 How to upload a screen capture video to the Moodle?]
===Best Video Formats===
This could do with a little updating/editing. (Feel free to edit)
* [http://moodle.org/mod/forum/discuss.php?d=143478 Best video format]
*https://moodle.org/mod/forum/discuss.php?d=306025
*https://moodle.org/mod/forum/discuss.php?d=228303
*https://moodle.org/mod/forum/discuss.php?d=185879

[[Category:Site administration]]
[[Category:Multimedia]]

[[de:Multimedia-Plugins]]
[[es:Filtro_de_plugins_multimedia]]
[[fr:Extensions multimédia]]
[[es:Multimedia plugins (filtro)|Multimedia plugins]]
[[ja:マルチメディアプラグイン]]

Media FAQ

2015-09-20T09:20:07Z

Derekcx: Adding extra info

{{Working with media}}
==Should I put my video into a label or a page?==
While the embedding process is the same, adding a video to a label will mean it displays as soon as the user clicks on that course page. This can be beneficial if the video is, for example, an introduction to the course or an integral part of the whole course. However, if there are several videos in labels, they can slow the loading of the course down, especially if the videos are coming from an external site. Adding a video to a page in Moodle means that the user has to click a text link to reach the video, but it doesn't clutter up the main course page and it is a better choice if the course contains a large number of videos.

==My embedded video is too big/small. How can I change its display size?==
Changing the size of an embedded video depends on whether you're using Moodle's [[Multimedia plugins filter]] or if you're either embedding a video from another source using something like an iframe (for example, embedding a video from YouTube using the embed code they provide).

====If you're using Moodle's Mulimedia plugins filter:====
Your video will appear to you in the html editor as a hyperlink. Whether it's a video hosted elsewhere (ie Vimeo or Youtube) or a file you've uploaded yourself, it will still appear as a hyperlink. After you've saved this html, Moodle's Multimedia filter will turn that hyperlink into an embedded video. In order to change the video's size you need to:
#Open the HTML Source Editor by clicking the HTML code icon: [[File:Htmlcodeicon.png]]
#Find the <a href...> code for the video you want to change. In the href="LINK" section of your code, place your cursor right before the last quotation mark.
#Type "?d=100x200" where you're replacing "100" with your desired width and "200" with your desired height. For example, if you want a video that's 600 x 325, you would type ?d=600x325." [[File:Resizevideo.png]]
#Your <a> tag should now look something like the following: If you're working with a file you've uploaded yourself: <a href="https://yourschool.edu/draftfile.php?file=/135/user/draft/617331337/Module%.mp4?d=425x234">. In this example, your uploaded video would be embedded at 425x234. If you're working with an externally hosted file: <a href="https://www.youtube.com/watch?v=TubRpuaNVT4d?600x135">. In this example, the YouTube video would be embedded at 600x135.
#Click "update" in the HTML source editor screen, and save your changes.
#Your video should now be the new size.

====If you're using an embed code, such as an iframe, it's a little easier:====
#Open the HTML Source Editor, as above
#Locate the <iframe> tag or equivalent.
#Inside that iframe should be "width" and "height" variables, which you can adjust as needed. [[File:Youtuberesize.png]]
#Click "update" in the HTML source editor screen, and save your changes.
#Your video should now be the new size.

==Why is the size and player for MP4 video clips hard coded?==
*Not sure. If anyone from out there knows, so far they have not let on any reasons. See MDL-43385
*The code: https://moodle.org/mod/forum/discuss.php?d=266340#p1152013

The video is resized because the MP4 filter calls the Quicktime plugin with a predefined size of 400x315 px:

<object *** width="400" height="315">
<param name="pluginspage" value="http://www.apple.com/quicktime/download/" />
<param name="src" value="http://localhost/moodle25/pluginfile.php/100/mod_resource/content/0/video.mp4" />

If you rename the file to an FLV extension before uploading, then the video will be processed by Flowplayer.

==Why won't my swf video play?==
The .swf format carries with it some security issues and so the filter that allows it to display is disabled by default. For you to be able to add .swf videos, your administrator needs to enable the filter in [[Multimedia_plugins|Multimedia plugins]], then to go to ''Site Administration>Security>Site policies'' and check the "enable trusted content" box. They then need to go to ''Site Administration>Users>Permissions>Define roles'' and allow Trust Submitted content ''moodle/site:trustcontent'' for your role. However; swf will still not display in all areas of Moodle, for example forum posts. See this discussion [http://moodle.org/mod/forum/discuss.php?d=183681#p800390| here]

==How can I convert my video file to an .FLV or other format?==
*There are many sites online that allow you to upload a file which will then be converted and sent to you via a link or email. Zamzar [http://www.zamzar.com]or Youconvertit [http://www.youconvertit.com] are just two examples.
*However, if it is a large video file or you want to do the conversion off line, then the free Any Video Converter [http://www.any-video-converter.com/products/for_video_free/] (a downloadable program) will convert most video formats to most others.
*More and more full-featured MTS Video Converter [http://www.mtsconverterfree.com/]software free download a trial, to solve your problem more format conversions.
*The free and open source video player, VLC has the ability to convert to and from many video formats. For more details and downloads [http://www.videolan.org/vlc/ visit their site].
*If you are using Linux as your operating system either ffmpeg or avconv can both convert to FLV.

== I have a .wma/wav file. How can I play it in Moodle's player?==
*There are various free programs available that will convert one type of sound file to another. If you convert your file to an mp3 then you will be able to use Moodle's built-in mp3 player.
*Jodix Free WMA to MP3 converter [http://www.wma-mp3.org/] is just one example

== I have an MP4 file. How can I play it in Moodle's player? (ie Flowplayer)==
This section is a little sparse, and if you can improve it, feel free.

It seems that the media filter is hard coded to NOT use Flowplayer for MP4.
*See the discussion here: https://moodle.org/mod/forum/discuss.php?d=208849#p914927. Renaming an MP4 to an FLV seems to create a file that will play in Flowplayer.
Also: https://moodle.org/mod/forum/discuss.php?d=271199
*See the discussion here: https://docs.moodle.org/dev/Media_embedding
*See the discussion about [https://moodle.org/mod/forum/discuss.php?d=232296#p1048676 how to play mp4 videos in Moodle]

You can vote for a change here: MDL-43385

== What's the best way to manage/deploy MP4 files in Moodle? ==
And why bother about this? MP4 is probably the most common format, and it will play on both Flash enabled and disabled devices. It's a common question.

See above. Until we find out more information, it's difficult to get MP4 files into Moodle simply AND playing nicely. ie pick ONE.
#To play nicely: you need to do complex embedding etc. So it's not simple.
#To get them in simply: you drag and drop. But then they don' t play nicely, unless you want a small ugly looking product.
===The Videofile plugin option===
One option is the [[Videofile]] plugin.
*Download: https://docs.moodle.org/32/en/Videofile
*About: https://docs.moodle.org/32/en/Videofile
===The Re-naming option===
ie Don't use MP4's but rename to FLV
===The Youtube (etc) repository option===
Upload your file to Youtube and link to it.
==Can you stop Flowplayer from preloading a video?==
*See the discussion here: http://moodle.org/mod/forum/discuss.php?d=184081
==Videos don't embed even though the filters are enabled==
You might need to change the order of your filters. See the forum discussion [https://moodle.org/mod/forum/discuss.php?d=278993#p1198335 I can't embed YouTube videos]

[[Category:FAQ]]

[[de:Multimedia FAQ]]
[[es:Medios FAQ]]

Media embedding

2015-09-20T09:13:24Z

Derekcx: Add note on Videoeasy

{{Working with media}}
==Embedding audio and video==
[[File:mp3 player.png|thumb|MP3 player]]
Audio and video may be embedded in a course in the following ways:

* As a [[File module settings|file resource]]
* As a [[URL module settings|URL resource]] with embed as the display option
* In a [[Lesson settings|lesson popup]]
* In any text area using the Moodle media button in the [[Text editor|text editor]] or simply by typing the URL of media file

The media file link is then replaced with an appropriate multimedia player which can play the resource.

==Enabling media embedding==

To enable the embedding of media files, an admin must enable

# Appropriate media players (see below)
# The [[Multimedia plugins filter]] - unless you only want to allow embedding in File, URL and Lesson modules.

==Site administration settings==

An administrator can enable selected media players in ''Administration> Site administration > Appearance > Media embedding''.

===Available players===
* YouTube (displays videos hosted on youtube)
* Vimeo (displays videos hosted on vimeo)
* .mp3 - MPEG Audio Stream, Layer III
* .flv - Flash video
* .f4v - Flash video
* .swf - Macromedia Flash animation File (Adobe, Inc.)
:'''Note:''' Only used in trusted texts as it has potential security issues
* .ogg - HTML 5 audio
* .acc - HTML 5 audio
* .mp3 - HTML 5 audio
* .webm - HTML 5 video
* .m4v - HTML 5 video
* .ogv - HTML 5 video

===Other video players===
This is just a few links. Feel free to edit and improve this

====About JW player====
#https://moodle.org/mod/forum/discuss.php?d=313308#p1254528
#Plugin: https://moodle.org/plugins/view/filter_jwplayer Not responsive at the moment. Code given here to enable thumbnails.

====Videoeasy====
A Plugin: https://moodle.org/plugins/view.php?id=1384

===Legacy media players===
The following legacy media player formats are also available but not recommended for general usage:
* .mov - QuickTime player (requires QuickTime player or [http://en.wikipedia.org/wiki/Codec codec])
* .mp4 - QuickTime player (requires QuickTime player or codec)
* .m4a - QuickTime player (requires QuickTime player or codec)
* .mpg - MPEG animation - QuickTime player (requires QuickTime player or codec)
* .wmv - Windows media player (Microsoft)-not guaranteed to work in browsers other than IE and non-Windows systems
* .avi - Windows media player - not guaranteed to work in browsers other than IE and non-Windows systems

==See also==

* [[:dev:Media embedding]] developer documentation including information on how to change the size of the media player

[[Category:Site administration]]

[[de:Einbetten von Medien]]
[[es:Incrustación de medios]]

Media FAQ

2015-09-20T09:05:52Z

Derekcx: Add link

{{Working with media}}
==Should I put my video into a label or a page?==
While the embedding process is the same, adding a video to a label will mean it displays as soon as the user clicks on that course page. This can be beneficial if the video is, for example, an introduction to the course or an integral part of the whole course. However, if there are several videos in labels, they can slow the loading of the course down, especially if the videos are coming from an external site. Adding a video to a page in Moodle means that the user has to click a text link to reach the video, but it doesn't clutter up the main course page and it is a better choice if the course contains a large number of videos.

==My embedded video is too big/small. How can I change its display size?==
Changing the size of an embedded video depends on whether you're using Moodle's [[Multimedia plugins filter]] or if you're either embedding a video from another source using something like an iframe (for example, embedding a video from YouTube using the embed code they provide).

====If you're using Moodle's Mulimedia plugins filter:====
Your video will appear to you in the html editor as a hyperlink. Whether it's a video hosted elsewhere (ie Vimeo or Youtube) or a file you've uploaded yourself, it will still appear as a hyperlink. After you've saved this html, Moodle's Multimedia filter will turn that hyperlink into an embedded video. In order to change the video's size you need to:
#Open the HTML Source Editor by clicking the HTML code icon: [[File:Htmlcodeicon.png]]
#Find the <a href...> code for the video you want to change. In the href="LINK" section of your code, place your cursor right before the last quotation mark.
#Type "?d=100x200" where you're replacing "100" with your desired width and "200" with your desired height. For example, if you want a video that's 600 x 325, you would type ?d=600x325." [[File:Resizevideo.png]]
#Your <a> tag should now look something like the following: If you're working with a file you've uploaded yourself: <a href="https://yourschool.edu/draftfile.php?file=/135/user/draft/617331337/Module%.mp4?d=425x234">. In this example, your uploaded video would be embedded at 425x234. If you're working with an externally hosted file: <a href="https://www.youtube.com/watch?v=TubRpuaNVT4d?600x135">. In this example, the YouTube video would be embedded at 600x135.
#Click "update" in the HTML source editor screen, and save your changes.
#Your video should now be the new size.

====If you're using an embed code, such as an iframe, it's a little easier:====
#Open the HTML Source Editor, as above
#Locate the <iframe> tag or equivalent.
#Inside that iframe should be "width" and "height" variables, which you can adjust as needed. [[File:Youtuberesize.png]]
#Click "update" in the HTML source editor screen, and save your changes.
#Your video should now be the new size.

==Why is the size and player for MP4 video clips hard coded?==
Not sure. If anyone from out there knows, so far they have not let on any reasons. See MDL-43385

==Why won't my swf video play?==
The .swf format carries with it some security issues and so the filter that allows it to display is disabled by default. For you to be able to add .swf videos, your administrator needs to enable the filter in [[Multimedia_plugins|Multimedia plugins]], then to go to ''Site Administration>Security>Site policies'' and check the "enable trusted content" box. They then need to go to ''Site Administration>Users>Permissions>Define roles'' and allow Trust Submitted content ''moodle/site:trustcontent'' for your role. However; swf will still not display in all areas of Moodle, for example forum posts. See this discussion [http://moodle.org/mod/forum/discuss.php?d=183681#p800390| here]

==How can I convert my video file to an .FLV or other format?==
*There are many sites online that allow you to upload a file which will then be converted and sent to you via a link or email. Zamzar [http://www.zamzar.com]or Youconvertit [http://www.youconvertit.com] are just two examples.
*However, if it is a large video file or you want to do the conversion off line, then the free Any Video Converter [http://www.any-video-converter.com/products/for_video_free/] (a downloadable program) will convert most video formats to most others.
*More and more full-featured MTS Video Converter [http://www.mtsconverterfree.com/]software free download a trial, to solve your problem more format conversions.
*The free and open source video player, VLC has the ability to convert to and from many video formats. For more details and downloads [http://www.videolan.org/vlc/ visit their site].
*If you are using Linux as your operating system either ffmpeg or avconv can both convert to FLV.

== I have a .wma/wav file. How can I play it in Moodle's player?==
*There are various free programs available that will convert one type of sound file to another. If you convert your file to an mp3 then you will be able to use Moodle's built-in mp3 player.
*Jodix Free WMA to MP3 converter [http://www.wma-mp3.org/] is just one example

== I have an MP4 file. How can I play it in Moodle's player? (ie Flowplayer)==
This section is a little sparse, and if you can improve it, feel free.

It seems that the media filter is hard coded to NOT use Flowplayer for MP4.
*See the discussion here: https://moodle.org/mod/forum/discuss.php?d=208849#p914927. Renaming an MP4 to an FLV seems to create a file that will play in Flowplayer.
Also: https://moodle.org/mod/forum/discuss.php?d=271199
*See the discussion here: https://docs.moodle.org/dev/Media_embedding
*See the discussion about [https://moodle.org/mod/forum/discuss.php?d=232296#p1048676 how to play mp4 videos in Moodle]

You can vote for a change here: MDL-43385

== What's the best way to manage/deploy MP4 files in Moodle? ==
And why bother about this? MP4 is probably the most common format, and it will play on both Flash enabled and disabled devices. It's a common question.

See above. Until we find out more information, it's difficult to get MP4 files into Moodle simply AND playing nicely. ie pick ONE.
#To play nicely: you need to do complex embedding etc. So it's not simple.
#To get them in simply: you drag and drop. But then they don' t play nicely, unless you want a small ugly looking product.
===The Videofile plugin option===
One option is the [[Videofile]] plugin.
*Download: https://docs.moodle.org/32/en/Videofile
*About: https://docs.moodle.org/32/en/Videofile
===The Re-naming option===
ie Don't use MP4's but rename to FLV
===The Youtube (etc) repository option===
Upload your file to Youtube and link to it.
==Can you stop Flowplayer from preloading a video?==
*See the discussion here: http://moodle.org/mod/forum/discuss.php?d=184081
==Videos don't embed even though the filters are enabled==
You might need to change the order of your filters. See the forum discussion [https://moodle.org/mod/forum/discuss.php?d=278993#p1198335 I can't embed YouTube videos]

[[Category:FAQ]]

[[de:Multimedia FAQ]]
[[es:Medios FAQ]]

Media embedding

2015-09-20T09:04:23Z

Derekcx: Add note on JW player

{{Working with media}}
==Embedding audio and video==
[[File:mp3 player.png|thumb|MP3 player]]
Audio and video may be embedded in a course in the following ways:

* As a [[File module settings|file resource]]
* As a [[URL module settings|URL resource]] with embed as the display option
* In a [[Lesson settings|lesson popup]]
* In any text area using the Moodle media button in the [[Text editor|text editor]] or simply by typing the URL of media file

The media file link is then replaced with an appropriate multimedia player which can play the resource.

==Enabling media embedding==

To enable the embedding of media files, an admin must enable

# Appropriate media players (see below)
# The [[Multimedia plugins filter]] - unless you only want to allow embedding in File, URL and Lesson modules.

==Site administration settings==

An administrator can enable selected media players in ''Administration> Site administration > Appearance > Media embedding''.

===Available players===
* YouTube (displays videos hosted on youtube)
* Vimeo (displays videos hosted on vimeo)
* .mp3 - MPEG Audio Stream, Layer III
* .flv - Flash video
* .f4v - Flash video
* .swf - Macromedia Flash animation File (Adobe, Inc.)
:'''Note:''' Only used in trusted texts as it has potential security issues
* .ogg - HTML 5 audio
* .acc - HTML 5 audio
* .mp3 - HTML 5 audio
* .webm - HTML 5 video
* .m4v - HTML 5 video
* .ogv - HTML 5 video

===Other video players===
This is just a few links. Feel free to edit and improve this

====About JW player====
#https://moodle.org/mod/forum/discuss.php?d=313308#p1254528
#Plugin: https://moodle.org/plugins/view/filter_jwplayer Not responsive at the moment. Code given here to enable thumbnails.

===Legacy media players===
The following legacy media player formats are also available but not recommended for general usage:
* .mov - QuickTime player (requires QuickTime player or [http://en.wikipedia.org/wiki/Codec codec])
* .mp4 - QuickTime player (requires QuickTime player or codec)
* .m4a - QuickTime player (requires QuickTime player or codec)
* .mpg - MPEG animation - QuickTime player (requires QuickTime player or codec)
* .wmv - Windows media player (Microsoft)-not guaranteed to work in browsers other than IE and non-Windows systems
* .avi - Windows media player - not guaranteed to work in browsers other than IE and non-Windows systems

==See also==

* [[:dev:Media embedding]] developer documentation including information on how to change the size of the media player

[[Category:Site administration]]

[[de:Einbetten von Medien]]
[[es:Incrustación de medios]]

Working with files

2015-09-17T22:24:30Z

Derekcx: Adding note on assignments and file types

{{Managing content}}
==Adding files to your course==

Moodle provides an easy way for a teacher to present materials to their students. These materials may take the form of files such as word-processed documents or slideshow presentations. The materials can be displayed on the page either as individual items or bundled together inside folders. One teacher might for instance wish to share a single research document in pdf format; another might have a folder of sample past examination papers for students to download. Most types of files can be uploaded and accessed through Moodle but the student needs to have the correct software to be able to open them.

To add files to a Moodle course, you must first ensure you have the editing turned on.

===Drag and drop===
*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:
[[File:dragdropmessage.png]]

To drag and drop a folder, you must first compress/zip it using whichever program your computer has.

===Add a resource or activity===
*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.

{|
| [[File:filefolder23.png|thumb|Selecting a file or folder in the activity chooser]]
| [[File:Workingwithfiles.png|thumb|The "Add a resource" drop down menu]]
|}

*The screen for uploading and displaying a file (or folder of files) includes an "add" button. Clicking on this button takes you to the [[File picker]] which is the name given to the file storage and access area within Moodle. Find out more about the places you can upload or add files from in the [[File picker]] page.
*There is also a block (with an arrow) into which you can drag and drop a file straight from your desktop into Moodle.(Note that this currently doesn't work with Internet Explorer.)

{|
| [[File:newdraganddrop.png|thumb|Area for dragging and dropping files into]]
|}

==Viewing 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.

{|
| [[File:truthumbnailsiconsview.png|thumb|File picker icon view]]
| [[File:tableview.png|thumb|File picker table view]]
| [[File:hierarchicallistview.png|thumb|File picker hierarchical list view]]
|}

==Editing or updating uploaded files==

*Clicking on the name of an uploaded file opens up a pop up dialogue box which allows file details quickly to be altered.

{|
| [[File:popupdialogue.png|thumb|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''. (Note: Previously an alias could be made to a file stored in Box.net, however with [[Box.net APIv1 migration |Box.net API v2]] this is no longer possible.)
*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:alias.png|thumb|Creating an alias]]
| [[File:shortcut1.png|frame]]
|}

===Areas in which aliases cannot be made===

An alias cannot be made in the following areas of Moodle:

* 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". Below is an example of a file added to an assignment:

{|
| [[File:aliasassignment.png|thumb|Assignment submission with no option to create an alias]]
|}

==Site administration settings==

{{New features}}An administrator can add new file types and view, edit and delete existing file types from ''Site administration > Server > File types''. This means that, for example, if teachers and students on your site use a lot of files specific to a particular program, such files can now be recognised by Moodle, and, when downloaded, they will open in the correct program, rather than presenting themselves as a generic zip file.

[[File:Filetypes1.png|center|thumb|500px||Some examples from the list]]

===Adding a new file type===
1. Scroll down to the bottom of the page and click the "Add" button

2. Add the details of your file type, using the example below as a guide. This example will add the .mobi extension (for a Kindle ebook) with the standard document icon.

[[File:newfiletype.png|thumb|center|500px|Adding a new filetype]]

3. Click to save the changes and you will see your new file type has been added to the list:

[[File:customfileypesuccess.png|thumb|500px|center|New type in the list]]

===File types and Assignments===
Tracker item: https://tracker.moodle.org/browse/MDL-39913

Discussion thread: https://moodle.org/mod/forum/discuss.php?d=217532

===Removing a file type===
*Clicking the X next to a file type will remove it from the site. You will be prompted to confirm before deletion.

===Editing an existing file type===
*Clicking the edit icon next to a file type will allow you to change certain details, for example the associated icon and description. If you don't wish to use the default description, you can specify your own custom description (with multi-language tags if your site supports multi-languages) or you can use an alternative language string from mimetypes.php.
===Google docs and docx===
Importing Google docs files as docx. See https://moodle.org/mod/forum/discuss.php?d=320144

==See also==
*HQ Youtube video tutorial: [http://youtu.be/Wt5Hgv-eouE Dragging and dropping files into Moodle]
*HQ Youtube video tutorial: [http://youtu.be/7i2roZ_OCyI Uploading files to Moodle]
*[http://lewiscarr.co.uk/2014/11/moodle-file-sharing-explained/ File sharing explained] blog post by Lewis Carr
*How to share a single file with students: [[File resource]]
*How to share a folder of files with students: [[Folder]]
*Questions about the file picker: [[File picker FAQ]]
* [[Restoring file aliases]]
*[http://www.youtube.com/watch?v=IrOKxYRJvGU How teachers upload files in Moodle 2 video]

[[de:Arbeiten mit Dateien und Verzeichnissen]]
[[es:Trabajando con archivos]]
[[fr:Utilisation de fichiers]]

Working with files

2015-09-17T22:21:31Z

Derekcx: Add note about Google docs

{{Managing content}}
==Adding files to your course==

Moodle provides an easy way for a teacher to present materials to their students. These materials may take the form of files such as word-processed documents or slideshow presentations. The materials can be displayed on the page either as individual items or bundled together inside folders. One teacher might for instance wish to share a single research document in pdf format; another might have a folder of sample past examination papers for students to download. Most types of files can be uploaded and accessed through Moodle but the student needs to have the correct software to be able to open them.

To add files to a Moodle course, you must first ensure you have the editing turned on.

===Drag and drop===
*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:
[[File:dragdropmessage.png]]

To drag and drop a folder, you must first compress/zip it using whichever program your computer has.

===Add a resource or activity===
*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.

{|
| [[File:filefolder23.png|thumb|Selecting a file or folder in the activity chooser]]
| [[File:Workingwithfiles.png|thumb|The "Add a resource" drop down menu]]
|}

*The screen for uploading and displaying a file (or folder of files) includes an "add" button. Clicking on this button takes you to the [[File picker]] which is the name given to the file storage and access area within Moodle. Find out more about the places you can upload or add files from in the [[File picker]] page.
*There is also a block (with an arrow) into which you can drag and drop a file straight from your desktop into Moodle.(Note that this currently doesn't work with Internet Explorer.)

{|
| [[File:newdraganddrop.png|thumb|Area for dragging and dropping files into]]
|}

==Viewing 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.

{|
| [[File:truthumbnailsiconsview.png|thumb|File picker icon view]]
| [[File:tableview.png|thumb|File picker table view]]
| [[File:hierarchicallistview.png|thumb|File picker hierarchical list view]]
|}

==Editing or updating uploaded files==

*Clicking on the name of an uploaded file opens up a pop up dialogue box which allows file details quickly to be altered.

{|
| [[File:popupdialogue.png|thumb|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''. (Note: Previously an alias could be made to a file stored in Box.net, however with [[Box.net APIv1 migration |Box.net API v2]] this is no longer possible.)
*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:alias.png|thumb|Creating an alias]]
| [[File:shortcut1.png|frame]]
|}

===Areas in which aliases cannot be made===

An alias cannot be made in the following areas of Moodle:

* 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". Below is an example of a file added to an assignment:

{|
| [[File:aliasassignment.png|thumb|Assignment submission with no option to create an alias]]
|}

==Site administration settings==

{{New features}}An administrator can add new file types and view, edit and delete existing file types from ''Site administration > Server > File types''. This means that, for example, if teachers and students on your site use a lot of files specific to a particular program, such files can now be recognised by Moodle, and, when downloaded, they will open in the correct program, rather than presenting themselves as a generic zip file.

[[File:Filetypes1.png|center|thumb|500px||Some examples from the list]]

===Adding a new file type===
1. Scroll down to the bottom of the page and click the "Add" button

2. Add the details of your file type, using the example below as a guide. This example will add the .mobi extension (for a Kindle ebook) with the standard document icon.

[[File:newfiletype.png|thumb|center|500px|Adding a new filetype]]

3. Click to save the changes and you will see your new file type has been added to the list:

[[File:customfileypesuccess.png|thumb|500px|center|New type in the list]]

===Removing a file type===
*Clicking the X next to a file type will remove it from the site. You will be prompted to confirm before deletion.

===Editing an existing file type===
*Clicking the edit icon next to a file type will allow you to change certain details, for example the associated icon and description. If you don't wish to use the default description, you can specify your own custom description (with multi-language tags if your site supports multi-languages) or you can use an alternative language string from mimetypes.php.
===Google docs and docx===
Importing Google docs files as docx. See https://moodle.org/mod/forum/discuss.php?d=320144

==See also==
*HQ Youtube video tutorial: [http://youtu.be/Wt5Hgv-eouE Dragging and dropping files into Moodle]
*HQ Youtube video tutorial: [http://youtu.be/7i2roZ_OCyI Uploading files to Moodle]
*[http://lewiscarr.co.uk/2014/11/moodle-file-sharing-explained/ File sharing explained] blog post by Lewis Carr
*How to share a single file with students: [[File resource]]
*How to share a folder of files with students: [[Folder]]
*Questions about the file picker: [[File picker FAQ]]
* [[Restoring file aliases]]
*[http://www.youtube.com/watch?v=IrOKxYRJvGU How teachers upload files in Moodle 2 video]

[[de:Arbeiten mit Dateien und Verzeichnissen]]
[[es:Trabajando con archivos]]
[[fr:Utilisation de fichiers]]

Installing Moodle

2015-09-15T03:26:53Z

Derekcx: Added link to tracker

{{Template:Installing Moodle}}
''This page explains how to install Moodle. If you are an expert and/or in a hurry try [[Installation Quickstart]].''

If you just want to try Moodle on a standalone machine there are 'one-click' installers for Windows (see [[Complete install packages for Windows]]) and for OSX (see [[Complete Install Packages for Mac OS X]]) or [[ install on OS X]]. These are unsuitable for production servers.

== Requirements ==

Moodle is primarily developed in Linux using [[Apache]], [[PostgreSQL]]/[[MySQL]]/[[MariaDB]] and [[PHP]] (also sometimes known as the LAMP platform). If in doubt, this is the safest combination (if for no other reason than being the most common). There are other options - see the Software section that follows:

If you are installing Moodle in a Windows server, note that from php5.5 onwards, you will also need to have the Visual C++ Redistributable for Visual Studio 2012 installed from:
http://www.microsoft.com/en-us/download/details.aspx?id=30679 Visual C++] ( x86 or x64)

The basic requirements for Moodle are as follows:

=== Hardware ===
* Disk space: 160MB free (min) plus as much as you need to store your materials. 5GB is probably a realistic minimum.
* Processor: 1GHz (min), 2GHz dual core recommended. These settings may vary according to the resources used.
* Backups: at least the same again (at a remote location preferably) as above to keep backups of your site.
* Memory: 256MB (min), 1GB or more is strongly recommended. The general rule of thumb is that Moodle can support 10 to 20 ''concurrent'' users for every 1GB of RAM, but this will vary depending on your specific hardware and software combination and the type of use. 'Concurrent' really means web server processes in memory at the same time (i.e. users interacting with the system within a window of a few seconds). It does NOT mean people 'logged in'.

=== Software ===

See the [{{Release notes}} release notes] in the dev docs for software requirements.

== Set up your server ==

...or desktop computer, if you are just evaluating Moodle. There are lots of possibilities for installing the basic server software depending on your particular choices. Some links and pointers are at [[Installing AMP]], [[Internet_Information_Services|IIS]], [[Nginx]]

If you are using a hosted server all this should be done for you. However, (especially on shared hosting) make sure you understand or find out how to change PHP settings (e.g. file upload maximums). This can vary a huge amount from host to host.

== Download and copy files into place ==

'''IMPORTANT: While there are now a number of places you can get the Moodle code, you are strongly advised to obtain Moodle from moodle.org. If you run into problems it will be a great deal easier to support you.'''

You have two options:
* Download your required version from http://moodle.org/downloads and unzip/unpack...
* '''OR''' Pull the code from the Git repository (recommended for developers and also makes upgrading very simple):
<pre>
$ git clone --depth=1 -b MOODLE_29_STABLE git://git.moodle.org/moodle.git
</pre>
--depth=1 for shallow cloning (only) latest revision

--single-branch option to limit cloning to a single branch, this fetches the Moodle 2.9 Stable branch (latest weekly build). For a fuller discussion see [[Git for Administrators]].

Either of the above should result in a directory called '''moodle''', containing a number of files and folders.

You can either place the whole folder in your web server documents directory, in which case the site will be located at '''<nowiki>http://yourwebserver.com/moodle</nowiki>''', or you can copy all the contents straight into the main web server documents directory, in which case the site will be simply '''<nowiki>http://yourwebserver.com</nowiki>'''. See the documentation for your system and/or web server if you are unsure.

:''Tip:'' If you are downloading Moodle to your local computer and then uploading it to your hosted web site, if possible upload the compressed file and decompress at the remote end (check your 'file manager'). Failing that, watch FTP progress carefully for errors or missed files.

* '''Secure the Moodle files:''' It is vital that the files are not writeable by the web server user. For example, on Unix/Linux (as root):
<pre>
# chown -R root /path/to/moodle
# chmod -R 0755 /path/to/moodle
# find /path/to/moodle -type f -exec chmod 0644 {} \;
</pre>
(files are owned by the administrator/superuser and are only writeable by them - readable by everyone else)

The third command finds all the regular files and executes the chmod command 0644 on them.

If you want to use the built-in plugin installer you need to make the directory writable by web server user. It is strongly recommended to use ACL when your server supports it, for example if your Apache server uses account www-data:

<pre>
# chmod -R +a "www-data allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodle
</pre>

The effect of the previous command is to allow the Apache user account (www-data in this case) to access and change files within the moodle site. Many people would consider this a brave move for a new site admin to implement. In a new moodle you can safely leave this out. A default Ubuntu install does not have the +a option for the chmod command anyway. The +a attribute is an ACL (Access Control List) facility which allows you to set per user access for individual files. For example, OSX has this by default.

== Create an empty database ==

Next create a new, empty database for your installation. You need to find and make a note of following information for use during the final installation stage:
* '''dbhost''' - the database server hostname. Probably ''localhost'' if the database and web server are the same machine, otherwise the name of the database server
* '''dbname''' - the database name. Whatever you called it, e.g. ''moodle''
* '''dbuser''' - the username for the database. Whatever you assigned, e.g. ''moodleuser'' - do not use the root/superuser account. Create a proper account with the minimum permissions needed.
* '''dbpass''' - the password for the above user

If your site is hosted you should find a web-based administration page for databases as part of the control panel (or ask your administrator). For everyone else or for detailed instructions, see the page for your chosen database server:
* [[PostgreSQL]]
* [[MariaDB]]
* [[MySQL]]
* [[MSSQL]]
* [[Oracle]] (known issues, not fully supported - see for example https://moodle.org/mod/forum/discuss.php?d=65488 and the tracker item https://tracker.moodle.org/browse/MDL-41310)

== Create the (''moodledata'') data directory ==

Moodle requires a directory to store all of its files (all your site's uploaded files, temporary data, cache, session data etc.). The web server needs to be able to write to this directory. On larger systems consider how much free space you are going to use when allocating this directory.

Due to the way Moodle caches data you may have performance issues if you use relatively slow storage (e.g. NFS) for this directory. Read the [[Performance_recommendations]] carefully and consider using (e.g.) memcached for [[Caching]].

'''IMPORTANT:''' This directory must '''NOT''' be accessible directly via the web. This would be a serious security hole. Do not try to place it inside your web root or inside your Moodle program files directory. Moodle will not install. It can go anywhere else convenient.

Here is an example (Unix/Linux) of creating the directory and setting the permissions for '''anyone''' on the server to write here. This is only appropriate for Moodle servers that are not shared. Discuss this with your server administrator for better permissions that just allow the web server user to access these files.

<pre>
# mkdir /path/to/moodledata
# chmod 0777 /path/to/moodledata
</pre>

If your server supports ACL it is recommended to set following permissions, for example if your Apache server uses account www-data:
<pre>
# chmod -R +a "www-data allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodledata
</pre>
If you are planning to execute PHP scripts from the command line you should set the same permissions for the current user:
<pre>
$ sudo chmod -R +a "`whoami` allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodledata
</pre>

==== Securing moodledata in a web directory ====

If you are using a hosted site and you have no option but to place 'moodledata' in a web accessible directory. You may be able to secure it by creating an .htaccess file in the 'moodledata' directory. This does not work on all systems - see your host/administrator. Create a file called .htaccess containing only the following lines:
<pre>
order deny,allow
deny from all
</pre>

== Start Moodle install ==
It's now time to run the installer to create the database tables and configure your new site. The recommended method is to use the command line installer. If you cannot do this for any reason (e.g. on a Windows server) the web based installer is still available.

=== Command line installer ===

It's best to run the command line as your system's web user. You need to know what that is - see your system's documentation (e.g. Ubuntu/Debian is 'www-data', Centos is 'apache')

* Example of using the command-line (as root - substitute 'www-data' for your web user):
<pre>
# chown www-data /path/to/moodle
# cd /path/to/moodle/admin/cli
# sudo -u www-data /usr/bin/php install.php
# chown -R root /path/to/moodle
</pre>
The chowns allow the script to write a new config.php file. More information about the options can be found using
<pre>
# php install.php --help
</pre>

You will be asked for other settings that have not been discussed on this page - if unsure just accept the defaults. For a full discussion see [[Administration via command line]]

=== Web based installer ===
To run the web installer script, just go to your Moodle's main URL using a web browser.

The installation process will take you through a number of pages. You should be asked to confirm the copyright, see the database tables being created, supply administrator account details and supply the site details. The database creation can take some time - please be patient. You should eventually end up at the Moodle front page with an invitation to create a new course.

It is very likely that you will be asked to download the new config.php file and upload it to your Moodle installation - just follow the on-screen instructions.

==Final configuration==

=== Settings within Moodle ===
There are a number of options within the Moodle Site Administration screens (accessible from the 'Site administration' tab in the 'Administration' block. Here are a few of the more important ones that you will probably want to check:
* ''Administration > Site administration > Plugins > Message Outputs > Email'': Set your smtp server and authentication if required (so your Moodle site can send emails). The support contact for your site is also set on this page.
* ''Administration > Site administration > Server > System paths'': Set the paths to du, dot and aspell binaries.
* ''Administration > Site administration > Server > HTTP'': If you are behind a firewall you may need to set your proxy credentials in the 'Web proxy' section.
* ''Administration > Site administration > Location > Update timezones'': Run this to make sure your timezone information is up to date. (more info [[Location]])
** [http://php.net/manual/en/timezones.php Set server's local timezone] inside <tt>php.ini</tt> (should probably be inside <tt>/etc/php.ini</tt> or <tt>/etc/php.d/date.ini</tt>, depending on the underline OS):
**: <code ini>[Date]
; Defines the default timezone used by the date functions
date.timezone = "YOUR LOCAL TIMEZONE"</code>

=== Remaining tasks ===

* '''Configure Cron''': Moodle's background tasks (e.g. sending out forum emails and performing course backups) are performed by a script which you can set to execute at specific times of the day. This is known as a cron script. Please refer to the [[Cron|Cron instructions]].
* '''Set up backups''': See [[Site backup]] and [[Automated course backup]].
* '''Check mail works''': [[Add a new user|Create a test user]] with a valid email address and [[message|send them a message]]. Do they receive an email copy of the message? If not, check the settings in ''Settings > Site administration > Plugins > Message outputs > Email''. Don't be tempted to skip this step (clue: email is used to recover lost passwords, including the administrator password when you forget it!)
* '''Secure your Moodle site''': Read the [[Security recommendations]].
*'''Increasing the maximum upload size''' See [[Installation FAQ]] Maximum upload file size - how to change it?

=== Installation is complete :) ===

* Create a new course: You can now [[Adding a new course|create a new course]] and have a play ;-)

=== If something goes wrong... ===

Here are some things you should try...

* Check the [[Installation FAQ]]
* Check your file permissions carefully. Can your web server read (but not write) the Moodle program files? Can your web server read and write your Moodle data directory?
* Check your database permissions. Have you set up your database user with the correct rights and permissions for your configuration (especially if the web server and database server are different machines)?
* Create your [[Configuration file]] (config.php) by hand. Copy config-dist.php (in the root of the Moodle program directory) to config.php, edit it and set your database/site options there. Installation will continue from the right place.
* Once you have a config.php (see previous tip) you can edit it to turn on debugging (in section 8). This may give you extra information to help track down a problem. If you have access, check your web server error log(s).
* Re-check your php.ini / .htaccess settings. Are they appropriate (e.g. memory_limit), did you edit the correct php.ini / .htaccess file and (if required) did you re-start the web server after making changes?
* Did you include any non-core (optional) plugins, themes or other code before starting the installation script? If so, remove it and try again (it may be broken or incompatible).
* Explain your problem in the [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum]. '''PLEASE''' list your software versions; explain what you did, what happened and what error messages you saw (if any); explain what you tried. There is no such thing as 'nothing', even a blank page is something!

== Platform specific instructions ==

'''Note:''' Much of this information is provided by the community. It may not have been checked and may be out of date. Please read in conjunction with the above installation instructions.

* [[Windows installation]]
** [[Installing Moodle on SmarterASP.NET]]
* [[Unix or Linux Installation]]
* [[Mac Installation]]
* [[Amazon EC2 Cloud Services Installation]]

== See also ==
* [http://www.slideshare.net/gb2048/my-own-moodle Slideshare presentation by Gareth Barnard on installing a local installation of Moodle] and accompanying [https://drive.google.com/folderview?id=0B17B0rYH2zERU21sQnVweUZCUFk&usp=sharing help guides]
* [http://moodle.org/mod/forum/discuss.php?d=182086 New Video Tutorial- How to Install Moodle on Shared Hosting via cPanel (Not Fantastico)]
* [http://moodle.org/mod/forum/discuss.php?d=199542 Video Tutorial - Install Moodle on a Virtual Box from scratch]

[[es:Instalaci%C3%B3n_de_moodle]]
[[de:Installation von Moodle]]
[[fr:Installation de Moodle]]
[[ja:Moodleのインストール]]

Installing Moodle

2015-09-15T03:22:09Z

Derekcx: Small edit: link to forum

{{Template:Installing Moodle}}
''This page explains how to install Moodle. If you are an expert and/or in a hurry try [[Installation Quickstart]].''

If you just want to try Moodle on a standalone machine there are 'one-click' installers for Windows (see [[Complete install packages for Windows]]) and for OSX (see [[Complete Install Packages for Mac OS X]]) or [[ install on OS X]]. These are unsuitable for production servers.

== Requirements ==

Moodle is primarily developed in Linux using [[Apache]], [[PostgreSQL]]/[[MySQL]]/[[MariaDB]] and [[PHP]] (also sometimes known as the LAMP platform). If in doubt, this is the safest combination (if for no other reason than being the most common). There are other options - see the Software section that follows:

If you are installing Moodle in a Windows server, note that from php5.5 onwards, you will also need to have the Visual C++ Redistributable for Visual Studio 2012 installed from:
http://www.microsoft.com/en-us/download/details.aspx?id=30679 Visual C++] ( x86 or x64)

The basic requirements for Moodle are as follows:

=== Hardware ===
* Disk space: 160MB free (min) plus as much as you need to store your materials. 5GB is probably a realistic minimum.
* Processor: 1GHz (min), 2GHz dual core recommended. These settings may vary according to the resources used.
* Backups: at least the same again (at a remote location preferably) as above to keep backups of your site.
* Memory: 256MB (min), 1GB or more is strongly recommended. The general rule of thumb is that Moodle can support 10 to 20 ''concurrent'' users for every 1GB of RAM, but this will vary depending on your specific hardware and software combination and the type of use. 'Concurrent' really means web server processes in memory at the same time (i.e. users interacting with the system within a window of a few seconds). It does NOT mean people 'logged in'.

=== Software ===

See the [{{Release notes}} release notes] in the dev docs for software requirements.

== Set up your server ==

...or desktop computer, if you are just evaluating Moodle. There are lots of possibilities for installing the basic server software depending on your particular choices. Some links and pointers are at [[Installing AMP]], [[Internet_Information_Services|IIS]], [[Nginx]]

If you are using a hosted server all this should be done for you. However, (especially on shared hosting) make sure you understand or find out how to change PHP settings (e.g. file upload maximums). This can vary a huge amount from host to host.

== Download and copy files into place ==

'''IMPORTANT: While there are now a number of places you can get the Moodle code, you are strongly advised to obtain Moodle from moodle.org. If you run into problems it will be a great deal easier to support you.'''

You have two options:
* Download your required version from http://moodle.org/downloads and unzip/unpack...
* '''OR''' Pull the code from the Git repository (recommended for developers and also makes upgrading very simple):
<pre>
$ git clone --depth=1 -b MOODLE_29_STABLE git://git.moodle.org/moodle.git
</pre>
--depth=1 for shallow cloning (only) latest revision

--single-branch option to limit cloning to a single branch, this fetches the Moodle 2.9 Stable branch (latest weekly build). For a fuller discussion see [[Git for Administrators]].

Either of the above should result in a directory called '''moodle''', containing a number of files and folders.

You can either place the whole folder in your web server documents directory, in which case the site will be located at '''<nowiki>http://yourwebserver.com/moodle</nowiki>''', or you can copy all the contents straight into the main web server documents directory, in which case the site will be simply '''<nowiki>http://yourwebserver.com</nowiki>'''. See the documentation for your system and/or web server if you are unsure.

:''Tip:'' If you are downloading Moodle to your local computer and then uploading it to your hosted web site, if possible upload the compressed file and decompress at the remote end (check your 'file manager'). Failing that, watch FTP progress carefully for errors or missed files.

* '''Secure the Moodle files:''' It is vital that the files are not writeable by the web server user. For example, on Unix/Linux (as root):
<pre>
# chown -R root /path/to/moodle
# chmod -R 0755 /path/to/moodle
# find /path/to/moodle -type f -exec chmod 0644 {} \;
</pre>
(files are owned by the administrator/superuser and are only writeable by them - readable by everyone else)

The third command finds all the regular files and executes the chmod command 0644 on them.

If you want to use the built-in plugin installer you need to make the directory writable by web server user. It is strongly recommended to use ACL when your server supports it, for example if your Apache server uses account www-data:

<pre>
# chmod -R +a "www-data allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodle
</pre>

The effect of the previous command is to allow the Apache user account (www-data in this case) to access and change files within the moodle site. Many people would consider this a brave move for a new site admin to implement. In a new moodle you can safely leave this out. A default Ubuntu install does not have the +a option for the chmod command anyway. The +a attribute is an ACL (Access Control List) facility which allows you to set per user access for individual files. For example, OSX has this by default.

== Create an empty database ==

Next create a new, empty database for your installation. You need to find and make a note of following information for use during the final installation stage:
* '''dbhost''' - the database server hostname. Probably ''localhost'' if the database and web server are the same machine, otherwise the name of the database server
* '''dbname''' - the database name. Whatever you called it, e.g. ''moodle''
* '''dbuser''' - the username for the database. Whatever you assigned, e.g. ''moodleuser'' - do not use the root/superuser account. Create a proper account with the minimum permissions needed.
* '''dbpass''' - the password for the above user

If your site is hosted you should find a web-based administration page for databases as part of the control panel (or ask your administrator). For everyone else or for detailed instructions, see the page for your chosen database server:
* [[PostgreSQL]]
* [[MariaDB]]
* [[MySQL]]
* [[MSSQL]]
* [[Oracle]] (known issues, not fully supported - see for example https://moodle.org/mod/forum/discuss.php?d=65488)

== Create the (''moodledata'') data directory ==

Moodle requires a directory to store all of its files (all your site's uploaded files, temporary data, cache, session data etc.). The web server needs to be able to write to this directory. On larger systems consider how much free space you are going to use when allocating this directory.

Due to the way Moodle caches data you may have performance issues if you use relatively slow storage (e.g. NFS) for this directory. Read the [[Performance_recommendations]] carefully and consider using (e.g.) memcached for [[Caching]].

'''IMPORTANT:''' This directory must '''NOT''' be accessible directly via the web. This would be a serious security hole. Do not try to place it inside your web root or inside your Moodle program files directory. Moodle will not install. It can go anywhere else convenient.

Here is an example (Unix/Linux) of creating the directory and setting the permissions for '''anyone''' on the server to write here. This is only appropriate for Moodle servers that are not shared. Discuss this with your server administrator for better permissions that just allow the web server user to access these files.

<pre>
# mkdir /path/to/moodledata
# chmod 0777 /path/to/moodledata
</pre>

If your server supports ACL it is recommended to set following permissions, for example if your Apache server uses account www-data:
<pre>
# chmod -R +a "www-data allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodledata
</pre>
If you are planning to execute PHP scripts from the command line you should set the same permissions for the current user:
<pre>
$ sudo chmod -R +a "`whoami` allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodledata
</pre>

==== Securing moodledata in a web directory ====

If you are using a hosted site and you have no option but to place 'moodledata' in a web accessible directory. You may be able to secure it by creating an .htaccess file in the 'moodledata' directory. This does not work on all systems - see your host/administrator. Create a file called .htaccess containing only the following lines:
<pre>
order deny,allow
deny from all
</pre>

== Start Moodle install ==
It's now time to run the installer to create the database tables and configure your new site. The recommended method is to use the command line installer. If you cannot do this for any reason (e.g. on a Windows server) the web based installer is still available.

=== Command line installer ===

It's best to run the command line as your system's web user. You need to know what that is - see your system's documentation (e.g. Ubuntu/Debian is 'www-data', Centos is 'apache')

* Example of using the command-line (as root - substitute 'www-data' for your web user):
<pre>
# chown www-data /path/to/moodle
# cd /path/to/moodle/admin/cli
# sudo -u www-data /usr/bin/php install.php
# chown -R root /path/to/moodle
</pre>
The chowns allow the script to write a new config.php file. More information about the options can be found using
<pre>
# php install.php --help
</pre>

You will be asked for other settings that have not been discussed on this page - if unsure just accept the defaults. For a full discussion see [[Administration via command line]]

=== Web based installer ===
To run the web installer script, just go to your Moodle's main URL using a web browser.

The installation process will take you through a number of pages. You should be asked to confirm the copyright, see the database tables being created, supply administrator account details and supply the site details. The database creation can take some time - please be patient. You should eventually end up at the Moodle front page with an invitation to create a new course.

It is very likely that you will be asked to download the new config.php file and upload it to your Moodle installation - just follow the on-screen instructions.

==Final configuration==

=== Settings within Moodle ===
There are a number of options within the Moodle Site Administration screens (accessible from the 'Site administration' tab in the 'Administration' block. Here are a few of the more important ones that you will probably want to check:
* ''Administration > Site administration > Plugins > Message Outputs > Email'': Set your smtp server and authentication if required (so your Moodle site can send emails). The support contact for your site is also set on this page.
* ''Administration > Site administration > Server > System paths'': Set the paths to du, dot and aspell binaries.
* ''Administration > Site administration > Server > HTTP'': If you are behind a firewall you may need to set your proxy credentials in the 'Web proxy' section.
* ''Administration > Site administration > Location > Update timezones'': Run this to make sure your timezone information is up to date. (more info [[Location]])
** [http://php.net/manual/en/timezones.php Set server's local timezone] inside <tt>php.ini</tt> (should probably be inside <tt>/etc/php.ini</tt> or <tt>/etc/php.d/date.ini</tt>, depending on the underline OS):
**: <code ini>[Date]
; Defines the default timezone used by the date functions
date.timezone = "YOUR LOCAL TIMEZONE"</code>

=== Remaining tasks ===

* '''Configure Cron''': Moodle's background tasks (e.g. sending out forum emails and performing course backups) are performed by a script which you can set to execute at specific times of the day. This is known as a cron script. Please refer to the [[Cron|Cron instructions]].
* '''Set up backups''': See [[Site backup]] and [[Automated course backup]].
* '''Check mail works''': [[Add a new user|Create a test user]] with a valid email address and [[message|send them a message]]. Do they receive an email copy of the message? If not, check the settings in ''Settings > Site administration > Plugins > Message outputs > Email''. Don't be tempted to skip this step (clue: email is used to recover lost passwords, including the administrator password when you forget it!)
* '''Secure your Moodle site''': Read the [[Security recommendations]].
*'''Increasing the maximum upload size''' See [[Installation FAQ]] Maximum upload file size - how to change it?

=== Installation is complete :) ===

* Create a new course: You can now [[Adding a new course|create a new course]] and have a play ;-)

=== If something goes wrong... ===

Here are some things you should try...

* Check the [[Installation FAQ]]
* Check your file permissions carefully. Can your web server read (but not write) the Moodle program files? Can your web server read and write your Moodle data directory?
* Check your database permissions. Have you set up your database user with the correct rights and permissions for your configuration (especially if the web server and database server are different machines)?
* Create your [[Configuration file]] (config.php) by hand. Copy config-dist.php (in the root of the Moodle program directory) to config.php, edit it and set your database/site options there. Installation will continue from the right place.
* Once you have a config.php (see previous tip) you can edit it to turn on debugging (in section 8). This may give you extra information to help track down a problem. If you have access, check your web server error log(s).
* Re-check your php.ini / .htaccess settings. Are they appropriate (e.g. memory_limit), did you edit the correct php.ini / .htaccess file and (if required) did you re-start the web server after making changes?
* Did you include any non-core (optional) plugins, themes or other code before starting the installation script? If so, remove it and try again (it may be broken or incompatible).
* Explain your problem in the [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum]. '''PLEASE''' list your software versions; explain what you did, what happened and what error messages you saw (if any); explain what you tried. There is no such thing as 'nothing', even a blank page is something!

== Platform specific instructions ==

'''Note:''' Much of this information is provided by the community. It may not have been checked and may be out of date. Please read in conjunction with the above installation instructions.

* [[Windows installation]]
** [[Installing Moodle on SmarterASP.NET]]
* [[Unix or Linux Installation]]
* [[Mac Installation]]
* [[Amazon EC2 Cloud Services Installation]]

== See also ==
* [http://www.slideshare.net/gb2048/my-own-moodle Slideshare presentation by Gareth Barnard on installing a local installation of Moodle] and accompanying [https://drive.google.com/folderview?id=0B17B0rYH2zERU21sQnVweUZCUFk&usp=sharing help guides]
* [http://moodle.org/mod/forum/discuss.php?d=182086 New Video Tutorial- How to Install Moodle on Shared Hosting via cPanel (Not Fantastico)]
* [http://moodle.org/mod/forum/discuss.php?d=199542 Video Tutorial - Install Moodle on a Virtual Box from scratch]

[[es:Instalaci%C3%B3n_de_moodle]]
[[de:Installation von Moodle]]
[[fr:Installation de Moodle]]
[[ja:Moodleのインストール]]

Windows installation

2015-09-15T03:20:20Z

Derekcx: Small edit: link to forum

{{Installing Moodle}}

==Known problems==

Windows is not suitable for large Moodle installations because PHP for Windows does not support 64-bit integer numbers, even if it is running on 64-bit Windows in 64-bit mode. One of the problems is that Moodle may fail to access data if there are more than 2 billion records in one database table because the id column is too big for integers. Another limitation is a maximum file size of 2GB, which can cause problems (for example) when making backups of large courses. Please consider a different operating system with full 64-bit support for very large installations.

==Installation Packages==
If you are running a small (less than 30 users) Moodle server or just want to test Moodle on your Windows PC, pre-built packages are available for you to use. Here are links to pages containing step-by-step instructions for installing Moodle using install packages:

*[[Complete install packages for Windows]] for most Windows versions
*[[Windows installation using Git|Installation guide for Windows using WAMP and Git]] How to install Moodle on your Windows PC and update it regularly via Git.

*[[Windows installation using XAMPP|Installation guide for Windows using XAMPP]] A more typical webserver installation than a complete install package. Both use XAMPP.

*[[Installation guide for Windows using EasyPHP]]

== Manual Installation ==
For medium to large installations (e.g. a college, university or business), it is best practice to install Moodle on your server manually.

* '''Plan your system capacity'''. This involves estimating the appropriate hardware to support the number of users in your organisation. See [[Installing Moodle#How_many_users.3F| Installing Moodle ]] in the How Many Users section for a method of doing this.
* '''Install your database server'''. You have a choice of
#[http://dev.mysql.com/downloads/ MySQL]/[http://mariadb.org/ MariaDB] (recommended),
#[http://www.postgresql.org/download/ PostgreSQL] (recommended)
#[[Installing MSSQL for PHP | Microsoft SQL Server 2005]]
#Oracle (not recommended - see https://moodle.org/mod/forum/discuss.php?d=65488).
* '''Install your web server'''. You have several choices - the decision as to which one to use will depend on your in-house expertise and your required level of sustainability:
**Apache 2 is recommended as the most tested and popular for Moodle installations. See these instructions for [[Installing Apache on Windows |manually installing Apache 2 on Windows]].
**IIS 7/8 server can also be used. See these instructions for [[Internet Information Services|Installing and configuring IIS and PHP on Windows]].
**Other webservers are known to install on Windows, e.g. Lighttpd, so you may wish to experiment with these if available memory is low on your server.
* '''Install PHP'''. Use Microsoft Web Platform Installer when using [[IIS]] server.
* '''Install Moodle''' by getting the standard installation for Moodle from [http://download.moodle.org/ http://download.moodle.org/] and read [[Installing Moodle]] which has detailed generic information.
* '''Setup backups'''. Once Moodle is setup and configured, you should setup backups of the system in case of failure or loss of data.
** '''To perform full site backups''' you need to backup the moodledata and moodle directories, Apache webserver configuration (httpd.conf) if you're using Apache, PHP configuration (php.ini) and any php extensions which are non-standard, and the mysql database. To do this use the integrated backup program (Start -> All Programs -> Accessories -> System Tools -> Backup) or your own proprietary backup software (e.g. BackupExec). To backup your mysql database see the [[Backup and restore FAQ]].
** '''To perform course backups''' see the [[Course backup]] page.
** You should also perform a '''state backup''' of the [http://technet2.microsoft.com/WindowsServer/en/library/921f0ed5-523d-48ac-8825-e850b0e548841033.mspx?mfr=true server] or [http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/ntbackup_backup_sysstate.mspx?mfr=true PC]. This is especially important if you're using IIS as this will backup the IIS metabase.
* '''Check your server security and performance'''. It is also good practice to read the [[Performance]] and [[Security]] documentation. Although much of the content is targeted at Linux/Unix users, there is a growing amount for Windows systems.
* Set-up your '''Active Directory authentication'''. You can use the standard [[LDAP authentication]] which prompts users with a username/password, or [[NTLM authentication | integrated NTLM authentication]] which does not require campus users to enter their credentials.

== See also ==

* [[Manual install on Windows 7 with Apache and MySQL]]
* [[Installing APC in Windows]] contains instructions for using a PHP accelerator to reduce processor load.
* [http://moodle.org/mod/forum/discuss.php?d=56835 Running Apache and IIS on the same server] forum discussion.

Events and Signup Plugins

2015-03-24T01:52:43Z

Derekcx:

===A summary of some of the options around Plugins to manage events and signups===
A work in progress--[[User:Derek Chirnside|Derek Chirnside]] ([[User talk:Derek Chirnside|talk]]) 12:23, 12 March 2015 (AWST)

====Organizer: https://moodle.org/plugins/view/mod_organizer====
Help: http://www.academic-moodle-cooperation.org/module/organizer/

====Scheduler: https://moodle.org/plugins/view.php?plugin=mod_scheduler====

====https://moodle.org/plugins/view/mod_reservation====

====Face to Face: https://moodle.org/plugins/view/mod_facetoface====
*

====Groups Self Selection: https://moodle.org/plugins/view/mod_groupselect====
*

====Group Choice: https://moodle.org/plugins/view/mod_choicegroup====
*

====Booking: https://moodle.org/plugins/view/mod_booking====
*We only support uneven Moodle versions. That means, there is a version for Moodle 2.5, 2.7, and so on.
*Possibly the nicest looking, genuine 'Events" list page

Events and Signup Plugins

2015-03-12T04:23:46Z

Derekcx: A list of plugins that manage signups to events or groups

===A summary of some of the options around Plugins to manage events and signups===
A work in progress--[[User:Derek Chirnside|Derek Chirnside]] ([[User talk:Derek Chirnside|talk]]) 12:23, 12 March 2015 (AWST)

====Organizer: https://moodle.org/plugins/view/mod_organizer====
Help: http://www.academic-moodle-cooperation.org/module/organizer/

====Scheduler: https://moodle.org/plugins/view.php?plugin=mod_scheduler====

====Face to Face: https://moodle.org/plugins/view/mod_facetoface====
*

====Groups Self Selection: https://moodle.org/plugins/view/mod_groupselect====
*

====Group Choice: https://moodle.org/plugins/view/mod_choicegroup====
*

====Booking: https://moodle.org/plugins/view/mod_booking====
*We only support uneven Moodle versions. That means, there is a version for Moodle 2.5, 2.7, and so on.
*Possibly the nicest looking, genuine 'Events" list page

Book FAQ

2014-11-07T01:20:54Z

Derekcx: Add tracker item. Now with link to code.

{{Book}}
==How can I enable students to edit a book?==

Students are not supposed to be able to edit book; allowing it would be a serious security issue. The [[Capabilities/mod/book:edit|capability to edit book chapters]] is intended strictly for trusted users.

==How can I enable students to import web pages?==

Do not allow students to import or edit books! Only trusted users should have the [[Capabilities/mod/book:edit|capability to edit book chapters]] and the [[Capabilities/booktool/importhtml:import|capability to import chapters]].

==How can I enable teachers to export a book to IMS content package?==

Allow the [[Capabilities/booktool/exportimscp:export|capability to export to IMS CP]] for the role of teacher then go to ''Settings > Book administration > Generate IMS CP''.

==Why only two levels?==

Two levels are generally enough for all books, three levels may lead to poorly structured documents. The Book module is designed for the creation of short multi-page study materials. Consider uploading a file in PDF format for longer documents.

==How do I search within a book resource?==

There is no internal search facility, though you can always use your web browser's search capability in print page view.
==Can I import a powerpoint into a book?==
See the forum post [https://moodle.org/mod/forum/discuss.php?d=218473 Semi-automated Powerpoint to Book import macro]for one possible method.

==Can I change the font of the print view for Book?==
Not easily. In book view your theme controls how is your book is displayed, where as during printing, book/tool/print/print.css determines the font, which is defaulted to Times New Roman. See https://moodle.org/mod/forum/discuss.php?d=220147#p972743

#A hack: you can in Print view use some utility like [http://getfirebug.com/ Firebug] to change the font.
#Another hack: Also see suggestion here: https://moodle.org/mod/forum/discuss.php?d=220147#p1066265
#Tracker item: https://tracker.moodle.org/browse/MDL-43385

==Why does Moodle hard code the print CSS to output books in Print format?==
Not really sure. See https://tracker.moodle.org/browse/MDL-43385

==See also==

* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=208324 Moving Book from One Course to Another] forum discussion

[[Category:FAQ]]

[[de:Buch FAQ]]

Book FAQ

2014-11-07T01:19:58Z

Derekcx: Add tracker item

{{Book}}
==How can I enable students to edit a book?==

Students are not supposed to be able to edit book; allowing it would be a serious security issue. The [[Capabilities/mod/book:edit|capability to edit book chapters]] is intended strictly for trusted users.

==How can I enable students to import web pages?==

Do not allow students to import or edit books! Only trusted users should have the [[Capabilities/mod/book:edit|capability to edit book chapters]] and the [[Capabilities/booktool/importhtml:import|capability to import chapters]].

==How can I enable teachers to export a book to IMS content package?==

Allow the [[Capabilities/booktool/exportimscp:export|capability to export to IMS CP]] for the role of teacher then go to ''Settings > Book administration > Generate IMS CP''.

==Why only two levels?==

Two levels are generally enough for all books, three levels may lead to poorly structured documents. The Book module is designed for the creation of short multi-page study materials. Consider uploading a file in PDF format for longer documents.

==How do I search within a book resource?==

There is no internal search facility, though you can always use your web browser's search capability in print page view.
==Can I import a powerpoint into a book?==
See the forum post [https://moodle.org/mod/forum/discuss.php?d=218473 Semi-automated Powerpoint to Book import macro]for one possible method.

==Can I change the font of the print view for Book?==
Not easily. In book view your theme controls how is your book is displayed, where as during printing, book/tool/print/print.css determines the font, which is defaulted to Times New Roman. See https://moodle.org/mod/forum/discuss.php?d=220147#p972743

#A hack: you can in Print view use some utility like [http://getfirebug.com/ Firebug] to change the font.
#Another hack: Also see suggestion here: https://moodle.org/mod/forum/discuss.php?d=220147#p1066265
#Tracker item: https://tracker.moodle.org/browse/MDL-43385

==Why does Moodle hard code the print CSS to output books in Print format?==
Not sure. If anyone at Moodle knows, so far they are not telling.

==See also==

* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=208324 Moving Book from One Course to Another] forum discussion

[[Category:FAQ]]

[[de:Buch FAQ]]

Quiz FAQ

2014-10-28T00:24:47Z

Derekcx: Add link

{{Quiz}}

==How can I randomly generate a quiz from a larger question bank?==
See the section on adding random questions in [[Building Quiz]].

==Can I have different start times/timings/numbers of attempts for different groups?==
*In the Quiz administration settings block, there is a link "group override".
*Click this link and you will be able to select your groups and change the quiz dates, times and number of attempts:

[[File:quizgroupoverride.png]]

==What happens if students submit answers after the quiz closing date?==
It is possible for students to still submit answers after the quiz has closed (for example if they started the attempt before the closing date but then took a long time before submitting). These responses are stored by the quiz module, but the students are not given any credit for them. The teacher can see these answers when reviewing the student's attempts and can give the student credit for them by hand. Also the teacher could change the closing date after the fact and regrade the attempts. The students answers would then get graded.

==Is there a nice way to print a copy of a quiz?==

Not at the moment. See this tracker request: [https://tracker.moodle.org/browse/MDL-348 Printer-friendly (more compact) layout option for quiz]
*Also this discussion, where there is an unlikely hack: https://moodle.org/mod/forum/discuss.php?d=222565
*Some CSS suggestions here: https://moodle.org/mod/forum/discuss.php?d=205969#p899667
*The University of Vienna published an [http://www.academic-moodle-cooperation.org/en/modules/offline-quiz/ offline quiz module for Moodle 2.2+] available for [http://www.academic-moodle-cooperation.org/en/modules/offline-quiz/ download in GitHub].

Also note the comments here: https://docs.moodle.org/en/Effective_quiz_practices#Printing_and_sharing_questions

See this [https://moodle.org/plugins/view.php?plugin=qformat_wordtable addon] for exporting questions (including images) in a question bank into a Word file

Eion Campbell has a plugin that may be usefull here: https://moodle.org/plugins/view.php?plugin=qformat_htmltable

==Why am I no longer allowed to add or remove questions?==
Most likely it is because you have students that have already attempted the quiz. You will need to delete all of the attempts by selecting them and choosing to delete them if you need to add/remove questions from a quiz.

If you are developing a new quiz where the attempts have just been trials then deleting the previous attempts will have no consequeces in the grade book.

If this is not the case think carefully about how to handle the graded attempts.

There are several ways of getting to the “attempts #” which you need to click on to delete the previous attempts. Use which ever works for you.
#Click on the quiz that you want to amend. It will take you to a page with “attempts #" at the top.
#If you are on a page with this message “You cannot add or remove questions because the quiz has been attempted (attempts #)” Click on "attempts #".
#If you have navigated away from the page with the message go to the Settings block > Quiz Administration > Edit Quiz.
Whichever way you find “attempts #” click on it and you will go to a page with a drop down menu at the top. Select “all users who have attempted the quiz”. There are several other click boxes select whatever applies to your situation.
Click “Show Report” and then “select all”. Click “Delete selected attempts” and confirm selection.

Go back to Quiz Administration > Edit Quiz and you will now be able to add or delete questions.

==How can I turn off glossary auto-linking in a quiz? ==
*In the Quiz administration settings block there will be a link "filter".
*Click the link and you will have the option to disable filters just for that particular quiz:

[[File:quizfilter.png]]

==How can I remove a problem question after the quiz has been taken?==

You can not remove a question once a quiz has been taken by one student or more. However you can change the score and flag the question so you know it has problems.

Set the score for that question to 0.
*Caution: In some versions of Moodle if you use this question in an other quiz, this will potentially change the question in that quiz as well. A trick is to score the question as 0, then regrade the just completed quiz. This will establish the new grade for gradebook. Now go back and change the score to the original value.

Find the question in Question Bank. Maybe edit the title (Do not use in Bio101). Or if you do not share the question category with other teachers, create a sub category, move the offending question there, and perhaps create a better question to replace the one you just moved. Create a new quiz and if necessary hide the old one.
*Caution: if other departments or teachers use a question category it might be wise to check with the team before moving or changing any question. This is one reason importing questions in a course is a good best practice in some situations.

==Can I have a quiz that is not graded?==

This is not a common requirement, so it may not work perfectly, but you can get close:

# On the quiz editing page, set the score for each question, and the total score for the quiz to 0.
# On the quiz settings page, there is a grid of check-boxes. Turn off all the ones in the score column.

==Why is my quiz not displaying in the gradebook?==
*Check that you have a maximum score that is more than 0 - if your score is 0, then the quiz will not appear in the gradebook.

Remember you can tell gradebook not to include the quiz.

==How do I allow a person to retake a quiz if I have it set for 1 attempt?==
*In the Quiz administration settings block, there is a link "user overrides".
*Click this link and you can change the allowed number of attempts for that user. Screenshot:[https://docs.moodle.org/24/en/File:quizuseroverride.png]

==How can I give particular students extra time in a timed quiz?==
*In the Quiz administration settings block there is a link "user overrides"
*Click this link and you will be able to choose one or more users and change the timing of their quiz

[[File:quizuseroverride.png]]

==I've entered quiz grades manually in the gradebook. How can I allow students to improve on these grades?==

When a grade is entered directly in the gradebook, an "overridden" flag is set, meaning that the grade can no longer be changed from within the quiz.

However, the flag can be removed by turning editing on in the [[Grader report|grader report]], then clicking the [[Grade editing|edit grade]] icon, unchecking the overridden box and saving the changes.

==How can I enable notification of quiz submissions?==

See [[Quiz submission notification]].

==Why can't people (guests) take a quiz without creating an account and logging in?==

This is difficult to implement for technical reasons.

To explain: The quiz has to link all information about an attempt to a particular 'user' record in the database, and each user can only have one open quiz attempt at a time. All not-logged-in users share the same 'guest' user database record. Therefore, two guests could not attempt the quiz at the same time, and even if they could, it would be difficult to prevent one guest seeing another guest's attempts.

Of course, given enough work, it would be possible to change some of those assumptions, and so make it possible for guests to attempt quizzes. Indeed, some of the obstructions to implementing this have already been removed while doing other work on the quiz, but there is still some way to go.

If you would like to see this implemented, please vote for MDL-17892.

A workaround is to create a visitor account, say with username = password = visitor, for everyone to share.

==Can you explain the error The number of random questions required is more than are still available in the category!==

Review your quiz and verify Moodle has enough questions from each category of questions it will be pulling from. You may have inadvertently selected more questions than what exists in the category. Also make sure you're not pulling questions from a category that has zero questions. Because you are picking random questions, rather than a specific question, it may not be apparent at first that you have run out of questions to ask!

==How do I send a bulk message to all students who haven't completed a quiz?==
*From your navigation block, click ''Reports>Course participation''
*From the drop down, choose your quiz.
*In ''Show only'', choose "Student" and in ''Actions'', choose "post"
*In the list that appears, tick/check the boxes next to those you wish to message.
*In the bottom dropdown ''With selected users'', choose "send message"

[[File:quizemail.png]]

==Can I download the quiz questions in a non-Moodle format?==
You might want to keep a local copy of quiz questions as evidence. While Moodle doesn't offer a built-in method of doing this, suggestions include:
#previewing the quiz, getting to the review page and from your computer, choosing "Save as...webpage complete" and
#exporting the question as Moodle XML, or GIFT format. If you open either of those files in a text-editor, you should be able to see most details of each question. Not very pretty, but accurate.

==How can I turn off question flagging?==
By default, flags are available in quiz questions.

[[File:flag.png]]

There is a capablity attached to this: [[Capabilities/moodle/question:flag]]. Remove this capability from roles that you don't want to see the flags. You can either do that by editing the role definitions globally, or by overriding the permissions in just one quiz or course.

==How do I create system-wide question categories?==
* As an administrator or user with system permissions, go to ''Question bank>categories'' in any course.
*Using the "Add category form" at the bottom of the page, set the parent of the new category to be the system context.

==How can I prevent a student from reviewing or jumping around questions in a quiz?==
You can block the quiz navigation block and the summary of quiz page with CSS code in a theme. However, if a student fails to answer a question, they will not know if you implement this "solution". Also if others on the site do not want this patch, make sure the theme you select for the course is not used by others.

For example using the Afterburner theme: Site Administration >Appearance >Themes >Afterburner and enter this in the CSS code area:

:div#mod_quiz_navblock {visibility:hidden;}
:table.quizsummaryofattempt {visibility:hidden;}

There are other css solutions.

==How can I minimise the load on the server while using quizzes?==
*Try to avoid a lot of students starting a quiz at the same time
*Check these discussions:
**https://moodle.org/mod/forum/discuss.php?d=213259
**https://moodle.org/mod/forum/discuss.php?d=215641
**https://moodle.org/mod/forum/discuss.php?d=215130

For other notes on performance with quizzes, see the section 'Performance of different Moodle modules' in [[Performance recommendations]].
==How can I make the quiz timer "float" or move down the page?==
See this forum thread: [https://moodle.org/mod/forum/discuss.php?d=210049 How to make the quiz timer float] for one suggestion.

==Why are images not included when exporting quiz questions?==
Images are only included if you export the questions using Moodle XML format. For all other question export formats (including GIFT), you will get broken images. Please see forum post [https://moodle.org/mod/forum/discuss.php?d=244615 Students not able to see images in exported quiz questions]

==Why does the quiz timer keep counting down when the student is not looking at the quiz?==
It is not possible to stop the timer and start it again. Moodle cannot tell the difference between legitimate reasons for doing this (such as a fire alarm requiring evacuation of the test room) or a student simply using time going to another browser and googling the answers. Nor can Moodle tell if the connection has been lost, although the student does now get a warning MDL-42504

It might be preferable in certain circumstances, such as timed examinations using Quiz, to manually announce the start/end time, rather then rely on the quiz timer.

For further comments see:
* https://moodle.org/mod/forum/discuss.php?d=96194
* https://moodle.org/mod/forum/discuss.php?d=177180
* https://moodle.org/mod/forum/discuss.php?d=237847

==How can a "Never submitted quiz" be submitted?==
Currently there is no way to retrieve an attempt that was "Never Submitted", and get it back into the "In progress" state, but there is a tracker issue MDL-35745. Perhaps the best solution is to plan ahead and set your quiz to set your quiz to be submitted automatically. Failing that, see also this [https://moodle.org/mod/forum/discuss.php?d=212819 forum thread] which suggests:
# Update the quiz : set the "close the quiz" date after today
# Set "When time expires" to "There is a grace period ..."
#Under Grade set "Attempts allowed" to "unlimited"
#Question behavior: Each attempt builds on the last "Yes"
# Invite the students who did not close their exams
# Allow them to start a new attempt, and close it immediately.

==How can I hide the number of marks available for each question?==

This is not really possible unless you are prepared to edit the code.

If you have a custom theme, you can add CSS like this:
<code css>
.que .info .grade { display: none; }
</code>
or you could try to make it more specific, and only hide the grade before the question is answered:
<code css>
.que.answersaved .info .grade,
.que.invalidanswer .info .grade,
.que.notyetanswered .info .grade { display: none; }
</code>
You can also add this CSS using the [[Header_and_footer|Additional HTML admin setting]].

Alternatively, you can alter the PHP code here: https://github.com/moodle/moodle/blob/4de51c25ae227a727dcba7c39f6f644a5d47ce7a/mod/quiz/locallib.php#L1820. Change that line to give the behaviour you want, e.g.
<code php>
$options->marks = self::extract($quiz->reviewmarks, $when,
self::MARK_AND_MAX, self::HIDDEN);
</code>

Be warned that any of these approaches will affect every quiz in the Moodle site.

==How can a teacher dry run a quiz before it is released?==
* You have prepared a quiz exam for your students. It is currently in a hidden state.
* The exam opens on the day of the exam, at a time that the students know about.
* However, to satisfy yourself that it is doable in the time allotted, You wish to do a dry run yourself before that date.
* How can You accomplish this?

===Method 1===
You can use the Preview feature available to you as a teacher as you are making the quiz.

===Method 2===
* Make a dummy account with a name like "Test Student".
* Enrol that user in the course as a student.
* Add a "User override" to the quiz, so "Test Student" can attempt the quiz before it is open to everyone else.
* Log in as "Test student".
* Attempt the quiz.
* Log back in as teacher.
* Review the attempt.
* Go to Results -> Grades and delete the test attempt.
* Un-enrol "Test Student" from your course.

===Method 3===
* Set up a Moodle Playground course for your teachers.
* Add teachers with dual role (teacher and student).
* This provides them a place to test things out.
* Teachers can later copy the quiz/assignment/whatever over to their live class.

==How can I prevent a student doing a quiz for another student?==
For some ideas on preventing cheating, see the forum thread [https://moodle.org/mod/forum/discuss.php?d=271100#p1168345 User dependent locking and unlocking of quizzes]

==See also==
* [[Quiz Time Limit]]

Using Moodle forum discussions:

*[http://moodle.org/mod/forum/discuss.php?d=96326 Removing "Submit all and Finish" button]
*[http://moodle.org/mod/forum/discuss.php?d=141003 How do you keep people from cheating while taking a quiz?]
*[http://moodle.org/mod/forum/discuss.php?d=131325 Scientific notation in quiz answers]
*[http://moodle.org/mod/forum/discuss.php?d=158846 Quiz answers appear in wrong language]
*[http://moodle.org/mod/forum/discuss.php?d=196206 Random Order Override]

Related FAQs:
* [[Import and export FAQ]] - for hints on importing questions
* [[XML FAQ]] - for information on creating and importing questions in Moodle XML format

==External links==
* [http://www.alfiekohn.org/teaching/cheating.htm Who is Cheating Whom] article

[[Category:FAQ]]

[[de:Test FAQ]]
[[es:Examen FAQ]]

Grading Quiz

2014-10-28T00:20:21Z

Derekcx: Add link to plugin

{{stub}}
{{Quiz}}

==Grading quizzes==
Some questions auto mark. Some need manual grading.

===Quiz overview===
This enables you to grade one question at a time.

===Manual Grading Report===
This enables you to grade all of one question on one page.

For more information see [[Quiz_manual_grading_report|Manual Grading Report]]

Note: there is a report plugin to enable you to grade all the questions for one student here: https://moodle.org/plugins/view.php?plugin=quiz_gradingstudents

====Options====

===Tips===

[[es:Calificación del examen]]

Media FAQ

2014-10-02T21:54:54Z

Derekcx: Another possible answer

{{Working with media}}
==Should I put my video into a label or a page?==
While the embedding process is the same, adding a video to a label will mean it displays as soon as the user clicks on that course page. This can be beneficial if the video is, for example, an introduction to the course or an integral part of the whole course. However, if there are several videos in labels, they can slow the loading of the course down, especially if the videos are coming from an external site. Adding a video to a page in Moodle means that the user has to click a text link to reach the video, but it doesn't clutter up the main course page and it is a better choice if the course contains a large number of videos.

==My embedded video is too big/small. How can I change its display size?==
*With the editing turned on, click the edit (hand/pen) icon to get into the HMTL editor where you embedded your video.
*Click the HTML code icon:
[[File:Htmlcodeicon.png]]
*You will see the code of your video there.

*'''For videos you uploaded yourself...''' Find the file extension (such as flv or wmv) and just '''after''' the file extension and '''before''' the ", type in ''?d=400x300''(for example) where 400 and 300 are the width and height in pixels of the display size you wish your video to be:
[[File:Resizevideo.png]]
*'''For external videos you embedded with embed code'''...Change the height and width numbers to the size in pixels you wish your video to be:
[[File:Youtuberesize.png]]

*Click ''Update'' and then, on the next screen, click ''Save changes''. Your video will now display in a different size.

==Why is the size and player for MP4 video clips hard coded?==
Not sure. If anyone from out there knows, so far they have not let on any reasons. See MDL-43385

==Why won't my swf video play?==
The .swf format carries with it some security issues and so the filter that allows it to display is disabled by default. For you to be able to add .swf videos, your administrator needs to enable the filter in [[Multimedia_plugins|Multimedia plugins]], then to go to ''Site Administration>Security>Site policies'' and check the "enable trusted content" box. They then need to go to ''Site Administration>Users>Permissions>Define roles'' and allow Trust Submitted content ''moodle/site:trustcontent'' for your role. However; swf will still not display in all areas of Moodle, for example forum posts. See this discussion [http://moodle.org/mod/forum/discuss.php?d=183681#p800390| here]

==How can I convert my video file to an .FLV or other format?==
*There are many sites online that allow you to upload a file which will then be converted and sent to you via a link or email. Zamzar [http://www.zamzar.com]or Youconvertit [http://www.youconvertit.com] are just two examples.
*However, if it is a large video file or you want to do the conversion off line, then the free Any Video Converter [http://www.any-video-converter.com/products/for_video_free/] (a downloadable program) will convert most video formats to most others.
*More and more full-featured MTS Video Converter [http://www.mtsconverterfree.com/]software free download a trial, to solve your problem more format conversions.
*The free and open source video player, VLC has the ability to convert to and from many video formats. For more details and downloads [http://www.videolan.org/vlc/ visit their site].
*If you are using Linux as your operating system either ffmpeg or avconv can both convert to FLV.

== I have a .wma/wav file. How can I play it in Moodle's player?==
*There are various free programs available that will convert one type of sound file to another. If you convert your file to an mp3 then you will be able to use Moodle's built-in mp3 player.
*Jodix Free WMA to MP3 converter [http://www.wma-mp3.org/] is just one example

== I have an MP4 file. How can I play it in Moodle's player? (ie Flowplayer)==
It seems that the media filter is hard coded to NOT use Flowplayer for MP4.
*See the discussion here: https://moodle.org/mod/forum/discuss.php?d=208849#p914927. Renaming an MP4 to an FLV seems to create a file that will play in Flowplayer.
*See the discussion here: https://docs.moodle.org/dev/Media_embedding
*See the discussion about [https://moodle.org/mod/forum/discuss.php?d=232296#p1048676 how to play mp4 videos in Moodle]

You can vote for a change here: MDL-43385

== What's the best way to manage/deploy MP4 files in Moodle? ==
And why bother about this? MP4 is probably the most common format, and it will play on both Flash enabled and disabled devices. It's a common question.

See above. Until we find out more information, it's difficult to get MP4 files into Moodle simply AND playing nicely. ie pick ONE.
#To play nicely: you need to do complex embedding etc. So it's not simple.
#To get them in simply: you drag and drop. But then they don' t play nicely, unless you want a small ugly looking product.
===The Videofile plugin option===
One option is the [[Videofile]] plugin.
*Download: https://docs.moodle.org/32/en/Videofile
*About: https://docs.moodle.org/32/en/Videofile
===The Re-naming option===
ie Don't use MP4's but rename to FLV
===The Youtube (etc) repository option===
Upload your file to Youtube and link to it.
===Possible use of the PooDLL plugin===
See discussion here:

===?? There may be other options===
Please feel free to add.

==Can you stop Flowplayer from preloading a video?==
*See the discussion here: http://moodle.org/mod/forum/discuss.php?d=184081

[[Category:FAQ]]

[[de:Multimedia FAQ]]
[[es:Medios FAQ]]

Media FAQ

2014-10-02T21:53:47Z

Derekcx: Another FAQ

{{Working with media}}
==Should I put my video into a label or a page?==
While the embedding process is the same, adding a video to a label will mean it displays as soon as the user clicks on that course page. This can be beneficial if the video is, for example, an introduction to the course or an integral part of the whole course. However, if there are several videos in labels, they can slow the loading of the course down, especially if the videos are coming from an external site. Adding a video to a page in Moodle means that the user has to click a text link to reach the video, but it doesn't clutter up the main course page and it is a better choice if the course contains a large number of videos.

==My embedded video is too big/small. How can I change its display size?==
*With the editing turned on, click the edit (hand/pen) icon to get into the HMTL editor where you embedded your video.
*Click the HTML code icon:
[[File:Htmlcodeicon.png]]
*You will see the code of your video there.

*'''For videos you uploaded yourself...''' Find the file extension (such as flv or wmv) and just '''after''' the file extension and '''before''' the ", type in ''?d=400x300''(for example) where 400 and 300 are the width and height in pixels of the display size you wish your video to be:
[[File:Resizevideo.png]]
*'''For external videos you embedded with embed code'''...Change the height and width numbers to the size in pixels you wish your video to be:
[[File:Youtuberesize.png]]

*Click ''Update'' and then, on the next screen, click ''Save changes''. Your video will now display in a different size.

==Why is the size and player for MP4 video clips hard coded?==
Not sure. If anyone from out there knows, so far they have not let on any reasons. See MDL-43385

==Why won't my swf video play?==
The .swf format carries with it some security issues and so the filter that allows it to display is disabled by default. For you to be able to add .swf videos, your administrator needs to enable the filter in [[Multimedia_plugins|Multimedia plugins]], then to go to ''Site Administration>Security>Site policies'' and check the "enable trusted content" box. They then need to go to ''Site Administration>Users>Permissions>Define roles'' and allow Trust Submitted content ''moodle/site:trustcontent'' for your role. However; swf will still not display in all areas of Moodle, for example forum posts. See this discussion [http://moodle.org/mod/forum/discuss.php?d=183681#p800390| here]

==How can I convert my video file to an .FLV or other format?==
*There are many sites online that allow you to upload a file which will then be converted and sent to you via a link or email. Zamzar [http://www.zamzar.com]or Youconvertit [http://www.youconvertit.com] are just two examples.
*However, if it is a large video file or you want to do the conversion off line, then the free Any Video Converter [http://www.any-video-converter.com/products/for_video_free/] (a downloadable program) will convert most video formats to most others.
*More and more full-featured MTS Video Converter [http://www.mtsconverterfree.com/]software free download a trial, to solve your problem more format conversions.
*The free and open source video player, VLC has the ability to convert to and from many video formats. For more details and downloads [http://www.videolan.org/vlc/ visit their site].
*If you are using Linux as your operating system either ffmpeg or avconv can both convert to FLV.

== I have a .wma/wav file. How can I play it in Moodle's player?==
*There are various free programs available that will convert one type of sound file to another. If you convert your file to an mp3 then you will be able to use Moodle's built-in mp3 player.
*Jodix Free WMA to MP3 converter [http://www.wma-mp3.org/] is just one example

== I have an MP4 file. How can I play it in Moodle's player? (ie Flowplayer)==
It seems that the media filter is hard coded to NOT use Flowplayer for MP4.
*See the discussion here: https://moodle.org/mod/forum/discuss.php?d=208849#p914927. Renaming an MP4 to an FLV seems to create a file that will play in Flowplayer.
*See the discussion here: https://docs.moodle.org/dev/Media_embedding
*See the discussion about [https://moodle.org/mod/forum/discuss.php?d=232296#p1048676 how to play mp4 videos in Moodle]

You can vote for a change here: MDL-43385

== What's the best way to manage/deploy MP4 files in Moodle? ==
And why bother about this? MP4 is probably the most common format, and it will play on both Flash enabled and disabled devices. It's a common question.

See above. Until we find out more information, it's difficult to get MP4 files into Moodle simply AND playing nicely. ie pick ONE.
#To play nicely: you need to do complex embedding etc. So it's not simple.
#To get them in simply: you drag and drop. But then they don' t play nicely, unless you want a small ugly looking product.
===The Videofile plugin option===
One option is the [[Videofile]] plugin.
*Download: https://docs.moodle.org/32/en/Videofile
*About: https://docs.moodle.org/32/en/Videofile
===The Re-naming option===
ie Don't use MP4's but rename to FLV
===The Youtube (etc) repository option===
Upload your file to Youtube and link to it.
===?? There may be other options===
Please feel free to add.

==Can you stop Flowplayer from preloading a video?==
*See the discussion here: http://moodle.org/mod/forum/discuss.php?d=184081

[[Category:FAQ]]

[[de:Multimedia FAQ]]
[[es:Medios FAQ]]

Text editor

2014-09-25T11:39:01Z

Derekcx:

{{Editing text}}
The text editor (sometimes referred to as the 'HTML editor' has many icons to assist the user in entering content. Many of these icons and functions should be familiar to anyone who uses a word processor. However, writing for the web on the web is different, and especially with accessibility and design considerations Atto sometimes you may not do what you expect with a normal editor, or even the old default editor in Moodle.

For some comment on this, [https://moodle.org/mod/forum/discuss.php?d=265176 please see this post]

Some examples of where you will see the text editor include: Editing Section headings, description of an activity, writing an answer to a quiz question or editing the content of many blocks.

The default text editor in Moodle is the Atto editor, built specifically for Moodle. There is also a version of the [[TinyMCE editor]] and a plain text editor.

Text editors can be enabled, disabled or a different one set to default from ''Administration > Site administration > Plugins > Text editors > Manage editors''. The order of priority may also be specified here.

An individual user can select an editor in their profile from ''Administration > My Profile settings > Edit profile.''

==Atto HTML editor==
{{New features}}

[[File:Atto1.png]]

Atto Row 1

{| class="nicetable"
|-
|-
| 1:Expand
| 2.Style
| 3.Bold
| 4.Italic
|-
| 5.Bulleted list
| 6.Numbered list
| 7.Add link
| 8.Unlink
|-
| 9.Add image
| 10.Add media
| 11.Manage embedded files

|}

[[File:Atto22.png]]

Atto Row 2

{| class="nicetable"
|-
|-
| 1. Underline
| 2. Strikethrough
| 3. Subscript
| 4. Superscript
|-
| 5. Align left
| 6. Align centre
| 7. Align right
| 8. Increase indent
|-
| 9. Decrease indent
| 10. Equation editor
| 11. Special character
| 12. Table
|-
| 13. Clear formatting
| 14. Undo/redo
| 15. Undo/redo
| 16. Accessibility checker
|-
| 17. Screenreader helper
| 18. HTML/code view
|}

==Equation editor==

{{New features}}If either the [[MathJax filter|MathJax]] or the [[TeX notation filter|TeX notation]] filters are enabled (in ''Administration > Site administration > Plugins > Filters > Manage filters'') then an equation editor button is provided in the toolbar for launching the equation editor.
{|
| [[File:equation editor.png|thumb|Equation editor]]
|}

==Site administration settings==

===Toolbar settings===

The administrator can specify which plugins to display and in which order from ''Administration > Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings''.
[[File:atto-plugins.png|thumb|center|450px|Atto Plugins]]

Extra plugins from the list (for example 'Font color' or 'Emoticon') may be added by typing the toolbarconfig term into the toolbar config table.

[[File:toolbarconfig.png]]

Here for example are the available colours when 'fontcolor' is added:

[[File:fontcolor.png]]

The icons are displayed in related groups and the administrator can decide how many groups to display in the default collapsed state of the toolbar (that is, how many groups to display on Row 1).
==== Non default Atto plugins ====
Not all plugins are enabled by default and the administrator of each site should give careful thought as to which plugins they choose to enable for their users. Here are some things to consider before enabling the non-default plugins:

===== Background colour / Font colour =====
While these are very popular plugins, there are downsides to enabling their use on a site. Firstly - user specified colours may conflict visually with the site colours chosen by the theme designer. Even if the colours of the content does not conflict with the colours of the current theme, if the theme is changed in future, or the content is reused on a different site conflicts may be introduced. There are 2 possible types of conflicts, the first is just a visually unappealing combination of colours, the second is a combination of colours that may produce text that is hard to read for some people. It is preferable if the theme designer uses some interesting colours that meet the accessibility standards required for the site in the theme for the site, and the person creating the content simply uses the proper heading levels (for example) to make use of those styles.

===== Emoticons =====
The emoticon plugin inserts text representations of the emoticons in the content. The emoticon filter is responsible for converting these text sequences into proper smiley images. The emoticon filter is not enabled by default, which is why the emoticon plugin for Atto is not enabled by default.

===== No-auto link =====
In general, the more plugins are added to the Atto toolbar, the harder it becomes to find specific plugins. Because the no-auto link plugin is not felt to be widely used it is not enabled by default.

===== Right to left =====
Because this plugin is only useful for courses where text needs to be written in a mixture of both "left to right" and "right to left" languages, it is not enabled by default.

==== Moodle plugins directory ====

There are more plugins available for Atto than just those included in a default install.

See the [https://moodle.org/plugins/browse.php?list=category&id=53 Moodle plugins directory] for additional plugins.

===Some examples include===

===Equation editor settings===

Equation editor commands may be removed, added or reordered in ''Administration > Site administration > Plugins > Text editors > Atto HTML editor > Equation editor settings''.

[[File:equationeditor.png]]

==Dragging/dropping images into the text editor==
* If your browser supports it, you can drag and drop images into a [[Page]], [[Questions]] and [[Labels]].
* Images dragged into a [[Forum ]] post will not appear.
* Images cannot be dragged and dropped using Chrome or IE, but it is possible with Firefox.
* [https://moodle.org/mod/forum/discuss.php?d=270053 This forum thread] has more discussion on the matter.
* There is a tracker item for drag and drop here: https://tracker.moodle.org/browse/MDL-43996

==See also==

* [http://youtu.be/GNQSK_fPV98 Moodle HQ screencast demonstrating Atto editor]
* [http://youtu.be/ZoOAkpK9Oho The Moodle Text Editor - Atto] MoodleBites video on YouTube
* [[Text editor FAQ]]
* [[Embedded files repository]]
* [https://moodle.org/mod/forum/discuss.php?d=258631 New 2.7 Equation Editor - Missing Key Items] forum discussion and associated issue MDL-45067

[[Category:Site administration]]

[[de:Text-Editor]]
[[es:Editor de texto]]

Text editor

2014-09-25T10:56:40Z

Derekcx:

{{Editing text}}
The text editor (sometimes referred to as the 'HTML editor' has many icons to assist the user in entering content. Many of these icons and functions should be familiar to anyone who uses a word processor. However, writing for the web on the web is different, and especially with accessibility and design considerations Atto sometimes you may not do what you expect with a normal editor, or even the old default editor in Moodle.

For some comment on this, [please see this post https://moodle.org/mod/forum/discuss.php?d=265176]

Some examples of where you will see the text editor include: Editing Section headings, description of an activity, writing an answer to a quiz question or editing the content of many blocks.

The default text editor in Moodle is the Atto editor, built specifically for Moodle. There is also a version of the [[TinyMCE editor]] and a plain text editor.

Text editors can be enabled, disabled or a different one set to default from ''Administration > Site administration > Plugins > Text editors > Manage editors''. The order of priority may also be specified here.

An individual user can select an editor in their profile from ''Administration > My Profile settings > Edit profile.''

==Atto HTML editor==
{{New features}}

[[File:Atto1.png]]

Atto Row 1

{| class="nicetable"
|-
|-
| 1:Expand
| 2.Style
| 3.Bold
| 4.Italic
|-
| 5.Bulleted list
| 6.Numbered list
| 7.Add link
| 8.Unlink
|-
| 9.Add image
| 10.Add media
| 11.Manage embedded files

|}

[[File:Atto22.png]]

Atto Row 2

{| class="nicetable"
|-
|-
| 1. Underline
| 2. Strikethrough
| 3. Subscript
| 4. Superscript
|-
| 5. Align left
| 6. Align centre
| 7. Align right
| 8. Increase indent
|-
| 9. Decrease indent
| 10. Equation editor
| 11. Special character
| 12. Table
|-
| 13. Clear formatting
| 14. Undo/redo
| 15. Undo/redo
| 16. Accessibility checker
|-
| 17. Screenreader helper
| 18. HTML/code view
|}

==Equation editor==

{{New features}}If either the [[MathJax filter|MathJax]] or the [[TeX notation filter|TeX notation]] filters are enabled (in ''Administration > Site administration > Plugins > Filters > Manage filters'') then an equation editor button is provided in the toolbar for launching the equation editor.
{|
| [[File:equation editor.png|thumb|Equation editor]]
|}

==Site administration settings==

===Toolbar settings===

The administrator can specify which plugins to display and in which order from ''Administration > Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings''.
[[File:atto-plugins.png|thumb|center|450px|Atto Plugins]]

Extra plugins from the list (for example 'Font color' or 'Emoticon') may be added by typing the toolbarconfig term into the toolbar config table.

[[File:toolbarconfig.png]]

Here for example are the available colours when 'fontcolor' is added:

[[File:fontcolor.png]]

The icons are displayed in related groups and the administrator can decide how many groups to display in the default collapsed state of the toolbar (that is, how many groups to display on Row 1).
==== Non default Atto plugins ====
Not all plugins are enabled by default and the administrator of each site should give careful thought as to which plugins they choose to enable for their users. Here are some things to consider before enabling the non-default plugins:

===== Background colour / Font colour =====
While these are very popular plugins, there are downsides to enabling their use on a site. Firstly - user specified colours may conflict visually with the site colours chosen by the theme designer. Even if the colours of the content does not conflict with the colours of the current theme, if the theme is changed in future, or the content is reused on a different site conflicts may be introduced. There are 2 possible types of conflicts, the first is just a visually unappealing combination of colours, the second is a combination of colours that may produce text that is hard to read for some people. It is preferable if the theme designer uses some interesting colours that meet the accessibility standards required for the site in the theme for the site, and the person creating the content simply uses the proper heading levels (for example) to make use of those styles.

===== Emoticons =====
The emoticon plugin inserts text representations of the emoticons in the content. The emoticon filter is responsible for converting these text sequences into proper smiley images. The emoticon filter is not enabled by default, which is why the emoticon plugin for Atto is not enabled by default.

===== No-auto link =====
In general, the more plugins are added to the Atto toolbar, the harder it becomes to find specific plugins. Because the no-auto link plugin is not felt to be widely used it is not enabled by default.

===== Right to left =====
Because this plugin is only useful for courses where text needs to be written in a mixture of both "left to right" and "right to left" languages, it is not enabled by default.

==== Moodle plugins directory ====

There are more plugins available for Atto than just those included in a default install.

See the [https://moodle.org/plugins/browse.php?list=category&id=53 Moodle plugins directory] for additional plugins.

===Some examples include===

===Equation editor settings===

Equation editor commands may be removed, added or reordered in ''Administration > Site administration > Plugins > Text editors > Atto HTML editor > Equation editor settings''.

[[File:equationeditor.png]]

==Dragging/dropping images into the text editor==
* If your browser supports it, you can drag and drop images into a [[Page]], [[Questions]] and [[Labels]].
* Images dragged into a [[Forum ]] post will not appear.
* Images cannot be dragged and dropped using Chrome or IE, but it is possible with Firefox.
* [https://moodle.org/mod/forum/discuss.php?d=270053 This forum thread] has more discussion on the matter.
* There is a tracker item for drag and drop here: https://tracker.moodle.org/browse/MDL-43996

==See also==

* [http://youtu.be/GNQSK_fPV98 Moodle HQ screencast demonstrating Atto editor]
* [http://youtu.be/ZoOAkpK9Oho The Moodle Text Editor - Atto] MoodleBites video on YouTube
* [[Text editor FAQ]]
* [[Embedded files repository]]
* [https://moodle.org/mod/forum/discuss.php?d=258631 New 2.7 Equation Editor - Missing Key Items] forum discussion and associated issue MDL-45067

[[Category:Site administration]]

[[de:Text-Editor]]
[[es:Editor de texto]]

Text editor

2014-09-25T10:50:32Z

Derekcx: Add tracker item

{{Editing text}}
The text editor (sometimes referred to as the 'HTML editor' has many icons to assist the user in entering content. Many of these icons and functions should be familiar to anyone who uses a word processor. Some examples of where you will see the text editor include: Editing Section headings, description of an activity, writing an answer to a quiz question or editing the content of many blocks.

The default text editor in Moodle is the Atto editor, built specifically for Moodle. There is also a version of the [[TinyMCE editor]] and a plain text editor.

Text editors can be enabled, disabled or a different one set to default from ''Administration > Site administration > Plugins > Text editors > Manage editors''. The order of priority may also be specified here.

An individual user can select an editor in their profile from ''Administration > My Profile settings > Edit profile.''

==Atto HTML editor==
{{New features}}

[[File:Atto1.png]]

Atto Row 1

{| class="nicetable"
|-
|-
| 1:Expand
| 2.Style
| 3.Bold
| 4.Italic
|-
| 5.Bulleted list
| 6.Numbered list
| 7.Add link
| 8.Unlink
|-
| 9.Add image
| 10.Add media
| 11.Manage embedded files

|}

[[File:Atto22.png]]

Atto Row 2

{| class="nicetable"
|-
|-
| 1. Underline
| 2. Strikethrough
| 3. Subscript
| 4. Superscript
|-
| 5. Align left
| 6. Align centre
| 7. Align right
| 8. Increase indent
|-
| 9. Decrease indent
| 10. Equation editor
| 11. Special character
| 12. Table
|-
| 13. Clear formatting
| 14. Undo/redo
| 15. Undo/redo
| 16. Accessibility checker
|-
| 17. Screenreader helper
| 18. HTML/code view
|}

==Equation editor==

{{New features}}If either the [[MathJax filter|MathJax]] or the [[TeX notation filter|TeX notation]] filters are enabled (in ''Administration > Site administration > Plugins > Filters > Manage filters'') then an equation editor button is provided in the toolbar for launching the equation editor.
{|
| [[File:equation editor.png|thumb|Equation editor]]
|}

==Site administration settings==

===Toolbar settings===

The administrator can specify which plugins to display and in which order from ''Administration > Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings''.
[[File:atto-plugins.png|thumb|center|450px|Atto Plugins]]

Extra plugins from the list (for example 'Font color' or 'Emoticon') may be added by typing the toolbarconfig term into the toolbar config table.

[[File:toolbarconfig.png]]

Here for example are the available colours when 'fontcolor' is added:

[[File:fontcolor.png]]

The icons are displayed in related groups and the administrator can decide how many groups to display in the default collapsed state of the toolbar (that is, how many groups to display on Row 1).
==== Non default Atto plugins ====
Not all plugins are enabled by default and the administrator of each site should give careful thought as to which plugins they choose to enable for their users. Here are some things to consider before enabling the non-default plugins:

===== Background colour / Font colour =====
While these are very popular plugins, there are downsides to enabling their use on a site. Firstly - user specified colours may conflict visually with the site colours chosen by the theme designer. Even if the colours of the content does not conflict with the colours of the current theme, if the theme is changed in future, or the content is reused on a different site conflicts may be introduced. There are 2 possible types of conflicts, the first is just a visually unappealing combination of colours, the second is a combination of colours that may produce text that is hard to read for some people. It is preferable if the theme designer uses some interesting colours that meet the accessibility standards required for the site in the theme for the site, and the person creating the content simply uses the proper heading levels (for example) to make use of those styles.

===== Emoticons =====
The emoticon plugin inserts text representations of the emoticons in the content. The emoticon filter is responsible for converting these text sequences into proper smiley images. The emoticon filter is not enabled by default, which is why the emoticon plugin for Atto is not enabled by default.

===== No-auto link =====
In general, the more plugins are added to the Atto toolbar, the harder it becomes to find specific plugins. Because the no-auto link plugin is not felt to be widely used it is not enabled by default.

===== Right to left =====
Because this plugin is only useful for courses where text needs to be written in a mixture of both "left to right" and "right to left" languages, it is not enabled by default.

==== Moodle plugins directory ====

There are more plugins available for Atto than just those included in a default install.

See the [https://moodle.org/plugins/browse.php?list=category&id=53 Moodle plugins directory] for additional plugins.

===Equation editor settings===

Equation editor commands may be removed, added or reordered in ''Administration > Site administration > Plugins > Text editors > Atto HTML editor > Equation editor settings''.

[[File:equationeditor.png]]

==Dragging/dropping images into the text editor==
* If your browser supports it, you can drag and drop images into a [[Page]], [[Questions]] and [[Labels]].
* Images dragged into a [[Forum ]] post will not appear.
* Images cannot be dragged and dropped using Chrome or IE, but it is possible with Firefox.
* [https://moodle.org/mod/forum/discuss.php?d=270053 This forum thread] has more discussion on the matter.
* There is a tracker item for drag and drop here: https://tracker.moodle.org/browse/MDL-43996

==See also==

* [http://youtu.be/GNQSK_fPV98 Moodle HQ screencast demonstrating Atto editor]
* [http://youtu.be/ZoOAkpK9Oho The Moodle Text Editor - Atto] MoodleBites video on YouTube
* [[Text editor FAQ]]
* [[Embedded files repository]]
* [https://moodle.org/mod/forum/discuss.php?d=258631 New 2.7 Equation Editor - Missing Key Items] forum discussion and associated issue MDL-45067

[[Category:Site administration]]

[[de:Text-Editor]]
[[es:Editor de texto]]

Media FAQ

2014-09-08T05:16:57Z

Derekcx: tracker link

Media FAQ

2014-09-08T05:15:59Z

Derekcx: Extra question

Book FAQ

2014-09-08T05:02:25Z

Derekcx: Why is font hard coded?

{{Book}}
==How can I enable students to edit a book?==

Students are not supposed to be able to edit book; allowing it would be a serious security issue. The [[Capabilities/mod/book:edit|capability to edit book chapters]] is intended strictly for trusted users.

==How can I enable students to import web pages?==

Do not allow students to import or edit books! Only trusted users should have the [[Capabilities/mod/book:edit|capability to edit book chapters]] and the [[Capabilities/booktool/importhtml:import|capability to import chapters]].

==How can I enable teachers to export a book to IMS content package?==

Allow the [[Capabilities/booktool/exportimscp:export|capability to export to IMS CP]] for the role of teacher then go to ''Settings > Book administration > Generate IMS CP''.

==Why only two levels?==

Two levels are generally enough for all books, three levels may lead to poorly structured documents. The Book module is designed for the creation of short multi-page study materials. Consider uploading a file in PDF format for longer documents.

==How do I search within a book resource?==

There is no internal search facility, though you can always use your web browser's search capability in print page view.
==Can I import a powerpoint into a book?==
See the forum post [https://moodle.org/mod/forum/discuss.php?d=218473 Semi-automated Powerpoint to Book import macro]for one possible method.

==Can I change the font of the print view for Book?==
Not easily. In book view your theme controls how is your book is displayed, where as during printing, book/tool/print/print.css determines the font, which is defaulted to Times New Roman. See https://moodle.org/mod/forum/discuss.php?d=220147#p972743

#A hack: you can in Print view use some utility like [http://getfirebug.com/ Firebug] to change the font.
#Another hack: Also see suggestion here: https://moodle.org/mod/forum/discuss.php?d=220147#p1066265

==Why does Moodle hard code the print CSS to output books in Print format?==
Not sure. If anyone at Moodle knows, so far they are not telling.

==See also==

* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=208324 Moving Book from One Course to Another] forum discussion

[[Category:FAQ]]

[[de:Buch FAQ]]

Template:More to come here

2014-08-15T03:40:06Z

Derekcx: Just a little bit of a template to save me typing

- '''More to come here (You are welcome to add something of course!!)''' -

Legacy course files

2014-06-28T22:03:23Z

Derekcx: /* In backups, are legacy files included with a course? */

{{Repositories}}
Note: This page only applies to sites which have been upgraded from Moodle 1.9.
In Moodle 2.0 onwards, files are stored in separate areas, rather than together in the course files area. See [[Course files]] for a detailed explanation. When a site is upgraded from 1.9, the course files area is renamed 'Legacy course files'. By default, this area is not available in new courses.

''It is recommended that teachers make use of the new [[Repositories|repositories]] in Moodle 2.0 for storing course files, rather than saving them in the legacy course files area''.

==Enabling legacy course files areas==

To enable a legacy course files area in a new course

# Enable the legacy course files repository plugin in ''Administration > Site administration > Plugins > Repositories > [[Manage repositories]]''.
# Check the legacyfilesinnewcourses box in the Manage repositories common settings then click the 'Save changes' button.
# Set 'Legacy course files' to Yes in the course settings.

A legacy course files link will then appear in the ''Administration > Course administration'' area.

==Repository capabilities==

The capabilities [[Capabilities/repository/coursefiles:view|Use course files repository plugin]] and [[Capabilities/moodle/course:managefiles|Manage files]] are both required for users to access the legacy course files area.

==FAQs==
===Can you find out disk volume of legacy files?===
No. You will need a custom report of some kind. See http://moodle.org/mod/forum/discuss.php?d=201601

===Where are legacy files stored?===
For one explanation, see http://moodle.org/mod/forum/discuss.php?d=164544

===Is there a way to delete legacy files en masse?===
Not at the moment. Tracker item: http://tracker.moodle.org/browse/MDL-36008 and discussion: https://moodle.org/mod/forum/discuss.php?d=209353

See also a comment here: https://moodle.org/mod/forum/discuss.php?d=234922#p1020379

===Is there a way to prevent new additions to legacy files?===
Yes. Unchecking [[Managing_repositories#Allow adding to legacy course files|Allow adding to legacy course files]] in ''Site Administration > Plugins > Repositories > Common repository settings'' will prevent users from adding new files and directories to legacy course files, but they will still be able to delete files.

===What happens if you switch legacy files off in a site that has been upgraded and has a lot of legacy files?===
Unsure.

===Can you migrate a course from 1.9 to 2+ and NOT end up with a legacy files repository?===
Yes, you can. If you restore as a Teacher into the course you're currently present in (best if it's empty) and don't override any settings then the Legacy Files will not be added as a Repository.

===What happens to the Legacy files in a course imported from 1.9 to 2.x that is re-imported into another 2.x?===

===In backups, are legacy files included with a course?===
Seems to be the case: http://moodle.org/mod/forum/discuss.php?d=194981

Also check out https://moodle.org/mod/forum/discuss.php?d=251415

===Long term, will there be any problem keeping a large number of Legacy files?===
Possibly if you want to import (as opposed to restore) you may lose legacy files. See
*http://tracker.moodle.org/browse/MDL-25631
*http://tracker.moodle.org/browse/MDL-32598

===What happens if legacy files were previously enabled and then the legacy course files repository is disabled?===

Legacy course files are displayed if they have ever been enabled on the course, but can be disabled at the course level in the course settings. Any new courses created will not have a legacy course files area.

==Also see==
*http://moodle.org/mod/forum/discuss.php?d=172559
*http://moodle.org/mod/forum/discuss.php?d=197746
*https://moodle.org/mod/forum/discuss.php?d=234922

[[ja: レガシーコースファイル]]
[[de:Legacy-Kursdateien]]
[[es:Archivos de curso heredados]]

User:Derek Chirnside/Wish List

2014-03-31T01:56:56Z

Derekcx: Just some thinking aloud.

==The wish list==
Copied from https://moodle.org/mod/forum/discuss.php?d=245531 and I may get round to editing this sometime.

==File management. Mainly deleting==

I know it is official Moodle policy to encourage the use of repositories, but there are still times when there is a need to use the various file areas. Deleting is a one by one operation in many places that we often use:

#Bulk delete in legacy files: https://tracker.moodle.org/browse/MDL-36008
#Bulk delete in User Private Backup Area: https://tracker.moodle.org/browse/MDL-33671
#Bulk delete in Automated backup area:
#Bulk delete when editing a folder: https://tracker.moodle.org/browse/MDL-36121
#There are probably more. Is it possible to get this sorted in all these areas with just one fix?

==Image management==

===Better image insertion into posts. Click and drag into the editor?===
Rationale: this is one of the most common things one does in a course with lots of interaction via forums. Tracker: https://tracker.moodle.org/browse/MDL-40172
===Ability to manage the resizing of images when uploading into the editor===
Rationale: people still don't get this!! https://tracker.moodle.org/browse/MDL-32183
==Reports==

There are a few basic extra reports that would be good. The problem of course is performance hits. "Give me a print our of the courses yet to be completed by our 23,000 students"

Here is one of the reports that have good justification for being in core:
*SPAM accounts deletion help. Maybe "A member of no courses report" - tracker item: https://tracker.moodle.org/browse/MDL-19190. Yes I know there are other ways to skin this cat.

There are five or six more I'd like, but I decided they really were too idiosyncratic.

==Quizzes==

This is a complex issue. Plugable questions and the new question engine are now humming along. But from a functionality point of view, here are two things I think would give good bang for buck.

===Improved view to mark a test for a single student===
https://tracker.moodle.org/browse/MDL-43310

Rationale: if you need to mark a quiz for one student, you need to click in and out of every question individually. Could be improved.
===Provide a way to ask a series of short free response questions with an associated quick marking page===
Rationale: some answers are short but too complex to mark automatically, even with the OU AI smarts built in. You just want a bunch of short answers to mark manually.

Tracker item: https://tracker.moodle.org/browse/MDL-31581
*And a bonus random: I'd love a tweet question, 135 characters free response.
==Forums in separate groups mode==

===ONE post to reach all groups===
I know this issue of forums is a complex issue. One reason ordinary forums in groups mode can cause grief for teachers:

You have 27 groups. It is not possible to write ONE post in a basic forum in groups mode and have it in all groups and able to be replied to. https://tracker.moodle.org/browse/MDL-19670 This has huge benefits for MOOC's.
==Groups==

No ability to self sign up. (surely!!) Good also for MOOCs.

==Book==

Why is ugly printing hard coded?

Journal module

2014-03-27T19:53:58Z

Derekcx:

{{Infobox plugin
|type = Activity
|entry = https://moodle.org/plugins/view.php?plugin=mod_journal
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10880
|discussion = http://moodle.org/mod/forum/view.php?id=736
|maintainer = David Monllaó
|float = Right
}}

==Background==
In Moodle 2.0 the Journal was removed from the core install, and is now available only as a plugin. For the history, please see this discussion: https://moodle.org/mod/forum/discuss.php?d=96334

==The purpose of the Journal==
What makes it different from an Online Assignment? How could you use it?

==Using the Journal==
In the shift from 1.9 to 2.x the help files seemed to get lost. I could not find any really current material, but there are some screenshots here: https://moodle.org/mod/forum/discuss.php?d=257145 (from AL). If you do do a little fixing up of the docs, delete this message. --[[User:Derek Chirnside|Derek Chirnside]] ([[User talk:Derek Chirnside|talk]]) 03:52, 28 March 2014 (WST)

[[en:Módulo Journal]]

Journal module

2014-03-27T19:52:34Z

Derekcx: Just a few tweaks to the journal docs

{{Infobox plugin
|type = Activity
|entry = https://moodle.org/plugins/view.php?plugin=mod_journal
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10880
|discussion = http://moodle.org/mod/forum/view.php?id=736
|maintainer = David Monllaó
|float = Right
}}

==Background==
In Moodle 2.0 the Journal was removed from the core install, and is now available only as a plugin.

==The purpose of the Journal==
What makes it different from an Online Assignment? How could you use it?

==Using the Journal==
In the shift from 1.9 to 2.x the help files seemed to get lost. I could not find any really current material, but there are some screenshots here: https://moodle.org/mod/forum/discuss.php?d=257145 (from AL). If you do do a little fixing up of the docs, delete this message. --[[User:Derek Chirnside|Derek Chirnside]] ([[User talk:Derek Chirnside|talk]]) 03:52, 28 March 2014 (WST)

[[en:Módulo Journal]]

Course Menu block

2014-03-18T00:38:13Z

Derekcx:

{{Infobox plugin
|type = Block, Course Menu
|entry = https://moodle.org/plugins/view.php?plugin=block_course_menu
|tracker = https://tracker.moodle.org/browse/MDL-27039 and see https://moodle.org/mod/forum/discuss.php?d=169107#p741779
|discussion = https://tracker.moodle.org/browse/MDL-27039
|maintainer = [[User:Alex Contis|Alex Contis]]
|float = right
}}

This is a quick start for some documentation for the Course Menu Block plugin.

Get the code and information about the block here: https://moodle.org/plugins/view.php?plugin=block_course_menu

There is a tracker item suggesting this is worth putting in core. https://tracker.moodle.org/browse/MDL-27039

==What this block does==

At present there is no simple section to section navigation in regular moodle. The course menu bock takes the title of each section and puts them in a menu block. When combined with a format that shows one section per page, you then have simple section <> section navigation.

[[File:Course Menu.png]]

==Other links in the block==

These are configurable:

==History of this block==

[[Category:Contributed code]]

[[es:Bloque del menú del curso]]

Talk:Forum FAQ

2014-03-09T20:21:59Z

Derekcx:

Suggested FAQ addition:

"How can a teacher see all of a student's forum posts in a course?"
"How can students see all of their forum posts on Moodle?"

I don't find it addressed anywhere obvious, and it's a basic need for quick navigation and assessment.

:Yes, a good addition Clay. Maybe a link to the tracker items for this may help as well. --[[User:Derek Chirnside|Derek Chirnside]] ([[User talk:Derek Chirnside|talk]]) 04:21, 10 March 2014 (WST)

Grader report LAE

2014-02-13T22:55:21Z

Derekcx: A start to the documentation for this.

This is a new plugin, and a quick start to some docs. Please add as you wish.

#On the plugins database: https://moodle.org/plugins/view.php?plugin=gradereport_laeuser
#In the forums, some help: https://moodle.org/mod/forum/discuss.php?d=254137
#On GIT: https://github.com/bobpuffer/moodle-gradereport_laeuser

==What this does==

==Features, advantages and benefits===
"We know that students perform better given clear expectations and immediate and constant feedback because they feel they are more in control of the ultimate outcome. When students feel in control of their college outcome they stick around to graduate. This is what the new LAE User student grade report is all about" (Lifted from Bob's post in the thread mentioned above.

Course Menu block

2014-02-13T22:25:25Z

Derekcx: add tracker item

This is a quick start for some documentation for the Course Menu Block plugin.

Get the code and information about the block here: https://moodle.org/plugins/view.php?plugin=block_course_menu

There is a tracker item suggesting this is worth putting in core. https://tracker.moodle.org/browse/MDL-27039

==What this block does==

At present there is no simple section to section navigation in regular moodle. The course menu bock takes the title of each section and puts them in a menu block. When combined with a format that shows one section per page, you then have simple section <> section navigation.

[[File:Course Menu.png]]

==Other links in the block==

These are configurable:

==History of this block==

[[Category:Contributed code]]

Course Menu block

2014-02-13T22:18:04Z

Derekcx:

This is a quick start for some documentation for the Course Menu Block plugin.

Get the code and information about the block here: https://moodle.org/plugins/view.php?plugin=block_course_menu

==What this block does==

At present there is no simple section to section navigation in regular moodle.

The course menu bock takes the title of each section and puts them in a menu block. When combined with a format that shows one section per page, you then have simple section <> section navigation.

[[File:Course Menu.png]]

==Other links in the block==

These are configurable:

==History of this block==

[[Category:Contributed code]]

Course Menu block

2014-02-13T22:13:22Z

Derekcx: Just a little more documentation for course menu

This is a quick start for some documentation for the Course Menu Block plugin.

Get the code and information about the block here: https://moodle.org/plugins/view.php?plugin=block_course_menu

==What this block does==

At present there is no simple section to section navigation in regular moodle.

The course menu bock takes the title of each section and puts them in a menu block. When combined with a format that shows one section per page, you then have simple section <> section navigation.

[[File:Course Menu.png]]

==Other links in the block==

These are configurable:

==History of this block==

File:Course Menu.png

2014-02-13T22:11:58Z

Derekcx: Course Menu ilustration (1)

Course Menu ilustration (1)

Drag and drop into text

2014-01-22T01:37:10Z

Derekcx: Add video link

{{Questions}}A drag and drop question type where missing words have to be dragged into gaps in a paragraph of text.

[[File:danddqruntimem2.jpg]]

This is a question type created and maintained by the Open University.

== More documentation ==

More [http://labspace.open.ac.uk/mod/oucontent/view.php?id=470268&section=5.4.1 http://labspace.open.ac.uk/mod/oucontent/view.php?id=470268&section=5.4.1 documentation is available] on the Open University's [http://www.open.edu/openlearn/ OpenLearn site].

Nice YouTube video clip: https://www.youtube.com/watch?v=ohoTEfiNGA4

== See also ==

* [http://moodle.org/plugins/browse.php?list=set&id=10 Other Moodle plugins from the Open University]
* [http://moodle.org/plugins/browse.php?list=category&id=29 Other third-party question type plugins]
* [http://labspace.open.ac.uk/course/view.php?id=3484 eAssessment at the Open University with open source software]

[[Category:Contributed code]]
[[Category:Open University]]

[[es:Tipo de pregunta arrastrar y soltar al texto]]

Course homepage

2013-11-19T20:51:01Z

Derekcx: /* To delete a course section */

{{Courses}}
== Standard view of a blank course==
Our examples will be for a course homepage that is the standard default for a new install on a site. There are many course options that determine a course's appearance and make it look very different from our examples. The example course has a header, a footer (both content largely determined by a theme) and 3 columns in the middle.

[[Image:Blankcourselayout.png|thumb|600px|none|Example of Weekly format, teacher view, edit off - [https://docs.moodle.org/20/en/File:Blankcourselayout.png full resolution here]]]

===Parts of a course homepage===
Using the above image, here are the parts of a typical course homepage. It is possible to move and hide parts of the page and different themes display blocks in different regions, so not all courses will look like this.
{| style="width:75%; height:200px" border="1"
|-
| Column left || Course sections - Center || Column right
|-
|-
| *1 [[Course_settings#Full_name|Course full name]] || *6 Section header & [[News forum|News topic]] || *9 Login information
|-
| *2 [[Course_settings#Short_name|Navigation bar]] ||*7 Current week - First section || *10 Turn editing on button
|-
| *4 [[Navigation block]]|| *8 Future week - Second section|| *11 [[Latest News block|Latest news]]
|-
| *5 [[Administration block]]||*14 "Show only this section" || *12 [[Upcoming Events block|Upcoming events]]
|-
| *15 "Switch role to"|| || *13 [[Recent Activity block|Recent activity]]
|-
| *16 User profile settings || ||
|-
| *17 Site Administration || ||
|}

==Course sections==

Course sections are displayed in the centre of the course page.

===To edit a course section===

# Turn editing on
# Click the edit icon after the section title

If [[Conditional activities]] are enabled for the site, access to the section (including all activities and resources within it) may be restricted.

The number of course sections in the centre column may be changed in ''Settings > Course administration > Edit settings'' or by clicking the plus or minus icons at the bottom of the course page when editing is turned on.

{|
| [[File:editing a section.png|thumb|Editing a course section]]
| [[File:increasereduce.png|thumb|Changing the number of course sections]]
|}

===To move a course section===
#Turn editing on
#Click the up/down arrow or the crosshairs icon to move the section
#Drag the section to where you want to position it and let go

Note: The ability to move course sections is controlled by the capability [[Capabilities/moodle/course:movesections|moodle/course:movesections]], which is allowed for the default role of teacher.
===To delete a course section===
There is no way to delete a course section as such.
#Three options for a work around are in this post: https://moodle.org/mod/forum/discuss.php?d=243077
#There is a plugin here: https://moodle.org/plugins/view.php?plugin=block_quickset
#The tracker item https://tracker.moodle.org/browse/MDL-10405 has a hack that seems to work (updated for 2.6)

==Blocks==

Blocks are displayed in the right and/or left columns of the course page.

To add a block to the course page

#Turn on the editing by clicking the button top right or the link in ''Settings > Course administration''
#Select a block from the "Add block" dropdown menu (usually situated bottom right of the page)

To move a block
#Ensure editing is turned on then click onto the block title until the crosshair icon appears
#While keeping the block selected, drag it to where you want to position it and let go.

Alternatively
#Click on the up/down arrow
#Click on the place holder (a zone with a dashed border) where you want the block to appear.

{|
| [[File:moveblocksnew.png|thumb|Crosshair icon for moving a block]]
| [[File:Moveblocks.png|thumb|Up/down arrow icon for moving a block]]
|}

==Activities and resources==

To add an activity or resource to the course
#Turn on the editing by clicking the button top right or the link in ''Administration > Course administration.''
#Click 'Add an activity or resource' to open the new activity chooser. Select an activity or resource then click the Add button, or simply double-click on the activity or resource name.

If desired, the activity chooser can be switched off via ''Administration > Course administration > Activity chooser off''. Activities and resources can then be added using dropdown menus. (The setting appears only when editing is turned on.)

'''Note:''' The Moodle admin can switch this off by default in ''Administration > Site administration > Appearance > AJAX and Javascript''.
{|
| [[File:activity chooser.png|thumb|The activity chooser]]
|}

Alternatively, certain resources and activities may be added using drag and drop:

*To add a [[File|file]], simply drag and drop it onto the course section where you'd like it to appear
*To add a [[Folder|folder of files]], simply zip the folder then drag and drop it onto the course section where you'd like it to appear, answer 'Unzip files and create folder' to the popup dialogue, then click the upload button
*To add a [[SCORM module|SCORM package]], simply drag and drop it onto the course section where you'd like it to appear, answer 'Add a SCORM package' to the popup dialogue, then click the upload button

==Editing elements on your course homepage==
With the editing turned on, each item on your course homepage and each section/block will have icons next to it which all perform different functions such as edit/move/copy/delete/hide. '''Note:''' ''Your theme may have icons different from these below:''

:[[Image:hide24.png]] - the open-eye icon means an item is visible to students. It will close when you click on it

:[[Image:closedeye24.png]] - the eye with a strike through icon means an item is hidden from students. It will open when you click on it

: [[Image:26duplicate.png|61px|]] - the duplicate icon allows you to copy an activity or resource. It's done directly on the course page.

:[[Image:moveajax24.png]]- the move icon allows you to move items or sections by dragging and dropping.

:[[Image:movenoajaz241.png]] - this move icon appears if you don't have Ajax enabled.

:[[File:groups24.png]] - the groups icon allows you to change between no groups or separate/visible groups

:[[Image:26actionicon.png|150px]] - this icon groups actions together for easier editing on smaller screens. Click to reveal the options. {{New features}}

:[[Image:movenoajax24.png]] - the move here icon appears when moving a course element without Ajax. Click into the box to re-locate your item.

:[[File:topicmove24.png]] - the up/down arrows allow you to move course sections up or down and appear if you do not have Ajax enabled.

:[[Image:delete24.png]] - the delete icon will permanently delete something from the course

:[[File:groups24.png]] - the groups icon allows you to change between no groups or separate/visible groups

:[[File:assignroles24.png]] - the roles icon allows you to assign roles locally in the item.

The following icon only applies to sections

:[[Image:lightbulb24.png]] - the highlight icon allows you to highlight a section as current.

==Tips and tricks==

*Make your course home page look more like a webpage - see [[Course FAQ]]
*Activity and resource descriptions can be displayed on the course page just below the link to the activity or resource by clicking the 'Display description on course page' checkbox in the activity or resource settings.

==Course homepage capabilities==

*[[Capabilities/moodle/course:sectionvisibility|Control section visibility]]
*[[Capabilities/moodle/course:setcurrentsection|Set current section]]

==See also==

*[http://prezi.com/oays--oappai/making-my-moodle/ A useful Prezi from a student teacher on designing an effective Moodle course]
*[http://youtu.be/Je9udHLCIv0 How to quickly rename activities and use the activity chooser screencast]
*[http://youtu.be/1You5H_NXM0 Quickly add a course section in Moodle 2.3 screencast]
*[http://youtu.be/Yy6-Sg7z7A4 Drag and drop blocks in Moodle 2.3 screencast]

[[es:course/view]]
[[fr:Page de cours]]
[[ja:コースホームページ]]
[[de:Kursseite]]

Forum FAQ

2013-11-04T06:37:39Z

Derekcx: new FAQ about moderated posts

{{Forum}}
==Why are students unable to post in the forum?==

The most likely reason is that the forum is a [[News forum]] i.e. a special forum for general announcements which is automatically created for each course, and which by default only teachers and administrators can post in.

To create a standard forum in which students can post, turn editing on for the course, click the 'Add an activity or resource' link and then choose Forum.

Students may also be unable to post to a forum where a [[Forum_settings#Common_module_settings|Group Mode]] other than 'No Groups' has been used but the student is not a member of any group in the course. They will see the message "Adding discussions to this forum requires group membership". In this case, either add the student to a [[Groups|group]] or change the [[Forum_settings#Common_module_settings|Group Mode]] to 'No Groups'.

==How do I enable students to rate forum posts?==

In ''Settings > Forum administration > Permissions'' click the + symbol opposite the capability to rate posts and allow the role of student.

==Why can I not get ratings to work on my forums?==
Assuming you have followed the instructions above correctly and still cannot see ratings, then check you have json support enabled on your server. You can see this in ''Settings>Site administration>Server>PHP info.''

[[File:Json.png]]

See also this discussion:[ http://moodle.org/mod/forum/discuss.php?d=170563]

==How can I create a teacher-only forum?==

A teacher/tutor-only forum may be added to a course by creating a hidden forum. Teachers are able to view hidden course activities whereas students cannot.

==My users can't add attachments to my forum, either with drag and drop or with the file picker.==

Check that in the forum settings that you have changed the maximum number of attachments allowed to a number greater than 0 ;)

==How can I remove the news forum from a course?==

#Delete the news forum from the course homepage.
#In ''Settings > Course administration > Edit settings'' set "News items to show" to 0.
#Delete the Latest news block.

==How can I remove test messages from a new forum?==
There are several options ([http://moodle.org/mod/forum/discuss.php?d=95470 Here is a nice graphic]). Remember you can
*Move the discussion/thread to another forum
*Edit the post with your moderator powers
*Delete the post with your moderator powers
*Split the thread at a particular post and move it to another thread
*Split>move>delete your test messages.

==How can I set a display period for news forum announcements?==

Timed posts are disabled by default, but the feature can be enabled by checking the ''forum_enabletimedposts'' checkbox in ''Settings > Site administration > Plugins > Activity modules > Forum''. Timed posts can then be created by users with the [[Capabilities/mod/forum:viewhiddentimedposts|capability to view hidden timed posts]] (normally managers and teachers).

==Why are email copies of forum posts not being sent?==

The most likely reason is that the cron is not set up. Please refer to the [[Cron|cron instructions]].

Tips:
* Try the default settings in ''Settings > Site administration > Plugins > Message outputs > Email''. This generally works.
*Make sure that 'Allow user to select character set' in ''Settings > Site administration > Plugins > Message outputs > Email'' is set to No.

==Why can't students in separate groups reply to a forum discussion started by a teacher?==

When using groups, teachers are given the option of adding a new discussion topic for all participants or for a selected group. To enable students in separate groups to reply to a discussion, the teacher must copy and paste their discussion topic for each separate group, selecting each group from the dropdown menu at the top left of the forum page before clicking the "Add a new discussion topic" button.

==How do I enable guests to post in a forum?==

It's not possible to enable guests to post in a forum, though there is a workaround. Please see the section 'Guests and posting in a forum' in [[Forum settings]] for details.

==How can I close/archive a forum?==
*You might want to do this if, for example, you want to put an end to a student discussion topic but still want them to be able to see posts which had been made without being able to reply any more.

*In ''Settings > Forum administration > Permissions'' click the Prevent icon (X) for the student role for the capabilites 'Start new discussions' and 'Reply to posts'.

{|
|[[File:forum-permissions-page1.gif|thumb|The screen and relevant capabilities. (Click to enlarge]]
|}

'''NOTE:''' If you are a teacher in a course, you should be able to do this by default, but if you don't see these options, ask your admin to do the following:
#Go to ''Settings > Site Administration > Users > Permissions > Define roles''
#Edit the teacher role and change the capability moodle/role:safeoverride to allow
#Click the button "Save changes"
#Click the tab "Allow role overrides" (in ''Settings > Site administration > Users > Permissions > Define roles'')
#Check the appropriate box(s) in the teacher row to set which role(s) they can override. Most likely it will just be the student role, so check the box where the teacher row intersects with the student column
#Click the button "Save changes"

==How can I quarantine a forum post?==
If a student makes an inappropriate post, rather than deleting it, you can "quarantine" it by sending it to a hidden forum and then alerting your superior and the child's guardians. To do this you first need to create a forum "Hidden forum for Offensive Posts" (for example) and hide it with its eye.
**Find the offensive post and click 'split' (between 'edit' and 'delete')
**This will take you to a second page where you will be asked to verify the split. Confirm it by pressing the 'split' button near the top of the page.
**The post(s) will now be split. You should see the post/discussion individually on a separate page. In the right-hand corner will be a dropdown bar and a button that says 'move.'
**Choose 'Hidden Forum for Offensive Posts' in the dropdown and click 'move.'

Make sure you inform the child why their post has been quarantined, as well as your superior and the child's guardians.
''
(with thanks to Ben Reynolds)''

==Can I set up forum moderation or an approval process before a post appears?==
Not in core Moodle.
*Check out the tracker item https://tracker.moodle.org/browse/CONTRIB/component/10440
*And https://tracker.moodle.org/browse/CONTRIB-2260
*If anyone discovers a plugin to allow this, please post details

==Can I subscribe to just one discussion in a forum?==

Not at present, though please see MDL-1626.

==How can I receive forum emails in digest form?==

A daily digest of either complete forum posts or with subjects only can be enabled in ''Settings > My profile settings > Edit profile''.

==How can I allow students to add new questions in a Q & A forum type?==

Only teachers and managers by default see the "add a new question" button. If you wish students to be able to add new questions, they need to be given the capability [[Capabilities/mod/forum:addquestion|mod/forum:addquestion]]

==How can I make sure my students are notified of forum posts?==

For students to be notified of forum posts, they need to be ''subscribed'' to the forum. A teacher can choose to force subscription on a particular forum either initially (auto subscription) or permanently (forced subscription) using the subscription mode setting. See the section on subscription mode in [[Forum settings]] for further details.

A teacher can also subscribe selected students to the forum via ''Settings > Forum administration > Show/edit current subscribers''.

==How can I change the 'From' address for forum notifications sent via email?==

By default, a user's email is set as the 'From' address for forum notifications (unless the user has hidden their email address in their profile) so that recipients can choose to reply personally rather than via the forum. To set noreply@yourmoodlesite.org as 'From' address for all forum notification emails, untick the forum_replytouser checkbox in ''Settings > Site administration > Plugins > Activity modules > Forum''.

==How can I remove the words "Site news"?==
You can change the words to something else from ''Administration>Forum administration>Edit settings'' but to have no words at all - and without touching the code - do the following:
*As admin go to ''Administration>Site administration>Appearance>HTML settings'' and uncheck/untick ''Remove HTML tags from all activity names''
*Go to ''Administration>Forum administration<Edit settings'' (for the site news) and type:
[[File:sitenewsname.png]]

*Save. What this does is code a space into the name field so Moodle thinks there is something in the required field - but that something is a space, not words.
==Can I have different email digests for different forums?==
{{New features}}
This is possible, although there is not currently a setting for it. In the course you wish to manage the daily digests, type into your browser ''http://YOURMOODLESITE/mod/forum/index.php?id=2'' (where ''YOURMOODLESITE'' is your Moodle and the ''=number'' is the course ID) This will bring you to the index page of all your subscribed forums and you can specify how you want to receive notifications from there.
{|
|[[File:26forumdigest.png|thumb|Per forum digest settings]]
|}

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?f=116 Forum module forum]

Using Moodle forum discussions:

* [http://moodle.org/mod/forum/discuss.php?d=148055 Ability to post anonymously]
* [http://moodle.org/mod/forum/discuss.php?d=178331 How to resend forum posts]
* [http://moodle.org/mod/forum/discuss.php?d=196698 Discussion Count]

[[Category:FAQ]]
[[de:Forum FAQ]]
[[fr:FAQ sur le forum]]
[[es:Foro FAQ]]

Legacy course files

2013-10-22T20:27:23Z

Derekcx: /* Also see */

{{Repositories}}
Note: This page only applies to sites which have been upgraded from Moodle 1.9.
In Moodle 2.0 onwards, files are stored in separate areas, rather than together in the course files area. See [[Course files]] for a detailed explanation. When a site is upgraded from 1.9, the course files area is renamed 'Legacy course files'. By default, this area is not available in new courses.

''It is recommended that teachers make use of the new [[Repositories|repositories]] in Moodle 2.0 for storing course files, rather than saving them in the legacy course files area''.

==Enabling legacy course files areas==

To enable a legacy course files area in a new course

# Enable the legacy course files repository plugin in ''Settings > Site administration > Plugins > Repositories > [[Manage repositories]]''.
# Check the legacyfilesinnewcourses box in the Manage repositories common settings then click the 'Save changes' button.
# Set 'Legacy course files' to Yes in the course settings.

A legacy course files link will then appear in the ''Settings > Course administration'' area.

==Repository capabilities==

The capabilities [[Capabilities/repository/coursefiles:view|Use course files repository plugin]] and [[Capabilities/moodle/course:managefiles|Manage files]] are both required for users to access the legacy course files area.

==FAQs==
===Can you find out disk volume of legacy files?===
No. You will need a custom report of some kind. See http://moodle.org/mod/forum/discuss.php?d=201601

===Where are legacy files stored?===
For one explanation, see http://moodle.org/mod/forum/discuss.php?d=164544

===Is there a way to delete legacy files en mass?===
Not at the moment. Tracker item: http://tracker.moodle.org/browse/MDL-36008 and discussion: https://moodle.org/mod/forum/discuss.php?d=209353

See also a comment here: https://moodle.org/mod/forum/discuss.php?d=234922#p1020379

===Is there a way to prevent new additions to legacy files?===
{{New features}}
Yes. Unchecking [[Managing_repositories#Allow adding to legacy course files|Allow adding to legacy course files]] in ''Site Administration > Plugins > Repositories > Common repository settings'' will prevent users from adding new files and directories to legacy course files, but they will still be able to delete files.

===What happens if you switch legacy files off in a site that has been upgraded and has a lot of legacy files?===
Unsure.

===Can you migrate a course from 1.9 to 2+ and NOT end up with a legacy files repository?===
Yes, you can. If you restore as a Teacher into the course you're currently present in (best if it's empty) and don't override any settings then the Legacy Files will not be added as a Repository.

===What happens to the Legacy files in a course imported from 1.9 to 2.x that is re-imported into another 2.x?===

===In backups, are legacy files included with a course?===
Seems to be the case: http://moodle.org/mod/forum/discuss.php?d=194981

===Long term, will there be any problem keeping a large number of Legacy files?===
Possibly if you want to import (as opposed to restore) you may lose legacy files. See
*http://tracker.moodle.org/browse/MDL-25631
*http://tracker.moodle.org/browse/MDL-32598

===What happens if legacy files were previously enabled and then the legacy course files repository is disabled?===

Legacy course files are displayed if they have ever been enabled on the course, but can be disabled at the course level in the course settings. Any new courses created will not have a legacy course files area.

==Also see==
*http://moodle.org/mod/forum/discuss.php?d=172559
*http://moodle.org/mod/forum/discuss.php?d=197746
*https://moodle.org/mod/forum/discuss.php?d=234922

[[ja: レガシーコースファイル]]
[[de:Legacy-Kursdateien]]

Course homepage

2013-10-22T20:10:06Z

Derekcx: /* To delete a course section */

{{Courses}}
== Standard view of a blank course==
Our examples will be for a course homepage that is the standard default for a new install on a site. There are many course options that determine a course's appearance and make it look very different from our examples. The example course has a header, a footer (both content largely determined by a theme) and 3 columns in the middle.

[[Image:Blankcourselayout.png|thumb|600px|none|Example of Weekly format, teacher view, edit off - [https://docs.moodle.org/20/en/File:Blankcourselayout.png full resolution here]]]

===Parts of a course homepage===
Using the above image, here are the parts of a typical course homepage. It is possible to move and hide parts of the page and different themes display blocks in different regions, so not all courses will look like this.
{| style="width:75%; height:200px" border="1"
|-
| Column left || Course sections - Center || Column right
|-
|-
| *1 [[Course_settings#Full_name|Course full name]] || *6 Section header & [[News forum|News topic]] || *9 Login information
|-
| *2 [[Course_settings#Short_name|Navigation bar]] ||*7 Current week - First section || *10 Turn editing on button
|-
| *4 [[Navigation block]]|| *8 Future week - Second section|| *11 [[Latest News block|Latest news]]
|-
| *5 [[Administration block]]||*14 "Show only this section" || *12 [[Upcoming Events block|Upcoming events]]
|-
| *15 "Switch role to"|| || *13 [[Recent Activity block|Recent activity]]
|-
| *16 User profile settings || ||
|-
| *17 Site Administration || ||
|}

==Course sections==

Course sections are displayed in the centre of the course page.

===To edit a course section===

# Turn editing on
# Click the edit icon after the section title

If [[Conditional activities]] are enabled for the site, access to the section (including all activities and resources within it) may be restricted.

The number of course sections in the centre column may be changed in ''Settings > Course administration > Edit settings'' or by clicking the plus or minus icons at the bottom of the course page when editing is turned on.

{|
| [[File:editing a section.png|thumb|Editing a course section]]
| [[File:increasereduce.png|thumb|Changing the number of course sections]]
|}

===To move a course section===
#Turn editing on
#Click the up/down arrow or the crosshairs icon to move the section
#Drag the section to where you want to position it and let go

Note: The ability to move course sections is controlled by the capability [[Capabilities/moodle/course:movesections|moodle/course:movesections]], which is allowed for the default role of teacher.
===To delete a course section===
There is no way to delete a course section as such.
#Three options for a work around are in this post: https://moodle.org/mod/forum/discuss.php?d=243077
#There is a plugin here: https://moodle.org/plugins/view.php?plugin=block_quickset

==Blocks==

Blocks are displayed in the right and/or left columns of the course page.

To add a block to the course page

#Turn on the editing by clicking the button top right or the link in ''Settings > Course administration''
#Select a block from the "Add block" dropdown menu (usually situated bottom right of the page)

To move a block
#Ensure editing is turned on then click onto the block title until the crosshair icon appears
#While keeping the block selected, drag it to where you want to position it and let go.

Alternatively
#Click on the up/down arrow
#Click on the place holder (a zone with a dashed border) where you want the block to appear.

{|
| [[File:moveblocksnew.png|thumb|Crosshair icon for moving a block]]
| [[File:Moveblocks.png|thumb|Up/down arrow icon for moving a block]]
|}

==Activities and resources==

To add an activity or resource to the course
#Turn on the editing by clicking the button top right or the link in ''Administration > Course administration.''
#Click 'Add an activity or resource' to open the new activity chooser. Select an activity or resource then click the Add button, or simply double-click on the activity or resource name.

If desired, the activity chooser can be switched off via ''Administration > Course administration > Activity chooser off''. Activities and resources can then be added using dropdown menus. (The setting appears only when editing is turned on.)

'''Note:''' The Moodle admin can switch this off by default in ''Administration > Site administration > Appearance > AJAX and Javascript''.
{|
| [[File:activity chooser.png|thumb|The activity chooser]]
|}

Alternatively, certain resources and activities may be added using drag and drop:

*To add a [[File|file]], simply drag and drop it onto the course section where you'd like it to appear
*To add a [[Folder|folder of files]], simply zip the folder then drag and drop it onto the course section where you'd like it to appear, answer 'Unzip files and create folder' to the popup dialogue, then click the upload button
*To add a [[SCORM module|SCORM package]], simply drag and drop it onto the course section where you'd like it to appear, answer 'Add a SCORM package' to the popup dialogue, then click the upload button

==Editing elements on your course homepage==
With the editing turned on, each item on your course homepage and each section/block will have icons next to it which all perform different functions such as edit/move/copy/delete/hide. '''Note:''' ''Your theme may have icons different from these below:''

:[[Image:hide24.png]] - the open-eye icon means an item is visible to students. It will close when you click on it

:[[Image:closedeye24.png]] - the eye with a strike through icon means an item is hidden from students. It will open when you click on it

:[[Image:moveajax24.png]]- the move icon allows you to move items or sections by dragging and dropping.

:[[Image:movenoajaz241.png]] - this move icon appears if you don't have Ajax enabled.

:[[File:groups24.png]] - the groups icon allows you to change between no groups or separate/visible groups

:[[Image:26actionicon.png|150px]] - this icon groups actions together for easier editing on smaller screens. Click to reveal the options. {{New features}}

:[[Image:movenoajax24.png]] - the move here icon appears when moving a course element without Ajax. Click into the box to re-locate your item.

:[[File:topicmove24.png]] - the up/down arrows allow you to move course sections up or down and appear if you do not have Ajax enabled.

:[[Image:delete24.png]] - the delete icon will permanently delete something from the course

:[[File:groups24.png]] - the groups icon allows you to change between no groups or separate/visible groups

:[[File:assignroles24.png]] - the roles icon allows you to assign roles locally in the item.

The following icon only applies to sections

:[[Image:lightbulb24.png]] - the highlight icon allows you to highlight a section as current.

==Tips and tricks==

*Make your course home page look more like a webpage - see [[Course FAQ]]
*Activity and resource descriptions can be displayed on the course page just below the link to the activity or resource by clicking the 'Display description on course page' checkbox in the activity or resource settings.

==Course homepage capabilities==

*[[Capabilities/moodle/course:sectionvisibility|Control section visibility]]
*[[Capabilities/moodle/course:setcurrentsection|Set current section]]

==See also==

*[http://prezi.com/oays--oappai/making-my-moodle/ A useful Prezi from a student teacher on designing an effective Moodle course]
*[http://youtu.be/Je9udHLCIv0 How to quickly rename activities and use the activity chooser screencast]
*[http://youtu.be/1You5H_NXM0 Quickly add a course section in Moodle 2.3 screencast]
*[http://youtu.be/Yy6-Sg7z7A4 Drag and drop blocks in Moodle 2.3 screencast]

[[es:course/view]]
[[fr:Page de cours]]
[[ja:コースホームページ]]
[[de:Kursseite]]

Course homepage

2013-10-22T01:32:24Z

Derekcx: Adding subsections

{{Courses}}
== Standard view of a blank course==
Our examples will be for a course homepage that is the standard default for a new install on a site. There are many course options that determine a course's appearance and make it look very different from our examples. The example course has a header, a footer (both content largely determined by a theme) and 3 columns in the middle.

[[Image:Blankcourselayout.png|thumb|600px|none|Example of Weekly format, teacher view, edit off - [https://docs.moodle.org/20/en/File:Blankcourselayout.png full resolution here]]]

===Parts of a course homepage===
Using the above image, here are the parts of a typical course homepage. It is possible to move and hide parts of the page and different themes display blocks in different regions, so not all courses will look like this.
{| style="width:75%; height:200px" border="1"
|-
| Column left || Course sections - Center || Column right
|-
|-
| *1 [[Course_settings#Full_name|Course full name]] || *6 Section header & [[News forum|News topic]] || *9 Login information
|-
| *2 [[Course_settings#Short_name|Navigation bar]] ||*7 Current week - First section || *10 Turn editing on button
|-
| *4 [[Navigation block]]|| *8 Future week - Second section|| *11 [[Latest News block|Latest news]]
|-
| *5 [[Administration block]]||*14 "Show only this section" || *12 [[Upcoming Events block|Upcoming events]]
|-
| *15 "Switch role to"|| || *13 [[Recent Activity block|Recent activity]]
|-
| *16 User profile settings || ||
|-
| *17 Site Administration || ||
|}

==Course sections==

Course sections are displayed in the centre of the course page.

===To edit a course section===

# Turn editing on
# Click the edit icon after the section title

If [[Conditional activities]] are enabled for the site, access to the section (including all activities and resources within it) may be restricted.

The number of course sections in the centre column may be changed in ''Settings > Course administration > Edit settings'' or by clicking the plus or minus icons at the bottom of the course page when editing is turned on.

{|
| [[File:editing a section.png|thumb|Editing a course section]]
| [[File:increasereduce.png|thumb|Changing the number of course sections]]
|}

===To move a course section===
#Turn editing on
#Click the up/down arrow or the crosshairs icon to move the section
#Drag the section to where you want to position it and let go

Note: The ability to move course sections is controlled by the capability [[Capabilities/moodle/course:movesections|moodle/course:movesections]], which is allowed for the default role of teacher.
===To delete a course section===
There is no way to delete a course section as such. Three options for a work around are in this post:

https://moodle.org/mod/forum/discuss.php?d=243077

==Blocks==

Blocks are displayed in the right and/or left columns of the course page.

To add a block to the course page

#Turn on the editing by clicking the button top right or the link in ''Settings > Course administration''
#Select a block from the "Add block" dropdown menu (usually situated bottom right of the page)

To move a block
#Ensure editing is turned on then click onto the block title until the crosshair icon appears
#While keeping the block selected, drag it to where you want to position it and let go.

Alternatively
#Click on the up/down arrow
#Click on the place holder (a zone with a dashed border) where you want the block to appear.

{|
| [[File:moveblocksnew.png|thumb|Crosshair icon for moving a block]]
| [[File:Moveblocks.png|thumb|Up/down arrow icon for moving a block]]
|}

==Activities and resources==

To add an activity or resource to the course
#Turn on the editing by clicking the button top right or the link in ''Administration > Course administration.''
#Click 'Add an activity or resource' to open the new activity chooser. Select an activity or resource then click the Add button, or simply double-click on the activity or resource name.

If desired, the activity chooser can be switched off via ''Administration > Course administration > Activity chooser off''. Activities and resources can then be added using dropdown menus. (The setting appears only when editing is turned on.)

'''Note:''' The Moodle admin can switch this off by default in ''Administration > Site administration > Appearance > AJAX and Javascript''.
{|
| [[File:activity chooser.png|thumb|The activity chooser]]
|}

Alternatively, certain resources and activities may be added using drag and drop:

*To add a [[File|file]], simply drag and drop it onto the course section where you'd like it to appear
*To add a [[Folder|folder of files]], simply zip the folder then drag and drop it onto the course section where you'd like it to appear, answer 'Unzip files and create folder' to the popup dialogue, then click the upload button
*To add a [[SCORM module|SCORM package]], simply drag and drop it onto the course section where you'd like it to appear, answer 'Add a SCORM package' to the popup dialogue, then click the upload button

==Editing elements on your course homepage==
With the editing turned on, each item on your course homepage and each section/block will have icons next to it which all perform different functions such as edit/move/copy/delete/hide. '''Note:''' ''Your theme may have icons different from these below:''

:[[Image:quickrename24.png]] - the pencil icon allows to rename your item directly on the course page without entering the settings for that item.

:[[Image:edit24.png]] - the edit icon allows you to change the wording or settings of the item.

:[[File:duplicate24.png]] - the duplicate icon allows you to copy an activity or resource within your course

:[[Image:hide24.png]] - the open-eye icon means an item is visible to students. It will close when you click on it

:[[Image:closedeye24.png]] - the eye with a strike through icon means an item is hidden from students. It will open when you click on it

:[[Image:indent24.png]] - the right arrow icon is used to indent course elements (there is also a left icon)

:[[Image:moveajax24.png]]- the move icon allows you to move items or sections by dragging and dropping.

:[[Image:movenoajaz241.png]] - this move icon appears if you don't have Ajax enabled.

:[[Image:movenoajax24.png]] - the move here icon appears when moving a course element without Ajax. Click into the box to re-locate your item.

:[[File:topicmove24.png]] - the up/down arrows allow you to move course sections up or down and appear if you do not have Ajax enabled.

:[[Image:delete24.png]] - the delete icon will permanently delete something from the course

:[[File:groups24.png]] - the groups icon allows you to change between no groups or separate/visible groups

:[[File:assignroles24.png]] - the roles icon allows you to assign roles locally in the item.

The following icon only applies to sections

:[[Image:lightbulb24.png]] - the highlight icon allows you to highlight a section as current.

==Tips and tricks==

*Make your course home page look more like a webpage - see [[Course FAQ]]
*Activity and resource descriptions can be displayed on the course page just below the link to the activity or resource by clicking the 'Display description on course page' checkbox in the activity or resource settings.

==Course homepage capabilities==

*[[Capabilities/moodle/course:sectionvisibility|Control section visibility]]
*[[Capabilities/moodle/course:setcurrentsection|Set current section]]

==See also==

*[http://prezi.com/oays--oappai/making-my-moodle/ A useful Prezi from a student teacher on designing an effective Moodle course]
*[http://youtu.be/Je9udHLCIv0 How to quickly rename activities and use the activity chooser screencast]
*[http://youtu.be/1You5H_NXM0 Quickly add a course section in Moodle 2.3 screencast]
*[http://youtu.be/Yy6-Sg7z7A4 Drag and drop blocks in Moodle 2.3 screencast]

[[es:course/view]]
[[fr:Page de cours]]
[[ja:コースホームページ]]
[[de:Kursseite]]

Accounts FAQ

2013-10-13T19:36:46Z

Derekcx: /* Can Moodle send a notification e-mails automatically to a new user when an account is created for them? */

{{Accounts}}

==How can I get my students to sign up to my Moodle site?==

Look at how to set up [[Email-based self-registration|email based self registration]].

==How can I suspend a user's account?==

Tick the 'Suspended account' checkbox on the edit profile page.

==Can Moodle send a notification e-mails automatically to a new user when an account is created for them?==

Not at the moment with core Moodle. See Tracker items MDL-19390.

There is a work around. If you create a CSV for your user, and OMIT the password field a cron job does get triggered and an e-mail is sent to the user. The text of the e-mail is customisable by an administrator in the admin settings. See: https://docs.moodle.org/24/en/Upload_users#Fields_that_can_be_included

News: fixed in Moodle 2.6. See https://tracker.moodle.org/browse/MDL-19390

==How can I log in as another user?==
This is normally only allowed for administrators or managers because of possible security issues. Click on the user's profile and then look in the Settings block on the side. Click the link there.

[[File:loginas.png]]

Note that when you have finished, you will be logged out and will have to log in again. This is deliberate, again for security reasons, but you will be returned to the page you just left.

==How can I prevent users from editing elements of their profile?==
You can lock user fields from ''Settings>Site Administration>Plugins>Authentication>Manual accounts''

==The search box for users is limited to 100 displayed users. Can I change this?==
Yes -see [[User policies]]

==I am getting an error uploading a csv file with user data==
This may be due to a number of causes:
#open up your file in a text editor such as notepad and ensure you don't have any extra commas
#make sure when you use, for example, the fields 'course1', 'course2' that you are using the SHORT name for the course
#make sure if you are uploading cohorts that you use the ID of the cohort and not its name
#make sure if you are adding a country that you use the 2 letter country code and not the full country name.

[[Category:FAQ]]
[[de:Nutzerkonten FAQ]]

Decaf theme

2013-09-04T03:12:29Z

Derekcx: /* Theme Settings */

{{stub}}
{{Themes}}
This is a [[:Category:Contributed_code|contributed (third party)]] three column full width theme for Moodle written by Lei Zhang and maintained now by Paul Nichols.

The theme is customisable through Moodle's theme settings.
==Theme Features==
#Main feature of Decaf: the Awesome Bar navigation which is at the top rather than at the side.
#Plus there is a nice small edit button rather than the usual row of icons.

==Illustration of decaf-course menu combo==

[[File:MainDecaf.png]]

==Configurable Options==
'''Important Note:''' When making changes to any theme please ensure that [[Theme_settings#Theme_designer_mode|Theme Designer Mode]] is enabled to ensure your changes appear.

==The menus==
From a post in the plugins forum:

You can't run Awesome bar AND the built in Nav and Settings menus. Just to much overhead.
So, you are best to
#Go to home page and for NAV and SETTINGS blocks show on front page only
#Then "hide on front page"
#In DECAF settings set both to 'Show on front page=NO".

==Other themes with the Awesome bar==

==Theme Settings==
The only setting to be aware of here is the show other menus (switch all settings/admins menus OFF as if you don't it will run like a dog)

[[File:Decaf_Options.jpg]]

===Edit button===
This option uses a small edit button rather than a number of edit option icons.

===Hide settings and/or navigation===
Needed really

===Show user picture===

===Add custom menu before/After Awesome bar===

[[File:One_Menu_Option.jpg]]

==Download link==
You can download the theme from https://moodle.org/plugins/view.php?plugin=theme_decaf

==Interesting hacks and Mods==
*Add dynamic footer: https://moodle.org/mod/forum/discuss.php?d=230045

==See also==


[[Category:Contributed code]]

Decaf theme

2013-08-27T23:03:27Z

Derekcx: /* Theme Features */

{{stub}}
{{Themes}}
This is a [[:Category:Contributed_code|contributed (third party)]] three column full width theme for Moodle written by Lei Zhang and maintained now by Paul Nichols.

The theme is customisable through Moodle's theme settings.
==Theme Features==
#Main feature of Decaf: the Awesome Bar navigation which is at the top rather than at the side.
#Plus there is a nice small edit button rather than the usual row of icons.

==Illustration of decaf-course menu combo==

[[File:MainDecaf.png]]

==Configurable Options==
'''Important Note:''' When making changes to any theme please ensure that [[Theme_settings#Theme_designer_mode|Theme Designer Mode]] is enabled to ensure your changes appear.

==The menus==
From a post in the plugins forum:

You can't run Awesome bar AND the built in Nav and Settings menus. Just to much overhead.
So, you are best to
#Go to home page and for NAV and SETTINGS blocks show on front page only
#Then "hide on front page"
#In DECAF settings set both to 'Show on front page=NO".

==Other themes with the Awesome bar==

==Theme Settings==
The only setting to be aware of here is the xxx (switch all settings menus OFF as if you don't it will run like a dog)

[[File:Decaf_Options.jpg]]

===Edit button===
This option uses a small edit button rather than a number of edit option icons.

===Hide settings and/or navigation===
Needed really

===Show user picture===

===Add custom menu before/After Awesome bar===

[[File:One_Menu_Option.jpg]]

==Download link==
You can download the theme from https://moodle.org/plugins/view.php?plugin=theme_decaf

==Interesting hacks and Mods==
*Add dynamic footer: https://moodle.org/mod/forum/discuss.php?d=230045

==See also==


[[Category:Contributed code]]