Note: You are currently viewing documentation for Moodle 3.1. Up-to-date documentation for the latest stable version of Moodle is probably available here: Moodle Mobile FAQ.

Moodle Mobile FAQ: Difference between revisions

From MoodleDocs
(→‎Administrators: I am having problems requesting an airnotifier access key)
 
(47 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Mobile}}
{{Mobile}}
== How can I use Moodle on mobile devices? ==
==Students==
There are currently 3 main ways to use Moodle on mobile devices:


* Users can open Moodle sites in their mobile web browsers.
===How can I get the Moodle Mobile app?===
* Users can download native apps for their mobile devices.
* Admins can configure their Moodle site to be Mobile-accessible through server extensions.


=== Mobile Apps ===
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'.
* The official [[Mobile app]] developed by Juan Leyva with support from Jerome Mouneyrac, Moodle HQ and others.
* [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 can't get the app to work. What do I do?===
* [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 for iPhone and Android?==
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.


The app can be downloaded for free from the Google Play Store and Apple app store.
===What permissions does the app require?===


==How do I get the official Mobile app to work for my Moodle site?==
The app requires the following permissions:


Firstly, your Moodle site must be using Moodle 2.4 or later.
* 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.


Secondly mobile web services must be enabled. See [[Enable mobile web services]] for details.  
===I can't see my course on the app. What do I do?===
Check with your course tutor that you are correctly enrolled.


==Where can I select a theme for mobile devices?==
=== Why can't I upload my assignment on the app?===
Check with your Moodle site administrator.


In ''Site administration > Appearance > Themes > Theme selector''.
===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.


New in Moodle 2.2 onwards is the MyMobile theme especially designed for mobile devices.  
===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.


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


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.


Also, authentication methods like Shibboleth, CAS or LDAP/SSO are not supported currently. See https://tracker.moodle.org/browse/MOBILE-113 for more information.
==Teachers==


You should verify also that Debugging and "Display debug messages" are disabled in your site (go to Administration / Development / Debugging for checking that options)
===How can I enable videos in my course to be downloaded?===


== Moodle Mobile app says I need 2.4 or higher ==
See the section 'Media download for offline usage' in [[Creating Moodle Mobile friendly courses]].


The administrator of your Moodle site (which must be version 2.4 or later) must enable mobile access as follows:
===Which course format is it best to use?===


In Site administration > Plugins > Web services > Mobile tick the 'Enable web services for mobile devices' checkbox, then click the button to save changes.
Topics or weekly course format is best suited to mobile devices.


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.
===How do I make YouTube links open automatically in the app?===


==I can't view the courses tab as an administrator==
Add YouTube links as a [[URL resource]].
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? ==
===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.


Remote translation is not available any more; this feature was removed because due to core changes in Moodle it never worked as expected.
=== 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.


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


== I got the "we lost connection, you need to reconnect. Your token is now invalid." on my custom version of Moodle Mobile ==
===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


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
===Equations or any formula using TeX or MathJax are not displayed in the app===
You must enable the Moodle Text filter pointing to a correct latex binary. Go to 'Site administration -> Plugins -> Filters -> TeX Notation' to enable it, please, also check that the 'Output image format' is set to 'SVG'


And also that you have enabled the moodle/webservice:createtoken capability for the Authenticated User Role at System Context
==Administrators==


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


* [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum]
Assuming you have enabled mobile services on your site, please check:
* 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
# 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.
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"
# [[Debugging]] is disabled (in ''Site administration > Development > Debugging'')
* [http://www.moodlenews.com/mobile/ Moodle News - Mobile] - a breakdown of the mobile projects and products available
# 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].
 
=== 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. Alternatively you may use the search function to find the course you want to see.
 
===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.
 
===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]. Your site registration will be checked and you will be sent an access key in a few days if everything is correct.
 
===Error messages===
 
===='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.
 
===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)
 
==Developers==
 
[https://docs.moodle.org/dev/Moodle_Mobile_FAQ Developers FAQ]
 
==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]]
[[Category:FAQ]]


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

Latest revision as of 08:38, 2 December 2016

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


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.

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

Equations or any formula using TeX or MathJax are not displayed in the app

You must enable the Moodle Text filter pointing to a correct latex binary. Go to 'Site administration -> Plugins -> Filters -> TeX Notation' to enable it, please, also check that the 'Output image format' is set to 'SVG'

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. Alternatively you may use the search function to find the course you want to see.

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.

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 Airnotifier access key manual request form. Your site registration will be checked and you will be sent an access key in a few days if everything is correct.

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. Where can I report it?

  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 doing a search
  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 email button at the bottom)
    • App Log (Settings -> Development -> Show Log, again you can send yourself this information by email)

Developers

Developers FAQ

Any further questions?

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