Moodle Mobile FAQ: Difference between revisions

Latest revision as of 16:11, 17 May 2016

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

If you still have a problem, please post in the Moodle for mobile forum.

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

Log in to the Moodle Mobile tracker (you'll need to create a tracker account if you've not done so previously)
Check whether the issue has already been reported by 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)

Check with the administrator of your site that mobile services have been enabled.
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 | 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

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 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 How to enable Moodle Mobile App for all accounts.

I get the error "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), please read this for more information:

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

@@ Line 1: / Line 1: @@
 {{Mobile}}
 == How can I use Moodle on mobile devices? ==
-There are currently 3 main ways to use Moodle on mobile devices:
-* Users can open Moodle sites in their mobile web browsers.
+The official [https://download.moodle.org/mobile/ Moodle mobile app] allows you to view and participate in courses from your mobile.
-* Users can download native apps for their mobile devices.
-* Admins can configure their Moodle site to be Mobile-accessible through server extensions.
-=== Mobile Apps ===
+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.
-* The official [[Mobile app]] developed by Moodle HQ.
-* [http://www.moodletouch.com MoodleTouch] (aka ''mTouch'') for iOS, created by Ali OzGur
-* [http://mpage.hk/ mPage] for iOS and Android (work in progress), created by Mass Media HK
-* [http://codeguild.org/app/mbot/ Mbot] for Android, created by Code Guild
-* The [https://docs.moodle.org/23/en/Mobile_app My Moodle app] for iPhone, created by Moodle HQ (no longer being developed)
-* [https://market.android.com/details?id=com.ivoid.droodle Droodle] - an Android client for the Moodle 2.1 platform
-=== Server-side ===
+== I cannot access with old users, but I can with recently created ones! ===
-* [http://www.mobilemoodle.org/momo18/ MoMo] (Moodle for Mobiles) - Requires a server extension and a client app; supports most mobile OSes including Symbian.
-* [http://code.google.com/p/moodbile/ Moodbile] - Reference implementation of Moodle Web Services. Under development.
-* [http://iphone.moodle.com.au iPhone4Moodle] - Under development.
-==Where can I download the official Mobile app? ==
+Please, do a "Purge all caches" via the Moodle administration settings, this will solve the problem.
-Please, visit https://download.moodle.org/mobile/ for download links
+==I can't get the app to work. Where can I get help?==
-==How do I get the official Mobile app to work for my Moodle site?==
+If you are a student or teacher, first contact the administrator of your organisation's Moodle site.
-Firstly, your Moodle site must be using Moodle 2.4 or later.
+If you are the administrator and you have enabled mobile services on your site, please check:
-Secondly mobile web services must be enabled. See [[Enable mobile web services]] for details.
+# 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'')
+# 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).
-==Where can I select a theme for mobile devices?==
+If you still have a problem, please post in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum].
-In ''Site administration > Appearance > Themes > Theme selector''.
+==I think I found a bug with the app. What do I do?==
-New in Moodle 2.2 onwards is the MyMobile theme especially designed for mobile devices.
+# 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)
-== I can't access my Moodle site using the app ==
+== 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) ==
-Notice that by default Mobile access is disabled in Moodle. The administrator of your Moodle site (which must be version 2.4 or later) must enable mobile access.
+* Check with the administrator of your site that mobile services have been enabled.
+* 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)
-Authentication methods like Shibboleth, CAS or LDAP/SSO are supported only using a Moodle add-one (See [[Moodle Mobile additional features]])
+==I can't view the courses tab as an administrator==
-You should verify also that Debugging and "Display debug messages" are disabled in your site (go to Administration / Development / Debugging for checking that options)
-If your site uses a SSL certificate it must be a trusted certificate. For security reasons the app doesn't work with self-signed certificates. There are some certificates entities that provides certificates not trusted by the Android browser (but trusted in desktop browsers) like GoDaddy and TERENA SSL CA. Here you can find a workaround/solution: https://moodle.org/mod/forum/discuss.php?d=268963#p1172128
-== Moodle Mobile app says I need 2.4 or higher ==
+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.
-The administrator of your Moodle site (which must be version 2.4 or later) must enable mobile access as follows:
+== I got the "we lost connection; you need to reconnect. Your token is now invalid." on my custom version of Moodle Mobile ==
-In Site administration > Plugins > Web services > Mobile tick the 'Enable web services for mobile devices' checkbox, then click the button to save changes.
-Some Moodle sites uses special authentication methods like Shibboleth, CAS or LDAP/SSO that currently are not supported. See https://tracker.moodle.org/browse/MOBILE-113 for more information.
-==I can't view the courses tab as an administrator==
-Moodle Mobile app is not suited for administrators ad the app displays only the courses you are enrolled in (not the courses you can see by capabilities).Note that the targeted user of the app is mainly a student or teacher.If you want to see the courses as an admin, you must be enrolled in the courses. You can use a non visible role or something similar.
-== What happened to the Mobile app remote translation feature? ==
+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
-Remote translation is not available any more; this feature was removed because due to core changes in Moodle it never worked as expected.
+==I get "Error: No permission to create web service token for the service local_mobile" when attempting to log in as an admin==
-Language packs comes now with the app bundle. If you want to contribute a translation of the app you can do so on the [http://lang.moodle.org Moodle translation site]. The component name is local_moodlemobileapp. See the forum discussion [https://moodle.org/mod/forum/discuss.php?d=252704 Moodle Mobile translation to other languages] for more details.
+You need to create a token for the admin account (only) as follows:
-== I got the "we lost connection, you need to reconnect. Your token is now invalid." on my custom version of Moodle Mobile ==
+# 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.
-Please, verify that you have followed all the steps here: https://docs.moodle.org/dev/Moodle_Mobile_Developing_a_plugin_tutorial#Set_up_your_Moodle_installation
+== I get the error "Invalid response value detected" when accessing the site ==
-And also that you have enabled the moodle/webservice:createtoken capability for the Authenticated User Role at System Context
+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 got the error "Automatically token generation is not available to site administrators" ==
+== I get the error "A required parameter (username) was missing" ==
-This can be easily solved, administrators must create a token manually in Moodle (Plugins > Web Services > Manage tokens) for the local_mobile service.
+This may happen if your site implements HTTP Redirects, the request is redirected by the browser not passing the POST parameters.
-== I got the following error "Invalid response value detected" ==
+Unfortunately, this is something we cannot control in the Mobile app (it can't be handled via Javascript), please read this for more information:
+* http://stackoverflow.com/questions/228225/prevent-redirection-of-xmlhttprequest
+* http://stackoverflow.com/questions/4168784/ajax-redirection-handling
-Sometimes it happens the user quota global setting is not an integer, when it should be, see https://moodle.org/mod/forum/discuss.php?d=320873 for more information
+The solution is to change the HTTP Redirect and use an HTML page with a meta tag or Javascript redirect
 ==See also==
 * [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum]
-* Tracker area [http://tracker.moodle.org/browse/MOBILE Moodle for Mobiles]
-* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=162872 Proposal for Supporting Mobile Themes and Browser Detection] forum discussion
-* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"
-* [http://www.moodlenews.com/mobile/ Moodle News - Mobile] - a breakdown of the mobile projects and products available
 [[Category:FAQ]]
 [[de:Moodle Mobile FAQ]]
-[[es:Moodle para móviles FAQ]]
+[[ca:Moodle Mobile FAQ]]
+[[es:Moodle Mobile FAQ]]
 [[fr:Moodle pour les mobiles]]
 [[ja:モバイルMoodle FAQ]]

Documentation