MoodleDocs - User contributions [en]

Moodle app guide for admins

2019-07-19T07:48:16Z

Ghillenb: /* See also */

{{Mobile}}
==Enable mobile services on your site==
Your site needs to have mobile access enabled so users can use the mobile app.

For sites using https, mobile access is enabled by default in new installations of Moodle 3.0 onwards.

For http sites, mobile access can be enabled by an administrator as follows:

# In ''Site administration > Mobile app > Mobile settings'' tick the 'Enable web services for mobile devices' checkbox
# Click the button to save changes.

If your site uses a [https://en.wikipedia.org/wiki/Transport_Layer_Security SSL certificate], it must be a trusted certificate. For security reasons the app doesn't work with self-signed certificates.

Please, verify that your certificate is valid via: https://www.geocerts.com/ssl_checker (you shouldn't see any warning).

If your site has the /login directory protected (frequently done when using the Shibboleth authentication method), you must enable access to the login/token.php script.

===Frame embedding===
If your sites uses [https://en.wikipedia.org/wiki/ReCAPTCHA reCaptcha], Vimeo videos or custom menu items (as described bellow) you must enable the admin setting "Allow frame embedding" (allowframembedding).

==Mobile authentication==

If your site uses a SSO authentication method (CAS, Shibboleth, LDAP SSO, OAuth...), then select via a browser window or via an embedded browser for 'Type of login' (typeoflogin) in 'Mobile authentication' in the Site administration. (This setting is provided for older pre-Moodle 3.2 sites via the [[Moodle Mobile additional features]] plugin.)

The options 'browser window' and 'embedded browser' are very similar; the only difference is when redirecting the user to enter their credentials in the site, the site will be opened in the device's default browser (for browser window) or the site will be opened "embedded" in the mobile app (for embedded browser). The user experience is better in embedded browser, but not all the authentication plugins will work in embedded browser (for example, if JavaScript popups are required they must use the 'browser window'). The admin should check whether both options work, and if so, choose 'embedded browser'.

If you are using Google OAuth you will have to use the 'browser window' method because Google recently blocked authentication via 'embedded browsers'.

If your organisation uses a custom branded app and 'Type of login' is set to 'Via a browser window' or 'Via embedded browser', then a URL scheme (forcedurlscheme) may be set. This will result in only the custom branded app working for the site: the official Moodle Mobile app will not work.

== Customise your app theme ==

The app can also retrieve your custom styles from your Moodle site. Since the app is a HTML5 app, you can safely apply any CSS, CSS2 and CSS3 style.

Go to ''Administration > Site administration > Mobile app > Mobile appearance'' and enter in the mobilecssurl field a valid URL pointing to a CSS file containing your custom styles.

The CSS should be placed inside your Moodle installation (in your custom theme or inside a local plugin).

'''For example:''' ''https://mymoodlesite.com/theme/mytheme/style/mymobileapp.css''

Once the user is logged in the app, remote CSS files for applying your custom styles are regularly retrieved.

Notice that on the first time a user opens the app, he will see the default "orange" style. Your custom styles will be applied once the user has added a site in the app.

For further information, see the dev docs [[:dev:Moodle Mobile Themes|Moodle Mobile Themes]].

If you want your own custom branding for your organization, Moodle offers the The Branded Moodle Mobile app service, please visit https://moodle.com/mobileapp/ for more information.

== Moodle Mobile additional features plugin for old Moodle sites ==

For old Moodle sites it is recommended to install the [[Moodle Mobile additional features]] plugin.

== Notifications ==

You might find them annoying but push notifications keeps you and your users informed and updated on everything about the app. Moodle only send useful and important notifications such as new features or service disruptions.

Enabling push notifications is easy! An administrator can enable it by connecting their Moodle site/s to our free Notifications server available (only) for registered Moodle sites.

An access key can be obtained via ''Site administration > Plugins > Message outputs > Manage message outputs''. Then by clicking the link to the Mobile settings, on the next page select ''Request access key''.

The full guide on enabling push notifications can be found here: [[Mobile app notifications]]

== App banners ==
[[File:app banner.png|thumb|Moodle Mobile app banner]]
App banners let your users know that there is a mobile app available for the site. App banners are only displayed when accessing the site using a mobile browser.

In Moodle 3.3 onwards, app banners for Android are supported as well as for iOS.

App banners are disabled by default. They can be enabled in 'Mobile appearance' in the Site administration.

If you are using a custom mobile app, you need to provide the unique identifier for the iOS and Android app; if you are using the Moodle Mobile app, the settings may be left as default.

Please, notice the following:
* App banners for iOS devices (iPhone, iPad or iPod) are only shown when accessing the site using the Safari browser
* App banners for Android devices are only shown in very recent Chrome browser versions and when the app is not installed. Note also that Chrome uses an engagement heuristic that will display the banner only on certain conditions, like interactions with the site, the last time you interacted with it, etc. You can remove the engagement restriction check by disabling this special chrome flag: chrome://flags/#bypass-app-banner-engagement-checks

=='Get the mobile app' link==

In Moodle 3.4 onwards, the link 'Get the mobile app' in the footer of each page on the site encourages users to make use of the mobile app.

By default, the link is https://download.moodle.org/mobile however the setting 'App download page' can be changed e.g. for sites using a branded mobile app.

If mobile services are not enabled for the site, then the 'Get the mobile app' link is not displayed.

To prevent the 'Get the mobile app' link being displayed, simply remove the URL from the 'App download page' setting and save changes.

== Configuring the app from your site ==

In Moodle 3.3 onwards, or with the [[Moodle Mobile additional features]] plugin, settings in the Site administration enable admins to configure the app.

* In Moodle 3.3 onwards go to ''Site administration > Mobile features''
* In sites with the Moodle Mobile additional features plugin installed, go to ''Site administration > Plugins > Local plugins > Mobile additional features''

===Force log out===

Replace the Change site option to "Log out" so that users must enter their credentials on their next access. This is useful for custom mobile apps, as there is no reason for users wanting to switch to a different site.

===Disabled features===

The mobile app may be simplified by removing unwanted features. Some items may already be not available in the app because they are not enabled on your site.

Options to remove include:

* Offline use
* Create new account
* Main menu
** My courses
** Site home
** Grades
** My learning plans
** Notifications
** Messages
** Calendar
** Files
** Web page
** Help
* Course
** Search
** Competencies
** Participants
** Grades
** Course completion
** Notes
** Download course (new in 3.5)
** Download courses (new in 3.5)
* User
** Badges
** Competencies
** Course completion
** Grades
** Send message
** Add contact
** Block contact
** Add a new note
** User picture
* Files
** Private files
** Ste files
** Upload

===Custom menu items===

Additional items can be added to the app main menu (the side menu), such as a link to a different grade book.

Each custom menu item should have format: item text, link URL, link-opening method and language code (optional, for displaying the item to users of the specified language only), separated by pipe characters.

Possible link-opening methods are:

* app - for linking to an activity supported by the app i.e. almost all activity types, as listed in [[Moodle Mobile features]].
* inappbrowser - for linking to external URLs or site functionalities not supported by the app. The link will open in a browser inside the app overlaying the complete screen.
* browser - as for inappbrowser except that the link will instead open in the device default browser outside the app.
* embedded - as for inappbrowser except that the link will instead open in an iframe in a new page in the app. (For this option you may need to enable the admin setting "Allow frame embedding" (allowframembedding)

Tip: If you add a custom menu item and save changes, then it doesn't appear in the app main menu, double check that the item is correctly formatted.

Please, note that if the app is using a language not indicated in the previous list, the first language in the list will be used.

If you want options tied to a language, you can append _only to the language code, for example:
en_only
es_only

Will display the custom menu item only when the app language is English or Spanish.

===Custom language strings ===

Words and phrases displayed in the app can be customised via the "Custom language strings" (customlangstrings) setting.

Enter each custom language string on a new line with format: string identifier, custom language string and language code, separated by pipe characters. For example:

mm.user.student|Learner|en
mm.user.student|Aprendiz|es

The complete list of string identifiers is listed in https://raw.githubusercontent.com/moodlehq/moodlemobile-phonegapbuild/master/assets/lang/en.json. The string identifier is before the colon.

For example:

[[File:Mobile string identifiers list examples.png|300px]]

means that the string "Student" has string identifier "mm.user.student".

==Web services token duration==

In Moodle 3.4 onwards, an admin can set how long a web services token created by a user (for example via the mobile app) is valid. (In previous versions of Moodle a token was valid for 3 months.)

==See also==

* [[Moodle Mobile FAQ]] for other administration-related mobile app questions.
* [[:dev:Moodle Mobile debugging WS requests]] - a guide to helping you find and report problems with the Moodle Mobile app on your site
* [[:dev: Moodle Mobile Roadmap]]
* [[:dev:Moodle Mobile release notes]]
* [[:dev:Moodle Mobile|Moodle Mobile developer docs]]
* [[Moodle Mobile availability plugin]]
* [[Mobile web services]]

[[fr: Guide mobile pour administrateurs]]
[[es:Moodle app guía para administradores]]
[[de:Moodle App - Anleitung für Administrator/innen]]

Moodle app synchronization

2019-07-10T09:26:00Z

Ghillenb:

{{Mobile}}
There are two ways of synchronizing data: automatic and manual.

== Automatic synchronization ==

When an activity that can generate offline data is opened in the app, that activity will always be synchronized if the device is connected. For example, when opening a wiki while online, any offline data will be synchronized.

Furthermore, each activity type has an automatic synchronization process that runs regularly, usually every 10 minutes. Let's use wiki as an example. When the wiki synchronization process runs, it synchronizes all wikis that have offline data and haven't been synchronized in the last 5 minutes. This is to decrease the data usage of the app since the server might be down. This means that an activity could take up to 15 minutes to be synchronized in the worst case scenario. An example of the worst case scenario:

# Time = 0. The wiki automatic sync process runs. Nothing to sync.
# Time = 5 minutes and 1 second. The user opens a wiki with no offline data, so the synchronization is successful.
# Time = 5 minutes and a few seconds. The user generates some offline data for that wiki.
# Time = 10 minutes. The wiki automatic sync process runs again. The wiki has offline data, but it has been synchronized in less than 5 minutes (step 2), so it isn't synchronized again.
# Time = 20 minutes. The wiki automatic sync process runs again. Now the wiki is synchronized.

If an automatic synchronization runs when the device is offline, it will stop running until the device is online again. When the device is next online, all the automatic sync processes that were stopped will be run immediately, synchronizing the activities with offline data that weren't synchronized in the last 5 minutes. For example:

# Forum sync process runs. Device is online, so it is executed.
# Device goes offline.
# Wiki sync process runs. Device is offline, so it stops being executed.
# Device goes online.
# Wiki sync process is executed since it was stopped. Forum isn't executed yet because it wasn't stopped, it will be executed after 10 minutes from step 1.

Finally, in ''App Settings > Synchronization'' there is a setting "''Allow sync only when on Wi-Fi''". If this is enabled and the device is using a 3G/4G connection, the automatic sync processes won't be run; their execution will be delayed for 10 minutes until the device uses a Wi-Fi connection.

Note that the automatic sync processes will only run if the app is alive; if the app is closed, the data won't be synchronized until it is started again. Also, in iOS the app needs to be in the foreground (active) in order to execute the sync processes; if it is put in background (minimized) the processes won't be executed until the app is in the foreground again.

== Manual synchronization ==

When a user generates data offline, the app will display a message inside the activity informing the user that there is data to be synchronized. Performing a Pull To Refresh in that view will synchronize the data for that activity only (not for other activities). The activity can also be synchronized by opening the context menu in the top right and clicking "''Synchronize''". So if a user performs a Pull To Refresh in a certain wiki, only that wiki will be synchronized. Performing a Pull To Refresh outside of the activity (e.g. in the section) will do nothing.

In ''App Settings > Synchronization'' the app will display a list of the sites stored in the app. Clicking the refresh button next to a site results in all automatic sync processes being executed immediately, so all activities with offline data that haven't been synchronized in the last 5 minutes will be synchronized.

[[de:Moodle App - Synchronisierung]]

Unexpected installation halts

2019-06-07T12:21:10Z

Ghillenb: /* See also */

{{Installing Moodle}}
Sometimes the installation will hang when setting up tables, where only half the page displayed in the browser and/or other outputs are removed. Examples and causes are:

==Truncated MySQL statements==

(mysql): SET NAMES 'utf8'
--------------------------------------------------------------------------------
(mysql): SHOW LOCAL VARIABLES LIKE 'character_set_database'
...
...
(no more statements are displayed)

==Missing Continue button==
The “Scroll to continue” link is displayed but no “Continue” button is there.

:'''Note''': There is an exception to this when upgrading an existing database and the installation may appear to hang at the roles generation phase. This process can take a very long time - so please be patient.

Below are some solutions you can try to overcome this problem:

*'''Check for MySQL limits'''. This is often a MySQL error and not a php error. Check that there is no limit placed on your mysql database, e.g. a "questions" limit. See [http://dev.mysql.com/doc/refman/5.0/en/user-resources.html Limiting Account Resources in the MySQL manual].

*'''Check your .htaccess files'''. If the install is on a webhost, adding the following line to the .htaccess file in the Moodle directory has been known to solve the problem.
AddType x-mapp-php5 .php

:Try also renaming the .htaccess file so that it is disabled.

==Code customizations==
You may also want to look and see if you've customized any of your code. Look at the last successful table, and then look at the block, mod, or other code that is referenced by that table. For example, if your install hangs and continues to say that the forum tables were successful as the last message, look at /mod/forum/ for any custom code. If you have customized code, backup those files and replace with the correct files. You can then restart the install by renaming config.php or reinstalling your database from the backup. If your install is successful, you can make your code changes back into the stock Moodle code.

==Check your memory limit==
It may also be that the "memory_limit" in your php.ini is set too low. Please check your php.ini file and allocate the recommended amount (see [https://docs.moodle.org/en/Installing_Moodle#Requirements Moodle requirements]). For Moodle version 1.8 and above at least 40MB is recommended.

==Do not upgrade incrementally==
To avoid this problem when upgrading, it is recommended to upgrade directly from any previous version to these versions:

1.x -> 1.9.19+ -> 2.2.11 -> 2.7.14 -> 3.1

A work-around to this problem is to setup a working Moodle system on your local PC or server using the [http://download.moodle.org Moodle Packages]. Once you have a running Moodle, [https://docs.moodle.org/en/Upgrading_Moodle#Backup_important_data backup the database] and import to your webhost. Then backup the Moodle code itself (the "moodle" directory on your PC) and copy this to your webhost using (for example) FTP. Finally, edit the moodle/config.php file for the new settings that have to be changed for the webhost.

Some Moodlers have found the suggestion in http://moodle.org/mod/forum/discuss.php?d=65786#p297433 helpful, for some unknown reason. It claims that it is because the fopen function in the line (now line 426 instead of 406) was not being given a string as the first argument, but that's not true. It was a string; after the edit it is a string whose first and last characters are single quote marks. The amazing thing is that it works at all after that edit. What's even more amazing is that it fixes the problem, at least for some users. Go figure.

==Database configuration issues==
If the installation hangs after entering your database details, it is likely that there is a problem with the details that you have entered for accessing the database. For example, if your MySQL database is running on port 3309 rather than the default 3306, make sure that you set the database URL to "http://localhost:3309" rather than just "http://localhost".

==See also==

*[http://moodle.org/mod/forum/view.php?id=28 Installation Forum at Moodle.org]

[[es:Paros inesperados de la instalación]]
[[ja:予期しないインストールの停止]]
[[de:Unerwartete Installationsabbrüche]]

Capabilities/tool/dataprivacy:downloadallrequests

2019-05-29T08:17:46Z

Ghillenb:

{{Capabilities}}
* This allows a user to download other users' exported data.
* This capability is not set for any of the default roles. It may only be applied in the system context i.e. as a system role.
* This capability is available in Moodle 3.5.2 onwards.

Organisations with multiple systems and a centralised request process can prevent users from downloading their own data (by removing the capability [[Capabilities/tool/dataprivacy:downloadownrequest|Download your own exported data]] for the authenticated user role) and instead enable a privacy officer to download it for them (by allowing this capability for the [[Privacy officer role]]).

==See also==

* [[Data privacy]]

[[Category:Capabilities|Privacy]]
[[Category:Privacy]]

[[es:Capabilities/tool/dataprivacy:downloadallrequests]]
[[de:Capabilities/tool/dataprivacy:downloadallrequests]]

Capabilities/tool/dataprivacy:downloadownrequest

2019-05-28T14:42:29Z

Ghillenb:

{{Capabilities}}
* This allows a user to download their own exported data.
* This capability is allowed for the default role of authenticated user.
* This capability is available in Moodle 3.5.2 onwards.

Organisations with multiple systems and a centralised request process can prevent users from downloading their own data (by removing this capability for the authenticated user role) and instead enable a privacy officer to download it for them (by allowing the capability [[Capabilities/tool/dataprivacy:downloadallrequests|Download exported data for everyone]] for the [[Privacy officer role]]).

==See also==

* [[Data privacy]]

[[Category:Capabilities|Privacy]]
[[Category:Privacy]]

[[es:Capabilities/tool/dataprivacy:downloadownrequest]]
[[de:Capabilities/tool/dataprivacy:downloadownrequest]]

Moodle Learning Analytics FAQ

2019-05-28T13:17:59Z

Ghillenb:

{{Tracking progress}}

Here are some common questions about Moodle Learning Analytics. You may also find it helpful to visit the [https://moodle.org/analytics Moodle Learning Analytics Working Group] site.

==Will I start getting predictions as soon as I enable the model?==

Learning analytics models must be trained on your site data before they can generate predictions. The Moodle Learning Analytics engine needs historical data (previous courses), so it will need to be enabled on a production site or a copy of your production site. The model training process happens in the background once the model is enabled on your Moodle site. Once the model has been trained, you will start to receive predictions about current courses. See [[Analytics#Model_management|Analytics: Model management]] for more information.

==Is there a way to export and import model data between sites?==

Model '''data''' can be [[Analytics#Export | exported]] from one site and placed in the [[Analytics#Models_output_directory | model data directory]] of a new site. We are working to collect model data from many sites to construct a training set we can provide with Moodle installations. Please see [https://moodle.org/course/view.php?id=17233#| How to Participate in Learning Analytics Data Collection] for more details.

==Is there a way to export and import the settings of a model between sites?==

This functionality is currently in development. Please see MDL-60944 Allow model configurations to be imported and exported.

==How can I disable Moodle Learning Analytics notifications, or restrict them to certain users, while still enabling models for testing purposes?==

Notifications go to users with the "analytics:listinsights" capability in the context of the prediction-- what this means for the default model is that notifications go to teachers in each course. What you can do is modify the "Teacher" role (editingteacher) to remove that capability. Currently that capability is also turned on for Managers by default. If you want to restrict the notifications to a few individuals, make a new role with just this capability, and assign that role to the individuals you wish to grant permission to in each context.

==How accurate are the model predictions?==

This varies depending on the quality and quantity of site data (including how many activities are in each course and what percentage of the course is conducted online in Moodle). See [[Analytics#Evaluate| Analytics: Evaluate]] for more details on how to review model accuracy.

==How can I create my own Learning Analytics models?==

At present, a new model must be implemented as a Moodle plugin in PHP. See the [https://docs.moodle.org/dev/Analytics_API Moodle Learning Analytics API] for details. We are working to develop tools that will allow non-programmers to create models.

==See also==

* [[Analytics]]
* [https://moodle.org/analytics Moodle Learning Analytics Working Group]
* [https://docs.moodle.org/dev/Analytics_API Moodle Learning Analytics API]

[[Category:FAQ]]
[[Category:Analytics]]

[[de:Analytics FAQ]]

Tags FAQ

2019-05-21T14:00:35Z

Ghillenb:

{{Tags}}
==Can you tag courses?==
Yes, Managers and teachers can tag courses in ''Course administration > Edit settings > Tags'' for a course, and all users may search for them in ''Navigation >Site pages > Tags" and/or you can add the Tags block to your course.

==Who can tag courses?==
By default, the roles of Teacher and Manager can tag courses. Other users may be given the capability to do so in a specific course with a role override in ''Course administration > Users > Permissions'' where you can choose the role to add this ability to (e.g. Non-editing teacher), and then set the moodle/course:tag capability to Allow.
See also [[Course tagger]] for how to create a specific system role to do this.

==Can you display only tag courses in the Tags block?==

Yes. When you add the Tags block to a course, you can specify that the tag cloud only show tags from that course, in ''Configure Tag block > Tagged items context'' and choose the current course from the pull down menu. (The course needs to have at least one tag already in it for it to appear on the list to choose.)

==How do I deal with inappropriate tags?==
When someone adds an unsuitable or inappropriate tag, other users can click on the word (1) to get to the screen where they can flag it as inappropriate (2) The administrator can modify or delete inappropriate tags from ''Site administration>Appearance>Manage tags'' (3)

{|
| [[File:badtag1.png|thumb|(1) Inappropriate tag]]
| [[File:badtag2.png|thumb| (2) Flagging a tag as inappropriate]]
| [[File:badtag3.png|thumb|(3) Admin view of flagged tag]]
|}

[[es:Marcas (Tags) FAQ]]
[[fr:FAQ sur les tags]]
[[de:Schlagwörter FAQ]]

Grade locking

2019-05-20T11:57:03Z

Ghillenb:

{{Grades}}

== Locked after ==
Date ''after'' which the grades will be ''locked''. Usually this date is set to the end of the activity, and the beginning of the grading process.. A typical sequence of events would be:

{| cellpadding="4"
|-
!Event
!Locked
![[Grade hiding|Hidden]]
|-
|Start of activity and participant submissions
|No
|Yes
|-
|End of activity and beginning of grading/feedback
|Yes
|Yes
|-
|End of grading/feedback, and release of grades
|Yes
|No
|}

== Effects of locking ==
Locking prevents changes to grades. It disables the "quick grading" and "quick feedback" features of the [[Grader report]], and prevents modules from updating grades. Locking affects grade items and grades differently, as outlined below.

=== In grade categories ===
Locking has no effect on the category itself, it is only used to affect a large number of grade items at once (bulk action), which in turns locks all their grades. The locking effect cascades down to all the category's children. If the category contains categories, the locking effect continues to cascade down, locking all categories, items and grades below the initial category. A grade item can be unlocked even though its parent category is flagged as locked.

=== In grade items ===
A locked grade item doesn't accept changes to its settings or grades from its related module. When there is no related module (as for manual grades), the locking simply prevents grader report users from changing the grade using the grader report interface.

=== In grades ===
If a grade item is locked, its grades are also locked, and cannot be unlocked until the grade item is also unlocked.

[[ca:Tancament_de_qualificacions]]
[[fr:Verrouillage de notes]]
[[ja:評定ロック]]
[[de:Bewertungen sperren]]

Grade hiding

2019-05-20T09:52:19Z

Ghillenb:

{{Grades}}
==Introduction==
Assessors often decide to hide grades and feedback until marking is complete and finalised, and then release them all at once.

Although Workflow allows this (and is particularly helpful where there are several multiple markers) it is sometimes quicker to simply hide the grades in the Grader Report until it is time to release them. This page explains how to do that.
{{Note|Using Show/Hide for an Assignment on the course front page has '''no effect''' on whether its grades are shown or hidden for students. The assignment and its grades are entirely independent from each other, so the grades must be show or hidden independently.}}

{{Note|If you are using the Grader Report to calculate final grades, do ensure those activities are not hidden when you carry out the calculation.}}

==Automatically hide grades and feedback until a set date==
This is useful if you have agreed a fixed date to reveal marks and feedback to students. It saves you needing to remember to do this manually (though you can manually change the date if you need to).
#In the Grader Report, turn editing on; further settings and controls display.
#In the activity's column, in its '''Controls''' row, click the '''Edit''' icon; a settings page displays.
#To reveal the settings for dates setting, click the link to '''Show more'''; further settings display.
#For the '''Hidden until''' setting, click its Enable checkbox; it becomes editable.
#Type in the date and time to reveal the marks and feedback.
#Save.

==Manually hide grades and feedback==
This is best used if you never want students to see the grades or feedback, or if you are unsure of the date on which they need to be revealed.
#To get to the Grader Report go to your Moodle course front page and in its Settings click Grades; the Grader Report displays.
#'''Turn editing on'''; further settings and controls display.
# Note that columns correspond to activities, and each column has '''Controls''' (just below the column title) which act on that entire activity.
#To hide grades and feedback for an assignment, find its column and click the '''Show/Hide''' icon in the '''Controls''' row.
#In this case there is no need to Save - the effects are immediate.

==An example of how hiding grades might be used==

{| class="nicetable"
|-
!Phase
!Hidden
![[Grade locking|Locked]]
|-
|Before the due date; participant submissions
|Yes
|No
|-
|Due date and beginning of grading/feedback
|Yes
|Yes
|-
|End of grading/feedback, release of grades
|No
|Yes
|}

[[ca:Ocultació_de_qualificacions]]
[[es:Ocultamiento de calificación]]
[[fr:Note cachée]]
[[ja:評定非表示]]
[[de:Bewertungen verbergen]]

Grader report

2019-05-20T07:40:26Z

Ghillenb:

{{Grades}}
All the grades for each student in a course can be found in the course gradebook, or 'Grader report', accessed from the Grades link either in the nav drawer or navigation block depending on your theme.

{{MediaPlayer | url = https://youtu.be/ZR4AvpD3bVA | desc = Overview of the gradebook}}

The grader report collects [[Grade_items|items]] that have been graded from the various parts of Moodle that are assessed, and allows you to view and change them as well as sort them out into [[Grade_categories|categories]] and calculate totals in various ways. When you add an assessed item in a Moodle course, the gradebook automatically creates space for the grades it will produce and also adds the grades themselves as they are generated, either by the system or by you.

The grades displayed are initially displayed as the raw marks from the assessments themselves, so will depend on how you set those up e.g. an essay out of 36 will appear as however many raw marks that student got, not a percentage (although this can be changed later, see below).

Note that various default options for the gradebook are set at system level by the administrator in and can be marked as being overridable by you, or fixed. This means that the options will not always be set up the same way for every user when they see the grader report for the first time.

==Hiding settings globally==

New settings hide parts of the user interface:

*''Site administration>Grades>General settings'': 'Show minimum grade' . If this setting is disabled, the minimum grade will default to zero and cannot be edited (the minimum grade can never be edited).
*''Site administration>Grades>Grade category settings'': 'Allow category grades to be manually overridden'. If this setting is disabled, users cannot override category grades.

==Display==

Along the top of the grader report are several rows: first the course, then the category, then the columns for each graded activity (for example: Assignment, Quiz, Lesson). Any activities settings which were left "uncategorised" will appear in the general category which is named after the course by default (any category name can be changed).

[[Image:gradereportcategories.png|center|thumb|600px]]

You can add a row showing the range of possible scores by selecting 'Show ranges' in 'My report preferences.

There are three ways that the categories can be displayed:

* Grades only - without the category totals column
* Aggregates - Category total column only
* Full view - grades and the aggregates (the totals column for the category)

Each section has a small icon immediately to the right of its name. Clicking this will cycle through these display modes for that category;

[[Image:grades3iconsa.png|thumb|500px|center]]

===Scrolling through the gradebook===

The gradebook allows for smooth and stable scrolling horizontally and vertically through grades. It uses the whole window, making it accessible on all platforms.( Note: horizontal scrolling is at the bottom of the browser window, and there is no horizontal scrollbar at the top.)

{|
| [[File:scrolling28a.png|thumb|500px|Scrolling in all directions]]
| [[File:wholewindow.png|thumb|500px|Using the whole window]]
|}

[[File:newgradereporta.png|thumb|600px|center]]

===Sorting by columns===

You can sort by any column. Click the [[Image:iconsort.png]] symbol near the top of a column to sort by that column (1 below). This will change the symbol to a single down arrow. Clicking again will sort lowest-to-highest, changing the symbol to an up arrow. The arrows will toggle between these two states until you click on a different column.

You can also access the [[Single view]] by clicking the pencil icon next to the arrows (2 below).

[[File:iconsgrades.png]]

You can sort the students by clicking the arrow (1 below), access individual [[User report| user reports]] by clicking the icon (2 below) and similar to the grade items you can access [[Single view]] by clicking the pencil icon (3 below)

[[File:studentsort.png]]

===Searching and filtering the gradebook===
If you change the course settings Group mode to Visible groups or Separate groups a drop-down menu will appear in the gradebook to allow you to filter your students by groups.

It is also possible to search students by first name and last name:

[[File:gradebooksearch.png]]

==Editing==

Note: Editing anything in the gradebook refers to editing the grades '''only''' and none of the available operations bear any relationship to editing the main course page i.e. the appearance of your course page cannot be influenced by anything you do in the gradebook. The "Turn editing on" button functions separately from the main course one, so editing can be on in the gradebook, but simultaneously off when you switch back to course view. This is because editing grades and editing the course page are separate capabilities. Roles such as 'non-editing teacher' may only have one or the other.

===Altering the grades===
You can click "Turn editing on" at the top right to show an edit icon next to each grade. Clicking on the icon will bring up the editing screen for that grade which will allow you to set the grade, its written feedback and a number of other attributes.

Alternatively, you can choose "Quick grading" and "Quick feedback" in 'My preferences' to make the report appear with editable boxes containing each grade, so you can change many at once. This capability can be a real time saver, but make sure to save at reasonable intervals lest a pageful of changes be lost.

Note: If you make changes here, they are then shown highlighted to indicate grades which have been manually changed.

===Altering the grades using Single View===
There is a new way to enter grades into the grader report using the Single View tab (or listing in the dropdown) under Setup. (This interface can also be accessed by clicking on the pencil icon at the top of the column by the item name).
The single view interface allows you to enter grades in bulk for a specific grade item or a specific user. To change a specific grade or all grades, click on the Override checkbox by the specific grade row or use the Override All link to check every row. If you wish to override all grades with a set grade, check the Bulk Insert checkbox and enter the grade that you wish to insert. You can select whether to fill the grade for just empty grades or for all grades from the dropdown list.
Click on Save and you will now see in the Grader Report that all grades the specific item/user have been overridden with the grade/grades that you entered.

===Hiding columns or individual grades===
Turning on editing then clicking the "Show show/hide icons" link will give you the familiar show/hide eye icon next to each grade and at the top of each column. For more information, read about [[Grade_hiding|grade hiding]].

===Recalculating===
If you change any part of an assessment e.g. alter the maximum grade for one of the questions in a quiz, you may find that the columns do not yet reflect the change you have made. Click '''Turn editing on''' twice to force the gradebook to re-check.

==Gradebook capabilities==

There is just one gradebook capability, [[Capabilities/gradereport/grader:view|View the grader report]], which is allowed for the default roles of manager, teacher and non-editing teacher.

==Extending the gradebook==

The Gradebook can be extended in three main ways:

===1. [https://moodle.org/plugins/browse.php?list=category&id=9 Grade reports]===
Which are the main way to view and manipulate grades
* [[LAEGrader report|LAE Grader Report]] Alternative to Grader report that scrolls vertically and horizontally without losing student columns or grade item header rows. Lot of additional enhancements.
* [https://moodle.org/plugins/view.php?plugin=gradereport_updfgrades Upload PDF Grader Report] lets you view assignment grades, comments and lateness in a report

===2. Grade import plugins===
Which allow data to be imported from external sources

===3. [https://moodle.org/plugins/browse.php?list=category&id=10 Grade export plugins]:===
Which allow you to export grade data for other systems
* [https://moodle.org/plugins/view.php?plugin=gradeexport_pdf PDF document] This is moodle plugin for exporting grades in PDF format. It is developed by using "Moodle PDF library"
* [https://moodle.org/plugins/view.php?plugin=gradeexport_checklist Checklist] This is a grade export plugin which will create an Excel spreadsheet containing all the checkmarks from a single checklist.

==See also==

* Join the discussions about gradebook plugins in the [https://moodle.org/mod/forum/view.php?id=2122 Gradebook forum].

[[de:Bewertungen]]
[[es:Libro de calificaciones]]
[[fr:Carnet de notes]]
[[ja:評定表]]

Competency breakdown report

2019-05-13T09:26:42Z

Ghillenb:

{{Course reports}}
*The competency breakdown report allows teachers to view the competencies of each student in their course, along with their ratings.
*Teachers can click a 'Not rated' link and rate a competency.

[[File:Picture1.png]]

[[Category:Competencies]]

[[es:Reporte de desglose de competencias]]
[[fr:Rapport de compétences]]
[[de:Kompetenzaufteilung]]

Learning plan supervisor

2019-05-10T12:06:53Z

Ghillenb: /* See also */

{{Competencies}}Course teachers cannot by default create, manage or view student [[Learning plans|learning plans]], since competencies and learning plans exist outside of a course context, whereas the role of teacher is assigned in the course context. To allow course teachers to create, manage and view learning plans ''for the students they are responsible for only'', follow these steps:

==Create two custom roles==

====Learning plan supervisor (system)====

#From Site administration, access the Define Roles screen and click the button to Add a new role.
#Click the Continue button.
#Give your role the name ''Learning plan supervisor (system)''
#Tick 'System' as the context type where the role may be assigned.
#Scroll down and set the capabilities moodle/site:configview, moodle/competency:templatemanage, moodle/competency:templateview and block/lp:view all to Allow.
#Save the new role.

====Learning plan supervisor (user)====

#From Site administration, access the Define Roles screen and click the button to Add a new role.
#Click the Continue button.
#Give your role the name ''Learning plan supervisor (user)''
#Tick 'User' as the context type where the role may be assigned.
#Scroll down and set the capabilities moodle/competency:planmanage, moodle/competency:planreview, moodle/competency:plancomment all to Allow.
#Save the new role.

==Create a cohort of the teacher's students==
In order to ensure the new learning plan supervisor can only deal with his/her own students, we need to create a cohort.

#From Site administration, access the Cohorts screen and add a new cohort.
#Add the students of the teacher you wish to make a learning plan supervisor.

==Match the cohort to their teacher==
#From Site administration, access the Cohorts screen and create a cohort with the relevant students in it.
#Then from the Users tab, click the link Assign user roles to cohort.
#From the top dropdown, choose your teacher.
#In the middle ('Select role') dropdown, choose 'Learning plan supervisor (user)'. (Note that only roles with 'User' ticked as the context type where they may be assigned will be visible here.)
#From the bottom ('Select cohorts') dropdown, choose the cohort with the teacher's students.
# Click the Assign button.

==Assign your teacher the new role==
#From Site administration, access the Users screen, and then from Permissions, click Assign system roles.
#Assign your chosen teacher the role of Learning plan supervisor (system).

==What the teacher sees==
''Note: The role will not take effect immediately; only once the scheduled task has run.''

The course teacher will see a Site administration link and be able to access learning plan templates:

[[File:learninplanmanager1.png|center|thumb|500px]]

He/she will be able to add a new learning template.

[[File:learningplanmanager2.png|center|thumb|500px]]

Once the template is created, clicking the Edit link will allow them to create new learning plans ''only for the students in the cohort'' created by the admin.

[[File:learninplanmanager3.png|center|thumb|500px]]

The course teacher and learning plan supervisor will be able to see the learning plans from their students' profiles.

==See also==
*The [[Learning plan viewer]] role allows course teachers to view (but not create or edit) the learning plans of their students.
*The [[Competency reviewer]] role allows course teachers to view evidence uploaded by students and review their competencies.

[[Category:Roles]]

[[es:Supervisor de plan de aprendizaje]]
[[de:Lernplan-Verwalter-Rolle]]

Moodle Mobile assignment

2019-04-02T09:39:09Z

Ghillenb:

{{Mobile}}
==Features==

* Students can make [[Assignment activity|assignment submissions]] using the app, review their submissions and check their feedback, comments and grades.
* Teachers can view and download the students' submissions and review comments, feedback and grades.
* When uploading a file submission, all files are uploaded again if any changes have been made.

<div><ul>
<li style="display: inline-block;">[[File:Android assignment 1.png|thumb|250px|View assignment, check status and submit]]</li>
<li style="display: inline-block;">[[File:Android assignment 2.png|thumb|250px|Online text submission]]</li>
<li style="display: inline-block;">[[File:Android assignment 3.png|thumb|250px|File submissions]]</li>
<li style="display: inline-block;">[[File:Android assignment 4.png|thumb|250px|Submit for grading]]</li>
<li style="display: inline-block;">[[File:Android assignment 5.png|thumb|250px||Teacher: Check user submissions]]</li>
<li style="display: inline-block;">[[File:Android assignment 6.png|thumb|250px|Teacher: Blind marking]]</li>
</ul></div>

== Requirements ==

Moodle Mobile assignment requires Moodle 3.1 onwards.

Alternatively, it may be used with sites running Moodle 2.8 to Moodle 3.0 with the [[Moodle Mobile additional features]] plugin installed. For earlier versions of Moodle, only basic information will be displayed.

Third party submission and feedback plugins are only supported if the Moodle website has the appropriate remote add-on installed.

==See also==

For submission of files using iOS please refer to [[Sharing files with Moodle Mobile with iOS]].

[[Category:Assignment]]

[[es:Tarea de Moodle Mobile]]
[[de:Moodle App - Aufgaben]]

Moodle app SCORM player

2019-04-02T09:37:24Z

Ghillenb:

{{Mobile}}
==Features==

The Moodle app SCORM player enables the playing of SCORM 1.2 packages online and offline.

When a user loses connectivity, offline mode is enabled automatically and all interactions that are tracked by the SCORM package are saved.

When a user is online again, the offline attempt is synchronised back to the Moodle site, either merging it with other incomplete attempts on the site or saving it as a new attempt.

== Requirements ==

The Moodle app SCORM player requires Moodle 3.0 onwards. In ''Site administration > Plugins > Activity Modules > SCORM Package'' the setting 'Protect package downloads' should be disabled (default setting).

The Moodle app SCORM player may be used on sites running Moodle 2.6 to Moodle 2.9 if the [[Moodle app additional features]] plugin is installed.

If the playing of SCORM packages offline is not desired, the setting 'Protect package downloads' may be enabled. If the Moodle app additional features plugin is being used, the setting can be found in ''Site administration > Plugins > Local plugins > Moodle Mobile additional features''.

The ZIP file containing the SCORM contents should not be Windows specific. If your SCORM package contains directories using the inverted path separator "\" they won't work in Android.

== Technical details ==

The Moodle app SCORM player provides support for:

* SCORM 1.2 packages
* Objectives, interactions and prerequisites
* SCO navigation via nav.event
* Uploaded packages, remote zip packages and zip packages in any type of repository supported by Moodle

The Moodle app SCORM player does not currently support:

* Remote imsmanifest.xml packages or file system repository unzipped SCORMS
* Opening of packages outside the app e.g. in a new browser window
* JavaScript pop-ups via window.open (Mobile device limitation)

==Tips for Moodle app friendly SCORM packages ==

* Try to reduce the size of the images and use mobile-compatible formats e.g. png
* Try to reduce the size of videos and use mobile-compatible formats e.g. mp4
* Avoid using Flash or FLV
* Avoid using images, files or media on remote sites
* Avoid using pop-ups
* Avoid using advanced HTML5 features, as they may not be supported by old devices such as iOS 4 or Android < 4.4
* Avoid having a left navigation menu as part of the SCORM package, as this reduces the space available for the package content
* If you want to display your SCORM package in semi full-screen mode (it will just remove the app bottom menu), you have to configure it in Moodle so it will open in "New window" via the SCORM module Appearance settings.

[[Category:SCORM]]

[[es:Reproductor SCORM Moodle Mobile]]
[[de:Moodle App - SCORM Player]]

Moodle app features

2019-04-02T09:36:38Z

Ghillenb:

{{Mobile}}
__NOTOC__
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:36MoodleApp.png|600px]]
<div class="caption">
<h4>See your courses at glance</h4>
<p>Your courses are listed with easy access to contents, participants, grades and notes. A useful filter field lets you find a particular course quickly. If your token expires during a session, you're prompted to re-enter your password and continue. </p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35timeline.png|600px]]
<div class="caption">
<h4>View and access activities which are due</h4>
<p> The timeline display shows you which tasks you need to complete, with quick access links. </p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35connectparticipants1.png|600px]]
<div class="caption">
<h4>Connect with course participants</h4>
<p>Easily connect to course participants.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35dashboardbothorientations.png|600px]]
<div class="caption">
<h4> Orientation and resolution support </h4>
<p>The app displays in portrait or landscape view, whatever your screen resolution.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35accesscourses.png|600px]]
<div class="caption">
<h4>Easily access course content</h4>
<p>View course activities and download materials for offline use. Work through Books and IMS Content packages directly in the app. The downloading status of resources is preserved even when changing sections or pages.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35activitycompletion.png|600px]]
<div class="caption">
<h4>Activity completion</h4>
<p>Track progress from your device with [[Activity completion]]. Automatic completion is registered, and students can also manually mark a task complete on their mobile.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35gradebook.png|600px]]
<div class="caption">
<h4>Grades and grading</h4>
<p> A Grades link for each course gives fingertip access to the gradebook, and teachers can view assignment submissions on the move.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35notes.png|600px]]
<div class="caption">
<h4>Notes</h4>
<p>Teachers can view site, course and personal notes about their students and add their own notes.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35messages.png|600px]]
<div class="caption">
<h4>Message participants</h4>
<p>Send and view private messages to colleagues and students from the Messages link in the side tab.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35calendar.png|600px]]
<div class="caption">
<h4>Keep up to date with calendar events</h4>
<p>Site, course and user events can be viewed in the calendar.Calendar events can now be viewed offline and infinite scrolling is available.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35privatefiles.png|600px]]
<div class="caption">
<h4>View and upload to your Private files</h4>
<p>Check the contents of your private files and upload media to them on the go. You're now allowed up to 50MB storage (depending on your SD card).</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35notifications.png|600px]]
<div class="caption">
<h4>Notifications</h4>
<p>Keep up to date with notifications. The app supports both local (calendar events) and push (messages, forum posts, submitted assignments etc) notifications. See [[Mobile app notifications]] for more details. Infinite scrolling is available and local notifications have multi-site support.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile35choice.png|600px]]
<div class="caption">
<h4>Make choices</h4>
<p>The app supports students making and removing choices.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35chat.png|600px]]
<div class="caption">
<h4>Engage in chat, on the move</h4>
<p>Participate in a course [[Chat activity]].</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35survey.png|600px]]
<div class="caption">
<h4> Feed back to teachers with a survey</h4>
<p>[[Survey|Surveys]] may now be taken using the app.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35searchcourses.png|600px]]
<div class="caption">
<h4>Search the list of courses</h4>
<p>App users can search courses to find one they wish to take.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35selfenrol.png|600px]]
<div class="caption">
<h4>Enrol yourself from your smartphone</h4>
<p>Found a course you like? Enrol immediately via the app.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35scorm.png|600px]]
<div class="caption">
<h4>Play SCORM packages on and off-line</h4>
<p>The [[Moodle Mobile SCORM player]] tracks interactions and synchronises when you're back online.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35downloadcourse.png|600px]]
<div class="caption">
<h4>Download all course sections</h4>
<p>Easily download all sections to view offline.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35glossary.png|600px]]
<div class="caption">
<h4>Browse glossary entries</h4>
<p>Search for and browse glossary entries.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile35quiz.png|600px]]
<div class="caption">
<h4>Take quizzes on your mobile</h4>
<p>Quizzes may now be completed on the move. Find out more about the [[Moodle Mobile Quiz module|Moodle Mobile quiz]].</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35learningplans.png|600px]]
<div class="caption">
<h4>Learning plans </h4>
<p>Learning plans may be viewed and progress checked from the mobile.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35competencies.png|600px]]
<div class="caption">
<h4>Easiy view course competencies</h4>
<p>A Competencies tab allows you to see course competencies at a glance.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35teachergrading.png|600px]]
<div class="caption">
<h4>Teachers: Grade assignments</h4>
<p>Assignments may be graded on the move, from the app and may be graded offline</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile35badges.png|600px]]
<div class="caption">
<h4>View badges from your profile</h4>
<p>Badges are now visible from a link in the user profile</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35preferences.png|600px]]
<div class="caption">
<h4>Notifications & Messaging preferences</h4>
<p>New preferences screen lets you decide how to be alerted</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile35workshop.png|600px]]
<div class="caption">
<h4>Submit to workshops from the app</h4>
<p>Students can now do workshop activities from their mobile or tablet.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35paypal.png|600px]]
<div class="caption">
<h4>Sign up to courses via PayPal</h4>
<p>PayPal enrolment is now supported in the app.</p>
</div>
</div>
</li>
</ul>
</div>
====Features summary====

* Responsive design for phone and tablets
* Upload a picture into your private file area
* Record an audio file and upload it into your private file area
* Record a video and upload it into your private file area
* Send a private message to a course participant (can be done offline)
* Take a personal note about a course participant (can be done offline)
* Add a course participant to your phone contact
* Call a course participant touching the phone number
* Locate a course participant address on Google map
* Download and view some course resources
* Quick access to your course contents
* View calendar events
* Reminder notifications for calendar events
* Mobile Push notifications
* Remote layout/style customization (see below)
* View all your past private messages and notifications
* Browse and download your private and course files
* View forum discussions
* Private messaging between users
* Calendar integration with warning reminders as local notifications
* Upload any type of file from your device to your Moodle private files area
* View site, course and personal users notes
* Support for sites using CAS or Shibboleth as auth methods
* View your activity and course total grades in a course
* Course search
* Self-enrolment in courses (including via PayPal)
* Access courses with guest access enrolment method enabled
* Follow app-specific activity links (see [[Creating Moodle Mobile friendly courses]] for details)
* Browse glossary entries
* Browse your learning plans
* View competencies of students in your course
* Support for all the course modules (activities and resources) except the Workshop module
* [[Moodle Mobile quiz|Attempt quizzes]]
* [[Moodle_Mobile_SCORM_player|SCORM player]]
* [[Moodle Mobile assignment|Make assignment submissions]] and review submissions, comments, feedback and grades
* Use a rich text editor when creating forum posts, attempting quizzes with essay questions, creating wiki pages or submitting assignments (only in Android 4.4 onwards)
* Submit to workshop activities

==Activities & Resources Support==

[[File:moodlemobile_activities_resources.png]]

==Comparison of features in different versions==
[[File:30_moodlemobile_features.png]]

=== Languages ===

The Moodle app is being translated into an increasing number of languages. As of August 2018, 35 languages are available:

(ar) عربي, (bg) Български, (ca) Català, (cs) Čeština, (da) Dansk, (de) Deutsch, (de-du) Deutsch - Du, (el) Ελληνικά, (en) English, (es) Español, (es-mx) Español - México, (eu) Euskara, (fa) فارسی, (fi) Suomi, (fr)Français, (he)עברית, (hu) magyar, (it) Italiano, (ja) 日本語, (ko) 한국어, (lt) Lietuvių, (mr) मराठी, (nl) Nederlands, (pl) Polski, (pt-br) Português - Brasil, (pt) Português - Portugal, (ro) Română, (ru) Русский, (sr-cr) Српски, (sr-lt) Srpski, (sv) Svenska, (tr) Türkçe, (uk) Українська, (zh-cn) 简体中文, (zh-tw) 正體中文

If the Moodle app is not yet available in your language, please consider helping with the translation. See [[:dev:Translating Moodle Mobile|Translating Moodle Mobile]] for details.

[[ca:Característiques_Moodle_Mobile]]
[[es:Características de Moodle Mobile]]
[[fr:Fonctionnalités de l'app mobile]]
[[de:Moodle App - Funktionalitäten]]

== See also ==
* [http://www.slideshare.net/juanleyva/moodle-mobile-offline-features Moodle Mobile offline features] - Presentation in the MoodleMoot UK 2016
* [[:dev:Moodle Mobile release notes|Moodle Mobile release notes]] in the dev docs

Moodle app notifications

2019-04-02T09:24:13Z

Ghillenb: /* Testing push notifications */

{{Mobile}}

==For students and teachers==
[[File:12Notifications.png|thumb|Forum post notification]]
The Moodle mobile app lets you keep up to date with all that's happening in your courses and on the site. Every time you open the app, events are synchronised with the website.

You will receive [[Calendar|Moodle calendar]] event notifications automatically. If you don't want to get them, you can turn them all off individually (or globally) in the Calendar events options in the main menu.

You will also receive notifications of messages, forum posts, submitted assignments etc (known as 'push notifications') if your site administrator has enabled these. To receive these notifications you need to enable them EITHER via the app OR via the website.

To enable mobile notifications via the app:

# Go to the app settings then Notification preferences
# Move the slider so that disable notifications is off
# Move the slider to turn on notifications for assignment, feedback, forum etc. as required

To enable mobile notifications via the website:

# Go to your user menu (top right of each page) and select Preferences
# Click the link 'Notification preferences'
# Click to turn on notifications for assignment, feedback, forum etc. as required

{|
|-
| [[File:notification preferences app.png|thumb|Notification preferences in the app]]
| [[File:notification preferences web.png|thumb|Notification preferences on website]]
|}

==For administrators==

Push notifications can be enabled by an administrator by connecting their Moodle site to a messaging server such https://messages.moodle.net (available for [[Site registration|registered Moodle sites]] only). An access key can be obtained via ''Administration > Site administration > Plugins > Message outputs > Mobile Notifications''.

You can enable by default Mobile notifications for your students, please read the "Default message outputs" section in [[Messaging settings]].

If you have problems requesting the access key, please fill in the [http://goo.gl/forms/WLwkbe8b7c Airnotifier access key manual request form]. (If your site is hosted so you can't obtain your siteidentifier, enter "cannot obtain" in the field.) Your site registration will be checked and you will be sent an access key in a few days if everything is correct.

Users then need to connect at least once with the latest version of the Moodle Mobile app in order to register their phones with the Moodle site.

=== Event Reminders plugin===

Push notifications can also include calendar event notifications, however this requires the [https://moodle.org/plugins/view/local_reminders Event Reminders plugin] to be installed on the Moodle site.

The Event Reminders plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. It also allows users to control how they receive messages for each type of event in the Moodle calendar.

=== Installing your own notifications infrastructure ===

If you have a customized version of the Moodle Mobile app, or you want to use your own notifications infrastructure, you will have to install a private [http://airnotifier.github.io AirNotifier] (backend server for notifications).

https://messages.moodle.net uses a slightly modified version of Airnotifier: https://github.com/moodlehq/airnotifier/tree/moodle2.

'''UPDATE''': Google is deprecating FCM in April, 2019. The following steps may not be valid starting that date

You will have to add your app certificates - see https://github.com/airnotifier/airnotifier/wiki/Installation for further information.

The Airnotifier message plugin allows you to point to your custom Airnotifier instance using your own access keys.

Remember to install using GIT (repository https://github.com/moodlehq/airnotifier.git branch ''moodle2'').

Moodle offers a branded app service including a private notifications infrastructure, for more information visit https://moodle.com/mobileapp/

== Troubleshooting ==

If your users are not receiving push notifications please check:

* You have entered an Airnotifier access key in the Mobile settings in the Site administration
* Mobile is enabled (open eye) in 'Manage message outputs' in the Site administration
* Any user not receiving notifications has enabled mobile notifications in the mobile app in App settings > Notification preferences then check that "Disable notifications" is not selected
* Any user not receiving notifications has enabled the type of notifications they want to receive in App settings > Notification preferences
* Any user not receiving notifications hasn't disabled his current device in App settings > Notification preferences > 3 dots menu > Configure devices
* Mobile notifications are not disallowed by an administrator in 'Default message outputs' in the Site administration
* Mobile notifications are enabled in the user's Android phone (Settings > Apps > Moodle Mobile > Show notifications ticked) or iOS phone (in iOS in Settings -> Moodle Mobile > Notifications)
* The server where your Moodle site is installed is able to connect to messages.moodle.net (port 443) via telnet
* You are using the Moodle Mobile official app. If you are using a custom/branded app for your institution, please contact your institution since custom apps need their own notifications infrastructure (see above).
* Your Moodle installation cron jobs are not locked. You can check it executing the CRON manually and reading the output, more info [https://moodle.org/mod/forum/discuss.php?d=361595 here]

=== Testing push notifications ===

To test push notifications:

# Ensure that mobile notifications are enabled (as described above).
# Go to a course and create a forum with forced subscription.
# Log in as a student and create a new discussion in the forum.
# As the same student, log in on the mobile app, go to App settings > Notification preferences > Forum and enable all the notifications.
# In the same page, check that at the top of the page you see "You are configuring Mobile notifications". If it says "You are configuring notifications for web (or email)", switch to mobile via the three dots menu at the top right.
# In the same page, tap the three dots menu (top right), go to Configure devices and check that your current device is enabled.
# Now, put the Moodle Mobile app in background (switching to a different app or going to your device home).
# Log in to the site (on the web) and post a reply to the discussion started by the student., ticking the option "Send forum post notifications with no editing-time delay".
# Verify that the student receives a push notification on their mobile device.

[[de:Moodle App - Systemnachrichten]]
[[ca:Notificacions_de_la_app_Mobile]]
[[es:Mobile app Notificaciones Push]]
[[fr:Notifications de l'app mobile]]

New for mobile

2019-04-02T09:19:26Z

Ghillenb: /* See also */

{{Mobile}}

__NOTOC__

The Moodle app for 3.6 will be released a short time after Moodle 3.6 and will support the new features in Moodle 3.6, along with infinite scrolling and improved performance.

== See also ==

* [[:dev:Moodle_Mobile_release_notes|Moodle Mobile release notes]] in the dev docs

[[Category:New features]]

[[es:Nuevo para mobile]]
[[de:Moodle App - Neuigkeiten]]

Moodle app additional features

2019-04-02T09:13:20Z

Ghillenb: /* Admin users, please read */

{{Mobile}}
{{Infobox plugin
|type = Local plugin
|entry = http://moodle.org/plugins/view.php?plugin=local_mobile
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/13930
|discussion = https://moodle.org/mod/forum/view.php?id=7798
|maintainer = [[User:Juan Leyva|Juan Leyva]]
}}

The Moodle Mobile additional features plugin provides new features and web services for the Moodle Mobile app which are currently only available in the latest Moodle version.

This plugin is officially developed and maintained by Moodle HQ

== How it works ==

Once installed the plugin creates a new service "Moodle Mobile additional features". The Mobile app checks if this service is enabled. If not, the Mobile app falls backs to the standard core Mobile app service.

Please, open [[Moodle Mobile features]] to check what new features are added to your site depending on your Moodle version.

== Features ==

* Support for Moodle sites prior to 3.2 using SSO authentication methods (Shibboleth, CAS and Google OAuth 2)
* Support for sites using MNet authentication (Moodle Network authentication)
* Support for push notifications in Moodle sites prior to version 2.6

=== Enable authentication for sites using SSO methods (like Shibboleth and CAS) ===

VERY IMPORTANT NOTE: If SSO is not working for your (or it is failing randomly), you'd need to disable the "Auto login guest" option "autologinguests". This setting may not be compatible with the SSO via app in some sites (it should work fine in Moodle 3.2 onwards).

SSO and MNet authentication is not supported in the Windows 8 and Windows Phone 8 apps

Once the plugin is installed, you need to go to Site administration > Plugins > Local plugins > Moodle Mobile additional features

There you can choose the "Type of login":
; '''Via the app''' : Is the default login, the user must introduce his credentials in the app
; '''Via a browser window''' : A new browser instance is open in the mobile device pointing to the login form in the Moodle site (which may again redirect to external identity providers if required). The user must introduce his credentials there. This is the option that must be selected for sites using SSO methods (or for sites that wants to force the user to authenticate in the site, not in the app)

[https://www.youtube.com/watch?v=cl8rsyyyg9g Video showing Moodle Mobile SSO]

When using the "Via a browser window" option, you can optionally specify an URL scheme to be used by the system to open the Mobile app. By default, the URL scheme used to open the app will be the one indicated by the own app during the SSO process. If you've developed a custom app using its own URL scheme and you want to allow only SSO logins via your app, you can indicate there an URL scheme. The site will detect that setting and will use it instead of the value indicated by the app.

=== Configuring the app from your site ===

* Disable app functionalities for your site. If there's a feature you don't want to make available via the app you can disable it here.
* Rename app text strings.
* Add new items in the app's main menu (the side menu).
* Replace the Change site option with a "Log out" one to force the users to enter their credentials on their next access.

== Installation ==

# Unpack the zip file into the local/ directory. A new directory will be created called local/mobile.
# Go to ''Site administration > Notifications'' to complete the plugin installation.
# Go to ''Site administration > Mobile app > Mobile settings'' and enable web services for mobile devices (Remember to save the changes)
# Go to ''Site administration > Plugins > Web services > External services'', edit "Moodle Mobile additional features" and check the "Enabled" field, then save changes.
# Go to ''Site administration > Users > Permissions > Define roles'', edit the Authenticated user role and allow the capability moodle/webservice:createtoken.

Note: You need to have upgraded the Moodle Mobile app to version 1.4.4.

If you are currently using the Moodle Mobile app, you will need to log out of all your sites in order for the app to detect the new service.

== Admin users, please read ==

This plugin installs a new service in your Moodle installation, the automatic token creation for this type of services is forbidden for admin users. This means that admin users will not be able to use the Mobile app.

This can be solved easily, administrators must create a token manually in Moodle (''Plugins > Web Services > Manage tokens'') for the local_mobile service. '''Note:''' Be sure to toggle the default "Moodle mobile web services" setting to "Moodle mobile additional features service" before creating the token.

[[de:Moodle App - Zusatzfunktionen]]
[[es:Características adicionales de Moodle Mobile]]
[[fr:Fonctionnalités additionnelles de l'app mobile]]

Moodle Mobile quiz

2019-04-02T09:07:48Z

Ghillenb: /* See also */

{{Mobile}}
==Features==

Users can attempt a [[Quiz activity|quiz]] on their mobile device using the Moodle Mobile app.

Notes:
* Any quiz with standard [[Question types|question types]] and [[Question behaviours|question behaviours]] is suitable for mobile access, apart from essay questions which require the student to upload a file.
* Quizzes using additional plugins won't work in the app unless the plugin include support for mobile remote add-ons (see in the dev docs [[:dev:Moodle Mobile Remote add-ons|Moodle Mobile Remote add-ons]]).
* Quizzes requiring safe browser are not supported.
* Quizzes including blocked questions (questions that require that the previous question has been answered) are not supported.

== Requirements ==

Moodle Mobile quiz requires Moodle 3.1 onwards.

Alternatively, it may be used with sites running Moodle 2.6 to Moodle 3.0 if the [[Moodle Mobile additional features]] plugin is installed.

If you have quizzes with questions using TeX / MathJAX you must enable the [[TeX notation filter]] enabling all the LaTeX renderer settings. Please note that equations are rendered using LaTeX.

==See also==

* [[Moodle Mobile quiz offline attempts]] for details of how to enable students to download and attempt quizzes offline

[[Category:Quiz]]

[[es:Módulo de Examen Moodle Mobile]]
[[de:Moodle App - Tests]]

Box repository

2019-04-02T08:53:16Z

Ghillenb: /* Capabilities */

{{Repositories}}

The Box repository enables users to copy files from Box into Moodle.

In order to use the Box repository, your Moodle site must use HTTPS. In addition, an administrator must obtain a Box client ID and secret. The client ID and secret can then be used to configure all Box plugins.

==Obtaining a Box client ID and secret==
#Go to https://app.box.com and create an account or log in
#Go to https://app.box.com/developers/services and click the link 'Create new application'
#Select 'Custom app' and click 'Next'
#Select 'Standard OAuth 2.0 (User Authentication)' and click 'Next'
#Click 'View Your App'
#Enter an application name
#Edit 'Redirect URI' on the OAuth 2.0 Redirect URI section and write http://yourmoodleserver/admin/oauth2callback.php
#Click 'Save Changes' button
#On to the section 'OAuth 2.0 Credentials' make a note of the client ID and secret
#The client ID and secret can then be used to configure the Box repository and Box portfolio.

The client ID and secret can then be used to configure the Box repository and Box portfolio.

==Enabling the Box repository==

# Go to ''Administration > Site administration > Plugins > Repositories > Manage Repositories''
# Reactivate the Box.net repository by selecting 'Enabled and visible' in the dropdown menu
# Configure the repository plugin by entering the Box client ID and secret. Make sure you don't include any white space in the text boxes!
# Save changes

==Enabling the Box portfolio==

# Go to ''Administration > Site administration > Plugins > Portfolios > Manage Portfolios''
# Reactivate the Box.net portfolio by selecting 'Enabled and visible' in the dropdown menu
# Configure the portfolio plugin by entering the Box client ID and secret
# Save changes

==Capabilities==

There is just one capability, [[Capabilities/repository/boxnet:view|View box.net repository]], which is allowed for the default authenticated user role.

[[eu:Box.net_ezarpenak]]
[[de:Box Repository]]
[[es:Repositorio Box.net]]

Remote RSS feeds block

2019-04-02T08:17:37Z

Ghillenb: /* See also */

{{Blocks}}The '''RSS feeds''' block enables [[RSS]] feeds from external websites to be displayed within Moodle. As the information on the other site (for example, news headlines or recently added documents) is changed the block will update to show the latest information.

[[File:Rssexample.png]]

One or more RSS feeds can be added to a course by selecting them from an existing list. Site and course home pages are common places to place an RSS feed block(s).

==Configuring RSS feeds block==

After adding an RSS feed block, select the edit icon on the Remote News Feed block. The default will open up the '''Configure this block''' tab.

;Display each link's description?
:Choose yes or no from the drop-down menu to determine whether the block will display a description of each article, or just the title of the article. Both the title and description are generated by the external feed.

;Max number of entries to show per block
:Determines how many articles will be displayed. The most recent will be displayed first.

;Choose the feeds to make available
:Check the box next to each feed you would displayed in this block. You can have more than one instance of the RSS feed block if you would like to break them up.

;Title
:Enter a title for the block. If you leave this blank a title will be taken from the RSS feeds, which can be confusing if there are multiple feeds in one block.

;Display a link?
:Each article headline should link to the full article, but you can also display a link to the original site where available.

;Show channel image?
:Some feeds supply an image or logo from the original site which you can choose to display when available.

==Add/Manage all RSS feeds ==
All the Moodle site's RSS feeds can be managed on the ''Manage all my feeds'' tab in the RSS News Feed edit menu. The site administrator may give other roles permission to use this tab. This tab creates a list of RSS feeds that can be selected for display in every course on the Moodle site.

Copy and paste (or type) the URL address of the RSS feed in the space provided. This the generating site's actual RSS page address. For example here is a Moodle RSS feed address : http://moodle.org/rss/file.php/1/1/forum/1/rss.xml

Adding a custom title will take the place of the one supplied by the generating site.There is a validation tool included to confirm the feed URL is accurate.

When checked, the Shared Feed checkbox makes the feed available (although not necessarily visible) to all courses on the Moodle site. This would be useful, for example, when a college has an urgent announcements feed that would be of interest to all students, regardless of the Moodle course in which they are enrolled. Leave unchecked if the feed is of interest only to a single course.

Click the ''Add'' button to submit the feed.

==Site administration settings==

The RSS feeds block has some settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Blocks > RSS client''.

* ''block_rss_client_num_entries'' - The default number of entries to show per feed shown in the block. This can be overridden when you actually set up a block in a course.
* ''block_rss_timeout'' - The time in minutes between a reread of the feed by Moodle. Since some feeds on busy sites can take long to load, it can slow down the load of your course page. Therefore it is wise to set this time rather high, so only every now and then a visitor of your course is the victim of the slow remote server. Time is in minutes here.

==See also==

* [[RSS feeds]]
*[http://www.youtube.com/watch?v=wiwSZNgXuzo RSS feeds and how to add them to your course video]
*[http://tracker.moodle.org/browse/MDL-31599 RSS feeds on front page not working]

[[Category:RSS]]
[[Category:Site administration]]

[[de:RSS Feeds Block]]
[[eu:RSS_jarioak_blokea]]
[[fr:Bloc Fil RSS]]
[[es:Bloque de canales RSS remotos]]

Moodle app FAQ

2019-03-29T13:53:06Z

Ghillenb: /* Any further questions? */

{{Mobile}}
==Students==

===How can I get the Moodle app?===

The Moodle app is available for free from Google Play and the Apple Store. See [https://download.moodle.org/mobile/ Moodle app downloads] for links. You can also install the app directly from your mobile device by searching for 'Moodle app' with author/owner 'Moodle Pty Ltd'.

===I can't get the app to work. What do I do?===

The Moodle app will ONLY work with Moodle sites that have been set up to allow it. Please talk to your Moodle administrator if you have any problems connecting.

===What permissions does the app require?===

The app requires the following permissions:

* Record audio - for uploading to your Moodle site
* Read and modify the contents of your SD card - for content to be downloaded to your SD Card for offline access.
* Network access - to be able to connect with your Moodle site and check if you are connected, and if not to switch to offline mode.
* Run at startup - to receive local notifications even when the app is running in the background.
* Prevent phone from sleeping - to receive push notifications anytime.

===I can't see my course on the app. What do I do?===
Check with your course tutor that you are correctly enrolled.

=== Why can't I upload my assignment on the app?===
Check with your Moodle site administrator.

===Why can't I sometimes access the app or submit anything to it?===
This could be because of interruptions in your internet connection. Wait a while and try again. If you continue to have problems, contact your Moodle site administrator.

===Is there a space limit on my files?===
Assignments will have a size limit which you can see. For other space limit questions, check with your Moodle site administrator.

===Who should I contact for help with the app?===
Your Moodle site administrator can assist you in getting the app to work correctly.

===When are activities completed offline synchronized?===

See [[Moodle app synchronization]].

===Why the site is asking for my username and password when an activity is opened in the browser?===

Auto-login from the app is only supported in sites using Moodle 3.2 onwards. Also, for security reasons, between auto-logins you must wait 6 minutes (this should not be a problem because most of the browsers will keep your Moodle session open).

==Teachers==

===How can I enable videos in my course to be downloaded?===

See the section 'Media download for offline usage' in [[Creating Moodle-app-friendly courses]].

===Video subtitles are not working===

This may happen in old Android versions (Android < 4.4), in modern Android and iOS versions they should work fine.

===Which course format is it best to use?===

Topics or weekly course format is best suited to mobile devices.

===How do I make YouTube links open automatically in the app?===

Add YouTube links as a [[URL resource]].

===Why can't my students see their courses?===
If you or an administrator have correctly enrolled them in a course, they can see it in their mobile app. If they are correctly enrolled but can still not see their course, ask them to check with your Moodle site administrator.

=== I can't mark assignments in the app===
If you are experiencing problems when grading, please review that you are using the correct decimal separators (if the app interface is in English, you must use a period).

===What communications tools can I use in the app to engage with my learners?===
See [[Mobile app notifications]]. Chat, forums and messaging are all supported by the app.

===My protected Vimeo videos are not playing in the app===

Vimeo protected videos should work on Moodle 3.3.4 onwards, please note that you need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting).

You may also use Bootstrap responsive classes: https://getbootstrap.com/docs/4.0/utilities/embed/, for example, <div class="embed-responsive">

For older versions, see this forum discussion with a workaround: https://moodle.org/mod/forum/discuss.php?d=327342

===ReCaptcha doesn't work on my site===

You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting).

=== I use a Moodle plugin but the app says it is not supported ===
You should contact the plugin developer and point him to this documentation: https://docs.moodle.org/dev/Moodle_Mobile_Remote_addons where it is explained how to add support to plugins in the Mobile app.

There is a list of Moodle plugins supported by the app here: https://moodle.org/plugins/browse.php?list=award&id=6

=== I have problems playing SCORM packages ===
Please refer to [[Moodle app SCORM player]].

=== My quizzes or lessons are not working offline ===

You need to edit the quiz or lesson activity settings and enable the "Allow lesson/quiz to be attempted offline using the mobile app" configuration option.

=== Maths notation is not displaying correctly in the app ===

The app doesn't yet support MathJax (see MOBILE-1611). Instead, the [[TeX notation filter]] should be enabled.

=== How can I disable text selection / copy in the app? ===

You can create a remote theme and add some custom CSS rules to disable it, see https://docs.moodle.org/dev/Moodle_Mobile_Themes

==Administrators==

=== How can I debug errors in the app? ===

Go to the More tab and then to Settings > General. Enable "Display debug messages". This will show an explanatory message when an error occurs, alternatively, you can do a full debugging via: https://docs.moodle.org/dev/Moodle_Mobile_debugging_WS_requests

=== I can connect with my iPhone but not with my Android phone ===

This usually happens when the site is using https and the certificate is not correctly configured or it is using an old protocol, please use these pages to check this certificate: https://www.geocerts.com/ssl_checker and https://www.ssllabs.com/ssltest/analyze.html

===I can't get the app to work. What can I do?===

Assuming you have enabled mobile services on your site, please check:

# If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. Please use these tools or a similar one to check that your certificate is fine: [https://www.geocerts.com/ssl_checker SSL Checker] and [https://www.ssllabs.com/ssltest/analyze.html SSL Server Test]. All the checks must be ok, including the "Certificate Chain Complete". Otherwise the app might work on iOS but not on Android.
# [[Debugging]] is disabled (in ''Site administration > Development > Debugging'')
# The ADOdb debug option is disabled if you are using the external database auth or enrolment plugin (in ''Plugins > Authentication > External database'' and in ''Plugins > Enrolment > External database'').
# SHA-1 https certificates are not supported anymore in Chrome, this means that the Android version of the app won't work for your site. If your site doesn't work in desktop Chrome or Chromium it won't work in the Android app. See https://blog.chromium.org/2014/09/gradually-sunsetting-sha-1.html for more information
# If you are using IIS check that Anonymous access is not disabled for the /webservice directory.

If you still have a problem, please post in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum].

=== I cannot access with old users, but I can with recently created ones! ===

Please, do a "Purge all caches" via the Moodle administration settings, this will solve the problem.

===I can't view the courses tab as an administrator===

The Moodle app only displays courses you are enrolled in. If you want to view a course as an admin, you need to enrol in it.

===My Moodle site uses a SSO auth method (Shibboleth, CAS, Google OAuth, etc) and the app is not working===

See the section 'Mobile authentication' in the [[Moodle app guide for admins]] for details of how to configure it.

If configured the app is still not connecting: If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. Please use this tool or a similar one to check that your certificate is fine: [https://www.geocerts.com/ssl_checker SSL Checker]. All the checks must be OK, including the "Certificate Chain Complete".

If your SSO method is unable to authenticate when using an "embedded browser" (it gives an authentication error), please check if it works with a "browser window". If it does work with the browser window then it means your SSO is performing an HTTP redirect, and these kind of redirects aren't supported by the app (the request is redirected by the browser not passing the POST parameters). Unfortunately, this is something we cannot control in the Mobile app (it can't be handled via JavaScript). For further information, see http://stackoverflow.com/questions/228225/prevent-redirection-of-xmlhttprequest and http://stackoverflow.com/questions/4168784/ajax-redirection-handling

There are only 2 possible solutions: set the authentication via a "browser window" instead of an embedded one (please notice this won't work in the Linux desktop app), or remove the redirect from the SSO auth method.

===SSO is not working with my custom auth plugin===

SSO should work in any plugin if the plugin handles correctly the $SESSION->wantsurl, this is the way SSO works when it is launched via the app:

* It launchs this URL https://yourmoodle/local/mobile/launch.php?service=local_mobile&passport=abc in the device browser (Moodle 3.2 onwards the URL is /tool/mobile instead local/mobile)
* If the user is not logged in, the browser will redirect the user to the login page
* If the auth plugin used implements correctly the handling of the wantsurl session var, once the user has logged in, the browser should redirect back to the https://yourmoodle/local/mobile/launch.php?service=local_mobile&passport=abc URL that will launch the mobile app via the custom URL protocol

Custom auth plugins may be failing in the last step,not redirecting back to local/mobile, this will happen only if the plugin does not support correctly the $SESSION->wantsurl.

The SAML plugin works correctly but some modifications of that plugin may not work if important lines are changed.

===I am having problems requesting an airnotifier access key===

If you have registered your site but are still unable to request an access key, please fill in the [http://goo.gl/forms/WLwkbe8b7c Airnotifier access key manual request form]. (If your site is hosted so you can't obtain your siteidentifier, enter "cannot obtain" in the field.) Your site registration will be checked and you will be sent an access key in a few days if everything is correct.

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

===Error messages===

==== 'Can not find data record in database table external_functions' ====

This error usually happens due to a bad configuration or setting value in your Moodle site, please check:
# The user quota global setting should be an integer. For more details, see the discussion [https://moodle.org/mod/forum/discuss.php?d=320873 How to enable Moodle Mobile App for all accounts].
# The ''usermaxuploadfilesize'' should be an integer, please try to decrease the size. It can be configured in ''Site Administration > Security > Site Policies > Maximum uploaded file size''. The default value (Site upload limit) depends on the PHP configuration, you might have to change the value of ''upload_max_filesize'' and ''post_max_size'' in your ''php.ini'' file.
# The user "lang" field in the database is set to a correct value and existing language installed in the site. Some times the lang field is set via external systems to incorrect values or pointing to a language pack that was uninstalled. Please, note that to fix this you need direct access to the database and your 'user' and 'course' table.

===='Cannot connect: Verify that you have typed correctly the URL and that your site uses Moodle 2.4 or later'====

Please check:
# Mobile services are enabled for the site.
# The user is entering the correct URL for the site (see FAQ above)
# For https sites, the certificate is valid (see FAQ above)

===='We lost connection; you need to reconnect. Your token is now invalid.' on my custom version of the Moodle app ====

Please check:
# You have followed all the steps listed in [[:dev:Moodle Mobile Developing a plugin tutorial|Moodle Mobile Developing a plugin tutorial]]
# You have enabled the moodle/webservice:createtoken capability for the authenticated user

===='No permission to create web service token for the service local_mobile' when attempting to log in as an admin====

You need to create a token for the admin account (only) as follows:

# Go to ''Site administration > Plugins > Web services > Manage tokens''
# Click Add
# Enter the admin username and select 'Moodle app additional features service' (i.e. do NOT leave it as 'Moodle app web service')
# Click the 'Save changes' button.

===='Invalid response value detected' when accessing the site ====

The user quota global setting should be an integer. For more details, see the discussion [https://moodle.org/mod/forum/discuss.php?d=320873 How to enable Moodle Mobile App for all accounts].

==== ' Invalid response value detected: Invalid external api response: the value is "", the server was expecting "raw" type" ====

This usually happens when there is a field with value NULL in a table in the database that should not be there. This may happen if your Moodle has been upgraded over many years and the database schema is broken.

To fix it, you can do the following:
* Detect the field that is causing the problem (it should be indicated before the error message)
* Fix the field, for example, for the password field in the lesson table: UPDATE mdl_lesson SET password = '' WHERE password IS NULL (remember that your table prefix can be different than mdl_)

===='Invalid response value detected' when accessing My Courses or Course Overview ====

This usually happens when a course uses a language that isn't installed in the site. Please make sure that all courses use valid languages. This can be easily checked in the database, table "course", there is a column named "lang".

===='A required parameter (username) was missing'====

This may happen if your site implements HTTP redirects; the request is redirected by the browser not passing the POST parameters.

Unfortunately, this is something we cannot control in the Mobile app (it can't be handled via JavaScript). For further information, see http://stackoverflow.com/questions/228225/prevent-redirection-of-xmlhttprequest and http://stackoverflow.com/questions/4168784/ajax-redirection-handling

The solution is to change the HTTP redirect and use an HTML page with a meta tag or JavaScript redirect.

===='Invalid json in request: No error'====

There is a bug in Moodle 3.3 that can cause this error. Please update to Moodle 3.3.2.

===='Cannot get course contents'====

This usually happens when the course is using a course format plugin that was uninstalled from the server or that was not properly installed.

Please, reinstall again the course format plugin.

===='Access control exception' or 'Your authentication token is invalid or has expired'====

If this error appears as soon as you enter the username and password for a new site, then it probably means that the token expiration time is badly configured. This is how to fix it:

# Go to ''Site administration > Security > Site security settings''.
# Find the setting named ''User created token duration''.
# If the value is set to 0 or it's too low, please set it back to a valid value (the default value is 12 weeks).
# Click the 'Save changes' button.

===I think I found a bug with the app. Where can I report it?===

# Log in to the [https://tracker.moodle.org/browse/MOBILE Moodle Mobile tracker] (you'll need to [http://tracker.moodle.org/secure/Signup%21default.jspa create a tracker account] if you've not done so previously)
# Check whether the issue has already been reported by doing a [https://tracker.moodle.org/issues/?jql=project%20%3D%20MOBILE search]
# If not, report the bug by clicking the 'Create Issue' link at the top right of the page, selecting 'Moodle app' as the project
# Add a detailed description, then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (''Settings -> Development -> Device info'', you can send yourself this information by email using the email button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)

===How can I get the app in my language?===
[[File:setting the app lang.png|thumb|100px|Setting your language]]
The Moodle app automatically detects your mobile's language and displays in the same language (if the translation exists). Otherwise, you can set the app language in App settings > General.

If the Moodle app is not yet available in your language, please contribute a translation! See [[:dev:Translating Moodle Mobile|Translating Moodle Mobile]] for details of what to do.

==Any further questions?==

Please post in the [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum] on moodle.org.

[[Category:FAQ]]

[[de:Moodle Mobile - FAQ]]
[[ca:Moodle Mobile FAQ]]
[[es:Moodle Mobile FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app FAQ

2019-03-29T13:52:22Z

Ghillenb: /* Any further questions? */

{{Mobile}}
==Students==

===How can I get the Moodle app?===

The Moodle app is available for free from Google Play and the Apple Store. See [https://download.moodle.org/mobile/ Moodle app downloads] for links. You can also install the app directly from your mobile device by searching for 'Moodle app' with author/owner 'Moodle Pty Ltd'.

===I can't get the app to work. What do I do?===

The Moodle app will ONLY work with Moodle sites that have been set up to allow it. Please talk to your Moodle administrator if you have any problems connecting.

===What permissions does the app require?===

The app requires the following permissions:

* Record audio - for uploading to your Moodle site
* Read and modify the contents of your SD card - for content to be downloaded to your SD Card for offline access.
* Network access - to be able to connect with your Moodle site and check if you are connected, and if not to switch to offline mode.
* Run at startup - to receive local notifications even when the app is running in the background.
* Prevent phone from sleeping - to receive push notifications anytime.

===I can't see my course on the app. What do I do?===
Check with your course tutor that you are correctly enrolled.

=== Why can't I upload my assignment on the app?===
Check with your Moodle site administrator.

===Why can't I sometimes access the app or submit anything to it?===
This could be because of interruptions in your internet connection. Wait a while and try again. If you continue to have problems, contact your Moodle site administrator.

===Is there a space limit on my files?===
Assignments will have a size limit which you can see. For other space limit questions, check with your Moodle site administrator.

===Who should I contact for help with the app?===
Your Moodle site administrator can assist you in getting the app to work correctly.

===When are activities completed offline synchronized?===

See [[Moodle app synchronization]].

===Why the site is asking for my username and password when an activity is opened in the browser?===

Auto-login from the app is only supported in sites using Moodle 3.2 onwards. Also, for security reasons, between auto-logins you must wait 6 minutes (this should not be a problem because most of the browsers will keep your Moodle session open).

==Teachers==

===How can I enable videos in my course to be downloaded?===

See the section 'Media download for offline usage' in [[Creating Moodle-app-friendly courses]].

===Video subtitles are not working===

This may happen in old Android versions (Android < 4.4), in modern Android and iOS versions they should work fine.

===Which course format is it best to use?===

Topics or weekly course format is best suited to mobile devices.

===How do I make YouTube links open automatically in the app?===

Add YouTube links as a [[URL resource]].

===Why can't my students see their courses?===
If you or an administrator have correctly enrolled them in a course, they can see it in their mobile app. If they are correctly enrolled but can still not see their course, ask them to check with your Moodle site administrator.

=== I can't mark assignments in the app===
If you are experiencing problems when grading, please review that you are using the correct decimal separators (if the app interface is in English, you must use a period).

===What communications tools can I use in the app to engage with my learners?===
See [[Mobile app notifications]]. Chat, forums and messaging are all supported by the app.

===My protected Vimeo videos are not playing in the app===

Vimeo protected videos should work on Moodle 3.3.4 onwards, please note that you need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting).

You may also use Bootstrap responsive classes: https://getbootstrap.com/docs/4.0/utilities/embed/, for example, <div class="embed-responsive">

For older versions, see this forum discussion with a workaround: https://moodle.org/mod/forum/discuss.php?d=327342

===ReCaptcha doesn't work on my site===

You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting).

=== I use a Moodle plugin but the app says it is not supported ===
You should contact the plugin developer and point him to this documentation: https://docs.moodle.org/dev/Moodle_Mobile_Remote_addons where it is explained how to add support to plugins in the Mobile app.

There is a list of Moodle plugins supported by the app here: https://moodle.org/plugins/browse.php?list=award&id=6

=== I have problems playing SCORM packages ===
Please refer to [[Moodle app SCORM player]].

=== My quizzes or lessons are not working offline ===

You need to edit the quiz or lesson activity settings and enable the "Allow lesson/quiz to be attempted offline using the mobile app" configuration option.

=== Maths notation is not displaying correctly in the app ===

The app doesn't yet support MathJax (see MOBILE-1611). Instead, the [[TeX notation filter]] should be enabled.

=== How can I disable text selection / copy in the app? ===

You can create a remote theme and add some custom CSS rules to disable it, see https://docs.moodle.org/dev/Moodle_Mobile_Themes

==Administrators==

=== How can I debug errors in the app? ===

Go to the More tab and then to Settings > General. Enable "Display debug messages". This will show an explanatory message when an error occurs, alternatively, you can do a full debugging via: https://docs.moodle.org/dev/Moodle_Mobile_debugging_WS_requests

=== I can connect with my iPhone but not with my Android phone ===

This usually happens when the site is using https and the certificate is not correctly configured or it is using an old protocol, please use these pages to check this certificate: https://www.geocerts.com/ssl_checker and https://www.ssllabs.com/ssltest/analyze.html

===I can't get the app to work. What can I do?===

Assuming you have enabled mobile services on your site, please check:

# If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. Please use these tools or a similar one to check that your certificate is fine: [https://www.geocerts.com/ssl_checker SSL Checker] and [https://www.ssllabs.com/ssltest/analyze.html SSL Server Test]. All the checks must be ok, including the "Certificate Chain Complete". Otherwise the app might work on iOS but not on Android.
# [[Debugging]] is disabled (in ''Site administration > Development > Debugging'')
# The ADOdb debug option is disabled if you are using the external database auth or enrolment plugin (in ''Plugins > Authentication > External database'' and in ''Plugins > Enrolment > External database'').
# SHA-1 https certificates are not supported anymore in Chrome, this means that the Android version of the app won't work for your site. If your site doesn't work in desktop Chrome or Chromium it won't work in the Android app. See https://blog.chromium.org/2014/09/gradually-sunsetting-sha-1.html for more information
# If you are using IIS check that Anonymous access is not disabled for the /webservice directory.

If you still have a problem, please post in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum].

=== I cannot access with old users, but I can with recently created ones! ===

Please, do a "Purge all caches" via the Moodle administration settings, this will solve the problem.

===I can't view the courses tab as an administrator===

The Moodle app only displays courses you are enrolled in. If you want to view a course as an admin, you need to enrol in it.

===My Moodle site uses a SSO auth method (Shibboleth, CAS, Google OAuth, etc) and the app is not working===

See the section 'Mobile authentication' in the [[Moodle app guide for admins]] for details of how to configure it.

If configured the app is still not connecting: If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. Please use this tool or a similar one to check that your certificate is fine: [https://www.geocerts.com/ssl_checker SSL Checker]. All the checks must be OK, including the "Certificate Chain Complete".

If your SSO method is unable to authenticate when using an "embedded browser" (it gives an authentication error), please check if it works with a "browser window". If it does work with the browser window then it means your SSO is performing an HTTP redirect, and these kind of redirects aren't supported by the app (the request is redirected by the browser not passing the POST parameters). Unfortunately, this is something we cannot control in the Mobile app (it can't be handled via JavaScript). For further information, see http://stackoverflow.com/questions/228225/prevent-redirection-of-xmlhttprequest and http://stackoverflow.com/questions/4168784/ajax-redirection-handling

There are only 2 possible solutions: set the authentication via a "browser window" instead of an embedded one (please notice this won't work in the Linux desktop app), or remove the redirect from the SSO auth method.

===SSO is not working with my custom auth plugin===

SSO should work in any plugin if the plugin handles correctly the $SESSION->wantsurl, this is the way SSO works when it is launched via the app:

* It launchs this URL https://yourmoodle/local/mobile/launch.php?service=local_mobile&passport=abc in the device browser (Moodle 3.2 onwards the URL is /tool/mobile instead local/mobile)
* If the user is not logged in, the browser will redirect the user to the login page
* If the auth plugin used implements correctly the handling of the wantsurl session var, once the user has logged in, the browser should redirect back to the https://yourmoodle/local/mobile/launch.php?service=local_mobile&passport=abc URL that will launch the mobile app via the custom URL protocol

Custom auth plugins may be failing in the last step,not redirecting back to local/mobile, this will happen only if the plugin does not support correctly the $SESSION->wantsurl.

The SAML plugin works correctly but some modifications of that plugin may not work if important lines are changed.

===I am having problems requesting an airnotifier access key===

If you have registered your site but are still unable to request an access key, please fill in the [http://goo.gl/forms/WLwkbe8b7c Airnotifier access key manual request form]. (If your site is hosted so you can't obtain your siteidentifier, enter "cannot obtain" in the field.) Your site registration will be checked and you will be sent an access key in a few days if everything is correct.

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

===Error messages===

==== 'Can not find data record in database table external_functions' ====

This error usually happens due to a bad configuration or setting value in your Moodle site, please check:
# The user quota global setting should be an integer. For more details, see the discussion [https://moodle.org/mod/forum/discuss.php?d=320873 How to enable Moodle Mobile App for all accounts].
# The ''usermaxuploadfilesize'' should be an integer, please try to decrease the size. It can be configured in ''Site Administration > Security > Site Policies > Maximum uploaded file size''. The default value (Site upload limit) depends on the PHP configuration, you might have to change the value of ''upload_max_filesize'' and ''post_max_size'' in your ''php.ini'' file.
# The user "lang" field in the database is set to a correct value and existing language installed in the site. Some times the lang field is set via external systems to incorrect values or pointing to a language pack that was uninstalled. Please, note that to fix this you need direct access to the database and your 'user' and 'course' table.

===='Cannot connect: Verify that you have typed correctly the URL and that your site uses Moodle 2.4 or later'====

Please check:
# Mobile services are enabled for the site.
# The user is entering the correct URL for the site (see FAQ above)
# For https sites, the certificate is valid (see FAQ above)

===='We lost connection; you need to reconnect. Your token is now invalid.' on my custom version of the Moodle app ====

Please check:
# You have followed all the steps listed in [[:dev:Moodle Mobile Developing a plugin tutorial|Moodle Mobile Developing a plugin tutorial]]
# You have enabled the moodle/webservice:createtoken capability for the authenticated user

===='No permission to create web service token for the service local_mobile' when attempting to log in as an admin====

You need to create a token for the admin account (only) as follows:

# Go to ''Site administration > Plugins > Web services > Manage tokens''
# Click Add
# Enter the admin username and select 'Moodle app additional features service' (i.e. do NOT leave it as 'Moodle app web service')
# Click the 'Save changes' button.

===='Invalid response value detected' when accessing the site ====

The user quota global setting should be an integer. For more details, see the discussion [https://moodle.org/mod/forum/discuss.php?d=320873 How to enable Moodle Mobile App for all accounts].

==== ' Invalid response value detected: Invalid external api response: the value is "", the server was expecting "raw" type" ====

This usually happens when there is a field with value NULL in a table in the database that should not be there. This may happen if your Moodle has been upgraded over many years and the database schema is broken.

To fix it, you can do the following:
* Detect the field that is causing the problem (it should be indicated before the error message)
* Fix the field, for example, for the password field in the lesson table: UPDATE mdl_lesson SET password = '' WHERE password IS NULL (remember that your table prefix can be different than mdl_)

===='Invalid response value detected' when accessing My Courses or Course Overview ====

This usually happens when a course uses a language that isn't installed in the site. Please make sure that all courses use valid languages. This can be easily checked in the database, table "course", there is a column named "lang".

===='A required parameter (username) was missing'====

This may happen if your site implements HTTP redirects; the request is redirected by the browser not passing the POST parameters.

Unfortunately, this is something we cannot control in the Mobile app (it can't be handled via JavaScript). For further information, see http://stackoverflow.com/questions/228225/prevent-redirection-of-xmlhttprequest and http://stackoverflow.com/questions/4168784/ajax-redirection-handling

The solution is to change the HTTP redirect and use an HTML page with a meta tag or JavaScript redirect.

===='Invalid json in request: No error'====

There is a bug in Moodle 3.3 that can cause this error. Please update to Moodle 3.3.2.

===='Cannot get course contents'====

This usually happens when the course is using a course format plugin that was uninstalled from the server or that was not properly installed.

Please, reinstall again the course format plugin.

===='Access control exception' or 'Your authentication token is invalid or has expired'====

If this error appears as soon as you enter the username and password for a new site, then it probably means that the token expiration time is badly configured. This is how to fix it:

# Go to ''Site administration > Security > Site security settings''.
# Find the setting named ''User created token duration''.
# If the value is set to 0 or it's too low, please set it back to a valid value (the default value is 12 weeks).
# Click the 'Save changes' button.

===I think I found a bug with the app. Where can I report it?===

# Log in to the [https://tracker.moodle.org/browse/MOBILE Moodle Mobile tracker] (you'll need to [http://tracker.moodle.org/secure/Signup%21default.jspa create a tracker account] if you've not done so previously)
# Check whether the issue has already been reported by doing a [https://tracker.moodle.org/issues/?jql=project%20%3D%20MOBILE search]
# If not, report the bug by clicking the 'Create Issue' link at the top right of the page, selecting 'Moodle app' as the project
# Add a detailed description, then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (''Settings -> Development -> Device info'', you can send yourself this information by email using the email button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)

===How can I get the app in my language?===
[[File:setting the app lang.png|thumb|100px|Setting your language]]
The Moodle app automatically detects your mobile's language and displays in the same language (if the translation exists). Otherwise, you can set the app language in App settings > General.

If the Moodle app is not yet available in your language, please contribute a translation! See [[:dev:Translating Moodle Mobile|Translating Moodle Mobile]] for details of what to do.

==Any further questions?==

Please post in the [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum] on moodle.org.

[[Category:FAQ]]

[[de:Moodle App - FAQ]]
[[ca:Moodle Mobile FAQ]]
[[es:Moodle Mobile FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app FAQ

2019-03-29T13:52:04Z

Ghillenb: /* Any further questions? */

{{Mobile}}
==Students==

===How can I get the Moodle app?===

The Moodle app is available for free from Google Play and the Apple Store. See [https://download.moodle.org/mobile/ Moodle app downloads] for links. You can also install the app directly from your mobile device by searching for 'Moodle app' with author/owner 'Moodle Pty Ltd'.

===I can't get the app to work. What do I do?===

The Moodle app will ONLY work with Moodle sites that have been set up to allow it. Please talk to your Moodle administrator if you have any problems connecting.

===What permissions does the app require?===

The app requires the following permissions:

* Record audio - for uploading to your Moodle site
* Read and modify the contents of your SD card - for content to be downloaded to your SD Card for offline access.
* Network access - to be able to connect with your Moodle site and check if you are connected, and if not to switch to offline mode.
* Run at startup - to receive local notifications even when the app is running in the background.
* Prevent phone from sleeping - to receive push notifications anytime.

===I can't see my course on the app. What do I do?===
Check with your course tutor that you are correctly enrolled.

=== Why can't I upload my assignment on the app?===
Check with your Moodle site administrator.

===Why can't I sometimes access the app or submit anything to it?===
This could be because of interruptions in your internet connection. Wait a while and try again. If you continue to have problems, contact your Moodle site administrator.

===Is there a space limit on my files?===
Assignments will have a size limit which you can see. For other space limit questions, check with your Moodle site administrator.

===Who should I contact for help with the app?===
Your Moodle site administrator can assist you in getting the app to work correctly.

===When are activities completed offline synchronized?===

See [[Moodle app synchronization]].

===Why the site is asking for my username and password when an activity is opened in the browser?===

Auto-login from the app is only supported in sites using Moodle 3.2 onwards. Also, for security reasons, between auto-logins you must wait 6 minutes (this should not be a problem because most of the browsers will keep your Moodle session open).

==Teachers==

===How can I enable videos in my course to be downloaded?===

See the section 'Media download for offline usage' in [[Creating Moodle-app-friendly courses]].

===Video subtitles are not working===

This may happen in old Android versions (Android < 4.4), in modern Android and iOS versions they should work fine.

===Which course format is it best to use?===

Topics or weekly course format is best suited to mobile devices.

===How do I make YouTube links open automatically in the app?===

Add YouTube links as a [[URL resource]].

===Why can't my students see their courses?===
If you or an administrator have correctly enrolled them in a course, they can see it in their mobile app. If they are correctly enrolled but can still not see their course, ask them to check with your Moodle site administrator.

=== I can't mark assignments in the app===
If you are experiencing problems when grading, please review that you are using the correct decimal separators (if the app interface is in English, you must use a period).

===What communications tools can I use in the app to engage with my learners?===
See [[Mobile app notifications]]. Chat, forums and messaging are all supported by the app.

===My protected Vimeo videos are not playing in the app===

Vimeo protected videos should work on Moodle 3.3.4 onwards, please note that you need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting).

You may also use Bootstrap responsive classes: https://getbootstrap.com/docs/4.0/utilities/embed/, for example, <div class="embed-responsive">

For older versions, see this forum discussion with a workaround: https://moodle.org/mod/forum/discuss.php?d=327342

===ReCaptcha doesn't work on my site===

You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting).

=== I use a Moodle plugin but the app says it is not supported ===
You should contact the plugin developer and point him to this documentation: https://docs.moodle.org/dev/Moodle_Mobile_Remote_addons where it is explained how to add support to plugins in the Mobile app.

There is a list of Moodle plugins supported by the app here: https://moodle.org/plugins/browse.php?list=award&id=6

=== I have problems playing SCORM packages ===
Please refer to [[Moodle app SCORM player]].

=== My quizzes or lessons are not working offline ===

You need to edit the quiz or lesson activity settings and enable the "Allow lesson/quiz to be attempted offline using the mobile app" configuration option.

=== Maths notation is not displaying correctly in the app ===

The app doesn't yet support MathJax (see MOBILE-1611). Instead, the [[TeX notation filter]] should be enabled.

=== How can I disable text selection / copy in the app? ===

You can create a remote theme and add some custom CSS rules to disable it, see https://docs.moodle.org/dev/Moodle_Mobile_Themes

==Administrators==

=== How can I debug errors in the app? ===

Go to the More tab and then to Settings > General. Enable "Display debug messages". This will show an explanatory message when an error occurs, alternatively, you can do a full debugging via: https://docs.moodle.org/dev/Moodle_Mobile_debugging_WS_requests

=== I can connect with my iPhone but not with my Android phone ===

This usually happens when the site is using https and the certificate is not correctly configured or it is using an old protocol, please use these pages to check this certificate: https://www.geocerts.com/ssl_checker and https://www.ssllabs.com/ssltest/analyze.html

===I can't get the app to work. What can I do?===

Assuming you have enabled mobile services on your site, please check:

# If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. Please use these tools or a similar one to check that your certificate is fine: [https://www.geocerts.com/ssl_checker SSL Checker] and [https://www.ssllabs.com/ssltest/analyze.html SSL Server Test]. All the checks must be ok, including the "Certificate Chain Complete". Otherwise the app might work on iOS but not on Android.
# [[Debugging]] is disabled (in ''Site administration > Development > Debugging'')
# The ADOdb debug option is disabled if you are using the external database auth or enrolment plugin (in ''Plugins > Authentication > External database'' and in ''Plugins > Enrolment > External database'').
# SHA-1 https certificates are not supported anymore in Chrome, this means that the Android version of the app won't work for your site. If your site doesn't work in desktop Chrome or Chromium it won't work in the Android app. See https://blog.chromium.org/2014/09/gradually-sunsetting-sha-1.html for more information
# If you are using IIS check that Anonymous access is not disabled for the /webservice directory.

If you still have a problem, please post in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum].

=== I cannot access with old users, but I can with recently created ones! ===

Please, do a "Purge all caches" via the Moodle administration settings, this will solve the problem.

===I can't view the courses tab as an administrator===

The Moodle app only displays courses you are enrolled in. If you want to view a course as an admin, you need to enrol in it.

===My Moodle site uses a SSO auth method (Shibboleth, CAS, Google OAuth, etc) and the app is not working===

See the section 'Mobile authentication' in the [[Moodle app guide for admins]] for details of how to configure it.

If configured the app is still not connecting: If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. Please use this tool or a similar one to check that your certificate is fine: [https://www.geocerts.com/ssl_checker SSL Checker]. All the checks must be OK, including the "Certificate Chain Complete".

If your SSO method is unable to authenticate when using an "embedded browser" (it gives an authentication error), please check if it works with a "browser window". If it does work with the browser window then it means your SSO is performing an HTTP redirect, and these kind of redirects aren't supported by the app (the request is redirected by the browser not passing the POST parameters). Unfortunately, this is something we cannot control in the Mobile app (it can't be handled via JavaScript). For further information, see http://stackoverflow.com/questions/228225/prevent-redirection-of-xmlhttprequest and http://stackoverflow.com/questions/4168784/ajax-redirection-handling

There are only 2 possible solutions: set the authentication via a "browser window" instead of an embedded one (please notice this won't work in the Linux desktop app), or remove the redirect from the SSO auth method.

===SSO is not working with my custom auth plugin===

SSO should work in any plugin if the plugin handles correctly the $SESSION->wantsurl, this is the way SSO works when it is launched via the app:

* It launchs this URL https://yourmoodle/local/mobile/launch.php?service=local_mobile&passport=abc in the device browser (Moodle 3.2 onwards the URL is /tool/mobile instead local/mobile)
* If the user is not logged in, the browser will redirect the user to the login page
* If the auth plugin used implements correctly the handling of the wantsurl session var, once the user has logged in, the browser should redirect back to the https://yourmoodle/local/mobile/launch.php?service=local_mobile&passport=abc URL that will launch the mobile app via the custom URL protocol

Custom auth plugins may be failing in the last step,not redirecting back to local/mobile, this will happen only if the plugin does not support correctly the $SESSION->wantsurl.

The SAML plugin works correctly but some modifications of that plugin may not work if important lines are changed.

===I am having problems requesting an airnotifier access key===

If you have registered your site but are still unable to request an access key, please fill in the [http://goo.gl/forms/WLwkbe8b7c Airnotifier access key manual request form]. (If your site is hosted so you can't obtain your siteidentifier, enter "cannot obtain" in the field.) Your site registration will be checked and you will be sent an access key in a few days if everything is correct.

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

===Error messages===

==== 'Can not find data record in database table external_functions' ====

This error usually happens due to a bad configuration or setting value in your Moodle site, please check:
# The user quota global setting should be an integer. For more details, see the discussion [https://moodle.org/mod/forum/discuss.php?d=320873 How to enable Moodle Mobile App for all accounts].
# The ''usermaxuploadfilesize'' should be an integer, please try to decrease the size. It can be configured in ''Site Administration > Security > Site Policies > Maximum uploaded file size''. The default value (Site upload limit) depends on the PHP configuration, you might have to change the value of ''upload_max_filesize'' and ''post_max_size'' in your ''php.ini'' file.
# The user "lang" field in the database is set to a correct value and existing language installed in the site. Some times the lang field is set via external systems to incorrect values or pointing to a language pack that was uninstalled. Please, note that to fix this you need direct access to the database and your 'user' and 'course' table.

===='Cannot connect: Verify that you have typed correctly the URL and that your site uses Moodle 2.4 or later'====

Please check:
# Mobile services are enabled for the site.
# The user is entering the correct URL for the site (see FAQ above)
# For https sites, the certificate is valid (see FAQ above)

===='We lost connection; you need to reconnect. Your token is now invalid.' on my custom version of the Moodle app ====

Please check:
# You have followed all the steps listed in [[:dev:Moodle Mobile Developing a plugin tutorial|Moodle Mobile Developing a plugin tutorial]]
# You have enabled the moodle/webservice:createtoken capability for the authenticated user

===='No permission to create web service token for the service local_mobile' when attempting to log in as an admin====

You need to create a token for the admin account (only) as follows:

# Go to ''Site administration > Plugins > Web services > Manage tokens''
# Click Add
# Enter the admin username and select 'Moodle app additional features service' (i.e. do NOT leave it as 'Moodle app web service')
# Click the 'Save changes' button.

===='Invalid response value detected' when accessing the site ====

The user quota global setting should be an integer. For more details, see the discussion [https://moodle.org/mod/forum/discuss.php?d=320873 How to enable Moodle Mobile App for all accounts].

==== ' Invalid response value detected: Invalid external api response: the value is "", the server was expecting "raw" type" ====

This usually happens when there is a field with value NULL in a table in the database that should not be there. This may happen if your Moodle has been upgraded over many years and the database schema is broken.

To fix it, you can do the following:
* Detect the field that is causing the problem (it should be indicated before the error message)
* Fix the field, for example, for the password field in the lesson table: UPDATE mdl_lesson SET password = '' WHERE password IS NULL (remember that your table prefix can be different than mdl_)

===='Invalid response value detected' when accessing My Courses or Course Overview ====

This usually happens when a course uses a language that isn't installed in the site. Please make sure that all courses use valid languages. This can be easily checked in the database, table "course", there is a column named "lang".

===='A required parameter (username) was missing'====

This may happen if your site implements HTTP redirects; the request is redirected by the browser not passing the POST parameters.

Unfortunately, this is something we cannot control in the Mobile app (it can't be handled via JavaScript). For further information, see http://stackoverflow.com/questions/228225/prevent-redirection-of-xmlhttprequest and http://stackoverflow.com/questions/4168784/ajax-redirection-handling

The solution is to change the HTTP redirect and use an HTML page with a meta tag or JavaScript redirect.

===='Invalid json in request: No error'====

There is a bug in Moodle 3.3 that can cause this error. Please update to Moodle 3.3.2.

===='Cannot get course contents'====

This usually happens when the course is using a course format plugin that was uninstalled from the server or that was not properly installed.

Please, reinstall again the course format plugin.

===='Access control exception' or 'Your authentication token is invalid or has expired'====

If this error appears as soon as you enter the username and password for a new site, then it probably means that the token expiration time is badly configured. This is how to fix it:

# Go to ''Site administration > Security > Site security settings''.
# Find the setting named ''User created token duration''.
# If the value is set to 0 or it's too low, please set it back to a valid value (the default value is 12 weeks).
# Click the 'Save changes' button.

===I think I found a bug with the app. Where can I report it?===

# Log in to the [https://tracker.moodle.org/browse/MOBILE Moodle Mobile tracker] (you'll need to [http://tracker.moodle.org/secure/Signup%21default.jspa create a tracker account] if you've not done so previously)
# Check whether the issue has already been reported by doing a [https://tracker.moodle.org/issues/?jql=project%20%3D%20MOBILE search]
# If not, report the bug by clicking the 'Create Issue' link at the top right of the page, selecting 'Moodle app' as the project
# Add a detailed description, then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (''Settings -> Development -> Device info'', you can send yourself this information by email using the email button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)

===How can I get the app in my language?===
[[File:setting the app lang.png|thumb|100px|Setting your language]]
The Moodle app automatically detects your mobile's language and displays in the same language (if the translation exists). Otherwise, you can set the app language in App settings > General.

If the Moodle app is not yet available in your language, please contribute a translation! See [[:dev:Translating Moodle Mobile|Translating Moodle Mobile]] for details of what to do.

==Any further questions?==

Please post in the [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum] on moodle.org.

[[Category:FAQ]]

[[de:Moodle App FAQ]]
[[ca:Moodle Mobile FAQ]]
[[es:Moodle Mobile FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle Desktop

2019-03-29T13:46:51Z

Ghillenb:

{{Mobile}}
==What is Moodle Desktop?==
[[File:desktop course overview.png|thumb|Course overview in Moodle Desktop]]
Moodle Desktop is our solution to accessing your Moodle courses on desktop and/or Surface tablets.

With Moodle Desktop you can experience all these popular (and more) functionalities that are found in Moodle Mobile, on your desktop or surface tablets:
* View course activities and download materials offline
* Quickly find and contact other people in your courses or organisation
* Attempt quizzes, post in forums, play SCORM packages, edit wiki pages and more - on and offline
* Upload images, audio, videos and other files from your desktop or tablet
* View deadlines filtered by dates or course subjects
* Receive instant notifications for messages, forum posts, calendar events and deadlines
* Track your learning progress or grades
[[File:desktop assignment grading.png|thumb|Assignment grading in Moodle Desktop]]

==How do I get Moodle desktop?==

Go to [https://download.moodle.org/desktop/ Moodle downloads: Moodle Desktop].

==Using Moodle Desktop==

As for the Moodle Mobile app, Moodle Desktop will ONLY work with Moodle sites that have been set up to allow it. Site admins, please see the [[Moodle Mobile guide for admins]].

Teachers, for info on improving your courses for access via Moodle Desktop, please see [[Creating Moodle Mobile friendly courses]].

==How will Moodle Desktop get updated to the latest release?==

As with Moodle Mobile, the desktop version will be updated by Moodle HQ every two months.

==Why has Moodle released Moodle Desktop?==

Moodle Desktop is another step that Moodle is taking to make online learning more accessible - for students, educators and other users - who are utilising various operating systems and devices.

Feedback has shown that Moodle users in the K-12, higher education and workplace sectors would like the option of accessing their courses through desktops, laptops or tablets, which are the devices often provided by their institutions or organisations.”

Making Moodle Desktop available in Windows operating system is also important, as many of our users are also studying and learning in this environment.

==Where can I get support for Moodle Desktop?==

If you have any questions or feedback about Moodle Desktop, please join the discussions in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum].

== See also ==

* [https://docs.moodle.org/dev/Moodle_Desktop_release_notes Moodle Desktop release notes]

[[es:Escritorio Moodle]]
[[de:Moodle Desktop]]

Template:Backup

2019-03-27T09:08:40Z

Ghillenb:

<div class="navtrail">[[Main page]] ► [[Managing a Moodle site]] ► [[Backup]] ► [[{{PAGENAME}}]]</div>
<div class="sideblock right" style="width: 12em;">
<div class="header">[[Backup]]</div>
<div class="content">
*[[Site backup]]
*[[Course backup]]
*[[Course restore]]
*[[Automated course backup]]
*[[Year-end procedures]]
*[[Context freezing]] (new in 3.6)
*[[IMS Common Cartridge import and export|IMS CC import and export]]
*[[Backup and restore FAQ|Backup FAQ]]
</div>
</div>

<includeonly>[[Category:Backup]]</includeonly>
<noinclude>This template will categorize articles that include it into [[:Category:Backup]].</noinclude>

Managing badges

2019-03-22T14:34:28Z

Ghillenb: /* Backpack settings */

{{Badges}}

Badges may be managed at the course or site level. (Note that teachers in a course cannot by default access site badges unless they have been given a system role with badge managing capabilities) For information on adding course or site badges, see [[Using badges]]. Individual users can manage their badges from their profile.

== Managing course badges==

*If course badges have been enabled by the administrator then a teacher will see a Badges section from the More link when clicking the cog icon (Boost theme) or from Badges in the course administration block (non-Boost themes).
*New badges may be added by clicking the 'Add a new badge' button, while clicking the name of an existing badge allows you to view its details and make changes ''if it is not enabled''.

[[File:BadgesManagementScreen.png|thumb|600px|center| The Managing badges screen]]

When the initial details have been added and the badge uploaded, clicking to continue leads to the screen where the criteria must be set along with extra information.

The badge must only be enabled once all necessary settings have been added.

[[File:36badgecriteria.png|thumb|center|600px|Badge information]]

{{New features}}

Support for Open Badges 2.0 means badges may now include language and version, image author details (in the initial set up) and Endorsements, Related badges and Competencies.

{{MediaPlayer | url = https://youtu.be/2HMprIQSSw0 }}

==Useful information==
*Fields which are not completed (such as Endorsements. Related badges etc) will not be shown on the badge page.
*Versions of badges make it easy to keep track of badges over a period of time or badges at different levels or languages.
*Endorsements are third party accreditations (official or unofficial) such as from an external body or the management of an institution, adding value to a badge by giving it their approval.
*Related badges are badges which are linked in some way to the badge being awarded, for example on a similar topic or one of several levels (beginner, intermediate, advanced). They are shown as text only, not hyperlinks.
*'''Competencies do not refer to Moodle comptencies or competency frameworks''' but instead refer to external competencies and competency frameworks.

==Managing site badges==

Badges should be enabled by default in ''Administration>Site administration>Advanced features'' and can be managed from ''Administration>Site administration>Badges>Manage badges.'' (For information on adding site badges see [[Using badges]]
Criteria for awarding site badges are as follows:

[[File:SiteBadgeCriteria.png|thumb|400px|center]]

*Badges may be awarded for uploading a profile picture, as part of the profile completion criteria
*Badges may be given to denote cohort membership
*Badges may be awarded dependent on previously awarded badges. (This applies to course and site badges.)

All existing badges are displayed in a table showing current badge image, name, status, criteria, how many users have already earned this badge and a set of available actions.

Other settings are the same as for course badges.Badges which have manual award among their criteria can be issued by one user to another. Users who issue a badge must have "moodle/badges:awardbadge" capability. Site administrators can choose their role when issuing a badge.

==Deleting badges==

[[File:badgedelete.png]]

Once a badge has been awarded, there are two options for deleting it, available by clicking the X icon for the badge in question from the Manage badges screen for site or course badges.
#Delete, but keep existing issued badges -if this option is chosen, then the badge will no longer be available but students who have earned the badge will still have it displayed on their profiles.
#Delete and remove all existing issued badges - if this option is chosen, then the badge will no longer be available and students who earned the badge will no longer have it displayed on their profiles.

[[File:deletingbadges.png]]

''Note: Even though the badge is deleted from Moodle, if a student has added it to an external backpack, it will still be visible online, although the award criteria will no longer be available.
''

==Individual user badge management==
*Users may manage their site and external badges by clicking on the user menu top right > ''Preferences >Badges > Manage badges''. From here, they can view, search for and download badges.
{|
|[[File:BadgesDisplay.png|thumb|Example of a badges screen]]
|}
*This then displays "badges" in the profile.
===Preferences===
Here users can decide whether to automatically display all badges earned. (Badges can be individually displayed or hidden from ''Preferences > Badges > Manage badges''.)

===Backpack settings===

In ''Preferences > Badges > Backpack settings'', a connection can be set up with an external backpack provider such as the [https://backpack.openbadges.org Open Badges backpack]. Connecting to a backpack lets you display external badges on your site and push badges earned on your site to your backpack.

You need to sign up for a backpack service '''before''' trying to set up a backpack connection.

When you enter your email address in the Backpack Settings page in Moodle, a verification email will be sent to you. You must click on the verification link in the email to activate your Backpack connection. After the backpack connection is successfully established, badges from your backpack can be displayed on your badges page and your profile page. You can select collections of badges from your backpack that you would like to display in your profile.

Note that connecting to external backpacks will not work on a Moodle hosted locally/offline.

A site admin may wish to disable the connection to external backbacks (badges_allowexternalbackpack) in 'Badges settings' in the Site administration. Existing users will then no longer see external badges from their backpack nor will they have the option to connect to an external account or push badges earned within Moodle to their backpack.

[[de:Badges verwalten]]
[[ja:バッジを管理する]]
[[es:Gestionando insignias]]

Using slash arguments

2019-03-07T15:04:28Z

Ghillenb:

{{Environment}}
==About slash arguments==

'Slash arguments' (using PATH_INFO) is required for SCORM packages and multiple-file resources to display correctly. If your web server doesn't support 'slash arguments' and you are unable to configure it, the setting can be disabled, though it will result in things not working.

==Enabling slash arguments==

Slash arguments must be enabled on your web server, as described in:
* [[Internet Information Services#Slasharguments|IIS slasharguments]]
* [[Apache#Slasharguments|Apache slasharguments]]
* [[Nginx#Slasharguments|Nginx slasharguments]]

==Error when uploading a file==
If you obtain a 'File not found' error when uploading a file, it indicates that slash arguments are not enabled on your web server. Please try enabling it.

If your web server doesn't support slash arguments, its use in Moodle can be disabled by un-ticking the checkbox 'Use slash arguments' in ''Administration > Site administration > Server > HTTP''.

Warning: Disabling the use of slash arguments will result in SCORM packages not working and slash arguments warnings being displayed!

==Slash arguments environment check==

Note: '''The use of slash arguments will be required in future versions of Moodle.'''

If your web server doesn't support slash arguments, you will in future need to change to a web server which does. (It will no longer be possible to disable the use of slash arguments.)

In the meantime, ''Administration > Site administration > Server > Environment'' reports if the slash argument setting needs to be checked i.e. if it is detected that 'Use slash arguments' is disabled in ''Administration > Site administration > Server > HTTP''. Thus, the check is a warning of the future requirement.

==See also==

* [https://moodle.org/mod/forum/discuss.php?d=278916 Requiring slasharguments in Moodle 2.9 - will anybody be seriously affected?] forum discussion
* [https://tracker.moodle.org/browse/MDL-50416 <nowiki>[MDL-50416]</nowiki> slasharguments check gives a warning on install], for versions 2.9 and 2.9.1
* [https://tracker.moodle.org/browse/MDL-51554 <nowiki>[MDL-51554]</nowiki> Broken file serving under Apache and PHP-FPM via mod_proxy_fcgi, when the filename is not only plain ASCII or w/ blank spaces], for versions below 2.8.9 and 2.9.3

[[es:Usando slash arguments]]
[[de:Verwendung von slash arguments]]

Course sharing

2019-03-01T12:58:14Z

Ghillenb:

<div class="navtrail">[[Main page]] ► [[Managing a Moodle site]] ► [[Moodle.net]] ► [[{{PAGENAME}}]]</div>

==Ways of sharing a course==
When you share a course, you can choose whether to make it available
* for download (as a course backup file) OR
* to enrol in on your site

==Connecting to Moodle.net==

An administrator first needs to check in 'Site Administration > Registration'' that your Moodle site is [[Site_registration|registered]].

==Sharing a course for download==
[[Image:Backup_publication.png|thumb|First page of the backup process]]

# Go to ''Course administration > Share'' (only available to users with the capability [[Capabilities/moodle/course:publish|moodle/course:publish]])
# Click the button 'Share this course for people to download'
# Enter information about the course
# Click the 'Upload this course' button
# Select the data to be included in the backup
# Create the course backup

The course will then need to be approved by the Moodle.net administrator before it appears in the course listing.

===Updating a course backup===

If you improve the course and wish to update the course backup, firstly remove it from the hub, then re-share it. You may also share different versions of the same course.

==Sharing a course for people to enrol in==

You can display a link to your course on Moodle.net.

# Go to ''Course administration > Share'' (only available to users with the capability [[Capabilities/moodle/course:publish|moodle/course:publish]])
# Click the button 'Share this course for people to join'
# Enter information about the course
# Click the 'Share this course' button

The course will then need to be approved by the Moodle.net administrator before it appears in the course listing.

You can change the information about the course by clicking the 'Update' button in the actions column.

''Note: You also need to make sure that users can actually enrol in the course you have just published.'' This normally means having [[Email-based self-registration|email-based self-registration]] enabled for the site and enabling [[Self enrolment|self-enrolment]] for the course.

== Moodle.net listing ==

You can check whether your course has been approved and is listed on Moodle.net as follows:

# Go to ''Course administration > Share''
# Click the 'Check it now' link in the listing column

Your Moodle site will contact Moodle.net and will then update the status of your course.

[[File:published on list.png]]

==Removing a course from Moodle.net==

If you wish, you can remove your course from Moodle.net at any time.

# Go to ''Course administration > Share''
# Click the 'Remove from Moodle.net' button in the actions column

==Capabilities==

Only users with the capability [[Capabilities/moodle/course:publish|moodle/course:publish]] (by default only users with the role of manager) can share courses on Moodle.net. The capability [[Capabilities/moodle/backup:backuptargethub|moodle/backup:backuptargethub]] is also required for sharing courses for download.

==Enabling teachers to share their courses==

An administrator can enable teachers to share their courses on a hub by allowing the capability ''moodle/course:publish'' for the teacher role.

# Go to ''Site administration > Users > Permissions > Define roles''
# Click the edit icon opposite the teacher role
# On the editing role page, paste ''moodle/course:publish'' into the filter box
# Tick the checkbox opposite ''moodle/course:publish'' to allow the capability
# Click the 'Save changes' button

==See also==

* [[Moodle.net]]

[[Category:Moodle.net]]

[[es:Compartiendo cursos]]
[[fr:Publier un cours]]
[[ja:コースを公開する]]
[[de:Kurse teilen]]

Moodle.net

2019-03-01T12:36:29Z

Ghillenb:

{{Managing a Moodle site}}
==What is Moodle.net?==
[[File:moodle.net search.png|thumb|Moodle.net search for courses]]
[http://moodle.net Moodle.net] is the Moodle.org Open Community Hub - a directory of courses for download or to enrol in.

==How do we get onto Moodle.net?==

* EITHER go to [http://moodle.net moodle.net]
* OR ensure your Moodle site is registered (via Registration in the Site administration) then add the [[Community finder block]] to courses on your site

==How can I share courses to Moodle.net?==

Managers (and any other users with the capability [[Capabilities/moodle/course:publish| moodle/course:publish]]) can share courses to Moodle.net as follows:

# Click 'Share' via the gear menu or the Administration block (depending upon your theme).
#Then choose whether you wish to your course to be available for people to enrol in or to download

See [[Course sharing]] for more details.

==How can a teacher share courses to Moodle.net?==

To enable teachers to share courses to Moodle.net, an administrator needs to allow the capability moodle/course:publish for the teacher role. See [[Course sharing]] for details.

==Are there any criteria which courses must satisfy in order to be listed on Moodle.net?==

Yes, just a few! See the [http://moodle.net/mod/page/view.php?id=2 Moodle.net Course approval criteria].

==How long does it take for a course to be approved and visible on Moodle.net?==

We aim to check and approve courses within 48 hours, though it can sometimes take a little longer, so please be patient. If you require your course to be approved urgently, please [http://moodle.net/mod/page/view.php?id=15 contact us].

== Can I sell courses on Moodle.net? ==
No yet but it is planned. See MDL-25496 for details.

[[Category:Moodle.net]]
[[it:Moodle.net]]
[[de:Moodle.net]]

Pattern-match with JME question type

2019-02-21T13:14:01Z

Ghillenb: /* See also */

{{Infobox plugin
|type = question type
|entry = https://moodle.org/plugins/qtype_pmatchjme
|tracker = https://github.com/moodleou/moodle-qtype_pmatchjme/issues
|discussion = https://moodle.org/mod/forum/view.php?id=737
|maintainer = [[user:Tim Hunt|Tim Hunt]]
|float = right
}}{{Questions}}
The Pattern-match with JME question type where the user enters their response using the Java Molecular Editor, and the response is then graded using the OU's pattern-match algorithm.

==Download==
* [https://moodle.org/plugins/view.php?plugin=qtype_pmatchjme from the Moodle Plugins database]

==See also==
* More [http://www.open.edu/openlearnworks/course/view.php?id=1581 documentation is available] in the [http://www.open.edu/openlearnworks/mod/oucontent/view.php?id=52747 Open University's reference manual].
* [https://github.com/moodleou/moodle-qtype_pmatchjme Source controlURL]

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

[[es:Tipo de pregunta coincidencia de patrón con JME]]
[[de:Fragetyp_Musterabgleich_mit_Java_Molecular_Editor]]

Pattern-match question type

2019-02-21T10:01:03Z

Ghillenb:

{{Infobox plugin
|type = question type
|entry = https://moodle.org/plugins/qtype_pmatch
|tracker = https://github.com/moodleou/moodle-qtype_pmatch
|discussion = https://moodle.org/mod/forum/view.php?id=737
|maintainer = [[user:Tim Hunt|Tim Hunt]]
|float = right
}}{{Questions}}
Pattern-match questions allow the student to give an answer of up to about 20 words, which can then be automatically graded by matching the students response against a number of different patterns expressed in the PMatch syntax. The first matching pattern determines the score and the feedback.

[[File:pmatch.png]]

This is a question type created and maintained by the Open University.
{{Note|This question type assumes that the [https://docs.moodle.org/dev/Decimal_separator#Pmatch_and_other_Open_University_question_types_problems.3D decimal separator] is a full stop. It will not work if you try to use a a decimal comma.}}

== More documentation ==
* See [[Pattern-match question type detailed documentation]].

More [http://www.open.edu/openlearnworks/course/view.php?id=1581 documentation is available] in the [http://www.open.edu/openlearnworks/mod/oucontent/view.php?id=52747 Open University's reference manual]. That includes a description of the pmatch syntax. There is another page that explains [[:dev:The_OU_PMatch_algorithm|The OU PMatch algorithm]], but that was written before development started, and may not be a 100% accurate description of what was finally implemented.

== 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]

* [[Preg question type]] additional plugin
* [[Regular Expression Short-Answer question type]] additional plugin
* [[Essay (auto-grade) question type]] additional plugin

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

[[es:Tipo de pregunta coincidencia de patrón]]
[[de:Fragetyp Musterabgleich]]

Site security settings

2019-02-12T11:15:14Z

Ghillenb: /* See also */

.
{{Security}}
===Protect usernames===

If enabled, when a user attempts to reset their password and enters a username or email address, the following message is displayed: "If you supplied a correct username or email address then an email should have been sent to you." This is to prevent a malicious party from using the interface to determine which usernames and email addresses are in use in valid accounts.

If the protect usernames setting is disabled, when a user attempts to reset their password they are provided with feedback regarding whether an account exists with the username or email address supplied. For example, the message "The email address was not found in the database" may be displayed.

===Force users to login===

If you turn this setting on, all users must login before they even see the [[Front Page]] of the site. Note however that this does not prevent guest access to courses, if you have autologin guests enabled in [[User policies]].

===Force users to login for profiles===

Leave this set to Yes to keep anonymous visitors away from user profiles.

===Force users to login to view user pictures===

If enabled, users must login in order to view user profile pictures and the default user picture will be used in all notification emails.

===Open to Google===

Enabling this setting allows Google's search spiders guest access to your site. Any part of the site that allows guest access will then be searchable on Google. In addition, people coming in to your site via a Google search will automatically be logged in as a guest.

==Allow indexing by search engines==
This determines whether to allow search engines to index your site. The default is Everywhere except login and signup pages.

===Profile visible roles===
Any role which is checked/ticked here will be visible on user profiles and the Participation screen.

===Maximum uploaded file size===

Probably the most frequently asked question in the Moodle.org Using Moodle forums is "How do I increase the upload file size limit?"

Upload file sizes are restricted in a number of ways - each one in this list restricts the following ones:

1. The Apache server setting LimitRequestBody ... default in Apache 2.x or greater is set to 0 or an unlimited upload size

2. The PHP site settings post_max_size and upload_max_filesize in php.ini : '''modify php.ini in web server directories''' ( apache2.x.x/bin/php.ini ) not in php directories :

post_max_size = 128M; to increase limit to 128 Megabytes;
upload_max_filesize = 128M; to increase limit to 128 Megabytes;
max_execution_time = 600 ; Maximum execution time of each script, in seconds;

3. The Moodle site-wide maximum uploaded file size setting: ''Settings > Site administration > Security > Site policies > Maximum uploaded file size''.

4. The Moodle course maximum uploaded file size setting in the course default settings: ''Settings > Site administration > Courses > Course default settings''

5. The file size settings in each individual course in ''Course Administration>Settings''.

5. Certain course activity module settings (for example, Assignment)

* See [[File upload size]] for more details.

===User quota===

The maximum number of bytes that a user can store in their own [[Private files]] area.

===Allow EMBED and OBJECT tags===
Allowing these presents a security risk but if you wish normal users such as students to be able to use them then check the box here.

===Enable trusted content===

By default Moodle will always thoroughly clean text that comes from users to remove any possible bad scripts, media etc that could be a security risk. The Trusted Content system is a way of giving particular users that you trust the ability to include these advanced features in their content without interference. To enable this system, you need to first enable this setting, and then grant the [[Capabilities/moodle/site:trustcontent|Trust submitted content]] capability to a specific Moodle role. Texts created or uploaded by such users will be marked as trusted and will not be cleaned before display.

===Maximum time to edit posts===

This sets the editing time for forum postings. The editing time is the amount of time users have to change forum postings before they are mailed to subscribers.

Please refer to the forum discussions [http://moodle.org/mod/forum/discuss.php?d=28679 Editing a forum post after the 30 minutes deadline] and [http://moodle.org/mod/forum/discuss.php?d=5367 The philosophy underlying "no editing after 30 minutes"]

===Full name format===

This setting has been moved in Moodle 2.6 onwards to ''Administration > Site administration > Users > Permissions > [[Roles settings|User policies]]''.

===Allow extended characters in usernames===

The default here, unchecked = unenabled, can only contain alphabetical letters in lowercase, numbers, hypen '-', underscore '_', period '.', or at sign '@'. If you enable this, it will be possible to have any characters for the username, but they must still be lowercase. This setting would allow you for example to have usernames with accents such as ö or ê and so on.

Note: In Moodle 3.4.2 onwards, the Site policy URL and Site policy URL for guests settings have been moved to 'Policy settings' in the Site administration.

===Keep tag name casing===

If checked, then tags like the following will be displayed: SOCCER, gUiTaR, MacDonalds, music

If unchecked, then all tags will be displayed as follows: Soccer, Guitar, Macdonalds, Music

:''Tips'':
:* For English, off is useful.
:* For Japanese, no changes are made either way.
:* For languages where this kind of capitalization changes the meaning, it is best to keep this option on.

===Profiles for enrolled users only===

To prevent misuse by spammers, profile descriptions of users who are not yet enrolled in any course are hidden. New users must enrol in at least one course before they can add a profile description.

===Cron execution via command line only===

[[Cron]] is an action that runs various administrative jobs on your Moodle such as sending out forum posts. Running the cron from a web browser can expose privileged information to anonymous users. Thus it is recommended to only run the cron from the command line or set a cron password for remote access.

===Cron password for remote access===

Setting a password will mean that users can only run cron from the browser if they know the password and add it like this:
www.YOURMOODLE.com/admin/cron.php/?password=THEPASSWORDYOUSET.

===Account lockout===

Account lockout may be enabled.

Account lockout threshold: After a specified number of failed login attempts, a user's account is locked and they are sent an email containing a URL to unlock the account. Setting this to 'No' means there is no threshold and an account attempting to log in can do so an unlimited number of times.

Account lockout observation window: Observation time for lockout threshold, if there are no failed attempts the threshold counter is reset after this time. This is the counter for how long to watch for more failed attempts by an account trying to log in even after being locked out, the counter will reset at each attempt and last this long.

Account lockout duration: Locked out account is automatically unlocked after this duration.

The account may also be unlocked by an administrator in ''Administration > Site administration > Users > Accounts > Browse list of users'' or by waiting for the account lockout duration to elapse.

===Password policy===

It is highly recommended that a password policy is set to force users to use stronger passwords that are less susceptible to being cracked by a intruder.
[[Image:Password policy.png|thumb|Password policy]]

The password policy includes option to set the minimum length of the password, the minimum number of digits, the minimum number of lower-case characters, the minimum number of upper-case characters and the minimum number of non alphanumeric characters.

The password policy is enabled by default. Default (recommended) settings are:
* Password length - 8
* Digits - 1
* Lowercase letters - 1
* Uppercase letters - 1
* Non-alphanumeric characters - 1

If a user enters a password that does not meet the requirements, they are given an error message indicating the nature of the problem with the entered password.

Enabling the password policy does not affect existing users until they decide to or are required to change their password. An admin can force all users to change their password using the force password change option in [[Bulk user actions]].

:''Tip'': The password policy may also be applied to [[Enrolment key|enrolment keys]] by ticking the 'Use password policy' checkbox in the [[Self enrolment]] settings.

===Password rotation limit===

Here you can specify how often a user must change their password before they can re-use a previous password. Note that this might not work with some external authentication plugins.

===Log out after password change===

By default, users can change their password and remain logged in. Enabling this setting will log them out of existing sessions except the one in which they specify their new password. This setting only applies to users manually changing their password, not to bulk password changes.

===User created token duration===

A new setting in Moodle 3.4 onwards enables the duration of a web services token created by a user (for example via the mobile app) to be set. (Previously the duration was 3 months and this value could not be changed.)

===Group enrolment key policy===
If this is enabled then when a teacher sets a group enrolment key, they will have to set a key which follows the password policy set above. Note that the group enrolment key policy requires the password policy to be enabled.

===Disable user profile images===

Check/tick this box if you don't want your users to be able to change their [[User pictures|profile images]].

===Email change confirmation===

A confirmation step is required for users to change their email address unless the ''emailchangeconfirmation'' box is unchecked.

===Remember username===
If you want usernames to be stored during login then set this to "yes". This will store permanent cookies and in some countries may be considered a privacy issue if used without consent. From a UK point of view, see http://tracker.moodle.org/secure/attachment/24290/UK+Laws+Relating+to+Cookies-LUNS2011.pdf See also the Using Moodle forum discussion [http://moodle.org/mod/forum/discuss.php?d=201558 EU Cookie Law].

===Strict validation of required fields===
If enabled, users are prevented from entering a space or line break only in required fields in forms. (note: add more info)

==See also==
* [[Policies plugin]] - The Policies plugin provides a new user sign-on process, with ability to define multiple policies (site, privacy, third party), track user consents, and manage updates and versioning of the policies

[[es:Políticas del sitio]]
[[eu:Gunearen_politikak]]
[[fr:Règles site]]
[[ja:サイトポリシー]]
[[de:Sicherheitsregeln der Website]]

Course completion settings

2019-02-08T09:26:27Z

Ghillenb: /* Course completion blocks */

{{Course completion}}
==Enabling course completion==

An administrator can enable course completion for the site by ticking the 'Enable completion tracking' checkbox in ''Administration > Site administration > Advanced features''.

A teacher can then enable course completion for their course by setting 'Enable completion tracking' to Yes in the Edit settings screen for their course. (This also enables the use of [[Activity completion]].)

A Course completion link will then appear in the gear menu or the navigation block, depending on the theme. Clicking there will display three tabs:

[[File:activitycompletiondefaultbulk.png]]

The information below explains the settings in the Course completion tab. See [[Activity completion settings]] for the Default activity completion and Bulk edit activity completion tabs.

==Course completion settings==

===General===

Choose here how you wish to mark the course complete -whether you want ''Any'' or ''All'' of the requirements that follow to count towards completion.
===Condition:Activity completion===
Tick the boxes of the activities you wish to count towards completion of the course. (You need to have [[Activity completion]] enabled to be able to do this. You can decide whether ALL of the activities must be completed or ANY one of them.
===Condition:Completion of other courses===
(These settings are collapsed by default.)
{|
|[[File:noothercoursecompletion25.png|thumb|Settings when no other courses have course completion enabled]]
|[[File:othercoursesompletion25.png|thumb|Settings when course completion is enabled in one or more other courses]]
|}

This setting allows you to make "the completion of another course" as a condition for completing the course you are currently working in. This does not block the student from your current course; it simply means that the current course will not be marked complete until the first course has been marked complete. Thus, completion of the current course is dependent upon completion of an earlier course. Just select one or more courses in the "Courses available box".

'''Note''': ''To remove a course from the list if it is not required, press CTRL+click on the highlighted course and it will be deselected.''

===Condition: Date===
If you tick the ''Enable'' box you can then set a date after which the course will be declared complete.

===Condition: Enrolment duration===

If you tick the ''Enable'' box you can then choose a number of days after enrolment upon which the course will be marked complete.
===Condition: Unenrolment===
If you tick "Enable" here then the course will be marked complete once the student is unenrolled.

===Condition: Course grade===
If you tick the ''Enable'' box, you can set a passing grade for the course. Please note that course grade in Completion status is looking at total of points (rawgrade) rather than a percentage.

===Condition: Manual self-completion===
If this is enabled then a student can mark the course complete themselves from the [[Self completion block]].

===Condition: Manual completion by others===
Users with selected roles may mark the course as complete if their role is ticked here. The roles listed are ones for which the capability [[Capabilities/moodle/course:markcomplete|Mark users as complete in course completion]] is allowed.

ALL means that each role must mark the course complete before; ANY means that it will be classed as complete once one role has marked it complete.

==Site administration settings==

Use ''Site administration > Advanced features > Enable completion tracking'' (check enabled) in order to allow completion tracking on your site.

You can set Completion tracking as On or Off in new courses as a course default in ''Site administration > Courses > Course default settings''.

==Course completion capabilities==

There are two capabilities, both of which are allowed for the default roles of manager, teacher and non-editing teacher:

*[[Capabilities/report/completion:view|View course completion report]]
*[[Capabilities/moodle/course:markcomplete|Mark users as complete in course completion]]

==Course completion blocks==

* [[Course completion status block]]
* [[Self completion block]]

[[Category:Site administration]]

[[eu:Ikastaro-osaketaren_jarraipenaren_ezarpenak]]
[[es:Configuraciones de finalización del curso]]
[[de:Einstellungen zum Kursabschluss]]

badges/competency

2019-02-08T09:13:57Z

Ghillenb: Redirected page to Managing badges

#redirect[[Managing badges]]

badges/endorsement

2019-02-08T09:13:01Z

Ghillenb: Redirected page to Managing badges

#redirect[[Managing badges]]

badges/related

2019-02-08T09:12:28Z

Ghillenb: Redirected page to Managing badges

#redirect[[Managing badges]]

Using badges

2019-02-08T08:58:05Z

Ghillenb: /* Badge expiry */

{{Badges}}This page is about how to add badges to a course or the site and how users can access their badges. For managing badges which have already been added, see [[Managing badges]].

==Adding a course badge==

If course badges have been enabled in ''Administration > Site administration > Badges > Badges'' settings then a teacher can add badges from ''Administration > Course administration > Badges > Add a new badge''.

===Badge details===

Add a name and description and upload your badge here.

{{New features}}A badge version and language may be added, along with information about the author of the image used for the badge.

===Issuer details===

If you add the teacher name here, it will appear when the badge is displayed. An email address is optional.

===Badge expiry===

Set a date here if the badge will cease to be valid after a certain date. Leave it to never if you want the badge to be permanently displayed.

*When the settings are saved, you are then taken to the Manage badges screen where you can decide the criteria for awarding the badge along with other optional information.
{{New features}}*This information can now include Endorsements, Related badges and (external) Competencies. See [[Managing badges]] for more details.

===Criteria===

*For course badges, the criteria are: Manual issue by role; course completion, activity completion and previously awarded badges.
*When selecting Manual completion by role, you can choose the role you wish to award the badge, so for example a teacher could allow a non-editing teacher to award badges in the course.
*For badges to be awarded for course or activity completion, [[Completion tracking]] must be enabled in the site and the course.

[[File:CourseBadgeCriteria.png|thumb|400px|center|Choosing criteria for the badge]]

It's possible to add a description of the criterion/criteria to provide more information or relevant links.

[[File:criteriondescription.png|thumb|center|400px|Criterion description field]]

*Once criteria have been set, you are returned to the Manage badges screen where you must "enable access" for the badge to be available:

[[File:enableaccesscoursebadge.png|thumb|400px|center|Click to enable access to the badge]]

===Awarding the badge===
[[File:badge recipients.png|thumb|Badge recipients]]
Badges may be awarded manually from ''Course administration > Badges > Manage badges > Recipients'' and clicking the "Award badge" button.

For information on the Overview, Edit details, Message and Recipients tab, see [[Managing badges]].

Tip: If your site has a large number of users, it's easier to search for email addresses than names.

===Revoking a badge===

If a badge is awarded my mistake, it may be revoked from the 'Badge recipients' page. Click the badge in question, click the Award button, select the person whose badge you wish to revoke and click 'Revoke'.

Only badges which were awarded manually may be revoked.

==Adding a site badge==

*An administrator can add a site badge from ''Administration > Site administration > Badges > Add a new badge''.
*While the settings are basically the same as for a teacher in a course, the '''criteria''' are slightly different because of the global nature of the badge. These are: manual issue by role; completing a set of courses or profile completion and, '''New in 3.5,'''cohort membership and previously awarded badges. As part of the profile completion criteria, a badge may be awarded for uploading a profile picture.
*In order to be able to award a site badge based on completing one or more courses, [[Completion tracking|completion tracking]] needs to be enabled in the site and relevant courses. In each course, [[Activity completion| activity completion]] must be set for the chosen activities, which must be then checked in the [[Course completion settings |course completion settings]].
{|
|[[File:SiteBadgeCriteria.png|thumb|Badge criteria for site badges]]
|}

==Earning badges==

*Once all criteria are set and badge creator is happy with badge details and settings, site users can start earning it. For users to be able to earn a badge, a badge creator/administrator needs to enable access to this badge on a badge overview page or "Manage badges" page (as shown on the picture).

*Normally badges are awarded to users automatically based on their actions in the system. The completion criteria of an active badge are re-calculated every time an event such as completion of a course or activity, or updating user profile happens. If a user has completed all necessary requirements they are issued a badge and sent an email notification.

'''Only badges with enabled access are available to users and can be earned!'''
{|
|[[File:Badge enable access.png|thumb|Enabling badge access]]
|[[File:Earning a badge.png|thumb|Earning a badge]]
|}

==See also==
*[https://moodle.org/mod/forum/discuss.php?d=262580 Moodle is shrinking badges size] - forum post
*[https://moodle.org/mod/forum/discuss.php?d=235135 Custom Reports for Badges - Get some Here] - forum post
*[http://school.demo.moodle.net/badges/index.php?type=1 School demo example: Managing site badges] (Log in with username: ''manager'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/index.php?type=2&id=62 School demo example: Managing course badges] (Log in with username: ''teacher'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/mybadges.php School demo example: Viewing your own badges] (Log in with username: ''student'', password: ''moodle'')
*[http://remediatingassessment.blogspot.co.nz/2013/07/research-design-principles-for-studying.html Research Design Principles for Studying Learning with Digital Badges] Re-mediating assessment blog post
*[http://www.jiscrsc.ac.uk/media/421718/jiscopenbadgesdesigntoolkit-print_1.pdf Jisc Open Badge Design Toolkit]

[[es:Usando insignias]]
[[de:Auszeichnungen nutzen]]

Using badges

2019-02-08T08:57:55Z

Ghillenb: /* Badge expiry */

{{Badges}}This page is about how to add badges to a course or the site and how users can access their badges. For managing badges which have already been added, see [[Managing badges]].

==Adding a course badge==

If course badges have been enabled in ''Administration > Site administration > Badges > Badges'' settings then a teacher can add badges from ''Administration > Course administration > Badges > Add a new badge''.

===Badge details===

Add a name and description and upload your badge here.

{{New features}}A badge version and language may be added, along with information about the author of the image used for the badge.

===Issuer details===

If you add the teacher name here, it will appear when the badge is displayed. An email address is optional.

===Badge expiry===

Set a date here if the badge will cease to be valid after a certain date. Leave it to never if you want the badge to be permanently displayed.

*When the settings are saved, you are then taken to the Manage badges screen where you can decide the criteria for awarding the badge along with other optional information.
{{New features}}*'This information can now include Endorsements, Related badges and (external) Competencies. See [[Managing badges]] for more details.

===Criteria===

*For course badges, the criteria are: Manual issue by role; course completion, activity completion and previously awarded badges.
*When selecting Manual completion by role, you can choose the role you wish to award the badge, so for example a teacher could allow a non-editing teacher to award badges in the course.
*For badges to be awarded for course or activity completion, [[Completion tracking]] must be enabled in the site and the course.

[[File:CourseBadgeCriteria.png|thumb|400px|center|Choosing criteria for the badge]]

It's possible to add a description of the criterion/criteria to provide more information or relevant links.

[[File:criteriondescription.png|thumb|center|400px|Criterion description field]]

*Once criteria have been set, you are returned to the Manage badges screen where you must "enable access" for the badge to be available:

[[File:enableaccesscoursebadge.png|thumb|400px|center|Click to enable access to the badge]]

===Awarding the badge===
[[File:badge recipients.png|thumb|Badge recipients]]
Badges may be awarded manually from ''Course administration > Badges > Manage badges > Recipients'' and clicking the "Award badge" button.

For information on the Overview, Edit details, Message and Recipients tab, see [[Managing badges]].

Tip: If your site has a large number of users, it's easier to search for email addresses than names.

===Revoking a badge===

If a badge is awarded my mistake, it may be revoked from the 'Badge recipients' page. Click the badge in question, click the Award button, select the person whose badge you wish to revoke and click 'Revoke'.

Only badges which were awarded manually may be revoked.

==Adding a site badge==

*An administrator can add a site badge from ''Administration > Site administration > Badges > Add a new badge''.
*While the settings are basically the same as for a teacher in a course, the '''criteria''' are slightly different because of the global nature of the badge. These are: manual issue by role; completing a set of courses or profile completion and, '''New in 3.5,'''cohort membership and previously awarded badges. As part of the profile completion criteria, a badge may be awarded for uploading a profile picture.
*In order to be able to award a site badge based on completing one or more courses, [[Completion tracking|completion tracking]] needs to be enabled in the site and relevant courses. In each course, [[Activity completion| activity completion]] must be set for the chosen activities, which must be then checked in the [[Course completion settings |course completion settings]].
{|
|[[File:SiteBadgeCriteria.png|thumb|Badge criteria for site badges]]
|}

==Earning badges==

*Once all criteria are set and badge creator is happy with badge details and settings, site users can start earning it. For users to be able to earn a badge, a badge creator/administrator needs to enable access to this badge on a badge overview page or "Manage badges" page (as shown on the picture).

*Normally badges are awarded to users automatically based on their actions in the system. The completion criteria of an active badge are re-calculated every time an event such as completion of a course or activity, or updating user profile happens. If a user has completed all necessary requirements they are issued a badge and sent an email notification.

'''Only badges with enabled access are available to users and can be earned!'''
{|
|[[File:Badge enable access.png|thumb|Enabling badge access]]
|[[File:Earning a badge.png|thumb|Earning a badge]]
|}

==See also==
*[https://moodle.org/mod/forum/discuss.php?d=262580 Moodle is shrinking badges size] - forum post
*[https://moodle.org/mod/forum/discuss.php?d=235135 Custom Reports for Badges - Get some Here] - forum post
*[http://school.demo.moodle.net/badges/index.php?type=1 School demo example: Managing site badges] (Log in with username: ''manager'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/index.php?type=2&id=62 School demo example: Managing course badges] (Log in with username: ''teacher'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/mybadges.php School demo example: Viewing your own badges] (Log in with username: ''student'', password: ''moodle'')
*[http://remediatingassessment.blogspot.co.nz/2013/07/research-design-principles-for-studying.html Research Design Principles for Studying Learning with Digital Badges] Re-mediating assessment blog post
*[http://www.jiscrsc.ac.uk/media/421718/jiscopenbadgesdesigntoolkit-print_1.pdf Jisc Open Badge Design Toolkit]

[[es:Usando insignias]]
[[de:Auszeichnungen nutzen]]

Using badges

2019-02-08T08:54:22Z

Ghillenb: /* Badge details */

{{Badges}}This page is about how to add badges to a course or the site and how users can access their badges. For managing badges which have already been added, see [[Managing badges]].

==Adding a course badge==

If course badges have been enabled in ''Administration > Site administration > Badges > Badges'' settings then a teacher can add badges from ''Administration > Course administration > Badges > Add a new badge''.

===Badge details===

Add a name and description and upload your badge here.

{{New features}}A badge version and language may be added, along with information about the author of the image used for the badge.

===Issuer details===

If you add the teacher name here, it will appear when the badge is displayed. An email address is optional.

===Badge expiry===

Set a date here if the badge will cease to be valid after a certain date. Leave it to never if you want the badge to be permanently displayed.

*When the settings are saved, you are then taken to the Manage badges screen where you can decide the criteria for awarding the badge along with other optional information.
*'''NEW IN 3.6''' This information can now include Endorsements, Related badges and (external) Competencies. See [[Managing badges]] for more details.

===Criteria===

*For course badges, the criteria are: Manual issue by role; course completion, activity completion and previously awarded badges.
*When selecting Manual completion by role, you can choose the role you wish to award the badge, so for example a teacher could allow a non-editing teacher to award badges in the course.
*For badges to be awarded for course or activity completion, [[Completion tracking]] must be enabled in the site and the course.

[[File:CourseBadgeCriteria.png|thumb|400px|center|Choosing criteria for the badge]]

It's possible to add a description of the criterion/criteria to provide more information or relevant links.

[[File:criteriondescription.png|thumb|center|400px|Criterion description field]]

*Once criteria have been set, you are returned to the Manage badges screen where you must "enable access" for the badge to be available:

[[File:enableaccesscoursebadge.png|thumb|400px|center|Click to enable access to the badge]]

===Awarding the badge===
[[File:badge recipients.png|thumb|Badge recipients]]
Badges may be awarded manually from ''Course administration > Badges > Manage badges > Recipients'' and clicking the "Award badge" button.

For information on the Overview, Edit details, Message and Recipients tab, see [[Managing badges]].

Tip: If your site has a large number of users, it's easier to search for email addresses than names.

===Revoking a badge===

If a badge is awarded my mistake, it may be revoked from the 'Badge recipients' page. Click the badge in question, click the Award button, select the person whose badge you wish to revoke and click 'Revoke'.

Only badges which were awarded manually may be revoked.

==Adding a site badge==

*An administrator can add a site badge from ''Administration > Site administration > Badges > Add a new badge''.
*While the settings are basically the same as for a teacher in a course, the '''criteria''' are slightly different because of the global nature of the badge. These are: manual issue by role; completing a set of courses or profile completion and, '''New in 3.5,'''cohort membership and previously awarded badges. As part of the profile completion criteria, a badge may be awarded for uploading a profile picture.
*In order to be able to award a site badge based on completing one or more courses, [[Completion tracking|completion tracking]] needs to be enabled in the site and relevant courses. In each course, [[Activity completion| activity completion]] must be set for the chosen activities, which must be then checked in the [[Course completion settings |course completion settings]].
{|
|[[File:SiteBadgeCriteria.png|thumb|Badge criteria for site badges]]
|}

==Earning badges==

*Once all criteria are set and badge creator is happy with badge details and settings, site users can start earning it. For users to be able to earn a badge, a badge creator/administrator needs to enable access to this badge on a badge overview page or "Manage badges" page (as shown on the picture).

*Normally badges are awarded to users automatically based on their actions in the system. The completion criteria of an active badge are re-calculated every time an event such as completion of a course or activity, or updating user profile happens. If a user has completed all necessary requirements they are issued a badge and sent an email notification.

'''Only badges with enabled access are available to users and can be earned!'''
{|
|[[File:Badge enable access.png|thumb|Enabling badge access]]
|[[File:Earning a badge.png|thumb|Earning a badge]]
|}

==See also==
*[https://moodle.org/mod/forum/discuss.php?d=262580 Moodle is shrinking badges size] - forum post
*[https://moodle.org/mod/forum/discuss.php?d=235135 Custom Reports for Badges - Get some Here] - forum post
*[http://school.demo.moodle.net/badges/index.php?type=1 School demo example: Managing site badges] (Log in with username: ''manager'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/index.php?type=2&id=62 School demo example: Managing course badges] (Log in with username: ''teacher'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/mybadges.php School demo example: Viewing your own badges] (Log in with username: ''student'', password: ''moodle'')
*[http://remediatingassessment.blogspot.co.nz/2013/07/research-design-principles-for-studying.html Research Design Principles for Studying Learning with Digital Badges] Re-mediating assessment blog post
*[http://www.jiscrsc.ac.uk/media/421718/jiscopenbadgesdesigntoolkit-print_1.pdf Jisc Open Badge Design Toolkit]

[[es:Usando insignias]]
[[de:Auszeichnungen nutzen]]

Using badges

2019-02-08T08:51:50Z

Ghillenb: /* Badge details */

{{Badges}}This page is about how to add badges to a course or the site and how users can access their badges. For managing badges which have already been added, see [[Managing badges]].

==Adding a course badge==

If course badges have been enabled in ''Administration > Site administration > Badges > Badges'' settings then a teacher can add badges from ''Administration > Course administration > Badges > Add a new badge''.

===Badge details===

Add a name and description and upload your badge here.

{{New in 3.6}}'''NEW IN 3.6''' A badge version and language may be added, along with information about the author of the image used for the badge.

===Issuer details===

If you add the teacher name here, it will appear when the badge is displayed. An email address is optional.

===Badge expiry===

Set a date here if the badge will cease to be valid after a certain date. Leave it to never if you want the badge to be permanently displayed.

*When the settings are saved, you are then taken to the Manage badges screen where you can decide the criteria for awarding the badge along with other optional information.
*'''NEW IN 3.6''' This information can now include Endorsements, Related badges and (external) Competencies. See [[Managing badges]] for more details.

===Criteria===

*For course badges, the criteria are: Manual issue by role; course completion, activity completion and previously awarded badges.
*When selecting Manual completion by role, you can choose the role you wish to award the badge, so for example a teacher could allow a non-editing teacher to award badges in the course.
*For badges to be awarded for course or activity completion, [[Completion tracking]] must be enabled in the site and the course.

[[File:CourseBadgeCriteria.png|thumb|400px|center|Choosing criteria for the badge]]

It's possible to add a description of the criterion/criteria to provide more information or relevant links.

[[File:criteriondescription.png|thumb|center|400px|Criterion description field]]

*Once criteria have been set, you are returned to the Manage badges screen where you must "enable access" for the badge to be available:

[[File:enableaccesscoursebadge.png|thumb|400px|center|Click to enable access to the badge]]

===Awarding the badge===
[[File:badge recipients.png|thumb|Badge recipients]]
Badges may be awarded manually from ''Course administration > Badges > Manage badges > Recipients'' and clicking the "Award badge" button.

For information on the Overview, Edit details, Message and Recipients tab, see [[Managing badges]].

Tip: If your site has a large number of users, it's easier to search for email addresses than names.

===Revoking a badge===

If a badge is awarded my mistake, it may be revoked from the 'Badge recipients' page. Click the badge in question, click the Award button, select the person whose badge you wish to revoke and click 'Revoke'.

Only badges which were awarded manually may be revoked.

==Adding a site badge==

*An administrator can add a site badge from ''Administration > Site administration > Badges > Add a new badge''.
*While the settings are basically the same as for a teacher in a course, the '''criteria''' are slightly different because of the global nature of the badge. These are: manual issue by role; completing a set of courses or profile completion and, '''New in 3.5,'''cohort membership and previously awarded badges. As part of the profile completion criteria, a badge may be awarded for uploading a profile picture.
*In order to be able to award a site badge based on completing one or more courses, [[Completion tracking|completion tracking]] needs to be enabled in the site and relevant courses. In each course, [[Activity completion| activity completion]] must be set for the chosen activities, which must be then checked in the [[Course completion settings |course completion settings]].
{|
|[[File:SiteBadgeCriteria.png|thumb|Badge criteria for site badges]]
|}

==Earning badges==

*Once all criteria are set and badge creator is happy with badge details and settings, site users can start earning it. For users to be able to earn a badge, a badge creator/administrator needs to enable access to this badge on a badge overview page or "Manage badges" page (as shown on the picture).

*Normally badges are awarded to users automatically based on their actions in the system. The completion criteria of an active badge are re-calculated every time an event such as completion of a course or activity, or updating user profile happens. If a user has completed all necessary requirements they are issued a badge and sent an email notification.

'''Only badges with enabled access are available to users and can be earned!'''
{|
|[[File:Badge enable access.png|thumb|Enabling badge access]]
|[[File:Earning a badge.png|thumb|Earning a badge]]
|}

==See also==
*[https://moodle.org/mod/forum/discuss.php?d=262580 Moodle is shrinking badges size] - forum post
*[https://moodle.org/mod/forum/discuss.php?d=235135 Custom Reports for Badges - Get some Here] - forum post
*[http://school.demo.moodle.net/badges/index.php?type=1 School demo example: Managing site badges] (Log in with username: ''manager'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/index.php?type=2&id=62 School demo example: Managing course badges] (Log in with username: ''teacher'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/mybadges.php School demo example: Viewing your own badges] (Log in with username: ''student'', password: ''moodle'')
*[http://remediatingassessment.blogspot.co.nz/2013/07/research-design-principles-for-studying.html Research Design Principles for Studying Learning with Digital Badges] Re-mediating assessment blog post
*[http://www.jiscrsc.ac.uk/media/421718/jiscopenbadgesdesigntoolkit-print_1.pdf Jisc Open Badge Design Toolkit]

[[es:Usando insignias]]
[[de:Auszeichnungen nutzen]]

Using badges

2019-02-08T08:51:33Z

Ghillenb: /* Badge details */

{{Badges}}This page is about how to add badges to a course or the site and how users can access their badges. For managing badges which have already been added, see [[Managing badges]].

==Adding a course badge==

If course badges have been enabled in ''Administration > Site administration > Badges > Badges'' settings then a teacher can add badges from ''Administration > Course administration > Badges > Add a new badge''.

===Badge details===

Add a name and description and upload your badge here.

{{New Feature}}'''NEW IN 3.6''' A badge version and language may be added, along with information about the author of the image used for the badge.

===Issuer details===

If you add the teacher name here, it will appear when the badge is displayed. An email address is optional.

===Badge expiry===

Set a date here if the badge will cease to be valid after a certain date. Leave it to never if you want the badge to be permanently displayed.

*When the settings are saved, you are then taken to the Manage badges screen where you can decide the criteria for awarding the badge along with other optional information.
*'''NEW IN 3.6''' This information can now include Endorsements, Related badges and (external) Competencies. See [[Managing badges]] for more details.

===Criteria===

*For course badges, the criteria are: Manual issue by role; course completion, activity completion and previously awarded badges.
*When selecting Manual completion by role, you can choose the role you wish to award the badge, so for example a teacher could allow a non-editing teacher to award badges in the course.
*For badges to be awarded for course or activity completion, [[Completion tracking]] must be enabled in the site and the course.

[[File:CourseBadgeCriteria.png|thumb|400px|center|Choosing criteria for the badge]]

It's possible to add a description of the criterion/criteria to provide more information or relevant links.

[[File:criteriondescription.png|thumb|center|400px|Criterion description field]]

*Once criteria have been set, you are returned to the Manage badges screen where you must "enable access" for the badge to be available:

[[File:enableaccesscoursebadge.png|thumb|400px|center|Click to enable access to the badge]]

===Awarding the badge===
[[File:badge recipients.png|thumb|Badge recipients]]
Badges may be awarded manually from ''Course administration > Badges > Manage badges > Recipients'' and clicking the "Award badge" button.

For information on the Overview, Edit details, Message and Recipients tab, see [[Managing badges]].

Tip: If your site has a large number of users, it's easier to search for email addresses than names.

===Revoking a badge===

If a badge is awarded my mistake, it may be revoked from the 'Badge recipients' page. Click the badge in question, click the Award button, select the person whose badge you wish to revoke and click 'Revoke'.

Only badges which were awarded manually may be revoked.

==Adding a site badge==

*An administrator can add a site badge from ''Administration > Site administration > Badges > Add a new badge''.
*While the settings are basically the same as for a teacher in a course, the '''criteria''' are slightly different because of the global nature of the badge. These are: manual issue by role; completing a set of courses or profile completion and, '''New in 3.5,'''cohort membership and previously awarded badges. As part of the profile completion criteria, a badge may be awarded for uploading a profile picture.
*In order to be able to award a site badge based on completing one or more courses, [[Completion tracking|completion tracking]] needs to be enabled in the site and relevant courses. In each course, [[Activity completion| activity completion]] must be set for the chosen activities, which must be then checked in the [[Course completion settings |course completion settings]].
{|
|[[File:SiteBadgeCriteria.png|thumb|Badge criteria for site badges]]
|}

==Earning badges==

*Once all criteria are set and badge creator is happy with badge details and settings, site users can start earning it. For users to be able to earn a badge, a badge creator/administrator needs to enable access to this badge on a badge overview page or "Manage badges" page (as shown on the picture).

*Normally badges are awarded to users automatically based on their actions in the system. The completion criteria of an active badge are re-calculated every time an event such as completion of a course or activity, or updating user profile happens. If a user has completed all necessary requirements they are issued a badge and sent an email notification.

'''Only badges with enabled access are available to users and can be earned!'''
{|
|[[File:Badge enable access.png|thumb|Enabling badge access]]
|[[File:Earning a badge.png|thumb|Earning a badge]]
|}

==See also==
*[https://moodle.org/mod/forum/discuss.php?d=262580 Moodle is shrinking badges size] - forum post
*[https://moodle.org/mod/forum/discuss.php?d=235135 Custom Reports for Badges - Get some Here] - forum post
*[http://school.demo.moodle.net/badges/index.php?type=1 School demo example: Managing site badges] (Log in with username: ''manager'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/index.php?type=2&id=62 School demo example: Managing course badges] (Log in with username: ''teacher'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/mybadges.php School demo example: Viewing your own badges] (Log in with username: ''student'', password: ''moodle'')
*[http://remediatingassessment.blogspot.co.nz/2013/07/research-design-principles-for-studying.html Research Design Principles for Studying Learning with Digital Badges] Re-mediating assessment blog post
*[http://www.jiscrsc.ac.uk/media/421718/jiscopenbadgesdesigntoolkit-print_1.pdf Jisc Open Badge Design Toolkit]

[[es:Usando insignias]]
[[de:Auszeichnungen nutzen]]

Using badges

2019-02-08T08:51:18Z

Ghillenb: /* Badge details */

{{Badges}}This page is about how to add badges to a course or the site and how users can access their badges. For managing badges which have already been added, see [[Managing badges]].

==Adding a course badge==

If course badges have been enabled in ''Administration > Site administration > Badges > Badges'' settings then a teacher can add badges from ''Administration > Course administration > Badges > Add a new badge''.

===Badge details===

Add a name and description and upload your badge here.

{{New}}'''NEW IN 3.6''' A badge version and language may be added, along with information about the author of the image used for the badge.

===Issuer details===

If you add the teacher name here, it will appear when the badge is displayed. An email address is optional.

===Badge expiry===

Set a date here if the badge will cease to be valid after a certain date. Leave it to never if you want the badge to be permanently displayed.

*When the settings are saved, you are then taken to the Manage badges screen where you can decide the criteria for awarding the badge along with other optional information.
*'''NEW IN 3.6''' This information can now include Endorsements, Related badges and (external) Competencies. See [[Managing badges]] for more details.

===Criteria===

*For course badges, the criteria are: Manual issue by role; course completion, activity completion and previously awarded badges.
*When selecting Manual completion by role, you can choose the role you wish to award the badge, so for example a teacher could allow a non-editing teacher to award badges in the course.
*For badges to be awarded for course or activity completion, [[Completion tracking]] must be enabled in the site and the course.

[[File:CourseBadgeCriteria.png|thumb|400px|center|Choosing criteria for the badge]]

It's possible to add a description of the criterion/criteria to provide more information or relevant links.

[[File:criteriondescription.png|thumb|center|400px|Criterion description field]]

*Once criteria have been set, you are returned to the Manage badges screen where you must "enable access" for the badge to be available:

[[File:enableaccesscoursebadge.png|thumb|400px|center|Click to enable access to the badge]]

===Awarding the badge===
[[File:badge recipients.png|thumb|Badge recipients]]
Badges may be awarded manually from ''Course administration > Badges > Manage badges > Recipients'' and clicking the "Award badge" button.

For information on the Overview, Edit details, Message and Recipients tab, see [[Managing badges]].

Tip: If your site has a large number of users, it's easier to search for email addresses than names.

===Revoking a badge===

If a badge is awarded my mistake, it may be revoked from the 'Badge recipients' page. Click the badge in question, click the Award button, select the person whose badge you wish to revoke and click 'Revoke'.

Only badges which were awarded manually may be revoked.

==Adding a site badge==

*An administrator can add a site badge from ''Administration > Site administration > Badges > Add a new badge''.
*While the settings are basically the same as for a teacher in a course, the '''criteria''' are slightly different because of the global nature of the badge. These are: manual issue by role; completing a set of courses or profile completion and, '''New in 3.5,'''cohort membership and previously awarded badges. As part of the profile completion criteria, a badge may be awarded for uploading a profile picture.
*In order to be able to award a site badge based on completing one or more courses, [[Completion tracking|completion tracking]] needs to be enabled in the site and relevant courses. In each course, [[Activity completion| activity completion]] must be set for the chosen activities, which must be then checked in the [[Course completion settings |course completion settings]].
{|
|[[File:SiteBadgeCriteria.png|thumb|Badge criteria for site badges]]
|}

==Earning badges==

*Once all criteria are set and badge creator is happy with badge details and settings, site users can start earning it. For users to be able to earn a badge, a badge creator/administrator needs to enable access to this badge on a badge overview page or "Manage badges" page (as shown on the picture).

*Normally badges are awarded to users automatically based on their actions in the system. The completion criteria of an active badge are re-calculated every time an event such as completion of a course or activity, or updating user profile happens. If a user has completed all necessary requirements they are issued a badge and sent an email notification.

'''Only badges with enabled access are available to users and can be earned!'''
{|
|[[File:Badge enable access.png|thumb|Enabling badge access]]
|[[File:Earning a badge.png|thumb|Earning a badge]]
|}

==See also==
*[https://moodle.org/mod/forum/discuss.php?d=262580 Moodle is shrinking badges size] - forum post
*[https://moodle.org/mod/forum/discuss.php?d=235135 Custom Reports for Badges - Get some Here] - forum post
*[http://school.demo.moodle.net/badges/index.php?type=1 School demo example: Managing site badges] (Log in with username: ''manager'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/index.php?type=2&id=62 School demo example: Managing course badges] (Log in with username: ''teacher'', password: ''moodle'')
*[http://school.demo.moodle.net/badges/mybadges.php School demo example: Viewing your own badges] (Log in with username: ''student'', password: ''moodle'')
*[http://remediatingassessment.blogspot.co.nz/2013/07/research-design-principles-for-studying.html Research Design Principles for Studying Learning with Digital Badges] Re-mediating assessment blog post
*[http://www.jiscrsc.ac.uk/media/421718/jiscopenbadgesdesigntoolkit-print_1.pdf Jisc Open Badge Design Toolkit]

[[es:Usando insignias]]
[[de:Auszeichnungen nutzen]]

Timeline block

2019-02-04T09:50:01Z

Ghillenb:

{{Blocks}}{{New features}}
*The Timeline block (displayed by default on the [[Dashboard]] and replacing the timeline tab of earlier versions of the [[Course overview]]) provides an overview of deadlines.
*Deadlines may be sorted by due dates (1) or by dates or course (2).

[[File:docsTimelineblock.png]]

==How to make activities and resources display in the Timeline block==

For activities
* Either set a deadline or
* Set an 'Expect completed on' date in the [[Activity completion settings|activity completion settings]]
* For teachers to see assignments which need grading, a 'Remind me to grade by' date must be entered in the assignment set up screen.

For resources
* Set an 'Expect completed on' date in the [[Activity completion settings|activity completion settings]]

[[es:Bloque Línea de tiempo]]
[[de:Zeitleiste]]

Timeline block

2019-02-04T09:49:50Z

Ghillenb:

Starred courses block

2019-02-04T09:48:27Z

Ghillenb:

{{Blocks}}{{New features}}
*The Starred courses block may be added to the [[Dashboard]] to display the courses which an enrolled user has 'starred' (bookmarked).
*It can be added to the side, as in the screenshot, or in the centre of the dashboard.

[[File:docsSC.png]]

[[es:Bloque Cursos destacados]]
[[de:Favorisierte Kurse]]

Recently accessed items block

2019-02-04T09:47:00Z

Ghillenb:

{{Blocks}}{{New features}}
*The Recently accessed items block may be added to the [[Dashboard]] to display the activities and resources which an enrolled user has most recently accessed, allowing them to quickly find where they were previously on the site.
*The block may be positioned in the centre, as in the screenshot, or to one side.

[[File:docsRAI.png]]

Note that block content may be scrolled horizontally. However the scrollbar is not shown by default for macOS users.

[[es:Bloque Ítems accedidos recientemente]]
[[de:Zuletzt genutzte Objekte]]

Recently accessed items block

2019-02-04T09:46:41Z

Ghillenb:

Recently accessed courses block

2019-02-04T09:45:28Z

Ghillenb:

{{Blocks}}{{New features}}

*The Recently accessed courses block, displayed by default on the [[Dashboard]] displays the courses which an enrolled user has most recently accessed.
*The block may be positioned in the centre, as in the screenshot, or to one side.
[[File:docsRAC.png]]

Note that block content may be scrolled horizontally. However the scrollbar is not shown by default for macOS users.

[[es:Bloque Cursos accedidos recientemente]]
[[de:Zuletzt besuchte Kurse]]

OAuth 2 Nextcloud service

2019-02-04T09:41:01Z

Ghillenb: /* Troubleshooting */

{{OAuth2}}{{New features}}

== Nextcloud configuration ==

As a prerequisite, you need Nextcloud in version 14.0.4 (or above). Otherwise, please [https://docs.nextcloud.com/server/14/admin_manual/maintenance/upgrade.html upgrade to a recent Nextcloud version] first. Then you need to [https://docs.nextcloud.com/server/14/admin_manual/configuration_server/oauth2.html#add-an-oauth2-application register Moodle as an OAuth 2 client] as follows:

# Log in to Nextcloud using the administrator account.
# Open the menu in the top-right corner and select '''Settings'''. On the next page, select the '''Security''' item in the "Administration" section on the left. <br>[[File:nextcloud-oauth2-settings.png|100px]]
# At the top of the next page you see the list of registered clients (which is empty initially). Below "Add client", enter the name of your Moodle (e.g., "Mount Orange School Moodle") in the first field (Name). Note that the name that you enter here will be displayed to your Moodle users.
# In the second field (Redirection URI), enter the URL of your Moodle followed by '''/admin/oauth2callback.php''' (e.g., "<nowiki>https://school.demo.moodle.net/admin/oauth2callback.php</nowiki>").
# Click '''Add''' to save. Afterwards, the page looks similar to the screenshot below.

[[File:nextcloud-moodle-client.png|none|frame|Registration of Moodle as an OAuth 2 client in Nextcloud]]

Moodle is now allowed to connect to Nextcloud using OAuth 2 authentication.

== Moodle configuration ==

After you have [[#Nextcloud configuration|set up Nextcloud]], you can configure Moodle.

# Go to ''Site administration > Server > OAuth 2 services'' and click '''Create new Nextcloud service'''.
# On the next page, enter the '''Name''' of your Nextcloud, the '''Client ID''' and '''Client secret''' (as seen in the Nextcloud admin interface in the screenshot above) and the '''Service base URL''' which is the URL of your Nextcloud. If you use a custom Nextcloud '''Logo''', specify its URL, too.<br>[[File:nextcloud-issuer-settings.png|400px]]
# You do not need to change any other settings. Click '''Save changes'''.

Afterwards, you can use the Nextcloud service from your Moodle, for example from the [[Nextcloud repository]].

[[File:nextcloud-issuer-configured.png|none]]

== Troubleshooting ==

There are some configuration mistakes that might prevent Moodle from communicating with Nextcloud properly. Some of them are due to the fact that you can host Nextcloud on your own and that it is easy to make mistakes that are hard to spot at first. However, this list will help you resolve them.

; I cannot connect a system account. : Log out from Nextcloud first. Make sure the Nextcloud account that you want to connect as a system account is different from all personal accounts. It has to be an account that belongs to Moodle, not to a person. Also, check the issuer settings. The checkbox '''Authenticate token requests via HTTP headers''' must be enabled!
; Authentication seems to have succeeded, but the filepicker shows "There are no files". : It is possible that HTTPS is not configured correctly on the Nextcloud end. You need a ''valid'' and ''trusted'' certificate for your Nextcloud server! A self-signed certificate will not work. Unlike in the browser, you cannot manually "trust" a self-signed server certificate. You should also check that the Apache modules "rewrite", "headers" and "env" are installed and enabled in the Nextcloud server.
; After signing in with Nextcloud I get an error that says "This request is not valid. Please contact the administrator of [your Moodle Name] if this error persists.". : You might have entered the wrong ''Redirect URI'' in Nextcloud. It is important that it ends with '''/admin/oauth2callback.php''' and that it corresponds '''exactly''' to the URL that Moodle is going to send to Nextcloud when attempting to authenticate!
; When I access an access controlled link I authorise Moodle but then cannot see the file. : In older Nextcloud versions (prior to 14.0.1), when you authorise Moodle, your Nextcloud browser session ends. Upgrade to a recent Nextcloud version (see [[#Nextcloud configuration]]) to resolve this.
; Since I connected a system account, Moodle is very slow : Nextcloud has a brute-force protection that was somewhat naïve (prior to 14.0.3). When enabled, it slows down some Moodle requests in some cases (even though the Moodle plugin is definitely not going to brute-force your Nextcloud!). First, upgrade to a recent Nextcloud version (see [[#Nextcloud configuration]]) to resolve this. As an additional measure, you can download the [https://apps.nextcloud.com/apps/bruteforcesettings "Brute-force settings" app for Nextcloud]. After installation, add the IP of your Moodle server to the whitelist.
; When I try to create an access controlled link I get a "Cannot download this file" error. : This may happen if the system account is not connected. Go to ''Site administration > Server > OAuth 2 services'' and try to connect again the Nextcloud system account.

[[es:Servicio OAuth 2 Nextcloud]]
[[de:OAuth2 Nextcloud Service]]