MoodleDocs - User contributions [en]

Moodle app FAQ

2021-03-24T08:56:37Z

Dpalou: /* Teachers */

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

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

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

2020-10-30T07:50:47Z

Dpalou: /* Teachers */

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

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

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

2020-10-16T08:00:01Z

Dpalou: /* 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']].

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

2020-06-29T12:33:00Z

Dpalou: /* I configured 'QR code access' to automatic login, but the app still asks for credentials */

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

Moodle app FAQ

2020-06-29T10:28:06Z

Dpalou: /* 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'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].

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

File:mobile39qr.png

2020-06-29T10:20:19Z

Dpalou: QR reader screenshot.

QR reader screenshot.

File:mobile39h5p.png

2020-06-29T10:19:36Z

Dpalou: H5P feature screenshot.

H5P feature screenshot.

Moodle app features

2020-06-29T10:19:00Z

Dpalou:

{{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 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 August 2018, 35 languages are available:

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

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

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

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

Moodle App Block support

2020-06-29T09:14:44Z

Dpalou: /* Pre-rendered blocks */

{{Mobile}}
Blocks are supported on the App from 3.8 onwards.
This is the list of blocks supported on the app.

== Only title blocks ==
Some blocks have a match with the app features. It will only display the title and they will link the app feature directly when clicked:

* Calendar month
* Calendar upcoming
* Comments
* Completion status
* Learning plans
* Private files
* Self completion

== Pre-rendered blocks ==
Some blocks displays likely the same content as in the website:

* Activity results
* Badges
* Blog menu
* Blog recent
* Blog tags
* Glossary random
* HTML block
* News items
* Online Users
* Recent Activity
* RSS Client
* Tags

== Full supported blocks ==
Some blocks have an specific treatment on the app, they've been natively adapted:

* Activity modules
* Site Main menu (Site home)
* Course overview (Dashboard)
* Timeline (Dashboard)
* Starred Courses (Dashboard)
* Recent accessed items (Dashboard)
* Recent Courses (Dashboard)

[[es:Soporte para Bloque en Moodle App]]

Moodle app FAQ

2020-04-15T09:42:47Z

Dpalou: /* Error messages */

{{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 debug errors in the app? ===

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

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

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

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

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

# If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. Please use these tools or a similar one to check that your certificate is fine: [https://www.geocerts.com/ssl_checker SSL Checker] and [https://www.ssllabs.com/ssltest/analyze.html SSL Server Test]. All the checks must be ok, including the "Certificate Chain Complete". Otherwise the app might work on iOS but not on Android.
# [[Debugging]] is disabled (in ''Site administration > Development > Debugging'')
# The ADOdb debug option is disabled if you are using the external database auth or enrolment plugin (in ''Plugins > Authentication > External database'' and in ''Plugins > Enrolment > External database'').
# SHA-1 https certificates are not supported anymore in Chrome, this means that the Android version of the app won't work for your site. If your site doesn't work in desktop Chrome or Chromium it won't work in the Android app. See https://blog.chromium.org/2014/09/gradually-sunsetting-sha-1.html for more information
# If you are using IIS check that Anonymous access is not disabled for the /webservice directory.
# If you 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 fill in the [http://goo.gl/forms/WLwkbe8b7c Airnotifier access key manual request form]. (If your site is hosted so you can't obtain your siteidentifier, enter "cannot obtain" in the field.) Your site registration will be checked and you will be sent an access key in a few days if everything is correct.

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

===Error messages===

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

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

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

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

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

Please check:
# You have followed all the steps listed in [[:dev:Moodle Mobile Developing a plugin tutorial|Moodle Mobile Developing a plugin tutorial]]
# You have enabled the [[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

2019-12-03T10:48:22Z

Dpalou:

{{Mobile}}
==Students==

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

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

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

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

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

The app requires the following permissions:

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

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

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

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

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

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

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

See [[Moodle app synchronization]].

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

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

===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 debug errors in the app? ===

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

===Error messages===

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

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

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

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

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

Please check:
# You have followed all the steps listed in [[:dev:Moodle Mobile Developing a plugin tutorial|Moodle Mobile Developing a plugin tutorial]]
# You have enabled the [[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.

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

atto applink

2019-06-17T06:15:52Z

Dpalou: /* Installation */

==Introduction==
Atto plugin which makes it easier to apply the Moodle App link filter to some content. For more information about the Moodle App link filter plugin please see [https://docs.moodle.org/310/en/filter_applink this documentation].

This plugin is meant to replace the default link button since it replicates all its features and adds some new ones.

==Installation==
You can download this plugin from [https://moodle.org/plugins/view.php?id=2305 the Moodle plugins directory] or from [https://github.com/dpalou/moodle-atto_applink the source repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../lib/editor/atto/plugins/ directory.

==Add the button to the Atto toolbar==
The button created by this plugin has to be added to the Atto toolbar before it can be used by users.

Please visit Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings.

There, please add the "applink" keyword to one of the lines in the "editor_atto | toolbar" setting according to your needs. It's recommended to replace the "link" button with this one.

==How to use==
Once enabled, a link and unlink buttons will appear in the toolbar of the Atto editor.

To create a link, follow the same steps as when you create a link using Moodle's default link button.

In the new dialog you'll see some new options. To make the link open the Moodle app, enable the "Open in the app" checkbox. Additionally, you can specify the URL scheme to use, if it's left empty the default scheme will be applied:

[[File:attoapplink_defaultscheme.png|300px]]

You can also add a username to use in the app. To do so, enable the "Add username" checkbox. Additionally, you can specify the username to use, if it's left empty the user viewing the link will be applied.

[[File:attoapplink_username.png|300px]]

==See also==
* [https://github.com/dpalou/moodle-filter_applink Moodle App link filter plugin]
* [https://docs.moodle.org/dev/Open_the_Moodle_app_from_another_app Open the Moodle app from another app]

filter ws

2019-06-17T06:14:18Z

Dpalou: /* Installation */

==Introduction==
With the WebService filter plugin you can choose if some content should be visible only in web (browser) or only in a WebService client like the Moodle apps. The main purpose of this plugin is to be able to display/hide some content only for the Moodle app.

==Installation==
You can download this plugin from [https://moodle.org/plugins/filter_ws the Moodle plugins directory] or from [https://github.com/dpalou/moodle-filter_ws the source repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../filter/ directory.

==Enabling/Disabling the filter on your site==
The WebService filter must be enabled before it can be used on your Moodle site (it is disabled by default, after installation). To enable (or disable) the plugin site-wide, visit Site Administration > Plugins > Filters > Manage Filters, locate the 'WebService' filter and click on the dropdown box to enable it (or disable it).

==How to use==
You need to enclose the content you want to filter between {fws} tags. Inside the opening {fws} you should specify if you want the content to be displayed in browser (web), in a WS client (ws) or in both of them (any).

<code>
{fws web}content only for web{fws}
{fws ws}content only for ws{fws}
{fws any}content for any request{fws}
</code>

Example: We edit a SCORM description and put the content in the following screenshot:

[[File:filterws_editor.png]]

You can see we have 3 pieces of content. The first one doesn't have any special tag, so it will be displayed everywhere. The second block has the "web" keyword, so it will only be displayed if the user is using a browser. Finally, the last block will only be displayed in a WS client (in our case, the Moodle app). You can see the result in the following screenshots:

[[File:filterws_web.png|1000px]]

[[File:filterws_app.png|320px]]

===Filtering by User Agent===
The filter also lets you filter by User Agent, so the content will only be displayed if the User Agent accessing the content contains a certain text. To do so, you need to add a'ua="MY_REGEXP"' attribute to the {fws} tag, where ''MY_REGEXP'' is the regular expression you want to check (without starting and ending slashes). Please notice that the regular expression is case sensitive. Example:

<code>
{fws ws ua="MoodleMobile\s?$" }content only for the official Moodle app{fws}
{fws any ua="iPhone|iPad|iPod"}content only for iOS devices{fws}
</code>

==Atto plugin==
There is a plugin to add this filter using an Atto button. You can see the documentation [https://docs.moodle.org/en/index.php?title=atto_filterws in here].

filter applink

2019-06-17T06:13:58Z

Dpalou: /* Installation */

==Introduction==
With this plugin you can easily create links to open the Moodle App (or your custom app if you have one). You only need to specify the URL that you want to be opened (e.g. a course URL) and the filter will automatically create the URL to launch the app.

You can also specify if you want to use a certain username in the app.

This filter will be applied when the user navigates using a browser, but not when the user navigates using the app (the app is already open, you don't need to open it with a link).

==Installation==
You can download this plugin from [https://moodle.org/plugins/view.php?id=2304 the Moodle plugins directory] or from [https://github.com/dpalou/moodle-filter_applink the source repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../filter/ directory.

==Enabling/Disabling the filter on your site==
The WebService filter must be enabled before it can be used on your Moodle site (it is disabled by default, after installation). To enable (or disable) the plugin site-wide, visit "Site Administration >> Plugins >> Filters >> Manage Filters", locate the 'Moodle App link' filter and click on the dropdown box to enable it (or disable it).

==How to use==
You need to add the attribute "''data-app-link''" to the links that you want to convert to a link to open the app:

<code>
<a href="https://domain.com/course/view.php?id=2" data-app-link>Click me</a>
</code>

If no value is assigned to ''data-app-link'', the default URL scheme will be used. The default scheme can be changed in "Site Administration >> Plugins >> Filters >> Moodle App link". Leaving this setting empty will use the official Moodle app scheme: "moodlemobile".

If you want to force a scheme only for a certain link you can do it like this:

<code>
<a href="https://domain.com/course/view.php?id=2" data-app-link="myscheme">Click me</a>
</code>

===Add a username===
By default, no username will be added to the URL. This means that, if there are several users from that site stored in the app, the app will use the one that's currently logged in. If there is no user currently logged in, the user will have to choose which account does he want to use to open the link.

You can specify a username so the app will force to use that user. If there are several users from that site stored in the app, the app will always use the user you specified. In case that user is not stored, the user will be sent to the credentials screen and the username will be prepopulated.

You can force to use a certain username, like this:

<code>
<a href="https://domain.com/course/view.php?id=2" data-app-link data-username="john.smith">Click me</a>
</code>

If data-username is left empty, the filter will automatically add the username of the user that's viewing the link:

<code>
<a href="https://domain.com/course/view.php?id=2" data-app-link data-username>Click me</a>
</code>

In the example above, the app will be opened with the same user I'm using in browser.

==Atto plugin==
There is a plugin to add this filter using an Atto button. You can see the documentation [https://docs.moodle.org/en/index.php?title=atto_applink in here].

==See also==

* [https://docs.moodle.org/dev/Open_the_Moodle_app_from_another_app Open the Moodle app from another app]
* [https://github.com/dpalou/moodle-filter_applink Source code]

filter ws

2019-06-17T06:12:29Z

Dpalou: /* Installation */

==Introduction==
With the WebService filter plugin you can choose if some content should be visible only in web (browser) or only in a WebService client like the Moodle apps. The main purpose of this plugin is to be able to display/hide some content only for the Moodle app.

==Installation==
You can download this plugin from [https://moodle.org/plugins/view.php?id=2304 the Moodle plugins directory] or from [https://github.com/dpalou/moodle-filter_ws the source repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../filter/ directory.

==Enabling/Disabling the filter on your site==
The WebService filter must be enabled before it can be used on your Moodle site (it is disabled by default, after installation). To enable (or disable) the plugin site-wide, visit Site Administration > Plugins > Filters > Manage Filters, locate the 'WebService' filter and click on the dropdown box to enable it (or disable it).

==How to use==
You need to enclose the content you want to filter between {fws} tags. Inside the opening {fws} you should specify if you want the content to be displayed in browser (web), in a WS client (ws) or in both of them (any).

<code>
{fws web}content only for web{fws}
{fws ws}content only for ws{fws}
{fws any}content for any request{fws}
</code>

Example: We edit a SCORM description and put the content in the following screenshot:

[[File:filterws_editor.png]]

You can see we have 3 pieces of content. The first one doesn't have any special tag, so it will be displayed everywhere. The second block has the "web" keyword, so it will only be displayed if the user is using a browser. Finally, the last block will only be displayed in a WS client (in our case, the Moodle app). You can see the result in the following screenshots:

[[File:filterws_web.png|1000px]]

[[File:filterws_app.png|320px]]

===Filtering by User Agent===
The filter also lets you filter by User Agent, so the content will only be displayed if the User Agent accessing the content contains a certain text. To do so, you need to add a'ua="MY_REGEXP"' attribute to the {fws} tag, where ''MY_REGEXP'' is the regular expression you want to check (without starting and ending slashes). Please notice that the regular expression is case sensitive. Example:

<code>
{fws ws ua="MoodleMobile\s?$" }content only for the official Moodle app{fws}
{fws any ua="iPhone|iPad|iPod"}content only for iOS devices{fws}
</code>

==Atto plugin==
There is a plugin to add this filter using an Atto button. You can see the documentation [https://docs.moodle.org/en/index.php?title=atto_filterws in here].

File:attoapplink defaultscheme.png

2019-06-13T15:04:51Z

Dpalou: Dpalou uploaded a new version of File:attoapplink defaultscheme.png

App link dialog with the "Open in the app" checkbox enabled.

File:attoapplink defaultscheme.png

2019-06-13T15:02:06Z

Dpalou:

App link dialog with the "Open in the app" checkbox enabled.

File:attoapplink username.png

2019-06-13T15:01:45Z

Dpalou: App link dialog with the "Open in the app" and "Add username" checkboxs enabled.

App link dialog with the "Open in the app" and "Add username" checkboxs enabled.

File:attoapplink defaultscheme.png

2019-06-13T15:00:52Z

Dpalou: Atto link dialog with the "Open in the app" checkbox enabled.

Atto link dialog with the "Open in the app" checkbox enabled.

atto applink

2019-06-13T14:59:10Z

Dpalou: Created page with "==Introduction== Atto plugin which makes it easier to apply the Moodle App link filter to some content. For more information about the Moodle App link filter plugin please see..."

==Introduction==
Atto plugin which makes it easier to apply the Moodle App link filter to some content. For more information about the Moodle App link filter plugin please see [https://docs.moodle.org/310/en/filter_applink this documentation].

This plugin is meant to replace the default link button since it replicates all its features and adds some new ones.

==Installation==
You can download this plugin from [https://github.com/dpalou/moodle-atto_applink the source repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../lib/editor/atto/plugins/ directory.

==Add the button to the Atto toolbar==
The button created by this plugin has to be added to the Atto toolbar before it can be used by users.

Please visit Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings.

There, please add the "applink" keyword to one of the lines in the "editor_atto | toolbar" setting according to your needs. It's recommended to replace the "link" button with this one.

==How to use==
Once enabled, a link and unlink buttons will appear in the toolbar of the Atto editor.

To create a link, follow the same steps as when you create a link using Moodle's default link button.

In the new dialog you'll see some new options. To make the link open the Moodle app, enable the "Open in the app" checkbox. Additionally, you can specify the URL scheme to use, if it's left empty the default scheme will be applied:

[[File:attoapplink_defaultscheme.png|300px]]

You can also add a username to use in the app. To do so, enable the "Add username" checkbox. Additionally, you can specify the username to use, if it's left empty the user viewing the link will be applied.

[[File:attoapplink_username.png|300px]]

==See also==
* [https://github.com/dpalou/moodle-filter_applink Moodle App link filter plugin]
* [https://docs.moodle.org/dev/Open_the_Moodle_app_from_another_app Open the Moodle app from another app]

filter applink

2019-06-13T14:51:06Z

Dpalou: Created page with "==Introduction== With this plugin you can easily create links to open the Moodle App (or your custom app if you have one). You only need to specify the URL that you want to be..."

==Introduction==
With this plugin you can easily create links to open the Moodle App (or your custom app if you have one). You only need to specify the URL that you want to be opened (e.g. a course URL) and the filter will automatically create the URL to launch the app.

You can also specify if you want to use a certain username in the app.

This filter will be applied when the user navigates using a browser, but not when the user navigates using the app (the app is already open, you don't need to open it with a link).

==Installation==
You can download this plugin from [https://github.com/dpalou/moodle-filter_applink the source repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../filter/ directory.

==Enabling/Disabling the filter on your site==
The WebService filter must be enabled before it can be used on your Moodle site (it is disabled by default, after installation). To enable (or disable) the plugin site-wide, visit "Site Administration >> Plugins >> Filters >> Manage Filters", locate the 'Moodle App link' filter and click on the dropdown box to enable it (or disable it).

==How to use==
You need to add the attribute "''data-app-link''" to the links that you want to convert to a link to open the app:

<code>
<a href="https://domain.com/course/view.php?id=2" data-app-link>Click me</a>
</code>

If no value is assigned to ''data-app-link'', the default URL scheme will be used. The default scheme can be changed in "Site Administration >> Plugins >> Filters >> Moodle App link". Leaving this setting empty will use the official Moodle app scheme: "moodlemobile".

If you want to force a scheme only for a certain link you can do it like this:

<code>
<a href="https://domain.com/course/view.php?id=2" data-app-link="myscheme">Click me</a>
</code>

===Add a username===
By default, no username will be added to the URL. This means that, if there are several users from that site stored in the app, the app will use the one that's currently logged in. If there is no user currently logged in, the user will have to choose which account does he want to use to open the link.

You can specify a username so the app will force to use that user. If there are several users from that site stored in the app, the app will always use the user you specified. In case that user is not stored, the user will be sent to the credentials screen and the username will be prepopulated.

You can force to use a certain username, like this:

<code>
<a href="https://domain.com/course/view.php?id=2" data-app-link data-username="john.smith">Click me</a>
</code>

If data-username is left empty, the filter will automatically add the username of the user that's viewing the link:

<code>
<a href="https://domain.com/course/view.php?id=2" data-app-link data-username>Click me</a>
</code>

In the example above, the app will be opened with the same user I'm using in browser.

==Atto plugin==
There is a plugin to add this filter using an Atto button. You can see the documentation [https://docs.moodle.org/en/index.php?title=atto_applink in here].

==See also==

* [https://docs.moodle.org/dev/Open_the_Moodle_app_from_another_app Open the Moodle app from another app]
* [https://github.com/dpalou/moodle-filter_applink Source code]

Creating mobile-friendly courses

2019-06-11T14:32:41Z

Dpalou: /* Links to open the Moodle app */

{{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 quiz module. See [[Moodle Mobile quiz offline attempts]] for more information.

=== 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 guide for admins

2019-06-11T12:47:41Z

Dpalou:

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

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

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

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

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

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

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

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

==Mobile authentication==

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

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

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

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

== Customise your app theme ==

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

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

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

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

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

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

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

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

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

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

== Notifications ==

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

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

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

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

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

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

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

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

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

=='Get the mobile app' link==

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

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

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

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

== Configuring the app from your site ==

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

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

===Force log out===

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

===Disabled features===

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

Options to remove include:

* Offline use
* 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/moodlemobile-phonegapbuild/master/assets/lang/en.json. The string identifier is before the colon.

For example:

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

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

==Web services token duration==

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

==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 Mobile - Anleitung für Administrator/innen]]

Moodle app FAQ

2019-02-18T07:20:20Z

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

{{Mobile}}
==Students==

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

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

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

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

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

The app requires the following permissions:

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

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

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

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

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

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

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

See [[Moodle app synchronization]].

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

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

==Teachers==

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

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

===Video subtitles are not working===

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

==Administrators==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

===Error messages===

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Please, reinstall again the course format plugin.

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

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

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

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

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

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

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

==Any further questions?==

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

[[Category:FAQ]]

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

filter ws

2019-01-28T07:39:54Z

Dpalou:

atto filterws

2019-01-28T07:38:49Z

Dpalou:

==Introduction==
Atto plugin which makes it easier to add WebService filter tags to some content. For more information about the WebService filter plugin please see [https://docs.moodle.org/en/index.php?title=filter_ws this documentation].

==Installation==
You can download this plugin from [https://moodle.org/plugins/atto_filterws the Moodle plugins directory] or from [https://github.com/dpalou/moodle-atto_filterws the source repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../lib/editor/atto/plugins/ directory.

==Add the button to the Atto toolbar==
The button created by this plugin has to be added to the Atto toolbar before it can be used by users.

Please visit Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings.

There, please add the "filterws" keyword to one of the lines in the "editor_atto | toolbar" setting according to your needs.

==How to use==
Once enabled, a new button will appear in the toolbar of the Atto editor.

While creating/editing some content using the Atto editor, select the text to filter and click the "WS" button. In the popup window, select the Origin and the User Agent (optional) you want to apply to the filter. Click "Insert" and the tags will be added to the content.

Example: In the following image we have some content that we want to filter. As you can see, a new button was added to the toolbar:

[[File:attofilterws_toolbar.png|1000px]]

We select the text we want to filter and click the button. A new popup window appears:

[[File:attofilterws_popup.png|400px]]

We select the options we want (in this case, Web and no User Agent) and click Insert. This will add the tags to the content, as you can see in the following screenshot:

[[File:attofilterws_result.png|1000px]]

===Predefined filters===
The site admin can create some predefined filters that users will be able to apply, that way they don't need to remember the Origin and User Agent to apply. By default, this plugin includes a predefined filter to display some content in the official Moodle app.

To define these predefined plugins, go to "Site Administration > Plugins > Text editors > WebService Filter settings > Predefined filters".

atto filterws

2019-01-21T10:10:11Z

Dpalou: /* Predefined filters */

==Introduction==
Atto plugin which makes it easier to add WebService filter tags to some content. For more information about the WebService filter plugin please see [https://docs.moodle.org/en/index.php?title=filter_ws this documentation].

==Installation==
The Atto plugin for the WebService filter isn't in the plugins directory yet, but you can download it [https://github.com/dpalou/moodle-atto_filterws from this repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../lib/editor/atto/plugins/ directory.

==Add the button to the Atto toolbar==
The button created by this plugin has to be added to the Atto toolbar before it can be used by users.

Please visit Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings.

There, please add the "filterws" keyword to one of the lines in the "editor_atto | toolbar" setting according to your needs.

==How to use==
Once enabled, a new button will appear in the toolbar of the Atto editor.

While creating/editing some content using the Atto editor, select the text to filter and click the "WS" button. In the popup window, select the Origin and the User Agent (optional) you want to apply to the filter. Click "Insert" and the tags will be added to the content.

Example: In the following image we have some content that we want to filter. As you can see, a new button was added to the toolbar:

[[File:attofilterws_toolbar.png|1000px]]

We select the text we want to filter and click the button. A new popup window appears:

[[File:attofilterws_popup.png|400px]]

We select the options we want (in this case, Web and no User Agent) and click Insert. This will add the tags to the content, as you can see in the following screenshot:

[[File:attofilterws_result.png|1000px]]

===Predefined filters===
The site admin can create some predefined filters that users will be able to apply, that way they don't need to remember the Origin and User Agent to apply. By default, this plugin includes a predefined filter to display some content in the official Moodle app.

To define these predefined plugins, go to "Site Administration > Plugins > Text editors > WebService Filter settings > Predefined filters".

atto filterws

2019-01-21T08:50:44Z

Dpalou:

==Introduction==
Atto plugin which makes it easier to add WebService filter tags to some content. For more information about the WebService filter plugin please see [https://docs.moodle.org/en/index.php?title=filter_ws this documentation].

==Installation==
The Atto plugin for the WebService filter isn't in the plugins directory yet, but you can download it [https://github.com/dpalou/moodle-atto_filterws from this repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../lib/editor/atto/plugins/ directory.

==Add the button to the Atto toolbar==
The button created by this plugin has to be added to the Atto toolbar before it can be used by users.

Please visit Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings.

There, please add the "filterws" keyword to one of the lines in the "editor_atto | toolbar" setting according to your needs.

==How to use==
Once enabled, a new button will appear in the toolbar of the Atto editor.

While creating/editing some content using the Atto editor, select the text to filter and click the "WS" button. In the popup window, select the Origin and the User Agent (optional) you want to apply to the filter. Click "Insert" and the tags will be added to the content.

Example: In the following image we have some content that we want to filter. As you can see, a new button was added to the toolbar:

[[File:attofilterws_toolbar.png|1000px]]

We select the text we want to filter and click the button. A new popup window appears:

[[File:attofilterws_popup.png|400px]]

We select the options we want (in this case, Web and no User Agent) and click Insert. This will add the tags to the content, as you can see in the following screenshot:

[[File:attofilterws_result.png|1000px]]

===Predefined filters===
The site admin can create some predefined filters that users will be able to apply, that way they don't need to remember the Origin and User Agent to apply. By default, this plugin includes a predefined filter to display some content in the official Moodle app.

To define these prdefined plugins, go to "Site Administration > Plugins > Text editors > WebService Filter settings > Predefined filters".

atto filterws

2019-01-21T08:49:23Z

Dpalou:

==Introduction==
Atto plugin which makes it easier to add WebService filter tags to some content. For more information about the WebService filter plugin please see [https://docs.moodle.org/en/index.php?title=filter_ws this documentation].

==Installation==
The Atto plugin for the WebService filter isn't in the plugins directory yet, but you can download it [https://github.com/dpalou/moodle-atto_filterws from this repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../lib/editor/atto/plugins/ directory.

==Add the button to the Atto toolbar==
The button created by this plugin has to be added to the Atto toolbar before it can be used by users.

Please visit Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings.

There, please add the "filterws" keyword to one of the lines in the "editor_atto | toolbar" setting according to your needs.

==How to use==
Once enabled, a new button will appear in the toolbar of the Atto editor.

While creating/editing some content using the Atto editor, select the text to filter and click the "WS" button. In the popup window, select the Origin and the User Agent (optional) you want to apply to the filter. Click "Insert" and the tags will be added to the content.

Example: In the following image we have some content that we want to filter. As you can see, a new button was added to the toolbar:

[[File:attofilterws_toolbar.png]]

We select the text we want to filter and click the button. A new popup window appears:

[[File:attofilterws_popup.png]]

We select the options we want (in this case, Web and no User Agent) and click Insert. This will add the tags to the content, as you can see in the following screenshot:

[[File:attofilterws_result.png]]

===Predefined filters===
The site admin can create some predefined filters that users will be able to apply, that way they don't need to remember the Origin and User Agent to apply. By default, this plugin includes a predefined filter to display some content in the official Moodle app.

To define these prdefined plugins, go to "Site Administration > Plugins > Text editors > WebService Filter settings > Predefined filters".

atto filterws

2019-01-21T08:48:54Z

Dpalou:

==Introduction==
Atto plugin which makes it easier to add WebService filter tags to some content. For more information about the WebService filter plugin please see [https://docs.moodle.org/en/index.php?title=filter_ws this documentation].

==Installation==
The Atto plugin for the WebService filter isn't in the plugins directory yet, but you can download it [https://github.com/dpalou/moodle-atto_filterws from this repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../lib/editor/atto/plugins/ directory.

==Add the button to the Atto toolbar==
The button created by this plugin has to be added to the Atto toolbar before it can be used by users.

Please visit Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings.

There, please add the "filterws" keyword to one of the lines in the "editor_atto | toolbar" setting according to your needs.

==How to use==
Once enabled, a new button will appear in the toolbar of the Atto editor.

While creating/editing some content using the Atto editor, select the text to filter and click the "WS" button. In the popup window, select the Origin and the User Agent (optional) you want to apply to the filter. Click "Insert" and the tags will be added to the content.

Example: In the following image we have some content that we want to filter. As you can see, a new button was added to the toolbar:

[[File:attofilterws_toolbar.png|thumb]]

We select the text we want to filter and click the button. A new popup window appears:

[[File:attofilterws_popup.png|thumb]]

We select the options we want (in this case, Web and no User Agent) and click Insert. This will add the tags to the content, as you can see in the following screenshot:

[[File:attofilterws_result.png|thumb]]

===Predefined filters===
The site admin can create some predefined filters that users will be able to apply, that way they don't need to remember the Origin and User Agent to apply. By default, this plugin includes a predefined filter to display some content in the official Moodle app.

To define these prdefined plugins, go to "Site Administration > Plugins > Text editors > WebService Filter settings > Predefined filters".

File:attofilterws result.png

2019-01-21T08:44:36Z

Dpalou: Screenshot of how the result looks like.

Screenshot of how the result looks like.

File:attofilterws popup.png

2019-01-21T08:43:51Z

Dpalou: Screenshot of how the popup looks like.

Screenshot of how the popup looks like.

File:attofilterws toolbar.png

2019-01-21T08:43:23Z

Dpalou: Screenshot of how the new button looks like in the Atto toolbar.

Screenshot of how the new button looks like in the Atto toolbar.

atto filterws

2019-01-21T08:42:45Z

Dpalou: /* How to use */

==Introduction==
Atto plugin which makes it easier to add WebService filter tags to some content. For more information about the WebService filter plugin please see [https://docs.moodle.org/en/index.php?title=filter_ws this documentation].

==Installation==
The Atto plugin for the WebService filter isn't in the plugins directory yet, but you can download it [https://github.com/dpalou/moodle-atto_filterws from this repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../lib/editor/atto/plugins/ directory.

==Add the button to the Atto toolbar==
The button created by this plugin has to be added to the Atto toolbar before it can be used by users.

Please visit Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings.

There, please add the "filterws" keyword to one of the lines in the "editor_atto | toolbar" setting according to your needs.

==How to use==
Once enabled, a new button will appear in the toolbar of the Atto editor.

While creating/editing some content using the Atto editor, select the text to filter and click the "WS" button. In the popup window, select the Origin and the User Agent (optional) you want to apply to the filter. Click "Insert" and the tags will be added to the content.

Example: In the following image we have some content we want to filter. As you can see, a new button was added to the toolbar:

[[File:attofilterws_toolbar.png|thumb]]

We select the text we want to filter and click the button. A new popup window appears:

[[File:attofilterws_popup.png|thumb]]

We select the options we want (in this case, Web and no User Agent) and click Insert. This will add the tags to the content, as you can see in the following screenshot:

[[File:attofilterws_result.png|thumb]]

===Predefined filters===
The site admin can create some predefined filters that users will be able to apply, that way they don't need to remember the Origin and User Agent to apply. By default, this plugin includes a predefined filter to display some content in the official Moodle app.

To define these prdefined plugins, go to "Site Administration > Plugins > Text editors > WebService Filter settings > Predefined filters".

filter ws

2019-01-21T08:32:14Z

Dpalou: /* How to use */

==Introduction==
With the WebService filter plugin you can choose if some content should be visible only in web (browser) or only in a WebService client like the Moodle apps. The main purpose of this plugin is to be able to display/hide some content only for the Moodle app.

==Installation==
The WebService filter plugin isn't in the plugins directory yet, but you can download it [https://github.com/dpalou/moodle-filter_ws from this repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../filter/ directory.

==Enabling/Disabling the filter on your site==
The WebService filter must be enabled before it can be used on your Moodle site (it is disabled by default, after installation). To enable (or disable) the plugin site-wide, visit Site Administration > Plugins > Filters > Manage Filters, locate the 'WebService' filter and click on the dropdown box to enable it (or disable it).

==How to use==
You need to enclose the content you want to filter between {fws} tags. Inside the opening {fws} you should specify if you want the content to be displayed in browser (web), in a WS client (ws) or in both of them (any).

<code>
{fws web}content only for web{fws}
{fws ws}content only for ws{fws}
{fws any}content for any request{fws}
</code>

Example: We edit a SCORM description and put the content in the following screenshot:

[[File:filterws_editor.png]]

You can see we have 3 pieces of content. The first one doesn't have any special tag, so it will be displayed everywhere. The second block has the "web" keyword, so it will only be displayed if the user is using a browser. Finally, the last block will only be displayed in a WS client (in our case, the Moodle app). You can see the result in the following screenshots:

[[File:filterws_web.png|1000px]]

[[File:filterws_app.png|320px]]

===Filtering by User Agent===
The filter also lets you filter by User Agent, so the content will only be displayed if the User Agent accessing the content contains a certain text. To do so, you need to add a'ua="MY_REGEXP"' attribute to the {fws} tag, where ''MY_REGEXP'' is the regular expression you want to check (without starting and ending slashes). Please notice that the regular expression is case sensitive. Example:

<code>
{fws ws ua="MoodleMobile\s?$" }content only for the official Moodle app{fws}
{fws any ua="iPhone|iPad|iPod"}content only for iOS devices{fws}
</code>

==Atto plugin==
There is a plugin to add this filter using an Atto button. You can see the documentation [https://docs.moodle.org/en/index.php?title=atto_filterws in here].

filter ws

2019-01-21T08:27:36Z

Dpalou: /* How to use */

==Introduction==
With the WebService filter plugin you can choose if some content should be visible only in web (browser) or only in a WebService client like the Moodle apps. The main purpose of this plugin is to be able to display/hide some content only for the Moodle app.

==Installation==
The WebService filter plugin isn't in the plugins directory yet, but you can download it [https://github.com/dpalou/moodle-filter_ws from this repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../filter/ directory.

==Enabling/Disabling the filter on your site==
The WebService filter must be enabled before it can be used on your Moodle site (it is disabled by default, after installation). To enable (or disable) the plugin site-wide, visit Site Administration > Plugins > Filters > Manage Filters, locate the 'WebService' filter and click on the dropdown box to enable it (or disable it).

==How to use==
You need to enclose the content you want to filter between {fws} tags. Inside the opening {fws} you should specify if you want the content to be displayed in browser (web), in a WS client (ws) or in both of them (any).

<code>
{fws web}content only for web{fws}
{fws ws}content only for ws{fws}
{fws any}content for any request{fws}
</code>

Example: We edit a SCORM description and put the content in the following screenshot:

[[File:filterws_editor.png]]

You can see we have 3 pieces of content. The first one doesn't have any special tag, so it will be displayed everywhere. The second block has the "web" keyword, so it will only be displayed if the user is using a browser. Finally, the last block will only be displayed in a WS client (in our case, the Moodle app). You can see the result in the following screenshots:

[[File:filterws_web.png]]

[[File:filterws_app.png]]

===Filtering by User Agent===
The filter also lets you filter by User Agent, so the content will only be displayed if the User Agent accessing the content contains a certain text. To do so, you need to add a'ua="MY_REGEXP"' attribute to the {fws} tag, where ''MY_REGEXP'' is the regular expression you want to check (without starting and ending slashes). Please notice that the regular expression is case sensitive. Example:

<code>
{fws ws ua="MoodleMobile\s?$" }content only for the official Moodle app{fws}
{fws any ua="iPhone|iPad|iPod"}content only for iOS devices{fws}
</code>

==Atto plugin==
There is a plugin to add this filter using an Atto button. You can see the documentation [https://docs.moodle.org/en/index.php?title=atto_filterws in here].

File:filterws app.png

2019-01-21T08:26:45Z

Dpalou: Example screenshot of the Moodle app.

Example screenshot of the Moodle app.

File:filterws web.png

2019-01-21T08:26:19Z

Dpalou: Example screenshot of browser access.

Example screenshot of browser access.

File:filterws editor.png

2019-01-21T08:25:44Z

Dpalou: Example screenshot of the editor.

Example screenshot of the editor.

filter ws

2019-01-21T08:24:57Z

Dpalou: /* How to use */

==Introduction==
With the WebService filter plugin you can choose if some content should be visible only in web (browser) or only in a WebService client like the Moodle apps. The main purpose of this plugin is to be able to display/hide some content only for the Moodle app.

==Installation==
The WebService filter plugin isn't in the plugins directory yet, but you can download it [https://github.com/dpalou/moodle-filter_ws from this repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../filter/ directory.

==Enabling/Disabling the filter on your site==
The WebService filter must be enabled before it can be used on your Moodle site (it is disabled by default, after installation). To enable (or disable) the plugin site-wide, visit Site Administration > Plugins > Filters > Manage Filters, locate the 'WebService' filter and click on the dropdown box to enable it (or disable it).

==How to use==
You need to enclose the content you want to filter between {fws} tags. Inside the opening {fws} you should specify if you want the content to be displayed in browser (web), in a WS client (ws) or in both of them (any).

<code>
{fws web}content only for web{fws}
{fws ws}content only for ws{fws}
{fws any}content for any request{fws}
</code>

Example: We edit a SCORM description and put the content in the following screenshot:

[[File:filterws_editor.png|thumb]]

You can see we have 3 pieces of content. The first one doesn't have any special tag, so it will be displayed everywhere. The second block has the "web" keyword, so it will only be displayed if the user is using a browser. Finally, the last block will only be displayed in a WS client (in our case, the Moodle app). You can see the result in the following screenshots:

[[File:filterws_web.png|thumb]]

[[File:filterws_app.png|thumb]]

===Filtering by User Agent===
The filter also lets you filter by User Agent, so the content will only be displayed if the User Agent accessing the content contains a certain text. To do so, you need to add a'ua="MY_REGEXP"' attribute to the {fws} tag, where ''MY_REGEXP'' is the regular expression you want to check (without starting and ending slashes). Please notice that the regular expression is case sensitive. Example:

<code>
{fws ws ua="MoodleMobile\s?$" }content only for the official Moodle app{fws}
{fws any ua="iPhone|iPad|iPod"}content only for iOS devices{fws}
</code>

==Atto plugin==
There is a plugin to add this filter using an Atto button. You can see the documentation [https://docs.moodle.org/en/index.php?title=atto_filterws in here].

atto filterws

2019-01-21T07:30:44Z

Dpalou: Created page with "==Introduction== Atto plugin which makes it easier to add WebService filter tags to some content. For more information about the WebService filter plugin please see [https://d..."

==Introduction==
Atto plugin which makes it easier to add WebService filter tags to some content. For more information about the WebService filter plugin please see [https://docs.moodle.org/en/index.php?title=filter_ws this documentation].

==Installation==
The Atto plugin for the WebService filter isn't in the plugins directory yet, but you can download it [https://github.com/dpalou/moodle-atto_filterws from this repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../lib/editor/atto/plugins/ directory.

==Add the button to the Atto toolbar==
The button created by this plugin has to be added to the Atto toolbar before it can be used by users.

Please visit Site administration > Plugins > Text editors > Atto HTML editor > Atto toolbar settings.

There, please add the "filterws" keyword to one of the lines in the "editor_atto | toolbar" setting according to your needs.

==How to use==
Once enabled, a new button will appear in the toolbar of the Atto editor.

While creating/editing some content using the Atto editor, select the text to filter and click the "WS" button. In the popup window, select the Origin and the User Agent (optional) you want to apply to the filter. Click "Insert" and the tags will be added to the content.

===Predefined filters===
The site admin can create some predefined filters that users will be able to apply, that way they don't need to remember the Origin and User Agent to apply. By default, this plugin includes a predefined filter to display some content in the official Moodle app.

To define these prdefined plugins, go to "Site Administration > Plugins > Text editors > WebService Filter settings > Predefined filters".

filter ws

2019-01-21T07:30:14Z

Dpalou: Created page with "==Introduction== With the WebService filter plugin you can choose if some content should be visible only in web (browser) or only in a WebService client like the Moodle apps...."

==Introduction==
With the WebService filter plugin you can choose if some content should be visible only in web (browser) or only in a WebService client like the Moodle apps. The main purpose of this plugin is to be able to display/hide some content only for the Moodle app.

==Installation==
The WebService filter plugin isn't in the plugins directory yet, but you can download it [https://github.com/dpalou/moodle-filter_ws from this repository]. It can be installed using any of the methods supported by Moodle. If you are unsure, please visit [https://docs.moodle.org/en/Installing_plugins#Installing_a_plugin this page].

To install it manually, unzip the plugin in the moodle .../filter/ directory.

==Enabling/Disabling the filter on your site==
The WebService filter must be enabled before it can be used on your Moodle site (it is disabled by default, after installation). To enable (or disable) the plugin site-wide, visit Site Administration > Plugins > Filters > Manage Filters, locate the 'WebService' filter and click on the dropdown box to enable it (or disable it).

==How to use==
You need to enclose the content you want to filter between {fws} tags. Inside the opening {fws} you should specify if you want the content to be displayed in browser (web), in a WS client (ws) or in both of them (any). Some examples:

<code>
{fws web}content only for web{fws}
{fws ws}content only for ws{fws}
{fws any}content for any request{fws}
</code>

===Filtering by User Agent===
The filter also lets you filter by User Agent, so the content will only be displayed if the User Agent accessing the content contains a certain text. To do so, you need to add a'ua="MY_REGEXP"' attribute to the {fws} tag, where ''MY_REGEXP'' is the regular expression you want to check (without starting and ending slashes). Please notice that the regular expression is case sensitive. Example:

<code>
{fws ws ua="MoodleMobile\s?$" }content only for the official Moodle app{fws}
{fws any ua="iPhone|iPad|iPod"}content only for iOS devices{fws}
</code>

==Atto plugin==
There is a plugin to add this filter using an Atto button. You can see the documentation [https://docs.moodle.org/en/index.php?title=atto_filterws in here].

Moodle app FAQ

2018-05-22T11:41:20Z

Dpalou: /* Administrators */

{{Mobile}}
==Students==

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

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

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

The Moodle Mobile 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 Mobile synchronization]].

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

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

==Teachers==

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

See the section 'Media download for offline usage' in [[Creating Moodle Mobile 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?===
Grading assignments is on the [https://docs.moodle.org/dev/Moodle_Mobile_Roadmap roadmap] and will be available shortly.

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

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

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

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

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

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

=== I have problems playing SCORM packages ===
Please refer to [[Moodle Mobile 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.

==Administrators==

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

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

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

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

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

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

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

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

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

The Moodle Mobile 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 Mobile 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".

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

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

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

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

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

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

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

=== Push notifications are not working ===

Please check [[Mobile app notifications#Troubleshooting]]

===Error messages===

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

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

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

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

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

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

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

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

# Go to ''Site administration > Plugins > Web services > Manage tokens''
# Click Add
# Enter the admin username and select 'Moodle Mobile additional features service' (i.e. do NOT leave it as 'Moodle Mobile 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' when accessing My Courses or Course Overview ====

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

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

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

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

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

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

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

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

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

Please, reinstall again the course format plugin.

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

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

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

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

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

===How can I get the app in my language?===

The Moodle Mobile app is currently being translated into many languages. If it is not yet available in your language, please contribute a translation! See [[:dev:Translating Moodle Mobile|Translating Moodle Mobile]] for details of what to do.

==Any further questions?==

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

[[Category:FAQ]]

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

Moodle app FAQ

2017-11-28T08:13:20Z

Dpalou: /* Error messages */

{{Mobile}}
==Students==

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

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

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

The Moodle Mobile 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 Mobile synchronization]].

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

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

==Teachers==

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

See the section 'Media download for offline usage' in [[Creating Moodle Mobile 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?===
Grading assignments is on the [https://docs.moodle.org/dev/Moodle_Mobile_Roadmap roadmap] and will be available shortly.

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

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

=== 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 Mobile SCORM player]].

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

==Administrators==

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

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

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

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

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

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

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

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

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

The Moodle Mobile 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 Mobile 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".

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

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

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

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

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

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

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

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

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

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

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

# Go to ''Site administration > Plugins > Web services > Manage tokens''
# Click Add
# Enter the admin username and select 'Moodle Mobile additional features service' (i.e. do NOT leave it as 'Moodle Mobile 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' 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.

===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 Mobile' as the project
# Add a detailed description, then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (''Settings -> Development -> Device info'', you can send yourself this information by email using the email button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)

===How can I get the app in my language?===

The Moodle Mobile app is currently being translated into many languages. If it is not yet available in your language, please contribute a translation! See [[:dev:Translating Moodle Mobile|Translating Moodle Mobile]] for details of what to do.

==Any further questions?==

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

[[Category:FAQ]]

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

Moodle app FAQ

2017-09-07T13:32:55Z

Dpalou: /* 'Can not find data record in database table external_functions' */

{{Mobile}}
==Students==

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

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

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

The Moodle Mobile 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 Mobile synchronization]].

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

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

==Teachers==

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

See the section 'Media download for offline usage' in [[Creating Moodle Mobile 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?===
Grading assignments is on the [https://docs.moodle.org/dev/Moodle_Mobile_Roadmap roadmap] and will be available shortly.

===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===
See this forum discussion with a workaround: https://moodle.org/mod/forum/discuss.php?d=327342

=== 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 Mobile SCORM player]].

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

==Administrators==

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

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

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

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

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

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

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

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

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

The Moodle Mobile 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 Mobile 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".

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

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

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

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

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

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

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

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

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

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

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

# Go to ''Site administration > Plugins > Web services > Manage tokens''
# Click Add
# Enter the admin username and select 'Moodle Mobile additional features service' (i.e. do NOT leave it as 'Moodle Mobile 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].

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

===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 Mobile' as the project
# Add a detailed description, then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (''Settings -> Development -> Device info'', you can send yourself this information by email using the email button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)

==Any further questions?==

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

[[Category:FAQ]]

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

Moodle app FAQ

2017-08-21T10:33:35Z

Dpalou: /* Error messages */

{{Mobile}}
==Students==

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

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

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

The Moodle Mobile 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 Mobile synchronization]].

==Teachers==

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

See the section 'Media download for offline usage' in [[Creating Moodle Mobile 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?===
Grading assignments is on the [https://docs.moodle.org/dev/Moodle_Mobile_Roadmap roadmap] and will be available shortly.

===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===
See this forum discussion with a workaround: https://moodle.org/mod/forum/discuss.php?d=327342

=== 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 Mobile SCORM player]].

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

==Administrators==

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

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

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

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

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

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

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

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

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

The Moodle Mobile 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 Mobile 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".

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

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

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

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

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

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

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

===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 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. Please, note that to fix this you need direct access to the database and your 'user' 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 Moodle Mobile ====

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

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

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

# Go to ''Site administration > Plugins > Web services > Manage tokens''
# Click Add
# Enter the admin username and select 'Moodle Mobile additional features service' (i.e. do NOT leave it as 'Moodle Mobile 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].

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

===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 Mobile' as the project
# Add a detailed description, then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (''Settings -> Development -> Device info'', you can send yourself this information by email using the email button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)

==Any further questions?==

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

[[Category:FAQ]]

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

Moodle app synchronization

2016-12-21T11:09:07Z

Dpalou:

{{Mobile}}
{{stub}}

== Automatic synchronization ==

When an activity that can generate offline data is opened in the app, that activity will always be synchronized if the device is connected. For example, opening a wiki in online will always try to synchronize '''that''' wiki (not all the wikis). If there is nothing to synchronize or the offline data is synchronized, the synchronization is successful.

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

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

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

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

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

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

== Manual synchronization ==

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

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

Moodle app FAQ

2016-01-21T08:29:04Z

Dpalou: /* I can't get the app to work. Where can I get help? */

{{Mobile}}
== How can I use Moodle on mobile devices? ==

The official [https://download.moodle.org/mobile/ Moodle mobile app] allows you to view and participate in courses from your mobile.

Even without the app, recent versions of Moodle should have mobile-friendly (responsive) themes to improve the user experience when accessing courses on smaller devices.

==I can't get the app to work. Where can I get help?==

If you are a student or teacher, first contact the administrator of your organisation's Moodle site.

If you are the administrator and 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 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". Otherwise the app might work on iOS but not on Android.
# [[Debugging]] is disabled (in ''Site administration > Development > Debugging'')

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

==I think I found a bug with the app. What do I do?==

# 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 [https://tracker.moodle.org/issues/?jql=project%20%3D%20MOBILE searching all the issues]''
# If not, report the bug by clicking the 'Create Issue' link at the top right of the page, selecting 'Moodle Mobile' as the project
# Add a detailed description then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (Settings -> Development -> Device info, you can send yourself this information by email using the e-mail button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)

== The Moodle Mobile app says I need 2.4 or higher ==

Check with the administrator of your site that mobile services have been enabled.

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

The Moodle Mobile app only displays courses you are enrolled in. If you want to see courses as an admin, you need to enrol in them.

== I got the "we lost connection; you need to reconnect. Your token is now invalid." on my custom version of Moodle Mobile ==

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

==I get "Error: 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 Mobile additional features service' (i.e. NOT leave it as 'Moodle Mobile web service')
# Click the 'Save changes' button.

== I get the error "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].

==See also==

* [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum]

[[Category:FAQ]]

[[de:Moodle Mobile FAQ]]
[[es:Moodle para móviles FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app FAQ

2016-01-21T08:27:10Z

Dpalou:

{{Mobile}}
== How can I use Moodle on mobile devices? ==

The official [https://download.moodle.org/mobile/ Moodle mobile app] allows you to view and participate in courses from your mobile.

Even without the app, recent versions of Moodle should have mobile-friendly (responsive) themes to improve the user experience when accessing courses on smaller devices.

==I can't get the app to work. Where can I get help?==

If you are a student or teacher, first contact the administrator of your organisation's Moodle site.

If you are the administrator and 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 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".
# [[Debugging]] is disabled (in ''Site administration > Development > Debugging'')

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

==I think I found a bug with the app. What do I do?==

# 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 [https://tracker.moodle.org/issues/?jql=project%20%3D%20MOBILE searching all the issues]''
# If not, report the bug by clicking the 'Create Issue' link at the top right of the page, selecting 'Moodle Mobile' as the project
# Add a detailed description then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (Settings -> Development -> Device info, you can send yourself this information by email using the e-mail button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)

== The Moodle Mobile app says I need 2.4 or higher ==

Check with the administrator of your site that mobile services have been enabled.

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

The Moodle Mobile app only displays courses you are enrolled in. If you want to see courses as an admin, you need to enrol in them.

== I got the "we lost connection; you need to reconnect. Your token is now invalid." on my custom version of Moodle Mobile ==

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

==I get "Error: 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 Mobile additional features service' (i.e. NOT leave it as 'Moodle Mobile web service')
# Click the 'Save changes' button.

== I get the error "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].

==See also==

* [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum]

[[Category:FAQ]]

[[de:Moodle Mobile FAQ]]
[[es:Moodle para móviles FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]