MoodleDocs - Användarbidrag [sv]

Moodle app FAQ

2022-08-23T10:41:28Z

Jleyva: /* H5P packages don't work on my site */

{{Mobile}}
== New Moodle App Plans (starting 2 April 2020) ==
Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal]
==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 recent sites that have been set up to allow it (the app will only connect to Moodle LMS sites version 3.5 onward). 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).
===I use LineageOS and I'm having problems using the app===
LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.
===H5P packages are not working on iOS ===
This is caused by a new feature of iOS 14 called ITP that blocks cookies for external sites embedded in the app (the H5P content is played embedded in an iframe pointing to the Moodle website) unless the user enables a setting in the app to allow those cookies.

The quick workaround is to ask your students using iPhone/iPad with iOS 14 to enable the setting "Allow Cross-Website Tracking" available via the Settings app (look for the Moodle app, at the bottom)
==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 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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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

If the issue is with vimeo videos on Moodle sites 3.10 or 3.11, please update the Moodle site to the latest version possible (at least 3.10.10 or 3.11.6). (See https://tracker.moodle.org/browse/MDL-74042)
===ReCaptcha doesn't work on my site===
You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"
===H5P packages don't work on my site===
In some old Moodle versions, you might need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

This can also happen when you are using the non-official H5P plugin (mod_hvp), in that case you will see the following message: This site is not configured properly for displaying mobile H5P content. Please contact a site administrator so they can apply the suggested configuration changes.

Finally, when this error appears "Missing dependency H5P.Editor. something X required by H5P.Editor. something Y". H5P packages need to include all the libraries (dependencies) they use so the package is self-contained. But sometimes packages might be missing at least one dependency.

In order to fix this, you could do the following:

Open Moodle’s Content Bank (from the link in the problematic H5P settings page) and upload your H5P package there, once uploaded, you will see the H5P package and an “Edit” button, click on that button so the editor opens, scroll down and click “Save”.
Now, you can replace the problematic H5P with this new one, for this, you can just include it from the Content bank by opening the activity settings page and the file picker.

=== 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 ===
This might be caused because:
* The SCORM was added using an advanced option (remote imsmanifest.xml packages or file system repository unzipped SCORMS)
* The SCORM ZIP file was created using a tool that does not create standardised ZIP files (for example, zip files containing the inverted path separator "\" will not work on Android)
Please refer to [[Moodle app SCORM player]] for additional information.
=== 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 ===
If you are having issues with MathJax, please enable the [[TeX notation filter]] instead.
=== 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
=== My images, videos or audios stop working after the first time ===
Please make sure the URL you're using on the media file doesn't have any redirect (e.g. http to https), always try to use the final URL. There's a bug in the library we use to download those files, it doesn't work when downloading files with redirects. We have plans to remove that library from the app, but since then please always try to use URLs without redirects.
==Administrators==
=== How can I have my site listed in the Moodle app site finder? ===
Please refer to our [[Moodle app guide for admins]] for instructions.
=== 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.sslshopper.com/ssl-checker.html, https://www.geocerts.com/ssl_checker, and https://www.ssllabs.com/ssltest/analyze.html
=== My certificate is fine but I still can't connect ===
This is usually a server configuration problem caused by this bug: "access-control-allow-origin cannot contain more than one origin".

iOS and Android apps do not allow the following header to contain more than one item: "Access-Control-Allow-Origin". For example, a header like this: Access-Control-Allow-Origin: *, https://mydomain.com will cause problems.

This HTTP header is not valid, according to the specification you can only specify a domain or a "*":
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin

Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header.
=== My certificate is fine but the Moodle app is detecting http instead of https ===
If the Moodle app is detecting http instead of https, please revise config.php (check "wwwroot" as well as "httpswwwroot")
===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 are using a web application firewall like StackPath, Barracuda, Cloudflare, Juniper, etc... try to temporary disable it to check if that's the cause. If so, you'll have to whitelist these endpoints: login/token.php, webservice/*, lib/ajax/*, media/player/vimeo/wsplayer.php and /tokenpluginfile.php
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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.
=== Push notifications are not working ===
Please check [[Mobile app notifications#Troubleshooting]]
=== I configured 'QR code access' to automatic login, but the app still asks for credentials ===
Automatic authentication only works for Pro and Premium sites. You can see the app plans [https://moodle.com/app/ in this site].

I you're getting an error saying that the device you're using to connect isn't in the same network as the device that displays the QR code but both devices are connected to the same network, please check the section: [[#ipmismatch:_.27Client_IP_address_mismatch.27|ipmissmatch: 'Client IP address mismatch']].
=== Some users are asked to reauthenticate too often when they browse the site ===
This can happen if the app is sending too many variables to a WebService, e.g. because a course has a large number of sections and/or activities. This error will be fixed in the 3.9.3 version of the app, but you can increase the value of ''max_input_vars'' in ''php.ini'' to fix it in your server.
=== After upgrading to 3.9.5 some of my plugins have stopped working ===
The Moodle App 3.9.5 version comes with some breaking changes for plugins, most of the existing plugins have been updated to support the new changes.

Please check the following list of plugins that should work for 3.9.5 once you have upgraded to the latest version indicated in the document: https://docs.google.com/spreadsheets/d/1E9PqcUBpp9SAfQc_zJtX5tf9GeS3UN76A85IrrB4UDw/edit#gid=0
=== After upgrading to 3.9.5 I can log in on my Moodle site but I see a blank page or the app styles broken ===
This is usually because your Moodle site has a customised CSS.

Please try leaving empty CSS (''mobilecssurl'') on Site administration > Mobile app > Mobile appearance. If that works, please read [https://docs.moodle.org/dev/Moodle_App_Remote_Themes Moodle App Remote Themes] and create a new CSS file using the variables mentioned there
=== I cannot access my site after upgrading to 3.9.5 ===
In the v3.9.5 of the app some security checks have become more strict than they used to in Android. Please check the following:
* Make sure your certificate is valid. Please use these pages to check this certificate: https://www.sslshopper.com/ssl-checker.html, https://www.geocerts.com/ssl_checker, and https://www.ssllabs.com/ssltest/analyze.html
* Make sure that the "Access-Control-Allow-Origin" header only contains one item. For example, a header like this: Access-Control-Allow-Origin: *, <nowiki>https://mydomain.com</nowiki> will cause problems.
===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 [[Capabilities/moodle/webservice:createtoken|moodle/webservice:createtoken]] for the authenticated user
===='No permission to create web service token for the service local_mobile' when attempting to log in (any user that it is not an admin)====
Please check you have enabled the moodle/webservice:createtoken for the authenticated user or any global role you want to allow to use the mobile app
===='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.
====ipmismatch: 'Client IP address mismatch'====
This error can appear when a user opens your site in a browser while using the app. This happens if your site is behind a proxy and you're using one of these Moodle versions o higher: 3.5.11, 3.6.9, 3.7.5, 3.8.2, 3.9.0.

To fix it:
# Go to ''Site administration > Administration > Server > HTTP''.
# Find the setting named ''Ignore reverse proxies'' (reverseproxyignore).
# Enter the IP of your proxy (or range of IPs).
# Click the 'Save changes' button.
===The Moodle app does not connect to MoodleBox (or other internal self-hosted systems)===
You will need to disable SSL to make the app works, please see this forum discussion for more information: https://moodle.org/mod/forum/discuss.php?d=424353#p1739474
===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 providing as much information as possible (Moodle version, app version, device model and operating system, etc...), then click the Create button
===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 app FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app FAQ

2022-08-23T10:40:20Z

Jleyva: /* H5P packages don't work on my site */

{{Mobile}}
== New Moodle App Plans (starting 2 April 2020) ==
Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal]
==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 recent sites that have been set up to allow it (the app will only connect to Moodle LMS sites version 3.5 onward). 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).
===I use LineageOS and I'm having problems using the app===
LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.
===H5P packages are not working on iOS ===
This is caused by a new feature of iOS 14 called ITP that blocks cookies for external sites embedded in the app (the H5P content is played embedded in an iframe pointing to the Moodle website) unless the user enables a setting in the app to allow those cookies.

The quick workaround is to ask your students using iPhone/iPad with iOS 14 to enable the setting "Allow Cross-Website Tracking" available via the Settings app (look for the Moodle app, at the bottom)
==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 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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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

If the issue is with vimeo videos on Moodle sites 3.10 or 3.11, please update the Moodle site to the latest version possible (at least 3.10.10 or 3.11.6). (See https://tracker.moodle.org/browse/MDL-74042)
===ReCaptcha doesn't work on my site===
You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"
===H5P packages don't work on my site===
In some old Moodle versions, you might need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

This can also happen when you are using the non-official H5P plugin (mod_hvp), in that case you will see the following message: This site is not configured properly for displaying mobile H5P content. Please contact a site administrator so they can apply the suggested configuration changes
=== 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 ===
This might be caused because:
* The SCORM was added using an advanced option (remote imsmanifest.xml packages or file system repository unzipped SCORMS)
* The SCORM ZIP file was created using a tool that does not create standardised ZIP files (for example, zip files containing the inverted path separator "\" will not work on Android)
Please refer to [[Moodle app SCORM player]] for additional information.
=== 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 ===
If you are having issues with MathJax, please enable the [[TeX notation filter]] instead.
=== 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
=== My images, videos or audios stop working after the first time ===
Please make sure the URL you're using on the media file doesn't have any redirect (e.g. http to https), always try to use the final URL. There's a bug in the library we use to download those files, it doesn't work when downloading files with redirects. We have plans to remove that library from the app, but since then please always try to use URLs without redirects.
==Administrators==
=== How can I have my site listed in the Moodle app site finder? ===
Please refer to our [[Moodle app guide for admins]] for instructions.
=== 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.sslshopper.com/ssl-checker.html, https://www.geocerts.com/ssl_checker, and https://www.ssllabs.com/ssltest/analyze.html
=== My certificate is fine but I still can't connect ===
This is usually a server configuration problem caused by this bug: "access-control-allow-origin cannot contain more than one origin".

iOS and Android apps do not allow the following header to contain more than one item: "Access-Control-Allow-Origin". For example, a header like this: Access-Control-Allow-Origin: *, https://mydomain.com will cause problems.

This HTTP header is not valid, according to the specification you can only specify a domain or a "*":
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin

Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header.
=== My certificate is fine but the Moodle app is detecting http instead of https ===
If the Moodle app is detecting http instead of https, please revise config.php (check "wwwroot" as well as "httpswwwroot")
===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 are using a web application firewall like StackPath, Barracuda, Cloudflare, Juniper, etc... try to temporary disable it to check if that's the cause. If so, you'll have to whitelist these endpoints: login/token.php, webservice/*, lib/ajax/*, media/player/vimeo/wsplayer.php and /tokenpluginfile.php
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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.
=== Push notifications are not working ===
Please check [[Mobile app notifications#Troubleshooting]]
=== I configured 'QR code access' to automatic login, but the app still asks for credentials ===
Automatic authentication only works for Pro and Premium sites. You can see the app plans [https://moodle.com/app/ in this site].

I you're getting an error saying that the device you're using to connect isn't in the same network as the device that displays the QR code but both devices are connected to the same network, please check the section: [[#ipmismatch:_.27Client_IP_address_mismatch.27|ipmissmatch: 'Client IP address mismatch']].
=== Some users are asked to reauthenticate too often when they browse the site ===
This can happen if the app is sending too many variables to a WebService, e.g. because a course has a large number of sections and/or activities. This error will be fixed in the 3.9.3 version of the app, but you can increase the value of ''max_input_vars'' in ''php.ini'' to fix it in your server.
=== After upgrading to 3.9.5 some of my plugins have stopped working ===
The Moodle App 3.9.5 version comes with some breaking changes for plugins, most of the existing plugins have been updated to support the new changes.

Please check the following list of plugins that should work for 3.9.5 once you have upgraded to the latest version indicated in the document: https://docs.google.com/spreadsheets/d/1E9PqcUBpp9SAfQc_zJtX5tf9GeS3UN76A85IrrB4UDw/edit#gid=0
=== After upgrading to 3.9.5 I can log in on my Moodle site but I see a blank page or the app styles broken ===
This is usually because your Moodle site has a customised CSS.

Please try leaving empty CSS (''mobilecssurl'') on Site administration > Mobile app > Mobile appearance. If that works, please read [https://docs.moodle.org/dev/Moodle_App_Remote_Themes Moodle App Remote Themes] and create a new CSS file using the variables mentioned there
=== I cannot access my site after upgrading to 3.9.5 ===
In the v3.9.5 of the app some security checks have become more strict than they used to in Android. Please check the following:
* Make sure your certificate is valid. Please use these pages to check this certificate: https://www.sslshopper.com/ssl-checker.html, https://www.geocerts.com/ssl_checker, and https://www.ssllabs.com/ssltest/analyze.html
* Make sure that the "Access-Control-Allow-Origin" header only contains one item. For example, a header like this: Access-Control-Allow-Origin: *, <nowiki>https://mydomain.com</nowiki> will cause problems.
===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 [[Capabilities/moodle/webservice:createtoken|moodle/webservice:createtoken]] for the authenticated user
===='No permission to create web service token for the service local_mobile' when attempting to log in (any user that it is not an admin)====
Please check you have enabled the moodle/webservice:createtoken for the authenticated user or any global role you want to allow to use the mobile app
===='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.
====ipmismatch: 'Client IP address mismatch'====
This error can appear when a user opens your site in a browser while using the app. This happens if your site is behind a proxy and you're using one of these Moodle versions o higher: 3.5.11, 3.6.9, 3.7.5, 3.8.2, 3.9.0.

To fix it:
# Go to ''Site administration > Administration > Server > HTTP''.
# Find the setting named ''Ignore reverse proxies'' (reverseproxyignore).
# Enter the IP of your proxy (or range of IPs).
# Click the 'Save changes' button.
===The Moodle app does not connect to MoodleBox (or other internal self-hosted systems)===
You will need to disable SSL to make the app works, please see this forum discussion for more information: https://moodle.org/mod/forum/discuss.php?d=424353#p1739474
===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 providing as much information as possible (Moodle version, app version, device model and operating system, etc...), then click the Create button
===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 app FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Mobile web services

2022-08-18T08:00:05Z

Jleyva: Removed outdated information

{{Web services}}
Moodle comes with a built-in web service designed for mobile applications. It is required to run the official [[Mobile app]]. Enable it only if you want people to use the official app or if a third-party app explicitly requires it.
== Enabling mobile web services ==
A site administrator first must enable mobile web services:
*In ''Administration > Site administration > Advanced features''
*Check "Enable web services for mobile devices" and then
*Click Save.
That's it! No other steps required.

The rest of this document explains the "behind the scenes".
== What happens when the service is enabled ==
Enabling the mobile web services will automatically:
* enable the web services system (''Administration > Site administration > Advanced features'')
* enable the built-in external service called 'Mobile web services' - you should see this new mobile service listed as enabled
* enable the rest protocol
* allow the 'webservice/rest:use' capability for authenticated user role
== Disabling mobile web services ==
When you uncheck 'Enable mobile web services', it will automatically disable the external service called 'Mobile web services'.

Prior to MDL-73414, the web services system and the REST protocol were additionally disabled, and it was not possible to enable the web services system unless an external service was enabled. This was not consistent with the web services usage documentation, where the first step was the activation of web services, whether or not an external service was enabled.
==See also==
* [[Mobile app]]
[[Category:Mobile]]
[[de:Mobile Webservices]]
[[ja:モバイルウェブサービス]]
[[es:Servicios web para móviles]]
[[fr:Services Web mobile]]

Moodle app FAQ

2022-05-30T14:28:29Z

Jleyva: /* I have problems playing SCORM packages */

{{Mobile}}
== New Moodle App Plans (starting 2 April 2020) ==
Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal]
==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 recent sites that have been set up to allow it (the app will only connect to Moodle LMS sites version 3.5 onward). 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).
===I use LineageOS and I'm having problems using the app===
LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.
===H5P packages are not working on iOS ===
This is caused by a new feature of iOS 14 called ITP that blocks cookies for external sites embedded in the app (the H5P content is played embedded in an iframe pointing to the Moodle website) unless the user enables a setting in the app to allow those cookies.

The quick workaround is to ask your students using iPhone/iPad with iOS 14 to enable the setting "Allow Cross-Website Tracking" available via the Settings app (look for the Moodle app, at the bottom)
==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 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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"
===H5P packages don't work on my site===
You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

This can also happen when you are using the non-official H5P plugin (mod_hvp), in that case you will see the following message: This site is not configured properly for displaying mobile H5P content. Please contact a site administrator so they can apply the suggested configuration changes
=== 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 ===

This might be caused because:
* The SCORM was added using an advanced option (remote imsmanifest.xml packages or file system repository unzipped SCORMS)
* The SCORM ZIP file was created using a tool that does not create standardised ZIP files (for example, zip files containing the inverted path separator "\" will not work on Android)

Please refer to [[Moodle app SCORM player]] for additional information.

=== 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 ===
If you are having issues with MathJax, please enable the [[TeX notation filter]] instead.
=== 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
=== My images, videos or audios stop working after the first time ===
Please make sure the URL you're using on the media file doesn't have any redirect (e.g. http to https), always try to use the final URL. There's a bug in the library we use to download those files, it doesn't work when downloading files with redirects. We have plans to remove that library from the app, but since then please always try to use URLs without redirects.
==Administrators==
=== How can I have my site listed in the Moodle app site finder? ===
Please refer to our [[Moodle app guide for admins]] for instructions.
=== 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.sslshopper.com/ssl-checker.html, https://www.geocerts.com/ssl_checker, and https://www.ssllabs.com/ssltest/analyze.html
=== My certificate is fine but I still can't connect ===
This is usually a server configuration problem caused by this bug: "access-control-allow-origin cannot contain more than one origin".

iOS and Android apps do not allow the following header to contain more than one item: "Access-Control-Allow-Origin". For example, a header like this: Access-Control-Allow-Origin: *, https://mydomain.com will cause problems.

This HTTP header is not valid, according to the specification you can only specify a domain or a "*":
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin

Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header.
=== My certificate is fine but the Moodle app is detecting http instead of https ===
If the Moodle app is detecting http instead of https, please revise config.php (check "wwwroot" as well as "httpswwwroot")
===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 are using a web application firewall like StackPath, Barracuda, Cloudflare, Juniper, etc... try to temporary disable it to check if that's the cause. If so, you'll have to whitelist these endpoints: login/token.php, webservice/*, lib/ajax/*, media/player/vimeo/wsplayer.php and /tokenpluginfile.php
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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.
=== Push notifications are not working ===
Please check [[Mobile app notifications#Troubleshooting]]
=== I configured 'QR code access' to automatic login, but the app still asks for credentials ===
Automatic authentication only works for Pro and Premium sites. You can see the app plans [https://moodle.com/app/ in this site].

I you're getting an error saying that the device you're using to connect isn't in the same network as the device that displays the QR code but both devices are connected to the same network, please check the section: [[#ipmismatch:_.27Client_IP_address_mismatch.27|ipmissmatch: 'Client IP address mismatch']].
=== Some users are asked to reauthenticate too often when they browse the site ===
This can happen if the app is sending too many variables to a WebService, e.g. because a course has a large number of sections and/or activities. This error will be fixed in the 3.9.3 version of the app, but you can increase the value of ''max_input_vars'' in ''php.ini'' to fix it in your server.
=== After upgrading to 3.9.5 some of my plugins have stopped working ===
The Moodle App 3.9.5 version comes with some breaking changes for plugins, most of the existing plugins have been updated to support the new changes.

Please check the following list of plugins that should work for 3.9.5 once you have upgraded to the latest version indicated in the document: https://docs.google.com/spreadsheets/d/1E9PqcUBpp9SAfQc_zJtX5tf9GeS3UN76A85IrrB4UDw/edit#gid=0
=== After upgrading to 3.9.5 I can log in on my Moodle site but I see a blank page or the app styles broken ===
This is usually because your Moodle site has a customised CSS.

Please try leaving empty CSS (''mobilecssurl'') on Site administration > Mobile app > Mobile appearance. If that works, please read [https://docs.moodle.org/dev/Moodle_App_Remote_Themes Moodle App Remote Themes] and create a new CSS file using the variables mentioned there
=== I cannot access my site after upgrading to 3.9.5 ===
In the v3.9.5 of the app some security checks have become more strict than they used to in Android. Please check the following:
* Make sure your certificate is valid. Please use these pages to check this certificate: https://www.sslshopper.com/ssl-checker.html, https://www.geocerts.com/ssl_checker, and https://www.ssllabs.com/ssltest/analyze.html
* Make sure that the "Access-Control-Allow-Origin" header only contains one item. For example, a header like this: Access-Control-Allow-Origin: *, <nowiki>https://mydomain.com</nowiki> will cause problems.
===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 [[Capabilities/moodle/webservice:createtoken|moodle/webservice:createtoken]] for the authenticated user
===='No permission to create web service token for the service local_mobile' when attempting to log in (any user that it is not an admin)====
Please check you have enabled the moodle/webservice:createtoken for the authenticated user or any global role you want to allow to use the mobile app
===='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.
====ipmismatch: 'Client IP address mismatch'====
This error can appear when a user opens your site in a browser while using the app. This happens if your site is behind a proxy and you're using one of these Moodle versions o higher: 3.5.11, 3.6.9, 3.7.5, 3.8.2, 3.9.0.

To fix it:
# Go to ''Site administration > Administration > Server > HTTP''.
# Find the setting named ''Ignore reverse proxies'' (reverseproxyignore).
# Enter the IP of your proxy (or range of IPs).
# Click the 'Save changes' button.
===The Moodle app does not connect to MoodleBox (or other internal self-hosted systems)===
You will need to disable SSL to make the app works, please see this forum discussion for more information: https://moodle.org/mod/forum/discuss.php?d=424353#p1739474
===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 providing as much information as possible (Moodle version, app version, device model and operating system, etc...), then click the Create button
===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 app FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app

2022-05-11T11:24:14Z

Jleyva: /* Using the app */

{{Main page}}
__NOTOC__
==On the move with Moodle==
[[File:Mobile orientation.png|thumb|Access your Moodle course on your mobile]]

With the official mobile app for Moodle, you can

* Browse the content of your courses, even when offline
* Receive instant notifications of messages and other events
* Quickly find and contact other people in your courses
* Upload images, audio, videos and other files from your mobile device
* Track your progress, mark tasks as complete and browse your learning plans
* Attempt quizzes, post in forums and edit wiki pages
* View your course grades

... and lots more - see the full list of [[Moodle app features]].

==Using the app==

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

We guarantee that the app will always work with the latest supported Moodle LMS version onward. See https://docs.moodle.org/dev/Releases for the latest supported Moodle LMS version.

Links to download the app are available in the footer and user profile pages when mobile access is enabled:

{{MediaPlayer | url = https://www.youtube.com/watch?v=wURqxr4eKs0 | desc = Mobile app links}}

Teachers, for info on improving your courses for access via the app, please see [[Creating Moodle-app-friendly courses]].

==Staying up to date with new features and improvements==

Follow [https://twitter.com/moodle @moodle on Twitter] for news, updates and release announcements and join the discussions in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum] on moodle.org.

See [[New for mobile]] and the [[:dev:Moodle Mobile release notes|Moodle app release notes]] for details of new features recently added.

==See also==
* [[Moodle app features]]
* [[Moodle app offline features]]
* [[New for mobile]]
* [[Moodle app guide for admins]]
* [[Moodle app notifications]]
* [[Creating mobile-friendly courses]]
* [[Moodle App Block support]]
* [[Moodle app FAQ]]

[[Category:Mobile]]

[[ca:Moodle Mobile]]
[[de:Mobiles Moodle]]
[[es:Moodle Mobile]]
[[fr:App Moodle]]
[[it:App Moodle]]
[[ja:モバイルアプリ]]

Moodle app FAQ

2022-04-25T08:24:13Z

Jleyva: /* I can't get the app to work. What do I do? */

{{Mobile}}
== New Moodle App Plans (starting 2 April 2020) ==
Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal]
==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 recent sites that have been set up to allow it (the app will only connect to Moodle LMS sites version 3.5 onward). 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).
===I use LineageOS and I'm having problems using the app===
LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.
===H5P packages are not working on iOS ===
This is caused by a new feature of iOS 14 called ITP that blocks cookies for external sites embedded in the app (the H5P content is played embedded in an iframe pointing to the Moodle website) unless the user enables a setting in the app to allow those cookies.

The quick workaround is to ask your students using iPhone/iPad with iOS 14 to enable the setting "Allow Cross-Website Tracking" available via the Settings app (look for the Moodle app, at the bottom)
==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 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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"
===H5P packages don't work on my site===
You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

This can also happen when you are using the non-official H5P plugin (mod_hvp), in that case you will see the following message: This site is not configured properly for displaying mobile H5P content. Please contact a site administrator so they can apply the suggested configuration changes
=== 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 ===
If you are having issues with MathJax, please enable the [[TeX notation filter]] instead.
=== 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
=== My images, videos or audios stop working after the first time ===
Please make sure the URL you're using on the media file doesn't have any redirect (e.g. http to https), always try to use the final URL. There's a bug in the library we use to download those files, it doesn't work when downloading files with redirects. We have plans to remove that library from the app, but since then please always try to use URLs without redirects.
==Administrators==
=== How can I have my site listed in the Moodle app site finder? ===
Please refer to our [[Moodle app guide for admins]] for instructions.
=== 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.sslshopper.com/ssl-checker.html, https://www.geocerts.com/ssl_checker, and https://www.ssllabs.com/ssltest/analyze.html
=== My certificate is fine but I still can't connect ===
This is usually a server configuration problem caused by this bug: "access-control-allow-origin cannot contain more than one origin".

iOS and Android apps do not allow the following header to contain more than one item: "Access-Control-Allow-Origin". For example, a header like this: Access-Control-Allow-Origin: *, https://mydomain.com will cause problems.

This HTTP header is not valid, according to the specification you can only specify a domain or a "*":
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin

Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header.
=== My certificate is fine but the Moodle app is detecting http instead of https ===
If the Moodle app is detecting http instead of https, please revise config.php (check "wwwroot" as well as "httpswwwroot")
===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 are using a web application firewall like StackPath, Barracuda, Cloudflare, Juniper, etc... try to temporary disable it to check if that's the cause. If so, you'll have to whitelist these endpoints: login/token.php, webservice/*, lib/ajax/*, media/player/vimeo/wsplayer.php and /tokenpluginfile.php
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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.
=== Push notifications are not working ===
Please check [[Mobile app notifications#Troubleshooting]]
=== I configured 'QR code access' to automatic login, but the app still asks for credentials ===
Automatic authentication only works for Pro and Premium sites. You can see the app plans [https://moodle.com/app/ in this site].

I you're getting an error saying that the device you're using to connect isn't in the same network as the device that displays the QR code but both devices are connected to the same network, please check the section: [[#ipmismatch:_.27Client_IP_address_mismatch.27|ipmissmatch: 'Client IP address mismatch']].
=== Some users are asked to reauthenticate too often when they browse the site ===
This can happen if the app is sending too many variables to a WebService, e.g. because a course has a large number of sections and/or activities. This error will be fixed in the 3.9.3 version of the app, but you can increase the value of ''max_input_vars'' in ''php.ini'' to fix it in your server.
=== After upgrading to 3.9.5 some of my plugins have stopped working ===
The Moodle App 3.9.5 version comes with some breaking changes for plugins, most of the existing plugins have been updated to support the new changes.

Please check the following list of plugins that should work for 3.9.5 once you have upgraded to the latest version indicated in the document: https://docs.google.com/spreadsheets/d/1E9PqcUBpp9SAfQc_zJtX5tf9GeS3UN76A85IrrB4UDw/edit#gid=0
=== After upgrading to 3.9.5 I can log in on my Moodle site but I see a blank page or the app styles broken ===
This is usually because your Moodle site has a customised CSS.

Please try leaving empty CSS (''mobilecssurl'') on Site administration > Mobile app > Mobile appearance. If that works, please read [https://docs.moodle.org/dev/Moodle_App_Remote_Themes Moodle App Remote Themes] and create a new CSS file using the variables mentioned there
=== I cannot access my site after upgrading to 3.9.5 ===
In the v3.9.5 of the app some security checks have become more strict than they used to in Android. Please check the following:
* Make sure your certificate is valid. Please use these pages to check this certificate: https://www.sslshopper.com/ssl-checker.html, https://www.geocerts.com/ssl_checker, and https://www.ssllabs.com/ssltest/analyze.html
* Make sure that the "Access-Control-Allow-Origin" header only contains one item. For example, a header like this: Access-Control-Allow-Origin: *, <nowiki>https://mydomain.com</nowiki> will cause problems.
===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 [[Capabilities/moodle/webservice:createtoken|moodle/webservice:createtoken]] for the authenticated user
===='No permission to create web service token for the service local_mobile' when attempting to log in (any user that it is not an admin)====
Please check you have enabled the moodle/webservice:createtoken for the authenticated user or any global role you want to allow to use the mobile app
===='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.
====ipmismatch: 'Client IP address mismatch'====
This error can appear when a user opens your site in a browser while using the app. This happens if your site is behind a proxy and you're using one of these Moodle versions o higher: 3.5.11, 3.6.9, 3.7.5, 3.8.2, 3.9.0.

To fix it:
# Go to ''Site administration > Administration > Server > HTTP''.
# Find the setting named ''Ignore reverse proxies'' (reverseproxyignore).
# Enter the IP of your proxy (or range of IPs).
# 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 providing as much information as possible (Moodle version, app version, device model and operating system, etc...), then click the Create button
===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 app FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app features

2022-01-11T15:32:48Z

Jleyva: /* Features summary */

{{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 app 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>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile39h5p.png|600px]]
<div class="caption">
<h4>Play H5P on and off-line</h4>
<p>Users can now play [[Moodle_app_H5P_support|H5P packages]] on and off-line, including grading for the H5P activity.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile39qr.png|600px]]
<div class="caption">
<h4>Scan QRs to login or open courses/activities in the app</h4>
<p>The app now includes a QR reader so users can easily authenticate in their site or open certain courses or activities in the app.</p>
</div>
</div>
</li>
</ul>
</div>
====Features summary====

Please, download the following document that includes a detailed features comparision table between Moodle LMS and the Moodle app: [[:File:Moodle_features_students.pdf|Moodle features for students]]

[[File:appfeaturespreview.png.png|700px|link=:File:Moodle_features_students.pdf]]

==Activities & Resources Support==

[[File:moodlemobile_activities_resources.png|600px]]

=== Languages ===

The Moodle app is being translated into an increasing number of languages. As of June 2020, 47 languages are available:

(ar) عربي, (bg) Български, (ca) Català, (cs) Čeština, (da) Dansk, (de) Deutsch, (de-du) Deutsch - Du, (el) Ελληνικά, (en) English, (en-us) English - United States, (es) Español, (es-mx) Español - México, (eu) Euskara, (fa) فارسی, (fi) Suomi, (fr) Français, (he) עברית, (hu) magyar, (id) Indonesian, (it) Italiano, (ja) 日本語, (km) ខ្មែរ, (kn) ಕನ್ನಡ, (ko) 한국어, (lt) Lietuvių, (lv) Latviešu, (mn) मराठी, (mr) मराठी, (nl) Nederlands, (no) Norsk - bokmål, (pl) Polski, (pt-br) Português - Brasil, (pt) Português - Portugal, (pt-br) Português - Brasil, (ro) Română, (ru) Русский, (sl) Slovenščina, (sr-cr) Српски, (sr-lt) Srpski, (sv) Svenska, (tg) Тоҷикӣ, (tr) Türkçe, (uk) Українська, (vi) Vietnamese, (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 la App Moodle]]
[[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

Fil:appfeaturespreview.png.png

2022-01-11T15:30:23Z

Jleyva:

Moodle app features

2022-01-11T15:30:12Z

Jleyva: /* Features summary */

{{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 app 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>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile39h5p.png|600px]]
<div class="caption">
<h4>Play H5P on and off-line</h4>
<p>Users can now play [[Moodle_app_H5P_support|H5P packages]] on and off-line, including grading for the H5P activity.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile39qr.png|600px]]
<div class="caption">
<h4>Scan QRs to login or open courses/activities in the app</h4>
<p>The app now includes a QR reader so users can easily authenticate in their site or open certain courses or activities in the app.</p>
</div>
</div>
</li>
</ul>
</div>
====Features summary====

Please, download the following document that includes a detailed features comparision table between Moodle LMS and the Moodle app: [[:File:Moodle_features_students.pdf|Moodle features for students]]

[[File:appfeaturespreview.png.png|700px]]

==Activities & Resources Support==

[[File:moodlemobile_activities_resources.png|600px]]

=== Languages ===

The Moodle app is being translated into an increasing number of languages. As of June 2020, 47 languages are available:

(ar) عربي, (bg) Български, (ca) Català, (cs) Čeština, (da) Dansk, (de) Deutsch, (de-du) Deutsch - Du, (el) Ελληνικά, (en) English, (en-us) English - United States, (es) Español, (es-mx) Español - México, (eu) Euskara, (fa) فارسی, (fi) Suomi, (fr) Français, (he) עברית, (hu) magyar, (id) Indonesian, (it) Italiano, (ja) 日本語, (km) ខ្មែរ, (kn) ಕನ್ನಡ, (ko) 한국어, (lt) Lietuvių, (lv) Latviešu, (mn) मराठी, (mr) मराठी, (nl) Nederlands, (no) Norsk - bokmål, (pl) Polski, (pt-br) Português - Brasil, (pt) Português - Portugal, (pt-br) Português - Brasil, (ro) Română, (ru) Русский, (sl) Slovenščina, (sr-cr) Српски, (sr-lt) Srpski, (sv) Svenska, (tg) Тоҷикӣ, (tr) Türkçe, (uk) Українська, (vi) Vietnamese, (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 la App Moodle]]
[[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

Fil:Moodle features students.pdf

2022-01-11T12:32:47Z

Jleyva: Jleyva uploaded a new version of File:Moodle features students.pdf

Moodle app guide for admins

2021-10-13T08:48:20Z

Jleyva: /* Custom language strings */

{{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). Please, note this is not necessary since Moodle 3.7
===Is your site behind a proxy, or load balancer or complex network infrastructure?===
In that case, you may need to configure the "Ignore reserver proxies" settings in Site administration > Administration > Server > HTTP
==Register your site on the Moodle Apps Portal==
We strongly recommend you to register your site for free on the Moodle Apps portal: https://apps.moodle.com

You will be able to retrieve statistics like the number of active user devices receiving Push Notifications and upgrade to a Pro/Premium plan for enjoying exclusive features.
==Have your site listed in the Moodle app site finder==
The Moodle apps site finder enables a user to easily find their Moodle site by entering the name (no need to enter the site URL)
===How can I have my site listed in the Moodle app site finder?===
Your site will be automatically listed in the site finder if:
* either your site is registered and listed with a link on [https://stats.moodle.org/sites/ Registered sites] and has over five hundred mobile users and you have been using the Moodle app for over a year
* or you have purchased a [https://moodle.com/app/ Pro or Premium Moodle app subscription].
You can arrange for your site to be listed in the site finder as follows:
* If your site is hosted by a Moodle Partner, please contact them to request for your site to be listed.
* If you have a MoodleCloud site, please log in to the Moodle Apps Portal where you will find an option to have your site listed.
Otherwise, to have your site listed in the site finder, you need to purchase a [https://moodle.com/app/ Pro or Premium Moodle app subscription] from the Moodle Apps Portal.
===I don’t want my site listed in the Moodle app site finder. How can I remove it?===
You can remove your site from the site finder as follows:
# Log in to the [https://apps.moodle.com/ Moodle Apps Portal]. (If you don’t yet have an account, you can create one for free.)
# Go to ‘App customisation’ -> ‘Site Listing’ and uncheck the option ‘Visible’ then save changes.
Your site will then be immediately removed from the site finder.

Alternatively, you can remove your site from the site finder by updating your site registration:
# Log in to your Moodle site as admin and go to ‘Site administration’ -> Registration.
# Change ‘Site listing’ to either ‘Do not list my site’ or ‘Only display my site name’.
Your site will then be removed from the site finder within 24 hours.
==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 [https://moodle.com/branded-app Branded Moodle Mobile app] service, please visit https://moodle.com/app/ 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 ==
'''IMPORTANT''': Please notice that the type and number of features that you can customise depend on your Moodle Apps plan, you can register for free on https://apps.moodle.com to check the different plans.

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
* Blocks
* Comments
* Ratings
* Tags
* Create new account
* Responsive menu items (new in 3.7)
* Main menu
** Site home
** My courses
** Dashboard
** Calendar
** Notifications
** Messages
** Grades
** My learning plans
** Blog
** Files
** Web page
** Help
* Course
** Blocks
** Blog
** Search
** Competencies
** Participants
** Grades
** Course completion
** Notes
** Download course (new in 3.5)
** Download courses (new in 3.5)
* User
** Blog
** Badges
** Competencies
** Course completion
** Grades
** Send message
** Add contact
** Block contact
** Add a new note
** User picture
* Files
** Private files
** Ste files
** Upload
* Modules (Each module can be disabled separately)
* Blocks (Each block available in the app can be disabled separately)
===Custom menu items===
Additional items can be added to the app main menu (the more 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), icon (optional, the name of the icon from https://ionicons.com) 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 custom menu items have the same URL, same link-opening method, and same language only the first custom menu item will be shown.

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. (So if you have a custom menu item in English (en) and French (fr), and the app is using Spanish the user will still see that custom menu item in English)

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.

Example of a menu item (it will display a home icon followed by Academy information linking to the URL indicated):
Academy information|https://yoursite.com/mod/page/view.php?id=X |app|en|home
===Responsive menu items===
From 3.7 onwards menu items on bottom tabs are moved to the side of the screen on big screens. Also the number of items displayed on the menu may vary:
* On small screens (usually phones) from 2 to 5 items will be displayed depending on the size of the screen.
* On big screens (usually tablets an desktop version) more than 2 items will be displayed without limit.
If '''Responsive menu items''' is selected in Disabled features items will be displayed in side of bottom anyway but 5 items will be displayed in all cases without depending on the size of the screen.
===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:
core.user.student|Learner|en
core.user.student|Aprendiz|es
The complete list of string identifiers is listed in https://master.apps.moodledemo.net/assets/lang/en.json

The string identifier is before the colon.

For example:

"core.user.student": v"Student",

means that the string "Student" has string identifier "core.user.student".
==Statistics==
To retrieve information about the Moodle app usage, site administrators and teachers can check the system, course or activity logs.

Among the log filters, there is a field called "All sources" with an option "Web Service" that can be used to filter the entry logs generated by the mobile application.

You can compare the number of log entries generated by the "Web" versus "Web Service" (mobile app) to have an overall idea about how your users use the platform.
==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.)
==App's cache==
The app caches WebService requests to decrease data usage and increase the app's speed. When the app needs to get some data from Moodle, it will use a cached request as long as it isn't expired.

This cache was improved in Moodle App 3.7.0, now there are several cache times depending on the WS being called. This means that some requests will expire more often than others. Also, if the user isn't using a WiFi connection, the expiration time will also be longer to decrease the data usage. These cache times cannot be configured using a Moodle setting.
==See also==
* [[Moodle Mobile FAQ]] for other administration-related mobile app questions.
* [[Moodle app security]]
* [[: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 FAQ

2021-09-14T07:43:08Z

Jleyva: /* Administrators */

{{Mobile}}
== New Moodle App Plans (starting 2 April 2020) ==
Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal]
==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).
===I use LineageOS and I'm having problems using the app===
LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.
===H5P packages are not working on iOS ===
This is caused by a new feature of iOS 14 called ITP that blocks cookies for external sites embedded in the app (the H5P content is played embedded in an iframe pointing to the Moodle website) unless the user enables a setting in the app to allow those cookies.

The quick workaround is to ask your students using iPhone/iPad with iOS 14 to enable the setting "Allow Cross-Website Tracking" available via the Settings app (look for the Moodle app, at the bottom)
==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 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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"
===H5P packages don't work on my site===
You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

This can also happen when you are using the non-official H5P plugin (mod_hvp), in that case you will see the following message: This site is not configured properly for displaying mobile H5P content. Please contact a site administrator so they can apply the suggested configuration changes
=== 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 ===
If you are having issues with MathJax, please enable the [[TeX notation filter]] instead.
=== 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
=== My images, videos or audios stop working after the first time ===
Please make sure the URL you're using on the media file doesn't have any redirect (e.g. http to https), always try to use the final URL. There's a bug in the library we use to download those files, it doesn't work when downloading files with redirects. We have plans to remove that library from the app, but since then please always try to use URLs without redirects.
==Administrators==
=== How can I have my site listed in the Moodle app site finder? ===
Please refer to our [[Moodle app guide for admins]] for instructions.
=== 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 connect with my Android but not with my iPhone (or iOS device) ===
This is usually a server configuration problem caused by this bug: "access-control-allow-origin cannot contain more than one origin"

iOS-based apps do not allow the following header to contain more than one item "Access-Control-Allow-Origin", for example, a header like this: Access-Control-Allow-Origin: *, https://mydomain.com will cause problems

This HTTP header is not valid, according to the specification you can only specify a domain or a "*", this is failing only in iOS (probably because the native Safari implementation is more restrictive):
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin

Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header. Once this server misconfiguration issue is solved, you will be able to access to your site using the app in iOS
===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 are using a web application firewall like StackPath, Barracuda, Cloudflare, Juniper, etc... try to temporary disable it to check if that's the cause. If so, you'll have to whitelist these endpoints: login/token.php, webservice/*, lib/ajax/*, media/player/vimeo/wsplayer.php and /tokenpluginfile.php
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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.
=== Push notifications are not working ===
Please check [[Mobile app notifications#Troubleshooting]]
=== I configured 'QR code access' to automatic login, but the app still asks for credentials ===
Automatic authentication only works for Pro and Premium sites. You can see the app plans [https://moodle.com/app/ in this site].

I you're getting an error saying that the device you're using to connect isn't in the same network as the device that displays the QR code but both devices are connected to the same network, please check the section: [[#ipmismatch:_.27Client_IP_address_mismatch.27|ipmissmatch: 'Client IP address mismatch']].
=== Some users are asked to reauthenticate too often when they browse the site ===
This can happen if the app is sending too many variables to a WebService, e.g. because a course has a large number of sections and/or activities. This error will be fixed in the 3.9.3 version of the app, but you can increase the value of ''max_input_vars'' in ''php.ini'' to fix it in your server.
=== After upgrading to 3.9.5 some of my plugins have stopped working ===
The Moodle App 3.9.5 version comes with some breaking changes for plugins, most of the existing plugins have been updated to support the new changes.

Please check the following list of plugins that should work for 3.9.5 once you have upgraded to the latest version indicated in the document: https://docs.google.com/spreadsheets/d/1E9PqcUBpp9SAfQc_zJtX5tf9GeS3UN76A85IrrB4UDw/edit#gid=0
===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 [[Capabilities/moodle/webservice:createtoken|moodle/webservice:createtoken]] 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.
====ipmismatch: 'Client IP address mismatch'====
This error can appear when a user opens your site in a browser while using the app. This happens if your site is behind a proxy and you're using one of these Moodle versions o higher: 3.5.11, 3.6.9, 3.7.5, 3.8.2, 3.9.0.

To fix it:
# Go to ''Site administration > Administration > Server > HTTP''.
# Find the setting named ''Ignore reverse proxies'' (reverseproxyignore).
# Enter the IP of your proxy (or range of IPs).
# 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 providing as much information as possible (Moodle version, app version, device model and operating system, etc...), then click the Create button
===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 app FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app FAQ

2021-08-07T10:20:44Z

Jleyva: /* I use LineageOS and I'm having problems using the app */

{{Mobile}}
== New Moodle App Plans (starting 2 April 2020) ==
Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal]
==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).
===I use LineageOS and I'm having problems using the app===
LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.
===H5P packages are not working on iOS ===
This is caused by a new feature of iOS 14 called ITP that blocks cookies for external sites embedded in the app (the H5P content is played embedded in an iframe pointing to the Moodle website) unless the user enables a setting in the app to allow those cookies.

The quick workaround is to ask your students using iPhone/iPad with iOS 14 to enable the setting "Allow Cross-Website Tracking" available via the Settings app (look for the Moodle app, at the bottom)

==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 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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"
===H5P packages don't work on my site===
You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"
=== 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 ===
If you are having issues with MathJax, please enable the [[TeX notation filter]] instead.
=== 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
=== My images, videos or audios stop working after the first time ===
Please make sure the URL you're using on the media file doesn't have any redirect (e.g. http to https), always try to use the final URL. There's a bug in the library we use to download those files, it doesn't work when downloading files with redirects. We have plans to remove that library from the app, but since then please always try to use URLs without redirects.
==Administrators==
=== How can I have my site listed in the Moodle app site finder? ===
Please refer to our [[Moodle app guide for admins]] for instructions.
=== 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 connect with my Android but not with my iPhone (or iOS device) ===
This is usually a server configuration problem caused by this bug: "access-control-allow-origin cannot contain more than one origin"

iOS-based apps do not allow the following header to contain more than one item "Access-Control-Allow-Origin", for example, a header like this: Access-Control-Allow-Origin: *, https://mydomain.com will cause problems

This HTTP header is not valid, according to the specification you can only specify a domain or a "*", this is failing only in iOS (probably because the native Safari implementation is more restrictive):
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin

Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header. Once this server misconfiguration issue is solved, you will be able to access to your site using the app in iOS
===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 are using a web application firewall like StackPath, Barracuda, Cloudflare, Juniper, etc... try to temporary disable it to check if that's the cause. If so, you'll have to whitelist these endpoints: login/token.php, webservice/*, lib/ajax/*, media/player/vimeo/wsplayer.php and /tokenpluginfile.php
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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.
=== Push notifications are not working ===
Please check [[Mobile app notifications#Troubleshooting]]
=== I configured 'QR code access' to automatic login, but the app still asks for credentials ===
Automatic authentication only works for Pro and Premium sites. You can see the app plans [https://moodle.com/app/ in this site].

I you're getting an error saying that the device you're using to connect isn't in the same network as the device that displays the QR code but both devices are connected to the same network, please check the section: [[#ipmismatch:_.27Client_IP_address_mismatch.27|ipmissmatch: 'Client IP address mismatch']].
=== Some users are asked to reauthenticate too often when they browse the site ===
This can happen if the app is sending too many variables to a WebService, e.g. because a course has a large number of sections and/or activities. This error will be fixed in the 3.9.3 version of the app, but you can increase the value of ''max_input_vars'' in ''php.ini'' to fix it in your server.
===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 [[Capabilities/moodle/webservice:createtoken|moodle/webservice:createtoken]] 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.
====ipmismatch: 'Client IP address mismatch'====
This error can appear when a user opens your site in a browser while using the app. This happens if your site is behind a proxy and you're using one of these Moodle versions o higher: 3.5.11, 3.6.9, 3.7.5, 3.8.2, 3.9.0.

To fix it:
# Go to ''Site administration > Administration > Server > HTTP''.
# Find the setting named ''Ignore reverse proxies'' (reverseproxyignore).
# Enter the IP of your proxy (or range of IPs).
# 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 providing as much information as possible (Moodle version, app version, device model and operating system, etc...), then click the Create button
===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 app FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app notifications

2021-07-13T08:50:56Z

Jleyva:

{{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''.

Note that from 2 April 2020, there will be certain limitations when using push notifications. Depending on the size of your site and the number of user devices receiving notifications, you may need to sign up to a Premium plan in the Moodle Apps portal: https://apps.moodle.com. For further information, see the official announcement [https://moodle.org/mod/forum/discuss.php?d=397926 Introducing our new Moodle App plans].

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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.

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 not exceeded the maximum number of active devices according to your Moodle App Plan. You can register for free on https://apps.moodle.com to check your current active user devices to check if you need to upgrade to a Pro/Premium plan.
* You have entered an Airnotifier access key in the Mobile settings in the Site administration
* Mobile is enabled in Messaging > Notification settings in the Site administration
* In your config.php, $CFG->noemailever is not set to true (or it does not exist)
* 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]]

Moodle app FAQ

2021-06-21T13:36:19Z

Jleyva: /* I can't get the app to work. What can I do? */

{{Mobile}}

== New Moodle App Plans (starting 2 April 2020) ==

Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal]

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

===I use LineageOS and I'm having problems using the app===

LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.

==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 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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

===H5P packages don't work on my site===

You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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

If you are having issues with MathJax, please enable the [[TeX notation filter]] instead.

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

=== My images, videos or audios stop working after the first time ===

Please make sure the URL you're using on the media file doesn't have any redirect (e.g. http to https), always try to use the final URL. There's a bug in the library we use to download those files, it doesn't work when downloading files with redirects. We have plans to remove that library from the app, but since then please always try to use URLs without redirects.

==Administrators==

=== How can I have my site listed in the Moodle app site finder? ===

Please refer to our [[Moodle app guide for admins]] for instructions.

=== 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 connect with my Android but not with my iPhone (or iOS device) ===

This is usually a server configuration problem caused by this bug: "access-control-allow-origin cannot contain more than one origin"

iOS-based apps do not allow the following header to contain more than one item "Access-Control-Allow-Origin", for example, a header like this: Access-Control-Allow-Origin: *, https://mydomain.com will cause problems

This HTTP header is not valid, according to the specification you can only specify a domain or a "*", this is failing only in iOS (probably because the native Safari implementation is more restrictive):
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin

Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header. Once this server misconfiguration issue is solved, you will be able to access to your site using the app in iOS

===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 are using a web application firewall like StackPath, Barracuda, Cloudflare, Juniper, etc... try to temporary disable it to check if that's the cause. If so, you'll have to whitelist these endpoints: login/token.php, webservice/*, lib/ajax/*, media/player/vimeo/wsplayer.php and /tokenpluginfile.php

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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

=== I configured 'QR code access' to automatic login, but the app still asks for credentials ===

Automatic authentication only works for Pro and Premium sites. You can see the app plans [https://moodle.com/app/ in this site].

I you're getting an error saying that the device you're using to connect isn't in the same network as the device that displays the QR code but both devices are connected to the same network, please check the section: [[#ipmismatch:_.27Client_IP_address_mismatch.27|ipmissmatch: 'Client IP address mismatch']].

=== Some users are asked to reauthenticate too often when they browse the site ===

This can happen if the app is sending too many variables to a WebService, e.g. because a course has a large number of sections and/or activities. This error will be fixed in the 3.9.3 version of the app, but you can increase the value of ''max_input_vars'' in ''php.ini'' to fix it in your server.

===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 [[Capabilities/moodle/webservice:createtoken|moodle/webservice:createtoken]] 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.

====ipmismatch: 'Client IP address mismatch'====

This error can appear when a user opens your site in a browser while using the app. This happens if your site is behind a proxy and you're using one of these Moodle versions o higher: 3.5.11, 3.6.9, 3.7.5, 3.8.2, 3.9.0.

To fix it:

# Go to ''Site administration > Administration > Server > HTTP''.
# Find the setting named ''Ignore reverse proxies'' (reverseproxyignore).
# Enter the IP of your proxy (or range of IPs).
# 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 providing as much information as possible (Moodle version, app version, device model and operating system, etc...), then click the Create button

===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 app FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app FAQ

2021-06-21T13:32:34Z

Jleyva: /* My protected Vimeo videos are not playing in the app */

{{Mobile}}

== New Moodle App Plans (starting 2 April 2020) ==

Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal]

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

===I use LineageOS and I'm having problems using the app===

LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.

==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 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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

===H5P packages don't work on my site===

You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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

If you are having issues with MathJax, please enable the [[TeX notation filter]] instead.

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

=== My images, videos or audios stop working after the first time ===

Please make sure the URL you're using on the media file doesn't have any redirect (e.g. http to https), always try to use the final URL. There's a bug in the library we use to download those files, it doesn't work when downloading files with redirects. We have plans to remove that library from the app, but since then please always try to use URLs without redirects.

==Administrators==

=== How can I have my site listed in the Moodle app site finder? ===

Please refer to our [[Moodle app guide for admins]] for instructions.

=== 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 connect with my Android but not with my iPhone (or iOS device) ===

This is usually a server configuration problem caused by this bug: "access-control-allow-origin cannot contain more than one origin"

iOS-based apps do not allow the following header to contain more than one item "Access-Control-Allow-Origin", for example, a header like this: Access-Control-Allow-Origin: *, https://mydomain.com will cause problems

This HTTP header is not valid, according to the specification you can only specify a domain or a "*", this is failing only in iOS (probably because the native Safari implementation is more restrictive):
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin

Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header. Once this server misconfiguration issue is solved, you will be able to access to your site using the app in iOS

===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 are using a web application firewall like StackPath, Barracuda, Cloudflare, Juniper, etc... try to temporary disable it to check if that's the cause. If so, you'll have to whitelist these endpoints: login/token.php, webservice/*, lib/ajax/*, and /tokenpluginfile.php

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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

=== I configured 'QR code access' to automatic login, but the app still asks for credentials ===

Automatic authentication only works for Pro and Premium sites. You can see the app plans [https://moodle.com/app/ in this site].

I you're getting an error saying that the device you're using to connect isn't in the same network as the device that displays the QR code but both devices are connected to the same network, please check the section: [[#ipmismatch:_.27Client_IP_address_mismatch.27|ipmissmatch: 'Client IP address mismatch']].

=== Some users are asked to reauthenticate too often when they browse the site ===

This can happen if the app is sending too many variables to a WebService, e.g. because a course has a large number of sections and/or activities. This error will be fixed in the 3.9.3 version of the app, but you can increase the value of ''max_input_vars'' in ''php.ini'' to fix it in your server.

===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 [[Capabilities/moodle/webservice:createtoken|moodle/webservice:createtoken]] 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.

====ipmismatch: 'Client IP address mismatch'====

This error can appear when a user opens your site in a browser while using the app. This happens if your site is behind a proxy and you're using one of these Moodle versions o higher: 3.5.11, 3.6.9, 3.7.5, 3.8.2, 3.9.0.

To fix it:

# Go to ''Site administration > Administration > Server > HTTP''.
# Find the setting named ''Ignore reverse proxies'' (reverseproxyignore).
# Enter the IP of your proxy (or range of IPs).
# 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 providing as much information as possible (Moodle version, app version, device model and operating system, etc...), then click the Create button

===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 app FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app guide for admins

2021-06-17T17:15:08Z

Jleyva: /* Web services token duration */

{{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). Please, note this is not necessary since Moodle 3.7

===Is your site behind a proxy, or load balancer or complex network infrastructure?===
In that case, you may need to configure the "Ignore reserver proxies" settings in Site administration > Administration > Server > HTTP

==Register your site on the Moodle Apps Portal==

We strongly recommend you to register your site for free on the Moodle Apps portal: https://apps.moodle.com

You will be able to retrieve statistics like the number of active user devices receiving Push Notifications and upgrade to a Pro/Premium plan for enjoying exclusive features.

==Have your site listed in the Moodle app site finder==

The Moodle apps site finder enables a user to easily find their Moodle site by entering the name (no need to enter the site URL)

===How can I have my site listed in the Moodle app site finder?===

Your site will be automatically listed in the site finder if:
* either your site is registered and listed with a link on [https://stats.moodle.org/sites/ Registered sites] and has over five hundred mobile users and you have been using the Moodle app for over a year
* or you have purchased a [https://moodle.com/app/ Pro or Premium Moodle app subscription].

You can arrange for your site to be listed in the site finder as follows:
* If your site is hosted by a Moodle Partner, please contact them to request for your site to be listed.
* If you have a MoodleCloud site, please log in to the Moodle Apps Portal where you will find an option to have your site listed.

Otherwise, to have your site listed in the site finder, you need to purchase a [https://moodle.com/app/ Pro or Premium Moodle app subscription] from the Moodle Apps Portal.

===I don’t want my site listed in the Moodle app site finder. How can I remove it?===

You can remove your site from the site finder as follows:

# Log in to the [https://apps.moodle.com/ Moodle Apps Portal]. (If you don’t yet have an account, you can create one for free.)
# Go to ‘App customisation’ -> ‘Site Listing’ and uncheck the option ‘Visible’ then save changes.

Your site will then be immediately removed from the site finder.

Alternatively, you can remove your site from the site finder by updating your site registration:

# Log in to your Moodle site as admin and go to ‘Site administration’ -> Registration.
# Change ‘Site listing’ to either ‘Do not list my site’ or ‘Only display my site name’.

Your site will then be removed from the site finder within 24 hours.

==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 [https://moodle.com/branded-app Branded Moodle Mobile app] service, please visit https://moodle.com/app/ 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 ==

'''IMPORTANT''': Please notice that the type and number of features that you can customise depend on your Moodle Apps plan, you can register for free on https://apps.moodle.com to check the different plans.

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
* Blocks
* Comments
* Ratings
* Tags
* Create new account
* Responsive menu items (new in 3.7)
* Main menu
** Site home
** My courses
** Dashboard
** Calendar
** Notifications
** Messages
** Grades
** My learning plans
** Blog
** Files
** Web page
** Help
* Course
** Blocks
** Blog
** Search
** Competencies
** Participants
** Grades
** Course completion
** Notes
** Download course (new in 3.5)
** Download courses (new in 3.5)
* User
** Blog
** Badges
** Competencies
** Course completion
** Grades
** Send message
** Add contact
** Block contact
** Add a new note
** User picture
* Files
** Private files
** Ste files
** Upload
* Modules (Each module can be disabled separately)
* Blocks (Each block available in the app can be disabled separately)

===Custom menu items===

Additional items can be added to the app main menu (the more 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), icon (optional, the name of the icon from https://ionicons.com) 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.

Example of a menu item (it will display a home icon followed by Academy information linking to the URL indicated):
Academy information|https://yoursite.com/mod/page/view.php?id=X |app|en|home

===Responsive menu items===

From 3.7 onwards menu items on bottom tabs are moved to the side of the screen on big screens. Also the number of items displayed on the menu may vary:

* On small screens (usually phones) from 2 to 5 items will be displayed depending on the size of the screen.
* On big screens (usually tablets an desktop version) more than 2 items will be displayed without limit.

If '''Responsive menu items''' is selected in Disabled features items will be displayed in side of bottom anyway but 5 items will be displayed in all cases without depending on the size of the screen.

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

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

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

For example:

"core.user.student": v"Student",

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

==Statistics==

To retrieve information about the Moodle app usage, site administrators and teachers can check the system, course or activity logs.

Among the log filters, there is a field called "All sources" with an option "Web Service" that can be used to filter the entry logs generated by the mobile application.

You can compare the number of log entries generated by the "Web" versus "Web Service" (mobile app) to have an overall idea about how your users use the platform.

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

==App's cache==

The app caches WebService requests to decrease data usage and increase the app's speed. When the app needs to get some data from Moodle, it will use a cached request as long as it isn't expired.

This cache was improved in Moodle App 3.7.0, now there are several cache times depending on the WS being called. This means that some requests will expire more often than others. Also, if the user isn't using a WiFi connection, the expiration time will also be longer to decrease the data usage. These cache times cannot be configured using a Moodle setting.

==See also==

* [[Moodle Mobile FAQ]] for other administration-related mobile app questions.
* [[Moodle app security]]
* [[: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 FAQ

2021-05-27T16:52:02Z

Jleyva: /* Maths notation is not displaying correctly in the app */

{{Mobile}}

== New Moodle App Plans (starting 2 April 2020) ==

Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal]

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

===I use LineageOS and I'm having problems using the app===

LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.

==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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

===H5P packages don't work on my site===

You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOWALL"

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

If you are having issues with MathJax, please enable the [[TeX notation filter]] instead.

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

=== My images, videos or audios stop working after the first time ===

Please make sure the URL you're using on the media file doesn't have any redirect (e.g. http to https), always try to use the final URL. There's a bug in the library we use to download those files, it doesn't work when downloading files with redirects. We have plans to remove that library from the app, but since then please always try to use URLs without redirects.

==Administrators==

=== How can I have my site listed in the Moodle app site finder? ===

Please refer to our [[Moodle app guide for admins]] for instructions.

=== 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 connect with my Android but not with my iPhone (or iOS device) ===

This is usually a server configuration problem caused by this bug: "access-control-allow-origin cannot contain more than one origin"

iOS-based apps do not allow the following header to contain more than one item "Access-Control-Allow-Origin", for example, a header like this: Access-Control-Allow-Origin: *, https://mydomain.com will cause problems

This HTTP header is not valid, according to the specification you can only specify a domain or a "*", this is failing only in iOS (probably because the native Safari implementation is more restrictive):
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin

Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header. Once this server misconfiguration issue is solved, you will be able to access to your site using the app in iOS

===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 are using a web application firewall like StackPath, Barracuda, Cloudflare, Juniper, etc... try to temporary disable it to check if that's the cause. If so, you'll have to whitelist these endpoints: login/token.php, webservice/*, lib/ajax/*, and /tokenpluginfile.php

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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

=== I configured 'QR code access' to automatic login, but the app still asks for credentials ===

Automatic authentication only works for Pro and Premium sites. You can see the app plans [https://moodle.com/app/ in this site].

I you're getting an error saying that the device you're using to connect isn't in the same network as the device that displays the QR code but both devices are connected to the same network, please check the section: [[#ipmismatch:_.27Client_IP_address_mismatch.27|ipmissmatch: 'Client IP address mismatch']].

=== Some users are asked to reauthenticate too often when they browse the site ===

This can happen if the app is sending too many variables to a WebService, e.g. because a course has a large number of sections and/or activities. This error will be fixed in the 3.9.3 version of the app, but you can increase the value of ''max_input_vars'' in ''php.ini'' to fix it in your server.

===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 [[Capabilities/moodle/webservice:createtoken|moodle/webservice:createtoken]] 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.

====ipmismatch: 'Client IP address mismatch'====

This error can appear when a user opens your site in a browser while using the app. This happens if your site is behind a proxy and you're using one of these Moodle versions o higher: 3.5.11, 3.6.9, 3.7.5, 3.8.2, 3.9.0.

To fix it:

# Go to ''Site administration > Administration > Server > HTTP''.
# Find the setting named ''Ignore reverse proxies'' (reverseproxyignore).
# Enter the IP of your proxy (or range of IPs).
# 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 providing as much information as possible (Moodle version, app version, device model and operating system, etc...), then click the Create button

===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 app FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app guide for admins

2021-04-08T16:31:03Z

Jleyva: /* Custom menu items */

{{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). Please, note this is not necessary since Moodle 3.7

===Is your site behind a proxy, or load balancer or complex network infrastructure?===
In that case, you may need to configure the "Ignore reserver proxies" settings in Site administration > Administration > Server > HTTP

==Register your site on the Moodle Apps Portal==

We strongly recommend you to register your site for free on the Moodle Apps portal: https://apps.moodle.com

You will be able to retrieve statistics like the number of active user devices receiving Push Notifications and upgrade to a Pro/Premium plan for enjoying exclusive features.

==Have your site listed in the Moodle app site finder==

The Moodle apps site finder enables a user to easily find their Moodle site by entering the name (no need to enter the site URL)

===How can I have my site listed in the Moodle app site finder?===

Your site will be automatically listed in the site finder if:
* either your site is registered and listed with a link on [https://stats.moodle.org/sites/ Registered sites] and has over five hundred mobile users and you have been using the Moodle app for over a year
* or you have purchased a [https://moodle.com/app/ Pro or Premium Moodle app subscription].

You can arrange for your site to be listed in the site finder as follows:
* If your site is hosted by a Moodle Partner, please contact them to request for your site to be listed.
* If you have a MoodleCloud site, please log in to the Moodle Apps Portal where you will find an option to have your site listed.

Otherwise, to have your site listed in the site finder, you need to purchase a [https://moodle.com/app/ Pro or Premium Moodle app subscription] from the Moodle Apps Portal.

===I don’t want my site listed in the Moodle app site finder. How can I remove it?===

You can remove your site from the site finder as follows:

# Log in to the [https://apps.moodle.com/ Moodle Apps Portal]. (If you don’t yet have an account, you can create one for free.)
# Go to ‘App customisation’ -> ‘Site Listing’ and uncheck the option ‘Visible’ then save changes.

Your site will then be immediately removed from the site finder.

Alternatively, you can remove your site from the site finder by updating your site registration:

# Log in to your Moodle site as admin and go to ‘Site administration’ -> Registration.
# Change ‘Site listing’ to either ‘Do not list my site’ or ‘Only display my site name’.

Your site will then be removed from the site finder within 24 hours.

==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 [https://moodle.com/branded-app Branded Moodle Mobile app] service, please visit https://moodle.com/app/ 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 ==

'''IMPORTANT''': Please notice that the type and number of features that you can customise depend on your Moodle Apps plan, you can register for free on https://apps.moodle.com to check the different plans.

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
* Blocks
* Comments
* Ratings
* Tags
* Create new account
* Responsive menu items (new in 3.7)
* Main menu
** Site home
** My courses
** Dashboard
** Calendar
** Notifications
** Messages
** Grades
** My learning plans
** Blog
** Files
** Web page
** Help
* Course
** Blocks
** Blog
** Search
** Competencies
** Participants
** Grades
** Course completion
** Notes
** Download course (new in 3.5)
** Download courses (new in 3.5)
* User
** Blog
** Badges
** Competencies
** Course completion
** Grades
** Send message
** Add contact
** Block contact
** Add a new note
** User picture
* Files
** Private files
** Ste files
** Upload
* Modules (Each module can be disabled separately)
* Blocks (Each block available in the app can be disabled separately)

===Custom menu items===

Additional items can be added to the app main menu (the more 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), icon (optional, the name of the icon from https://ionicons.com) 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.

Example of a menu item (it will display a home icon followed by Academy information linking to the URL indicated):
Academy information|https://yoursite.com/mod/page/view.php?id=X |app|en|home

===Responsive menu items===

From 3.7 onwards menu items on bottom tabs are moved to the side of the screen on big screens. Also the number of items displayed on the menu may vary:

* On small screens (usually phones) from 2 to 5 items will be displayed depending on the size of the screen.
* On big screens (usually tablets an desktop version) more than 2 items will be displayed without limit.

If '''Responsive menu items''' is selected in Disabled features items will be displayed in side of bottom anyway but 5 items will be displayed in all cases without depending on the size of the screen.

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

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

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

For example:

"core.user.student": v"Student",

means that the string "Student" has string identifier "core.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.)

==App's cache==

The app caches WebService requests to decrease data usage and increase the app's speed. When the app needs to get some data from Moodle, it will use a cached request as long as it isn't expired.

This cache was improved in Moodle App 3.7.0, now there are several cache times depending on the WS being called. This means that some requests will expire more often than others. Also, if the user isn't using a WiFi connection, the expiration time will also be longer to decrease the data usage. These cache times cannot be configured using a Moodle setting.

==See also==

* [[Moodle Mobile FAQ]] for other administration-related mobile app questions.
* [[Moodle app security]]
* [[: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]]

Fil:Moodle features students.pdf

2021-01-18T19:24:09Z

Jleyva: Jleyva uploaded a new version of File:Moodle features students.pdf

Moodle app features

2020-11-02T11:18:17Z

Jleyva: /* Features summary */

{{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 app 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>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile39h5p.png|600px]]
<div class="caption">
<h4>Play H5P on and off-line</h4>
<p>Users can now play [[Moodle_app_H5P_support|H5P packages]] on and off-line, including grading for the H5P activity.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile39qr.png|600px]]
<div class="caption">
<h4>Scan QRs to login or open courses/activities in the app</h4>
<p>The app now includes a QR reader so users can easily authenticate in their site or open certain courses or activities in the app.</p>
</div>
</div>
</li>
</ul>
</div>
====Features summary====

Please, download the following document that includes a detailed features comparision table between Moodle LMS and the Moodle app: [[:File:Moodle_features_students.pdf|Moodle features for students]]

==Activities & Resources Support==

[[File:moodlemobile_activities_resources.png|600px]]

=== Languages ===

The Moodle app is being translated into an increasing number of languages. As of June 2020, 47 languages are available:

(ar) عربي, (bg) Български, (ca) Català, (cs) Čeština, (da) Dansk, (de) Deutsch, (de-du) Deutsch - Du, (el) Ελληνικά, (en) English, (en-us) English - United States, (es) Español, (es-mx) Español - México, (eu) Euskara, (fa) فارسی, (fi) Suomi, (fr) Français, (he) עברית, (hu) magyar, (id) Indonesian, (it) Italiano, (ja) 日本語, (km) ខ្មែរ, (kn) ಕನ್ನಡ, (ko) 한국어, (lt) Lietuvių, (lv) Latviešu, (mn) मराठी, (mr) मराठी, (nl) Nederlands, (no) Norsk - bokmål, (pl) Polski, (pt-br) Português - Brasil, (pt) Português - Portugal, (pt-br) Português - Brasil, (ro) Română, (ru) Русский, (sl) Slovenščina, (sr-cr) Српски, (sr-lt) Srpski, (sv) Svenska, (tg) Тоҷикӣ, (tr) Türkçe, (uk) Українська, (vi) Vietnamese, (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

Fil:Moodle features students.pdf

2020-11-02T11:14:08Z

Jleyva:

Moodle app guide for admins

2020-10-31T21:43:55Z

Jleyva: /* 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). Please, note this is not necessary since Moodle 3.7

===Is your site behind a proxy, or load balancer or complex network infrastructure?===
In that case, you may need to configure the "Ignore reserver proxies" settings in Site administration > Administration > Server > HTTP

==Register your site on the Moodle Apps Portal==

We strongly recommend you to register your site for free on the Moodle Apps portal: https://apps.moodle.com

You will be able to retrieve statistics like the number of active user devices receiving Push Notifications and upgrade to a Pro/Premium plan for enjoying exclusive features.

==Have your site listed in the Moodle app site finder==

The Moodle apps site finder enables a user to easily find their Moodle site by entering the name (no need to enter the site URL)

===How can I have my site listed in the Moodle app site finder?===

Your site will be automatically listed in the site finder if:
* either your site is registered and listed with a link on [https://stats.moodle.org/sites/ Registered sites] and has over five hundred mobile users and you have been using the Moodle app for over a year
* or you have purchased a [https://moodle.com/app/ Pro or Premium Moodle app subscription].

You can arrange for your site to be listed in the site finder as follows:
* If your site is hosted by a Moodle Partner, please contact them to request for your site to be listed.
* If you have a MoodleCloud site, please log in to the Moodle Apps Portal where you will find an option to have your site listed.

Otherwise, to have your site listed in the site finder, you need to purchase a [https://moodle.com/app/ Pro or Premium Moodle app subscription] from the Moodle Apps Portal.

===I don’t want my site listed in the Moodle app site finder. How can I remove it?===

You can remove your site from the site finder as follows:

# Log in to the [https://apps.moodle.com/ Moodle Apps Portal]. (If you don’t yet have an account, you can create one for free.)
# Go to ‘App customisation’ -> ‘Site Listing’ and uncheck the option ‘Visible’ then save changes.

Your site will then be immediately removed from the site finder.

Alternatively, you can remove your site from the site finder by updating your site registration:

# Log in to your Moodle site as admin and go to ‘Site administration’ -> Registration.
# Change ‘Site listing’ to either ‘Do not list my site’ or ‘Only display my site name’.

Your site will then be removed from the site finder within 24 hours.

==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 [https://moodle.com/branded-app Branded Moodle Mobile app] service, please visit https://moodle.com/app/ 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 ==

'''IMPORTANT''': Please notice that the type and number of features that you can customise depend on your Moodle Apps plan, you can register for free on https://apps.moodle.com to check the different plans.

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
* Blocks
* Comments
* Ratings
* Tags
* Create new account
* Responsive menu items (new in 3.7)
* Main menu
** Site home
** My courses
** Dashboard
** Calendar
** Notifications
** Messages
** Grades
** My learning plans
** Blog
** Files
** Web page
** Help
* Course
** Blocks
** Blog
** Search
** Competencies
** Participants
** Grades
** Course completion
** Notes
** Download course (new in 3.5)
** Download courses (new in 3.5)
* User
** Blog
** Badges
** Competencies
** Course completion
** Grades
** Send message
** Add contact
** Block contact
** Add a new note
** User picture
* Files
** Private files
** Ste files
** Upload
* Modules (Each module can be disabled separately)
* Blocks (Each block available in the app can be disabled separately)

===Custom menu items===

Additional items can be added to the app main menu (the more 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.

===Responsive menu items===

From 3.7 onwards menu items on bottom tabs are moved to the side of the screen on big screens. Also the number of items displayed on the menu may vary:

* On small screens (usually phones) from 2 to 5 items will be displayed depending on the size of the screen.
* On big screens (usually tablets an desktop version) more than 2 items will be displayed without limit.

If '''Responsive menu items''' is selected in Disabled features items will be displayed in side of bottom anyway but 5 items will be displayed in all cases without depending on the size of the screen.

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

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

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

For example:

"core.user.student": v"Student",

means that the string "Student" has string identifier "core.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.)

==App's cache==

The app caches WebService requests to decrease data usage and increase the app's speed. When the app needs to get some data from Moodle, it will use a cached request as long as it isn't expired.

This cache was improved in Moodle App 3.7.0, now there are several cache times depending on the WS being called. This means that some requests will expire more often than others. Also, if the user isn't using a WiFi connection, the expiration time will also be longer to decrease the data usage. These cache times cannot be configured using a Moodle setting.

==See also==

* [[Moodle Mobile FAQ]] for other administration-related mobile app questions.
* [[Moodle app security]]
* [[: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 security

2020-10-31T21:43:25Z

Jleyva:

{{Mobile}}

The Moodle app is a hybrid app (uses web-technologies) developed on top of a well-tested widely used framework called "Cordova" that provides a robust container for HTML apps.

Security is very important to us, this is why we follow the Cordova and Moodle security recommendations:
* Cordova: https://cordova.apache.org/docs/en/latest/guide/appdev/security/
* Moodle: https://docs.moodle.org/dev/Security (when developing Web Services)

== How we approach security ==

* Login and authorisation
** Authorisation is done via temporary access tokens. The duration of the access tokens can be configured via Moodle settings.
** Single Sign-On (or auto-login) from the app to the site is done using a special private token (that is obtained and stored when the user log-in with the app)
** Single Sign-On (or auto-login) from the app to the site has several additional restrictions (like limiting it in only several times per hour)
** QR-Login is done using temporary tokens that require the user to be in the same network (IP address) and it is limited to 10 minutes time
** For retrieving files from the server (images or other assets), a different non-authentication token is used.

* Permissions
** The app only has access to a subset of Moodle functionalities (available through the Moodle App Service)
** Privileges escalation is not possible via the Web Services layer since all the operations are done in a non-privileged way, permissions are checked based on the currently authenticated user.
** Even if a temporary access token for an admin (or privileged user) was hijacked, it wouldn’t be possible for the attacker to access to site administration functionality via the Moodle site.

Because the app is a Webservices client we recommend to enable it only under https and use the following settings to enforce security like:
* Enable only certain roles to be able to access via the app via system capabilities (avoid site administrators)
* Use Moodle security settings to reduce the expiration time of WebService access tokens (so the user has to authenticate again)
* Apart from that, the Cordova framework enforces security adding restrictions like avoiding connecting to sites running non-trusted certificates.

== What is the Moodle app security issues process? ==

* We follow the standard Moodle security process: https://docs.moodle.org/dev/Moodle_security_procedures
* There is only one relevant difference: security patches are applied immediately in the next app release or in an emergency release (depending the risks attached to the issue)

== Do you run security/penetration/pentest or static code analysis tests? ==

We do occasionally receive automated vulnerability reports of this nature. The issue with automated tools is that they usually output generic results that indicate where an exploit may be possible, which means the results often contain many false positives.

As mentioned above our app is built on top of Cordova, we rely on the Cordova framework developers to detect any native code issue.

You can do a search in the Cordova project tracker to see that several runs with the Static Code Analysis Veracode tool created issues that have been already solved, see: https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20text%20~%20%22veracode%22%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC

Unfortunately, those Veracode runs are not publicly available because most of the time are run by external parties using the framework.

Please, note also that there are CVE codes for Cordova security issues: https://www.cvedetails.com/product/27153/Apache-Cordova.html?vendor_id=4

Moodle app security

2020-10-30T10:00:13Z

Jleyva: /* How we approach security */

{{Mobile}}

The Moodle app is a hybrid app (uses web-technologies) developed on top of a well-tested widely used framework called "Cordova" that provides a robust container for HTML apps.

Security is very important to us, this is why we follow the Cordova and Moodle security recommendations:
* Cordova: https://cordova.apache.org/docs/en/latest/guide/appdev/security/
* Moodle: https://docs.moodle.org/dev/Security (when developing Web Services)

== How we approach security ==

* Login and authorisation
** Authorisation is done via temporary access tokens. The duration of the access tokens can be configured via Moodle settings.
** Single Sign-On (or auto-login) from the app to the site is done using a special private token (that is obtained and stored when the user log-in with the app)
** Single Sign-On (or auto-login) from the app to the site has several additional restrictions (like limiting it in only several times per hour)
** QR-Login is done using temporary tokens and requires the user to be in the same network (IP address) and it is limited to 10 minutes time
** For retrieving files from the server (images or other assets), a different non-authentication token is used.

* Permissions
** The app only has access to a subset of Moodle functionalities (available through the Moodle App Service)
** Privileges escalation is not possible via the Web Services layer since all the operations are done in a non-privileged way, permissions are checked based on the currently authenticated user.
** Even if a temporary access token for an admin (or privileged user) is hijacked, it won't be possible for the attacker to access to site administration functionality via the Moodle site.

Because the app is a Webservices client we recommend to enable it only under https and use the different settings to enforce security like:
* Enable only certain roles to be able to access via the app via system capabilities (avoid site administrators)
* Use Moodle security settings to reduce the expiration time of WebService access tokens (so the user has to authenticate again)
* Apart from that, the Cordova framework enforces security with restrictions like avoiding connecting to sites running non-trusted certificates.

== Where is the Moodle app security issues process? ==

* We follow the standard Moodle security process: https://docs.moodle.org/dev/Moodle_security_procedures
* There is only one relevant difference: security patches are applied immediately in the next app release or in an emergency release (depending the risks attached to the issue)

== Do you run security/penetration/pentest or static code analys tests? ==

We do occasionally receive automated vulnerability reports of this nature. The issue with automated tools is that generally, they output generic results that indicate where an exploit may be possible, which means the results often contain many false positives.

As mentioned above our app is built on top of Cordova, we rely on the Cordova framework developers to detect any native code issue.

You can do a search in the Cordova project tracker to see that several runs with the Static Code Analysis Veracode tool created issues that have been already solved, see: https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20text%20~%20%22veracode%22%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC

Unfortunately, those Veracode runs are not publicly available because most of the time are run by external parties using the framework.

Please, note also that there are CVE codes for Cordova security issues: https://www.cvedetails.com/product/27153/Apache-Cordova.html?vendor_id=4

Moodle app security

2020-10-30T09:58:46Z

Jleyva:

{{Mobile}}

The Moodle app is a hybrid app (uses web-technologies) developed on top of a well-tested widely used framework called "Cordova" that provides a robust container for HTML apps.

Security is very important to us, this is why we follow the Cordova and Moodle security recommendations:
* Cordova: https://cordova.apache.org/docs/en/latest/guide/appdev/security/
* Moodle: https://docs.moodle.org/dev/Security (when developing Web Services)

== How we approach security ==

* Login and authorisation
** Authorisation is done via temporary access tokens. The duration of the access tokens can be configured via Moodle settings.
** Single Sign-On (or auto-login) from the app to the site is done using a special private token (that is obtained only the first time the user log-in with the app)
** Single Sign-On (or auto-login) from the app to the site has several additional restrictions (like limiting it in only several times per hour)
** QR-Login is done using temporary tokens and requires the user to be in the same network (IP address) and it is limited to 10 minutes time
** For retrieving files from the server (images or other assets), a different non-authentication token is used.

* Permissions
** The app only has access to a subset of Moodle functionalities (available through the Moodle App Service)
** Privileges escalation is not possible via the Web Services layer since all the operations are done in a non-privileged way, permissions are checked based on the currently authenticated user.
** Even if a temporary access token for an admin (or privileged user) is hijacked, it won't be possible for the attacker to access to site administration functionality via the Moodle site.

Because the app is a Webservices client we recommend to enable it only under https and use the different settings to enforce security like:
* Enable only certain roles to be able to access via the app via system capabilities (avoid site administrators)
* Use Moodle security settings to reduce the expiration time of WebService access tokens (so the user has to authenticate again)
* Apart from that, the Cordova framework enforces security with restrictions like avoiding connecting to sites running non-trusted certificates.

== Where is the Moodle app security issues process? ==

* We follow the standard Moodle security process: https://docs.moodle.org/dev/Moodle_security_procedures
* There is only one relevant difference: security patches are applied immediately in the next app release or in an emergency release (depending the risks attached to the issue)

== Do you run security/penetration/pentest or static code analys tests? ==

We do occasionally receive automated vulnerability reports of this nature. The issue with automated tools is that generally, they output generic results that indicate where an exploit may be possible, which means the results often contain many false positives.

As mentioned above our app is built on top of Cordova, we rely on the Cordova framework developers to detect any native code issue.

You can do a search in the Cordova project tracker to see that several runs with the Static Code Analysis Veracode tool created issues that have been already solved, see: https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20text%20~%20%22veracode%22%20ORDER%20BY%20priority%20DESC%2C%20updated%20DESC

Unfortunately, those Veracode runs are not publicly available because most of the time are run by external parties using the framework.

Please, note also that there are CVE codes for Cordova security issues: https://www.cvedetails.com/product/27153/Apache-Cordova.html?vendor_id=4

Moodle app security

2020-10-30T09:33:03Z

Jleyva: Created page with "{{Mobile}} The Moodle app is a hybrid app (uses web-technologies) developed on top of a well-tested widely used framework called "Cordova" that provides a robust container fo..."

Moodle app offline features

2020-10-27T13:13:29Z

Jleyva: /* Course features offline support */

{{Mobile}}

== Introduction ==

We live in a hyper-connected 5G world and we think the Internet is everywhere, but we usually forget about:

* Underdeveloped and developing countries
* Rural areas in big countries
* Kids with restricted data plans
* Shared internet connection in schools/classrooms
* Aerial and maritime traffic

One of the most powerful features of the Moodle App is its ability for working offline.

Students can browse contents offline and take activities, once the student is connected back to the Internet, the app will synchronise all the necessary information with the Moodle site.

== How does the app store data for offline use? ==

* While browsing the site and its contents
* External contents (e.g youtube videos) are not downloaded
* Embedded files (audio, video) are not always downloaded (it depends on the user connection and file size)
* When the user downloads content by the download icon
** The user can use the “cloud” icon to download specific content or a complete section or course
** The user gets alerted when downloading large files
** If a resource has been updated in the server, a refresh icon will be shown.

'''Why doesn’t the app prefetch/cache more data?'''
# Because the user may have a monthly data plan
# Because the device storage space may be limited
# Massive data download might impact on the server performance

'''What does the app consider to be a large file?'''
* If the user is connected to a Wi-Fi network: large file >= 20MB
*If the user is connected to a data network: large file >= 2MB

== Course features offline support ==

* All the course resources can be downloaded for offline (except URL)
* All the course activities are supported (except Chat and External tool)
* Community plugins usually don’t work offline
* Some functionality for certain activity modules does not work offline, see bellow for more information.

=== Assestment ===

The offline mode is disabled by default in Quiz and Lesson, however, the teacher can decide if they want to enable it.
* A quiz may be attempted offline only if:
** There is no time limit set
** The question behavior is deferred feedback (with or without CBM) only
** There is no network address requirement

For detailed information about the quiz module and how it works offline please read: [[Moodle Mobile quiz offline attempts]]

=== Other activities ===
* SCORM and H5P packages are always fully downloaded to the user’s device
* Wiki edition is not supported offline
* Glossaries entries can’t be deleted/updated offline
* Text assignment submissions can’t be edited offline
* Activities configured with availability conditions cannot be/are not downloaded for offline (the user will have to reconnect to be able to see activities unlocked by conditions recently met)

== What other features work offline?==

Apart from resources and activities certain course and site functionality are also available offline.

The offline support for completion is only for marking courses or activities completed (when viewed)

Conditioned activities are not downloaded for offline

* Participants
* Grades
* Completion
* Notes
* Messaging
* Notifications
* Calendar events
* Private files
* Badges
* Blogs
* Rating
* Comments

== Synchronisation ==

Synchronisation works differently depending on the device
* Android: The app must be opened but it can be in the background (you can be using a different app).
* iOS (iPhone, iPad): The app must be opened and in the foreground (it has to be the device active app).
* Desktop: The app must be opened but it can be in the background (minimised).

🔋The battery is the key factor, mobile OS limits its usage

There are two ways of synchronising data:

* Automatic
** Runs regularly, every 10 minutes
* Manual
** The user will see a message indicating there is data pending synchronisation

What happens with the student activity after synchronisation?
Actions performed offline are logged and stored into the system with the synchronisation time, not with the time when they happened.
We are exploring ways to improve reporting via Moodle’s xAPI support.

For more information about how synchronisation works visit: [[Moodle app synchronization]]

== Configuration options ==

Site administrators can decide if they want:
* Disable completely the offline mode
* Disable all courses downloading
* Disable individual courses downloading

For disabling the previous features, please read: [[Moodle app guide for admins]]

Users can decide if they want to allow synchronisation only when connected to a Wi-Fi network or also when using a data network

==Moodle App Plans ==

When using the Moodle App, site admins can choose to subscribe to a paid plan or use the free version.

Plans limit the download of complete courses in one click.

Students can still download individual contents or sections.

We recommend a Premium plan subscription: https://apps.moodle.com

== See also ==
* [[Moodle app SCORM player]]
* [[Moodle app H5P support]]
* [[Moodle Mobile quiz]]
* [[Moodle app synchronization]]

Moodle app offline features

2020-10-27T13:10:01Z

Jleyva: /* See also */

{{Mobile}}

== Introduction ==

We live in a hyper-connected 5G world and we think the Internet is everywhere, but we usually forget about:

* Underdeveloped and developing countries
* Rural areas in big countries
* Kids with restricted data plans
* Shared internet connection in schools/classrooms
* Aerial and maritime traffic

One of the most powerful features of the Moodle App is its ability for working offline.

Students can browse contents offline and take activities, once the student is connected back to the Internet, the app will synchronise all the necessary information with the Moodle site.

== How does the app store data for offline use? ==

* While browsing the site and its contents
* External contents (e.g youtube videos) are not downloaded
* Embedded files (audio, video) are not always downloaded (it depends on the user connection and file size)
* When the user downloads content by the download icon
** The user can use the “cloud” icon to download specific content or a complete section or course
** The user gets alerted when downloading large files
** If a resource has been updated in the server, a refresh icon will be shown.

'''Why doesn’t the app prefetch/cache more data?'''
# Because the user may have a monthly data plan
# Because the device storage space may be limited
# Massive data download might impact on the server performance

'''What does the app consider to be a large file?'''
* If the user is connected to a Wi-Fi network: large file >= 20MB
*If the user is connected to a data network: large file >= 2MB

== Course features offline support ==

* All the course resources can be downloaded for offline (except URL)
* All the course activities are supported (except Chat and External tool)
* Community plugins usually don’t work offline

=== Assestment ===

The offline mode is disabled by default in Quiz and Lesson, however the teacher can decide if they want to enable it.
* A quiz may be attempted offline only if:
** There is no time limit set
** The question behavior is deferred feedback (with or without CBM) only
** There is no network address requirement

For detailed information about the quiz module and how it works offline please read: [[Moodle Mobile quiz offline attempts]]

=== Other activities ===
* SCORM and H5P packages are downloaded to the user’s device
* Wiki edition is not supported offline
* Glossaries entries can’t be deleted/updated offline
* Text assignment submissions can’t be edited offline
* Activities configured with availability conditions cannot be/are not downloaded for offline

== What other features work offline?==

Apart from resources and activities certain course and site functionality are also available offline.

The offline support for completion is only for marking courses or activities completed (when viewed)

Conditioned activities are not downloaded for offline

* Participants
* Grades
* Completion
* Notes
* Messaging
* Notifications
* Calendar events
* Private files
* Badges
* Blogs
* Rating
* Comments

== Synchronisation ==

Synchronisation works differently depending on the device
* Android: The app must be opened but it can be in the background (you can be using a different app).
* iOS (iPhone, iPad): The app must be opened and in the foreground (it has to be the device active app).
* Desktop: The app must be opened but it can be in the background (minimised).

🔋The battery is the key factor, mobile OS limits its usage

There are two ways of synchronising data:

* Automatic
** Runs regularly, every 10 minutes
* Manual
** The user will see a message indicating there is data pending synchronisation

What happens with the student activity after synchronisation?
Actions performed offline are logged and stored into the system with the synchronisation time, not with the time when they happened.
We are exploring ways to improve reporting via Moodle’s xAPI support.

For more information about how synchronisation works visit: [[Moodle app synchronization]]

== Configuration options ==

Site administrators can decide if they want:
* Disable completely the offline mode
* Disable all courses downloading
* Disable individual courses downloading

For disabling the previous features, please read: [[Moodle app guide for admins]]

Users can decide if they want to allow synchronisation only when connected to a Wi-Fi network or also when using a data network

==Moodle App Plans ==

When using the Moodle App, site admins can choose to subscribe to a paid plan or use the free version.

Plans limit the download of complete courses in one click.

Students can still download individual contents or sections.

We recommend a Premium plan subscription: https://apps.moodle.com

== See also ==
* [[Moodle app SCORM player]]
* [[Moodle app H5P support]]
* [[Moodle Mobile quiz]]
* [[Moodle app synchronization]]

Mall:Mobile

2020-10-27T13:09:05Z

Jleyva:

<div class="navtrail">[[Main page]] ► [[Managing a Moodle site]] ► [[Moodle app]] ► [[{{PAGENAME}}]]</div>
<div class="sideblock right" style="width: 14em;">
<div class="header">[[Moodle app]]</div>
<div class="content">
* [[Moodle app features]]
* [[Moodle app offline features]]
* [[New for mobile]]
* [[Moodle app guide for admins]]
* [[Moodle app notifications]]
* [[Creating mobile-friendly courses]]
* [[Moodle App Block support]]
* [[Moodle Desktop]]
* [[Moodle app FAQ]]
</div>
</div>

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

Moodle app offline features

2020-10-27T13:07:58Z

Jleyva: Created page with "{{Mobile}} == Introduction == We live in a hyper-connected 5G world and we think the Internet is everywhere, but we usually forget about: * Underdeveloped and developing c..."

{{Mobile}}

== Introduction ==

We live in a hyper-connected 5G world and we think the Internet is everywhere, but we usually forget about:

* Underdeveloped and developing countries
* Rural areas in big countries
* Kids with restricted data plans
* Shared internet connection in schools/classrooms
* Aerial and maritime traffic

One of the most powerful features of the Moodle App is its ability for working offline.

Students can browse contents offline and take activities, once the student is connected back to the Internet, the app will synchronise all the necessary information with the Moodle site.

== How does the app store data for offline use? ==

* While browsing the site and its contents
* External contents (e.g youtube videos) are not downloaded
* Embedded files (audio, video) are not always downloaded (it depends on the user connection and file size)
* When the user downloads content by the download icon
** The user can use the “cloud” icon to download specific content or a complete section or course
** The user gets alerted when downloading large files
** If a resource has been updated in the server, a refresh icon will be shown.

'''Why doesn’t the app prefetch/cache more data?'''
# Because the user may have a monthly data plan
# Because the device storage space may be limited
# Massive data download might impact on the server performance

'''What does the app consider to be a large file?'''
* If the user is connected to a Wi-Fi network: large file >= 20MB
*If the user is connected to a data network: large file >= 2MB

== Course features offline support ==

* All the course resources can be downloaded for offline (except URL)
* All the course activities are supported (except Chat and External tool)
* Community plugins usually don’t work offline

=== Assestment ===

The offline mode is disabled by default in Quiz and Lesson, however the teacher can decide if they want to enable it.
* A quiz may be attempted offline only if:
** There is no time limit set
** The question behavior is deferred feedback (with or without CBM) only
** There is no network address requirement

For detailed information about the quiz module and how it works offline please read: [[Moodle Mobile quiz offline attempts]]

=== Other activities ===
* SCORM and H5P packages are downloaded to the user’s device
* Wiki edition is not supported offline
* Glossaries entries can’t be deleted/updated offline
* Text assignment submissions can’t be edited offline
* Activities configured with availability conditions cannot be/are not downloaded for offline

== What other features work offline?==

Apart from resources and activities certain course and site functionality are also available offline.

The offline support for completion is only for marking courses or activities completed (when viewed)

Conditioned activities are not downloaded for offline

* Participants
* Grades
* Completion
* Notes
* Messaging
* Notifications
* Calendar events
* Private files
* Badges
* Blogs
* Rating
* Comments

== Synchronisation ==

Synchronisation works differently depending on the device
* Android: The app must be opened but it can be in the background (you can be using a different app).
* iOS (iPhone, iPad): The app must be opened and in the foreground (it has to be the device active app).
* Desktop: The app must be opened but it can be in the background (minimised).

🔋The battery is the key factor, mobile OS limits its usage

There are two ways of synchronising data:

* Automatic
** Runs regularly, every 10 minutes
* Manual
** The user will see a message indicating there is data pending synchronisation

What happens with the student activity after synchronisation?
Actions performed offline are logged and stored into the system with the synchronisation time, not with the time when they happened.
We are exploring ways to improve reporting via Moodle’s xAPI support.

For more information about how synchronisation works visit: [[Moodle app synchronization]]

== Configuration options ==

Site administrators can decide if they want:
* Disable completely the offline mode
* Disable all courses downloading
* Disable individual courses downloading

For disabling the previous features, please read: [[Moodle app guide for admins]]

Users can decide if they want to allow synchronisation only when connected to a Wi-Fi network or also when using a data network

==Moodle App Plans ==

When using the Moodle App, site admins can choose to subscribe to a paid plan or use the free version.

Plans limit the download of complete courses in one click.

Students can still download individual contents or sections.

We recommend a Premium plan subscription: https://apps.moodle.com

== See also ==
* [[Moodle app SCORM player]]
* [[Moodle app H5P support]]
* [[Moodle Mobile quiz]]

Moodle app guide for admins

2020-10-13T08:08:53Z

Jleyva: /* Custom language strings */

{{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). Please, note this is not necessary since Moodle 3.7

===Is your site behind a proxy, or load balancer or complex network infrastructure?===
In that case, you may need to configure the "Ignore reserver proxies" settings in Site administration > Administration > Server > HTTP

==Register your site on the Moodle Apps Portal==

We strongly recommend you to register your site for free on the Moodle Apps portal: https://apps.moodle.com

You will be able to retrieve statistics like the number of active user devices receiving Push Notifications and upgrade to a Pro/Premium plan for enjoying exclusive features.

==Have your site listed in the Moodle app site finder==

The Moodle apps site finder enables a user to easily find their Moodle site by entering the name (no need to enter the site URL)

===How can I have my site listed in the Moodle app site finder?===

Your site will be automatically listed in the site finder if:
* either your site is registered and listed with a link on [https://stats.moodle.org/sites/ Registered sites] and has over five hundred mobile users and you have been using the Moodle app for over a year
* or you have purchased a [https://moodle.com/app/ Pro or Premium Moodle app subscription].

You can arrange for your site to be listed in the site finder as follows:
* If your site is hosted by a Moodle Partner, please contact them to request for your site to be listed.
* If you have a MoodleCloud site, please log in to the Moodle Apps Portal where you will find an option to have your site listed.

Otherwise, to have your site listed in the site finder, you need to purchase a [https://moodle.com/app/ Pro or Premium Moodle app subscription] from the Moodle Apps Portal.

===I don’t want my site listed in the Moodle app site finder. How can I remove it?===

You can remove your site from the site finder as follows:

# Log in to the [https://apps.moodle.com/ Moodle Apps Portal]. (If you don’t yet have an account, you can create one for free.)
# Go to ‘App customisation’ -> ‘Site Listing’ and uncheck the option ‘Visible’ then save changes.

Your site will then be immediately removed from the site finder.

Alternatively, you can remove your site from the site finder by updating your site registration:

# Log in to your Moodle site as admin and go to ‘Site administration’ -> Registration.
# Change ‘Site listing’ to either ‘Do not list my site’ or ‘Only display my site name’.

Your site will then be removed from the site finder within 24 hours.

==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 [https://moodle.com/branded-app Branded Moodle Mobile app] service, please visit https://moodle.com/app/ 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 ==

'''IMPORTANT''': Please notice that the type and number of features that you can customise depend on your Moodle Apps plan, you can register for free on https://apps.moodle.com to check the different plans.

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
* Blocks
* Comments
* Ratings
* Tags
* Create new account
* Responsive menu items (new in 3.7)
* Main menu
** Site home
** My courses
** Dashboard
** Calendar
** Notifications
** Messages
** Grades
** My learning plans
** Blog
** Files
** Web page
** Help
* Course
** Blocks
** Blog
** Search
** Competencies
** Participants
** Grades
** Course completion
** Notes
** Download course (new in 3.5)
** Download courses (new in 3.5)
* User
** Blog
** Badges
** Competencies
** Course completion
** Grades
** Send message
** Add contact
** Block contact
** Add a new note
** User picture
* Files
** Private files
** Ste files
** Upload
* Modules (Each module can be disabled separately)
* Blocks (Each block available in the app can be disabled separately)

===Custom menu items===

Additional items can be added to the app main menu (the more 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.

===Responsive menu items===

From 3.7 onwards menu items on bottom tabs are moved to the side of the screen on big screens. Also the number of items displayed on the menu may vary:

* On small screens (usually phones) from 2 to 5 items will be displayed depending on the size of the screen.
* On big screens (usually tablets an desktop version) more than 2 items will be displayed without limit.

If '''Responsive menu items''' is selected in Disabled features items will be displayed in side of bottom anyway but 5 items will be displayed in all cases without depending on the size of the screen.

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

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

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

For example:

"core.user.student": v"Student",

means that the string "Student" has string identifier "core.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.)

==App's cache==

The app caches WebService requests to decrease data usage and increase the app's speed. When the app needs to get some data from Moodle, it will use a cached request as long as it isn't expired.

This cache was improved in Moodle App 3.7.0, now there are several cache times depending on the WS being called. This means that some requests will expire more often than others. Also, if the user isn't using a WiFi connection, the expiration time will also be longer to decrease the data usage. These cache times cannot be configured using a Moodle setting.

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

2020-09-29T09:36:22Z

Jleyva: /* Administrators */

{{Mobile}}

== New Moodle App Plans (starting 2 April 2020) ==

Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal]

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

===I use LineageOS and I'm having problems using the app===

LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.

==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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOW-FROM *"

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). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOW-FROM *"

===H5P packages don't work on my site===

You need to enable this admin setting "Allow frame embedding" (allowframembedding admin setting). If that still doesn't work, make sure your server allows it by using this rule: X-Frame-Options "ALLOW-FROM *"

=== 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 have my site listed in the Moodle app site finder? ===

Please refer to our [[Moodle app guide for admins]] for instructions.

=== 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 connect with my Android but not with my iPhone (or iOS device) ===

This is usually a server configuration problem caused by this bug: "access-control-allow-origin cannot contain more than one origin"

iOS-based apps do not allow the following header to contain more than one item "Access-Control-Allow-Origin", for example, a header like this: Access-Control-Allow-Origin: *, https://mydomain.com will cause problems

This HTTP header is not valid, according to the specification you can only specify a domain or a "*", this is failing only in iOS (probably because the native Safari implementation is more restrictive):
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin

Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header. Once this server misconfiguration issue is solved, you will be able to access to your site using the app in iOS

===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 are using a web application firewall like StackPath, Barracuda, Cloudflare, Juniper, etc... try to temporary disable it to check if that's the cause. If so, you'll have to whitelist these endpoints: login/token.php, webservice/*, lib/ajax/*, and /tokenpluginfile.php

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 register your site on the Moodle Apps Portal https://apps.moodle.com once your site is registered there, an Airnotifier access key will be automatically generated for you.

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

=== I configured 'QR code access' to automatic login, but the app still asks for credentials ===

Automatic authentication only works for Pro and Premium sites. You can see the app plans [https://moodle.com/app/ in this site].

I you're getting an error saying that the device you're using to connect isn't in the same network as the device that displays the QR code but both devices are connected to the same network, please check the section: [[#ipmismatch:_.27Client_IP_address_mismatch.27|ipmissmatch: 'Client IP address mismatch']].

===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 [[Capabilities/moodle/webservice:createtoken|moodle/webservice:createtoken]] 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.

====ipmismatch: 'Client IP address mismatch'====

This error can appear when a user opens your site in a browser while using the app. This happens if your site is behind a proxy and you're using one of these Moodle versions o higher: 3.5.11, 3.6.9, 3.7.5, 3.8.2, 3.9.0.

To fix it:

# Go to ''Site administration > Administration > Server > HTTP''.
# Find the setting named ''Ignore reverse proxies'' (reverseproxyignore).
# Enter the IP of your proxy (or range of IPs).
# 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 providing as much information as possible (Moodle version, app version, device model and operating system, etc...), then click the Create button

===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 app FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Creating mobile-friendly courses

2020-09-08T12:44:38Z

Jleyva: /* Mobile device considerations */

{{Mobile}}
As more and more students access courses from their smartphones, tablets or other mobile devices, it is increasingly important to ensure your courses are mobile-friendly.

Encouraging students to install the [https://download.moodle.org/mobile/ official Moodle mobile app] is one way to improve their learning experience. Below are some suggestions for optimising your course materials for students both using the app and accessing Moodle from mobile devices.

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices. In topics format, the first section or the highlighted section is shown by default in the app. In weekly format, the current week is shown.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*Site or course blocks are not displayed in the Mobile app, so avoid putting important information in blocks.
*If you have a mix of students accessing the course on mobile and desktop, consider asking your admin to install the [[Moodle Mobile availability plugin]] which restricts items to desktop or mobile users.

==Course content==

*Use responsive HTML in pages.
*Use a [[Page resource|page resource]] or [[Book]] instead of downloadable documents where possible.
*Avoid uploading many documents or having numerous, text heavy pages. Think more in terms of short "information-bytes".
*If you include YouTube videos, keep them short and consider providing them for download and offline viewing in a [[Folder resource|folder]]. Not all video formats are supported so add them in different formats. (MP4 is probably the most widely accepted format.)
* For YouTube or Vimeo videos, you may use Bootstrap responsive classes: https://getbootstrap.com/docs/4.0/utilities/embed/, for example:
<pre><div class="embed-responsive"><video...</pre>
*Note that drag and drop questions behave differently in the app. You can't drag images, you need to tap to select and tap to drop.
*Note that if you add YouTube video links or map links as URL resources, they will open automatically in the app.
{|
| [[File:moodlemobile_short_text_intro.png|thumb|Short text for label]]
| [[File:moodlemobile_responsive_html.png|thumb|Responsive HTML]]
| [[File:moodlemobile_youtube_maps_links.png|thumb|Map link]]
|}
* Use only plugins with mobile app support so they can be accessed via the mobile app - see [https://moodle.org/plugins/browse.php?list=award&id=6 Moodle plugins directory: Award: mobile app support].
* If you want to include large audio files in your course, consider including them embedded in a label or page rather than as a file resource. The reason is that embedded files will play even if the screen is locked but files won't play with the screen locked.

===Media download for offline usage===

To enable media files, such as video, to be downloaded

* The file must be uploaded to the course, rather than being linked to (from YouTube, Vimeo etc)
* The file must be small - less than 2MB for 3G users or less than 20MB for WiFi users

When a page containing the video is viewed (without playing the video), the file will then be downloaded.

When using Moodle Mobile 3.1 or later with a WiFi connection, when the video is played, the file will be downloaded in the background. The next time the video is played, the downloaded file will be used.

===Offline activities===

All the supported activities work offline, although some require specific settings like the lesson and quiz module, you can find bellow additional information:
* [[Moodle Mobile quiz offline attempts]]
* [[Moodle_app_H5P_support#Working_offline|Moodle H5P]]
* [[Moodle app SCORM player]]

=== Things to avoid===

Some activities are not yet fully supported by the mobile app, so find alternatives. See [[Moodle Mobile SCORM player]] for things to avoid in SCORM packages.

You can find the list of activities supported by the app in the [[Moodle Mobile features]] page.

==Use the latest stable version of Moodle==

As indicated in [[Moodle Mobile features]] some features are only available in recent Moodle versions.

It is recommended to use the latest stable version or, if is not possible to upgrade your site, install the [[Moodle Mobile additional features]] plugin.

==Notifications and messages==

Encourage your students to enable mobile notifications so they are alerted about calendar events, forum posts, messages, assignment submissions and so on. Find out more in [[Mobile app notifications]].

You can also enable mobile notifications for all the users by default via the [[Messaging settings]] default message outputs. Students can disable Mobile notifications within the app.

==Mobile device considerations==

The app works better on devices running
* Android 4.4 onwards
* iOs 11 onwards

In old devices you may find problems related to:
* User interface
* Connection problems (specifically when connecting to sites using https certificates)
* Slowness

The first version of the app was supported in Windows Phone and Windows 7. This version is not supported any more and it was withdrawn from the Windows Store. Its usage is not advised.

==Links to open the Moodle app==

If required, links which open the Moodle app may be provided in the course (for users browsing the site using a mobile device with the app installed).

Links are of the form <code>moodlemobile://https://username@domain.com?token=TOKEN&privatetoken=PRIVATETOKEN&redirect=http://domain.com/course/view.php?id=2</code>.<br />

Please notice that this kind of links are only supported in Moodle app 3.7.0 onwards. If your app has an older version you'll have to use the old format: <code>moodlemobile://link=https://yourmoodlesite.org/mod/...</code>.

For more information about this, please read [https://docs.moodle.org/dev/Open_the_Moodle_app_from_another_app Open the Moodle app from another app].

==Learn more==

* [http://es.slideshare.net/juanleyva/tips-for-creating-moodle-mobile-friendly-courses-sites-moodlemoot-spain-2014 Tips for creating Moodle Mobile friendly courses and sites - MoodleMoot Spain 2014] - Juan Leyva, Mobile app developer, presented this in 2014. While some features have now been updated, the general principles are still useful.
* Forum post: [https://moodle.org/mod/forum/discuss.php?d=349160 Try the Moodle Mobile app with a mobile-friendly course].
* [https://docs.moodle.org/dev/Creating_mobile_question_types How to make third party question types work in Mobile] documentation for developers

[[de:Moodle Mobile - Websites optimieren]]
[[es:Crear sitios amistosos para Moodle Mobile]]
[[fr:Créer des cours pour appareils mobiles]]

Moodle app guide for admins

2020-08-27T11:36:31Z

Jleyva: /* Custom menu items */

{{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). Please, note this is not necessary since Moodle 3.7

===Is your site behind a proxy, or load balancer or complex network infrastructure?===
In that case, you may need to configure the "Ignore reserver proxies" settings in Site administration > Administration > Server > HTTP

==Register your site on the Moodle Apps Portal==

We strongly recommend you to register your site for free on the Moodle Apps portal: https://apps.moodle.com

You will be able to retrieve statistics like the number of active user devices receiving Push Notifications and upgrade to a Pro/Premium plan for enjoying exclusive features.

==Have your site listed in the Moodle app site finder==

The Moodle apps site finder enables a user to easily find their Moodle site by entering the name (no need to enter the site URL)

===How can I have my site listed in the Moodle app site finder?===

Your site will be automatically listed in the site finder if:
* either your site is registered and listed with a link on [https://stats.moodle.org/sites/ Registered sites] and has over five hundred mobile users and you have been using the Moodle app for over a year
* or you have purchased a [https://moodle.com/app/ Pro or Premium Moodle app subscription].

You can arrange for your site to be listed in the site finder as follows:
* If your site is hosted by a Moodle Partner, please contact them to request for your site to be listed.
* If you have a MoodleCloud site, please log in to the Moodle Apps Portal where you will find an option to have your site listed.

Otherwise, to have your site listed in the site finder, you need to purchase a [https://moodle.com/app/ Pro or Premium Moodle app subscription] from the Moodle Apps Portal.

===I don’t want my site listed in the Moodle app site finder. How can I remove it?===

You can remove your site from the site finder as follows:

# Log in to the [https://apps.moodle.com/ Moodle Apps Portal]. (If you don’t yet have an account, you can create one for free.)
# Go to ‘App customisation’ -> ‘Site Listing’ and uncheck the option ‘Visible’ then save changes.

Your site will then be immediately removed from the site finder.

Alternatively, you can remove your site from the site finder by updating your site registration:

# Log in to your Moodle site as admin and go to ‘Site administration’ -> Registration.
# Change ‘Site listing’ to either ‘Do not list my site’ or ‘Only display my site name’.

Your site will then be removed from the site finder within 24 hours.

==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 [https://moodle.com/branded-app Branded Moodle Mobile app] service, please visit https://moodle.com/app/ 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 ==

'''IMPORTANT''': Please notice that the type and number of features that you can customise depend on your Moodle Apps plan, you can register for free on https://apps.moodle.com to check the different plans.

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
* Blocks
* Comments
* Ratings
* Tags
* Create new account
* Responsive menu items (new in 3.7)
* Main menu
** Site home
** My courses
** Dashboard
** Calendar
** Notifications
** Messages
** Grades
** My learning plans
** Blog
** Files
** Web page
** Help
* Course
** Blocks
** Blog
** Search
** Competencies
** Participants
** Grades
** Course completion
** Notes
** Download course (new in 3.5)
** Download courses (new in 3.5)
* User
** Blog
** Badges
** Competencies
** Course completion
** Grades
** Send message
** Add contact
** Block contact
** Add a new note
** User picture
* Files
** Private files
** Ste files
** Upload
* Modules (Each module can be disabled separately)
* Blocks (Each block available in the app can be disabled separately)

===Custom menu items===

Additional items can be added to the app main menu (the more 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.

===Responsive menu items===

From 3.7 onwards menu items on bottom tabs are moved to the side of the screen on big screens. Also the number of items displayed on the menu may vary:

* On small screens (usually phones) from 2 to 5 items will be displayed depending on the size of the screen.
* On big screens (usually tablets an desktop version) more than 2 items will be displayed without limit.

If '''Responsive menu items''' is selected in Disabled features items will be displayed in side of bottom anyway but 5 items will be displayed in all cases without depending on the size of the screen.

===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/moodleapp/master/src/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.)

==App's cache==

The app caches WebService requests to decrease data usage and increase the app's speed. When the app needs to get some data from Moodle, it will use a cached request as long as it isn't expired.

This cache was improved in Moodle App 3.7.0, now there are several cache times depending on the WS being called. This means that some requests will expire more often than others. Also, if the user isn't using a WiFi connection, the expiration time will also be longer to decrease the data usage. These cache times cannot be configured using a Moodle setting.

==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 H5P support

2020-07-20T07:04:28Z

Jleyva: /* As part of the H5P activity */

{{Mobile}}
==Support by version==
=== Before Moodle 3.8 ===
* H5P was supported via an activity plugin developed by the H5P Team (requires Moodle 3.5 onwards)
* It worked in the app, the H5P content was launched in a special frame embedded in the app. Did not support offline browsing
* Required certain site configuration changes (like enabling frame embedding)
=== Moodle 3.8 ===
* Initial core support added
* H5P content only available via embedding (text editor and filter)
* H5P content supported in the Moodle App 3.8
=== Moodle 3.9 ===
* New H5P activity plugin available in the core distribution
* New Content Bank for managing H5P content in the Moodle site
* H5P activities can be graded
* H5P activities supported in the Moodle App 3.9

== How H5P content is displayed? ==

=== Embedded ===

* The content “auto-plays” in the web version while it has to be manually played in the app by the student
* The app will automatically download the content for offline (so it is available without connection)
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, the student can always choose to download it manually (click top-right)
* If the student is downloading the full course, all the embedded H5P packaged will be downloaded
* External H5P are not downloadable for offline

[[File:h5p_embedded.png|600px]]

=== As part of the core H5P activity (Moodle 3.9 onwards) ===

* The content is automatically downloaded and “auto-plays” in the app if:
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, we display a Play button so the student can launch it.
* The H5P is always downloaded (be careful with big H5P packages), it is required for activating tracking
* In the [[Moodle_app_guide_for_admins#Disabled_features|Moodle Site Administration settings]], downloading H5P packages can be disabled.
* Students can review their previous attempts in the app

[[File:h5p_activity.png|600px]]

== Working offline ==

* Students can download a full course with H5P activities or single H5P activities
* In both cases, if he is playing the package when is not connected to the Internet all the tracking information will be stored locally in the device
* Once the user is connected back to the Internet, all the tracking information will be send to the server for the teacher to review
* H5P offline support can be disabled via Moodle settings ([[Moodle_app_guide_for_admins#Disabled_features|Moodle app features section]])

[[Category:H5P]]

Moodle app features

2020-07-13T18:21:55Z

Jleyva:

{{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 app 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>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile39h5p.png|600px]]
<div class="caption">
<h4>Play H5P on and off-line</h4>
<p>Users can now play [[Moodle_app_H5P_support|H5P packages]] on and off-line, including grading for the H5P activity.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile39qr.png|600px]]
<div class="caption">
<h4>Scan QRs to login or open courses/activities in the app</h4>
<p>The app now includes a QR reader so users can easily authenticate in their site or open certain courses or activities 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)
* [[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
* Rate elements (forum posts, glossary and database entries)
* View blog posts
* [[Moodle App Block support|Partial Block support]]

==Activities & Resources Support==

[[File:moodlemobile_activities_resources.png|600px]]

=== Languages ===

The Moodle app is being translated into an increasing number of languages. As of June 2020, 47 languages are available:

(ar) عربي, (bg) Български, (ca) Català, (cs) Čeština, (da) Dansk, (de) Deutsch, (de-du) Deutsch - Du, (el) Ελληνικά, (en) English, (en-us) English - United States, (es) Español, (es-mx) Español - México, (eu) Euskara, (fa) فارسی, (fi) Suomi, (fr) Français, (he) עברית, (hu) magyar, (id) Indonesian, (it) Italiano, (ja) 日本語, (km) ខ្មែរ, (kn) ಕನ್ನಡ, (ko) 한국어, (lt) Lietuvių, (lv) Latviešu, (mn) मराठी, (mr) मराठी, (nl) Nederlands, (no) Norsk - bokmål, (pl) Polski, (pt-br) Português - Brasil, (pt) Português - Portugal, (pt-br) Português - Brasil, (ro) Română, (ru) Русский, (sl) Slovenščina, (sr-cr) Српски, (sr-lt) Srpski, (sv) Svenska, (tg) Тоҷикӣ, (tr) Türkçe, (uk) Українська, (vi) Vietnamese, (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

Fil:moodlemobile activities resources.png

2020-07-13T18:21:01Z

Jleyva: Jleyva uploaded a new version of File:moodlemobile activities resources.png

Creating mobile-friendly courses

2020-07-13T18:18:54Z

Jleyva: /* Offline activities */

{{Mobile}}
As more and more students access courses from their smartphones, tablets or other mobile devices, it is increasingly important to ensure your courses are mobile-friendly.

Encouraging students to install the [https://download.moodle.org/mobile/ official Moodle mobile app] is one way to improve their learning experience. Below are some suggestions for optimising your course materials for students both using the app and accessing Moodle from mobile devices.

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices. In topics format, the first section or the highlighted section is shown by default in the app. In weekly format, the current week is shown.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*Site or course blocks are not displayed in the Mobile app, so avoid putting important information in blocks.
*If you have a mix of students accessing the course on mobile and desktop, consider asking your admin to install the [[Moodle Mobile availability plugin]] which restricts items to desktop or mobile users.

==Course content==

*Use responsive HTML in pages.
*Use a [[Page resource|page resource]] or [[Book]] instead of downloadable documents where possible.
*Avoid uploading many documents or having numerous, text heavy pages. Think more in terms of short "information-bytes".
*If you include YouTube videos, keep them short and consider providing them for download and offline viewing in a [[Folder resource|folder]]. Not all video formats are supported so add them in different formats. (MP4 is probably the most widely accepted format.)
* For YouTube or Vimeo videos, you may use Bootstrap responsive classes: https://getbootstrap.com/docs/4.0/utilities/embed/, for example:
<pre><div class="embed-responsive"><video...</pre>
*Note that drag and drop questions behave differently in the app. You can't drag images, you need to tap to select and tap to drop.
*Note that if you add YouTube video links or map links as URL resources, they will open automatically in the app.
{|
| [[File:moodlemobile_short_text_intro.png|thumb|Short text for label]]
| [[File:moodlemobile_responsive_html.png|thumb|Responsive HTML]]
| [[File:moodlemobile_youtube_maps_links.png|thumb|Map link]]
|}
* Use only plugins with mobile app support so they can be accessed via the mobile app - see [https://moodle.org/plugins/browse.php?list=award&id=6 Moodle plugins directory: Award: mobile app support].
* If you want to include large audio files in your course, consider including them embedded in a label or page rather than as a file resource. The reason is that embedded files will play even if the screen is locked but files won't play with the screen locked.

===Media download for offline usage===

To enable media files, such as video, to be downloaded

* The file must be uploaded to the course, rather than being linked to (from YouTube, Vimeo etc)
* The file must be small - less than 2MB for 3G users or less than 20MB for WiFi users

When a page containing the video is viewed (without playing the video), the file will then be downloaded.

When using Moodle Mobile 3.1 or later with a WiFi connection, when the video is played, the file will be downloaded in the background. The next time the video is played, the downloaded file will be used.

===Offline activities===

All the supported activities work offline, although some require specific settings like the lesson and quiz module, you can find bellow additional information:
* [[Moodle Mobile quiz offline attempts]]
* [[Moodle_app_H5P_support#Working_offline|Moodle H5P]]
* [[Moodle app SCORM player]]

=== Things to avoid===

Some activities are not yet fully supported by the mobile app, so find alternatives. See [[Moodle Mobile SCORM player]] for things to avoid in SCORM packages.

You can find the list of activities supported by the app in the [[Moodle Mobile features]] page.

==Use the latest stable version of Moodle==

As indicated in [[Moodle Mobile features]] some features are only available in recent Moodle versions.

It is recommended to use the latest stable version or, if is not possible to upgrade your site, install the [[Moodle Mobile additional features]] plugin.

==Notifications and messages==

Encourage your students to enable mobile notifications so they are alerted about calendar events, forum posts, messages, assignment submissions and so on. Find out more in [[Mobile app notifications]].

You can also enable mobile notifications for all the users by default via the [[Messaging settings]] default message outputs. Students can disable Mobile notifications within the app.

==Mobile device considerations==

The app works better on devices running
* Android 4.4 onwards
* iOs 6 onwards

In old devices you may find problems related to:
* User interface
* Connection problems (specifically when connecting to sites using https certificates)
* Slowness

The first version of the app was supported in Windows Phone and Windows 7. This version is not supported any more and it was withdrawn from the Windows Store. Its usage is not advised.

==Links to open the Moodle app==

If required, links which open the Moodle app may be provided in the course (for users browsing the site using a mobile device with the app installed).

Links are of the form <code>moodlemobile://https://username@domain.com?token=TOKEN&privatetoken=PRIVATETOKEN&redirect=http://domain.com/course/view.php?id=2</code>.<br />

Please notice that this kind of links are only supported in Moodle app 3.7.0 onwards. If your app has an older version you'll have to use the old format: <code>moodlemobile://link=https://yourmoodlesite.org/mod/...</code>.

For more information about this, please read [https://docs.moodle.org/dev/Open_the_Moodle_app_from_another_app Open the Moodle app from another app].

==Learn more==

* [http://es.slideshare.net/juanleyva/tips-for-creating-moodle-mobile-friendly-courses-sites-moodlemoot-spain-2014 Tips for creating Moodle Mobile friendly courses and sites - MoodleMoot Spain 2014] - Juan Leyva, Mobile app developer, presented this in 2014. While some features have now been updated, the general principles are still useful.
* Forum post: [https://moodle.org/mod/forum/discuss.php?d=349160 Try the Moodle Mobile app with a mobile-friendly course].
* [https://docs.moodle.org/dev/Creating_mobile_question_types How to make third party question types work in Mobile] documentation for developers

[[de:Moodle Mobile - Websites optimieren]]
[[es:Crear sitios amistosos para Moodle Mobile]]
[[fr:Créer des cours pour appareils mobiles]]

Moodle app features

2020-07-13T18:16:36Z

Jleyva:

{{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 app 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>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile39h5p.png|600px]]
<div class="caption">
<h4>Play H5P on and off-line</h4>
<p>Users can now play [[Moodle_app_H5P_support|H5P packages]] on and off-line, including grading for the H5P activity.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile39qr.png|600px]]
<div class="caption">
<h4>Scan QRs to login or open courses/activities in the app</h4>
<p>The app now includes a QR reader so users can easily authenticate in their site or open certain courses or activities 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)
* [[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
* Rate elements (forum posts, glossary and database entries)
* View blog posts
* [[Moodle App Block support|Partial Block support]]

==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 June 2020, 47 languages are available:

(ar) عربي, (bg) Български, (ca) Català, (cs) Čeština, (da) Dansk, (de) Deutsch, (de-du) Deutsch - Du, (el) Ελληνικά, (en) English, (en-us) English - United States, (es) Español, (es-mx) Español - México, (eu) Euskara, (fa) فارسی, (fi) Suomi, (fr) Français, (he) עברית, (hu) magyar, (id) Indonesian, (it) Italiano, (ja) 日本語, (km) ខ្មែរ, (kn) ಕನ್ನಡ, (ko) 한국어, (lt) Lietuvių, (lv) Latviešu, (mn) मराठी, (mr) मराठी, (nl) Nederlands, (no) Norsk - bokmål, (pl) Polski, (pt-br) Português - Brasil, (pt) Português - Portugal, (pt-br) Português - Brasil, (ro) Română, (ru) Русский, (sl) Slovenščina, (sr-cr) Српски, (sr-lt) Srpski, (sv) Svenska, (tg) Тоҷикӣ, (tr) Türkçe, (uk) Українська, (vi) Vietnamese, (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 H5P support

2020-07-13T18:15:08Z

Jleyva: /* Working offline */

{{Mobile}}
==Support by version==
=== Before Moodle 3.8 ===
* H5P was supported via an activity plugin developed by the H5P Team (requires Moodle 3.5 onwards)
* It worked in the app, the H5P content was launched in a special frame embedded in the app. Did not support offline browsing
* Required certain site configuration changes (like enabling frame embedding)
=== Moodle 3.8 ===
* Initial core support added
* H5P content only available via embedding (text editor and filter)
* H5P content supported in the Moodle App 3.8
=== Moodle 3.9 ===
* New H5P activity plugin available in the core distribution
* New Content Bank for managing H5P content in the Moodle site
* H5P activities can be graded
* H5P activities supported in the Moodle App 3.9

== How H5P content is displayed? ==

=== Embedded ===

* The content “auto-plays” in the web version while it has to be manually played in the app by the student
* The app will automatically download the content for offline (so it is available without connection)
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, the student can always choose to download it manually (click top-right)
* If the student is downloading the full course, all the embedded H5P packaged will be downloaded
* External H5P are not downloadable for offline

[[File:h5p_embedded.png|600px]]

=== As part of the H5P activity ===

* The content is automatically downloaded and “auto-plays” in the app if:
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, we display a Play button so the student can launch it.
* The H5P is always downloaded (be careful with big H5P packages), it is required for activating tracking
* In the [[Moodle_app_guide_for_admins#Disabled_features|Moodle Site Administration settings]], downloading H5P packages can be disabled.
* Students can review their previous attempts in the app

[[File:h5p_activity.png|600px]]

== Working offline ==

* Students can download a full course with H5P activities or single H5P activities
* In both cases, if he is playing the package when is not connected to the Internet all the tracking information will be stored locally in the device
* Once the user is connected back to the Internet, all the tracking information will be send to the server for the teacher to review
* H5P offline support can be disabled via Moodle settings ([[Moodle_app_guide_for_admins#Disabled_features|Moodle app features section]])

[[Category:H5P]]

Moodle app H5P support

2020-07-13T18:14:18Z

Jleyva: /* As part of the H5P activity */

{{Mobile}}
==Support by version==
=== Before Moodle 3.8 ===
* H5P was supported via an activity plugin developed by the H5P Team (requires Moodle 3.5 onwards)
* It worked in the app, the H5P content was launched in a special frame embedded in the app. Did not support offline browsing
* Required certain site configuration changes (like enabling frame embedding)
=== Moodle 3.8 ===
* Initial core support added
* H5P content only available via embedding (text editor and filter)
* H5P content supported in the Moodle App 3.8
=== Moodle 3.9 ===
* New H5P activity plugin available in the core distribution
* New Content Bank for managing H5P content in the Moodle site
* H5P activities can be graded
* H5P activities supported in the Moodle App 3.9

== How H5P content is displayed? ==

=== Embedded ===

* The content “auto-plays” in the web version while it has to be manually played in the app by the student
* The app will automatically download the content for offline (so it is available without connection)
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, the student can always choose to download it manually (click top-right)
* If the student is downloading the full course, all the embedded H5P packaged will be downloaded
* External H5P are not downloadable for offline

[[File:h5p_embedded.png|600px]]

=== As part of the H5P activity ===

* The content is automatically downloaded and “auto-plays” in the app if:
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, we display a Play button so the student can launch it.
* The H5P is always downloaded (be careful with big H5P packages), it is required for activating tracking
* In the [[Moodle_app_guide_for_admins#Disabled_features|Moodle Site Administration settings]], downloading H5P packages can be disabled.
* Students can review their previous attempts in the app

[[File:h5p_activity.png|600px]]

== Working offline ==

* Students can download a full course with H5P activities or single H5P activities
* In both cases, if he is playing the package when is not connected to the Internet all the tracking information will be stored locally in the device
* Once the user is connected back to the Internet, all the tracking information will be send to the server for the teacher to review
* H5P offline support can be disabled via Moodle settings (Moodle app features section)

[[Category:H5P]]

Moodle app H5P support

2020-07-13T18:12:28Z

Jleyva: /* How H5P content is displayed? */

{{Mobile}}
==Support by version==
=== Before Moodle 3.8 ===
* H5P was supported via an activity plugin developed by the H5P Team (requires Moodle 3.5 onwards)
* It worked in the app, the H5P content was launched in a special frame embedded in the app. Did not support offline browsing
* Required certain site configuration changes (like enabling frame embedding)
=== Moodle 3.8 ===
* Initial core support added
* H5P content only available via embedding (text editor and filter)
* H5P content supported in the Moodle App 3.8
=== Moodle 3.9 ===
* New H5P activity plugin available in the core distribution
* New Content Bank for managing H5P content in the Moodle site
* H5P activities can be graded
* H5P activities supported in the Moodle App 3.9

== How H5P content is displayed? ==

=== Embedded ===

* The content “auto-plays” in the web version while it has to be manually played in the app by the student
* The app will automatically download the content for offline (so it is available without connection)
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, the student can always choose to download it manually (click top-right)
* If the student is downloading the full course, all the embedded H5P packaged will be downloaded
* External H5P are not downloadable for offline

[[File:h5p_embedded.png|600px]]

=== As part of the H5P activity ===

* The content is automatically downloaded and “auto-plays” in the app if:
* WiFi: Only if the package size is less than 20MB
* 3G/4G: Only if the package size is less than 2MB
* For larger packages, we display a Play button so the student can launch it.
* The H5P is always downloaded (be careful with big H5P packages), it is required for activating tracking
* In the Moodle Site Administration settings, downloading H5P packages can be disabled.
* Students can review their previous attempts in the app

[[File:h5p_activity.png|600px]]

== Working offline ==

* Students can download a full course with H5P activities or single H5P activities
* In both cases, if he is playing the package when is not connected to the Internet all the tracking information will be stored locally in the device
* Once the user is connected back to the Internet, all the tracking information will be send to the server for the teacher to review
* H5P offline support can be disabled via Moodle settings (Moodle app features section)

[[Category:H5P]]

Fil:h5p activity.png

2020-07-13T18:10:31Z

Jleyva:

Moodle app H5P support

2020-07-13T18:10:05Z

Jleyva: /* How H5P content is displayed? */

{{Mobile}}
==Support by version==
=== Before Moodle 3.8 ===
* H5P was supported via an activity plugin developed by the H5P Team (requires Moodle 3.5 onwards)
* It worked in the app, the H5P content was launched in a special frame embedded in the app. Did not support offline browsing
* Required certain site configuration changes (like enabling frame embedding)
=== Moodle 3.8 ===
* Initial core support added
* H5P content only available via embedding (text editor and filter)
* H5P content supported in the Moodle App 3.8
=== Moodle 3.9 ===
* New H5P activity plugin available in the core distribution
* New Content Bank for managing H5P content in the Moodle site
* H5P activities can be graded
* H5P activities supported in the Moodle App 3.9

== How H5P content is displayed? ==

=== Embedded ===

* The content “auto-plays” in the web version while it has to be manually played in the app by the student
* The app will automatically download the content for offline (so it is available without connection)
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, the student can always choose to download it manually (click top-right)
* If the student is downloading the full course, all the embedded H5P packaged will be downloaded
* External H5P are not downloadable for offline

[[File:h5p_activity.png|thumb]]

=== As part of the H5P activity ===

* The content is automatically downloaded and “auto-plays” in the app if:
* WiFi: Only if the package size is less than 20MB
* 3G/4G: Only if the package size is less than 2MB
* For larger packages, we display a Play button so the student can launch it.
* The H5P is always downloaded (be careful with big H5P packages), it is required for activating tracking
* In the Moodle Site Administration settings, downloading H5P packages can be disabled.
* Students can review their previous attempts in the app

[[File:h5p_embedded.png|thumb]]

== Working offline ==

* Students can download a full course with H5P activities or single H5P activities
* In both cases, if he is playing the package when is not connected to the Internet all the tracking information will be stored locally in the device
* Once the user is connected back to the Internet, all the tracking information will be send to the server for the teacher to review
* H5P offline support can be disabled via Moodle settings (Moodle app features section)

[[Category:H5P]]

Fil:h5p embedded.png

2020-07-13T18:09:06Z

Jleyva:

Moodle app H5P support

2020-07-13T18:08:41Z

Jleyva: /* Embedded */

{{Mobile}}
==Support by version==
=== Before Moodle 3.8 ===
* H5P was supported via an activity plugin developed by the H5P Team (requires Moodle 3.5 onwards)
* It worked in the app, the H5P content was launched in a special frame embedded in the app. Did not support offline browsing
* Required certain site configuration changes (like enabling frame embedding)
=== Moodle 3.8 ===
* Initial core support added
* H5P content only available via embedding (text editor and filter)
* H5P content supported in the Moodle App 3.8
=== Moodle 3.9 ===
* New H5P activity plugin available in the core distribution
* New Content Bank for managing H5P content in the Moodle site
* H5P activities can be graded
* H5P activities supported in the Moodle App 3.9

== How H5P content is displayed? ==

=== Embedded ===

* The content “auto-plays” in the web version while it has to be manually played in the app by the student
* The app will automatically download the content for offline (so it is available without connection)
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, the student can always choose to download it manually (click top-right)
* If the student is downloading the full course, all the embedded H5P packaged will be downloaded
* External H5P are not downloadable for offline

[[File:h5p_embedded.png|thumb]]

=== As part of the H5P activity ===

* The content is automatically downloaded and “auto-plays” in the app if:
* WiFi: Only if the package size is less than 20MB
* 3G/4G: Only if the package size is less than 2MB
* For larger packages, we display a Play button so the student can launch it.
* The H5P is always downloaded (be careful with big H5P packages), it is required for activating tracking
* In the Moodle Site Administration settings, downloading H5P packages can be disabled.
* Students can review their previous attempts in the app

== Working offline ==

* Students can download a full course with H5P activities or single H5P activities
* In both cases, if he is playing the package when is not connected to the Internet all the tracking information will be stored locally in the device
* Once the user is connected back to the Internet, all the tracking information will be send to the server for the teacher to review
* H5P offline support can be disabled via Moodle settings (Moodle app features section)

[[Category:H5P]]

Moodle app H5P support

2020-07-13T18:06:50Z

Jleyva:

{{Mobile}}
==Support by version==
=== Before Moodle 3.8 ===
* H5P was supported via an activity plugin developed by the H5P Team (requires Moodle 3.5 onwards)
* It worked in the app, the H5P content was launched in a special frame embedded in the app. Did not support offline browsing
* Required certain site configuration changes (like enabling frame embedding)
=== Moodle 3.8 ===
* Initial core support added
* H5P content only available via embedding (text editor and filter)
* H5P content supported in the Moodle App 3.8
=== Moodle 3.9 ===
* New H5P activity plugin available in the core distribution
* New Content Bank for managing H5P content in the Moodle site
* H5P activities can be graded
* H5P activities supported in the Moodle App 3.9

== How H5P content is displayed? ==

=== Embedded ===

* The content “auto-plays” in the web version while it has to be manually played in the app by the student
* The app will automatically download the content for offline (so it is available without connection)
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, the student can always choose to download it manually (click top-right)
* If the student is downloading the full course, all the embedded H5P packaged will be downloaded
* External H5P are not downloadable for offline

=== As part of the H5P activity ===

* The content is automatically downloaded and “auto-plays” in the app if:
* WiFi: Only if the package size is less than 20MB
* 3G/4G: Only if the package size is less than 2MB
* For larger packages, we display a Play button so the student can launch it.
* The H5P is always downloaded (be careful with big H5P packages), it is required for activating tracking
* In the Moodle Site Administration settings, downloading H5P packages can be disabled.
* Students can review their previous attempts in the app

== Working offline ==

* Students can download a full course with H5P activities or single H5P activities
* In both cases, if he is playing the package when is not connected to the Internet all the tracking information will be stored locally in the device
* Once the user is connected back to the Internet, all the tracking information will be send to the server for the teacher to review
* H5P offline support can be disabled via Moodle settings (Moodle app features section)

[[Category:H5P]]

Moodle app H5P support

2020-07-13T18:06:01Z

Jleyva: Created page with "{{Mobile}} ==Support by version== === Before Moodle 3.8 === * H5P was supported via an activity plugin developed by the H5P Team (requires Moodle 3.5 onwards) * It worked in..."

{{Mobile}}
==Support by version==

=== Before Moodle 3.8 ===
* H5P was supported via an activity plugin developed by the H5P Team (requires Moodle 3.5 onwards)
* It worked in the app, the H5P content was launched in a special frame embedded in the app. Did not support offline browsing
* Required certain site configuration changes (like enabling frame embedding)

=== Moodle 3.8 ===
* Initial core support added
* H5P content only available via embedding (text editor and filter)
* H5P content supported in the Moodle App 3.8

=== Moodle 3.9 ===
* New H5P activity plugin available in the core distribution
* New Content Bank for managing H5P content in the Moodle site
* H5P activities can be graded
* H5P activities supported in the Moodle App 3.9

== How H5P content is displayed? ==

=== Embedded ===

* The content “auto-plays” in the web version while it has to be manually played in the app by the student
* The app will automatically download the content for offline (so it is available without connection)
** WiFi: Only if the package size is less than 20MB
** 3G/4G: Only if the package size is less than 2MB
* For larger packages, the student can always choose to download it manually (click top-right)
* If the student is downloading the full course, all the embedded H5P packaged will be downloaded
* External H5P are not downloadable for offline

=== As part of the H5P activity ===

* The content is automatically downloaded and “auto-plays” in the app if:
* WiFi: Only if the package size is less than 20MB
* 3G/4G: Only if the package size is less than 2MB
* For larger packages, we display a Play button so the student can launch it.
* The H5P is always downloaded (be careful with big H5P packages), it is required for activating tracking
* In the Moodle Site Administration settings, downloading H5P packages can be disabled.
* Students can review their previous attempts in the app

== Working offline ==

* Students can download a full course with H5P activities or single H5P activities
* In both cases, if he is playing the package when is not connected to the Internet all the tracking information will be stored locally in the device
* Once the user is connected back to the Internet, all the tracking information will be send to the server for the teacher to review
* H5P offline support can be disabled via Moodle settings (Moodle app features section)

[[Category:H5P]]

Moodle app guide for admins

2020-07-01T09:39:47Z

Jleyva: /* Enable mobile services on your site */

{{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). Please, note this is not necessary since Moodle 3.7

===Is your site behind a proxy, or load balancer or complex network infrastructure?===
In that case, you may need to configure the "Ignore reserver proxies" settings in Site administration > Administration > Server > HTTP

==Register your site on the Moodle Apps Portal==

We strongly recommend you to register your site for free on the Moodle Apps portal: https://apps.moodle.com

You will be able to retrieve statistics like the number of active user devices receiving Push Notifications and upgrade to a Pro/Premium plan for enjoying exclusive features.

==Have your site listed in the Moodle app site finder==

The Moodle apps site finder enables a user to easily find their Moodle site by entering the name (no need to enter the site URL)

===How can I have my site listed in the Moodle app site finder?===

Your site will be automatically listed in the site finder if:
* either your site is registered and listed with a link on [https://stats.moodle.org/sites/ Registered sites] and has over five hundred mobile users and you have been using the Moodle app for over a year
* or you have purchased a [https://moodle.com/app/ Pro or Premium Moodle app subscription].

You can arrange for your site to be listed in the site finder as follows:
* If your site is hosted by a Moodle Partner, please contact them to request for your site to be listed.
* If you have a MoodleCloud site, please log in to the Moodle Apps Portal where you will find an option to have your site listed.

Otherwise, to have your site listed in the site finder, you need to purchase a [https://moodle.com/app/ Pro or Premium Moodle app subscription] from the Moodle Apps Portal.

===I don’t want my site listed in the Moodle app site finder. How can I remove it?===

You can remove your site from the site finder as follows:

# Log in to the [https://apps.moodle.com/ Moodle Apps Portal]. (If you don’t yet have an account, you can create one for free.)
# Go to ‘App customisation’ -> ‘Site Listing’ and uncheck the option ‘Visible’ then save changes.

Your site will then be immediately removed from the site finder.

Alternatively, you can remove your site from the site finder by updating your site registration:

# Log in to your Moodle site as admin and go to ‘Site administration’ -> Registration.
# Change ‘Site listing’ to either ‘Do not list my site’ or ‘Only display my site name’.

Your site will then be removed from the site finder within 24 hours.

==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 [https://moodle.com/branded-app Branded Moodle Mobile app] service, please visit https://moodle.com/app/ 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 ==

'''IMPORTANT''': Please notice that the type and number of features that you can customise depend on your Moodle Apps plan, you can register for free on https://apps.moodle.com to check the different plans.

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
* Blocks
* Comments
* Ratings
* Tags
* Create new account
* Responsive menu items (new in 3.7)
* Main menu
** Site home
** My courses
** Dashboard
** Calendar
** Notifications
** Messages
** Grades
** My learning plans
** Blog
** Files
** Web page
** Help
* Course
** Blocks
** Blog
** Search
** Competencies
** Participants
** Grades
** Course completion
** Notes
** Download course (new in 3.5)
** Download courses (new in 3.5)
* User
** Blog
** Badges
** Competencies
** Course completion
** Grades
** Send message
** Add contact
** Block contact
** Add a new note
** User picture
* Files
** Private files
** Ste files
** Upload
* Modules (Each module can be disabled separately)
* Blocks (Each block available in the app can be disabled separately)

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

===Responsive menu items===

From 3.7 onwards menu items on bottom tabs are moved to the side of the screen on big screens. Also the number of items displayed on the menu may vary:

* On small screens (usually phones) from 2 to 5 items will be displayed depending on the size of the screen.
* On big screens (usually tablets an desktop version) more than 2 items will be displayed without limit.

If '''Responsive menu items''' is selected in Disabled features items will be displayed in side of bottom anyway but 5 items will be displayed in all cases without depending on the size of the screen.

===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/moodleapp/master/src/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.)

==App's cache==

The app caches WebService requests to decrease data usage and increase the app's speed. When the app needs to get some data from Moodle, it will use a cached request as long as it isn't expired.

This cache was improved in Moodle App 3.7.0, now there are several cache times depending on the WS being called. This means that some requests will expire more often than others. Also, if the user isn't using a WiFi connection, the expiration time will also be longer to decrease the data usage. These cache times cannot be configured using a Moodle setting.

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