Difference between revisions of "Moodle app FAQ"

Jump to: navigation, search
(See also: rewording)
(reorganising and rewording)
Line 1: Line 1:
 
{{Mobile}}
 
{{Mobile}}
== How can I use Moodle on mobile devices? ==
+
==Students==
 +
=== 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.  
 
The official [https://download.moodle.org/mobile/ Moodle mobile app] allows you to view and participate in courses from your mobile.  
Line 6: Line 7:
 
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.
 
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 cannot access with old users, but I can with recently created ones! ==
+
===I can't get the app to work. What can I do?===
  
Please, do a "Purge all caches" via the Moodle administration settings, this will solve the problem.
+
Please contact your Moodle site administrator.
 +
 
 +
===I get an error message 'Cannot connect: Verify that you have typed correctly the URL and that your site uses Moodle 2.4 or later'===
 +
 
 +
# Check that you have entered the correct URL for your Moodle site. If your site uses a redirection such as <nowiki>https://mysite.com</nowiki> -> <nowiki>https://mysite.com/moodle/</nowiki> then you should enter the latter URL.
 +
# If you are still unable to connect, contact your Moodle site administrator.
 +
 
 +
==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]].
 +
 
 +
===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]].
  
==I can't get the app to work. Where can I get help?==
+
==Administrators==
  
If you are a student or teacher, first contact the administrator of your organisation's Moodle site.
+
===I can't get the app to work. What can I do?===
  
If you are the administrator and you have enabled mobile services on your site, please check:
+
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 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.
 
# 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'')
 
# [[Debugging]] is disabled (in ''Site administration > Development > Debugging'')
# Check that 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).
+
# 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'').
  
 
If you still have a problem, please post in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum].
 
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?==
+
=== 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.
  
# 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)
+
===My Moodle site uses a SSO auth method (Shibboleth, CAS, Google OAuth, etc) and the app is not working===
# ''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 (Cannot connect: Verify that you have typed correctly the URL and that your site uses Moodle 2.4 or later) ==
+
You must install the [[Moodle Mobile additional features]] plugin.
  
* Check with the administrator of your site that mobile services have been enabled.
+
===Error messages===
* Check that you are using your Moodle site full URL. Some installations use redirects like: https://mysite.com -> https://mysite.com/moodle/, in that case you'll have to use the last URL
 
* If you are using https, please, check that the certificate is valid (see [[Moodle_Mobile_FAQ#I_can.27t_get_the_app_to_work._Where_can_I_get_help.3F || I can't get the app to work. Where can I get help?]] question above)
 
  
==I can't view the courses tab as an administrator==
+
===='Cannot connect: Verify that you have typed correctly the URL and that your site uses Moodle 2.4 or later'====
  
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.
+
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)
  
== I got the "we lost connection; you need to reconnect. Your token is now invalid." on my custom version of Moodle Mobile ==
+
===='We lost connection; you need to reconnect. Your token is now invalid.' on my custom version of Moodle Mobile ====
  
 
Please check:
 
Please check:
Line 48: Line 69:
 
# You have enabled the moodle/webservice:createtoken capability for the authenticated user
 
# 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==
+
===='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:
 
You need to create a token for the admin account (only) as follows:
Line 54: Line 75:
 
# Go to ''Site administration > Plugins > Web services > Manage tokens''
 
# Go to ''Site administration > Plugins > Web services > Manage tokens''
 
# Click Add
 
# Click Add
# Enter the admin username and select 'Moodle Mobile additional features service' (i.e. NOT leave it as 'Moodle Mobile web service')
+
# 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.
 
# Click the 'Save changes' button.
  
== I get the error "Invalid response value detected" when accessing the site ==
+
===='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].
 
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].
  
== I get the error "A required parameter (username) was missing" ==
+
===='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.
+
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), please read this for more information:
+
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
* http://stackoverflow.com/questions/228225/prevent-redirection-of-xmlhttprequest
 
* 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
+
The solution is to change the HTTP redirect and use an HTML page with a meta tag or JavaScript redirect.
  
==How can I enable videos in my course to be downloaded?==
+
===I think I found a bug with the app. What do I do?===
  
See the section 'Media download for offline usage' in [[Creating Moodle Mobile friendly courses]].
+
# 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]''
==My Moodle sites uses a SSO auth method (Shibboleth, CAS, Google OAuth, etc..) and the app is not working==
+
# 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
You must install the [[Moodle Mobile additional features]] plugin
+
# 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)
  
 
==Any further questions?==
 
==Any further questions?==

Revision as of 14:48, 4 November 2016

Students

How can I use Moodle on mobile devices?

The official 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. What can I do?

Please contact your Moodle site administrator.

I get an error message 'Cannot connect: Verify that you have typed correctly the URL and that your site uses Moodle 2.4 or later'

  1. Check that you have entered the correct URL for your Moodle site. If your site uses a redirection such as https://mysite.com -> https://mysite.com/moodle/ then you should enter the latter URL.
  2. If you are still unable to connect, contact your Moodle site administrator.

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.

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.

Administrators

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

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

  1. 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: SSL Checker. All the checks must be ok, including the "Certificate Chain Complete". Otherwise the app might work on iOS but not on Android.
  2. Debugging is disabled (in Site administration > Development > Debugging)
  3. 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).

If you still have a problem, please post in the 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

You must install the Moodle Mobile additional features plugin.

Error messages

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

Please check:

  1. Mobile services are enabled for the site.
  2. The user is entering the correct URL for the site (see FAQ above)
  3. 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:

  1. You have followed all the steps listed in Moodle Mobile Developing a plugin tutorial
  2. 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:

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

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

  1. Log in to the Moodle Mobile tracker (you'll need to create a tracker account if you've not done so previously)
  2. Check whether the issue has already been reported by searching all the issues
  3. If not, report the bug by clicking the 'Create Issue' link at the top right of the page, selecting 'Moodle Mobile' as the project
  4. Add a detailed description then click the Create button
  5. 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)

Any further questions?

Please post in the Moodle for mobile forum on moodle.org.