MoodleDocs - User contributions [en]

Moodle Mobile guide for admins

2017-11-30T18:14:39Z

Jleyva: /* Custom language strings */

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

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

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

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

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

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

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

==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 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 Administration > Site administration > Plugins > Message outputs > Mobile Notifications.

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.

{{New features}}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.

== Configuring the app from your site ==

{{New features}}Moodle 3.3 or with the [[Moodle Mobile additional features]] plugin new settings in the Site administration enable admins to configure the app.

* In Moodle 3.3 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===

Disable app functionalities for your site. If there's a feature you don't want to make available via the app you can disable it here.

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

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.

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

Please, note that if the app is using a language not indicated in the previous list of strings, the string will be translated to the first language indicated in the list.

If you want strings tied to a language, you can append _only to the language code, for example:
mm.user.student|Learner|en_only
mm.user.student|Aprendiz|es_only

Will display student translated only when the app language is English or Spanish.

The complete list of string identifiers is listed in https://raw.githubusercontent.com/moodlehq/moodlemobile-phonegapbuild/master/build/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".

==See also==

* [[Moodle Mobile FAQ]] for other administration-related mobile app questions.
* [[:dev: Moodle Mobile Roadmap]]
* [[:dev:Moodle Mobile release notes]]
* [[:dev:Moodle Mobile|Moodle Mobile developer docs]]
* [[Moodle Mobile availability plugin]]
* [[Mobile web services]]

[[es:Moodle Mobile guía para administradores]]
[[de:Moodle Mobile - Anleitung für Administrator/innen]]

Moodle Mobile FAQ

2017-11-08T15:10:39Z

Jleyva: /* Teachers */

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

=== My links to images or files in the course legacy file system are not working in the app ===

The Mobile app doesn't support the legacy file system. You should migrate your files to the new file system.

==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].
# Your courses or categories are using a theme that was uninstalled from the server. Go to the database and in the user, course and course_categories table check the theme field to remove the references.
# The user or course "lang" field in the database is set to a language pack not installed on 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.

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

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

2017-11-08T11:37:05Z

Jleyva: /* 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===
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].
# Your courses or categories are using a theme that was uninstalled from the server. Go to the database and in the user, course and course_categories table check the theme field to remove the references.
# The user or course "lang" field in the database is set to a language pack not installed on 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.

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

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

2017-11-08T09:33:11Z

Jleyva: /* 'Invalid response value detected' when accessing the site */

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

Your courses or categories are using a theme that was uninstalled from the server. Go to the database and in the user, course and course_categories table check the theme field to remove the references.

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

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

2017-11-08T09:31:13Z

Jleyva: /* 'Invalid response value detected' when accessing the site */

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

Your courses or categories are using a theme that was uninstalled from the server. Go to the database and in the course and course_categories table check the theme field to remove the references.

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

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

2017-10-03T06:44:20Z

Jleyva: /* 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===
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.

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

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

2017-09-07T10:18:50Z

Jleyva: /* '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 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 Mobile FAQ

2017-09-04T10:34:35Z

Jleyva:

{{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 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 Mobile features

2017-08-03T10:28:20Z

Jleyva: /* Features summary */

{{Mobile}}
__NOTOC__
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile01.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:02connectwithcourseparticipants.png|600px]]
<div class="caption">
<h4>Connect with course participants</h4>
<p> Infinite scrolling improves access to the participant view, with the complete user profile now displayed and available from every page. </p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:10PulltoRefresh.png|600px]]
<div class="caption">
<h4>Pull to refresh</h4>
<p>Most screens will allow you to pull to refresh, improving the real-time participation experience.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:Mobile orientation.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:03coursecontent.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:04ActivityCompletionCheckboxes.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:05Grades.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:06Notes.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:07Messages.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:08Calendar.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:09PrivateFiles.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:12Notifications.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: MobileChoice.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:MobileappChat.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:MobileSurvey.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: coursesearchmobile.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:enrolmemobile.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:scorm syncing.png|600px]]
<div class="caption">
<h4>Play SCORM packages on and off-line</h4>
<p>The [[Moodle Mobile 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:MobDownloadAllSections.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:MMobileGlossary.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: MobileQuiz.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:31MO.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: Docs_Mobile_GradesLink.png|600px]]
<div class="caption">
<h4>Students: See your course grades easily</h4>
<p>A new Grades link allows you to quickly view course grades.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:Mobile_app_Teacher_Grading.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: Docs_Mobile_BadgesDisplay.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:Docs_Mobile_Preferences.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>
====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
* 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) except the Workshop module
* [[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)

==Activities & Resources Support==

[[File:moodlemobile_activities_resources.png]]

==Comparison of features in different versions==
[[File:30_moodlemobile_features.png]]

=== Languages ===

Over 15 languages are currently supported: Arabic, Basque, Catalan, Chinese, Czech, Dutch, English, French, German, Hebrew, Hungarian, Italian, Japanese, Mexican Spanish, Portuguese, Russian, Spanish, Swedish.

[[ca:Característiques_Moodle_Mobile]]
[[es:Características de Moodle Mobile]]
[[fr:Fonctionnalités de l'app mobile]]
[[de:Moodle Mobile - 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 Desktop

2017-07-29T08:19:09Z

Jleyva:

{{Mobile}}
==What is Moodle Desktop?==
[[File:desktop course overview.png|thumb|Course overview in Moodle Desktop]]
Moodle Desktop is our solution to accessing your Moodle courses on desktop and/or Surface tablets.

With Moodle Desktop you can experience all these popular (and more) functionalities that are found in Moodle Mobile, on your desktop or surface tablets:
* View course activities and download materials offline
* Quickly find and contact other people in your courses or organisation
* Attempt quizzes, post in forums, play SCORM packages, edit wiki pages and more - on and offline
* Upload images, audio, videos and other files from your desktop or tablet
* View deadlines filtered by dates or course subjects
* Receive instant notifications for messages, forum posts, calendar events and deadlines
* Track your learning progress or grades
[[File:desktop assignment grading.png|thumb|Assignment grading in Moodle Desktop]]
==How do I get Moodle desktop?==

Go to [https://download.moodle.org/desktop/ Moodle downloads: Moodle Desktop].

Moodle Desktop is now available for Windows and Surface tablets (Version 10 and above with the Windows Anniversary Update) and will be available soon for Windows 7 and 8.

The Desktop app will soon be released for:
* macOS: Minimum macOS version supported is macOS 10.9
* Linux: Ubuntu 12.04, Fedora 21 and Debian 8 and later

==Using Moodle Desktop==

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

Teachers, for info on improving your courses for access via Moodle Desktop, please see [[Creating Moodle Mobile friendly courses]].

==How will Moodle Desktop get updated to the latest release?==

As with Moodle Mobile, the desktop version will be updated by Moodle HQ every two months.

==Why has Moodle released Moodle Desktop?==

Moodle Desktop is another step that Moodle is taking to make online learning more accessible - for students, educators and other users - who are utilising various operating systems and devices.

Feedback has shown that Moodle users in the K-12, higher education and workplace sectors would like the option of accessing their courses through desktops, laptops or tablets, which are the devices often provided by their institutions or organisations.”

Making Moodle Desktop available in Windows operating system is also important, as many of our users are also studying and learning in this environment.

==Where can I get support for Moodle Desktop?==

If you have any questions or feedback about Moodle Desktop, please join the discussions in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum].

== See also ==

* [https://docs.moodle.org/dev/Moodle_Desktop_release_notes Moodle Desktop release notes]

[[es:Escritorio Moodle]]

Running Moodle Mobile in Desktop

2017-07-29T08:13:29Z

Jleyva: Redirected page to Moodle Desktop

#REDIRECT [[Moodle Desktop]]

File:30 moodlemobile features.png

2017-07-29T07:57:24Z

Jleyva: Jleyva uploaded a new version of File:30 moodlemobile features.png

Moodle Mobile features

2017-07-29T07:56:10Z

Jleyva:

{{Mobile}}
__NOTOC__
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile01.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:02connectwithcourseparticipants.png|600px]]
<div class="caption">
<h4>Connect with course participants</h4>
<p> Infinite scrolling improves access to the participant view, with the complete user profile now displayed and available from every page. </p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:10PulltoRefresh.png|600px]]
<div class="caption">
<h4>Pull to refresh</h4>
<p>Most screens will allow you to pull to refresh, improving the real-time participation experience.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:Mobile orientation.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:03coursecontent.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:04ActivityCompletionCheckboxes.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:05Grades.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:06Notes.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:07Messages.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:08Calendar.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:09PrivateFiles.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:12Notifications.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: MobileChoice.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:MobileappChat.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:MobileSurvey.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: coursesearchmobile.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:enrolmemobile.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:scorm syncing.png|600px]]
<div class="caption">
<h4>Play SCORM packages on and off-line</h4>
<p>The [[Moodle Mobile 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:MobDownloadAllSections.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:MMobileGlossary.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: MobileQuiz.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:31MO.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: Docs_Mobile_GradesLink.png|600px]]
<div class="caption">
<h4>Students: See your course grades easily</h4>
<p>A new Grades link allows you to quickly view course grades.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:Mobile_app_Teacher_Grading.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: Docs_Mobile_BadgesDisplay.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:Docs_Mobile_Preferences.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>
====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
* 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) except the Workshop module
* [[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 and iOS 6 onwards)

==Activities & Resources Support==

[[File:moodlemobile_activities_resources.png]]

==Comparison of features in different versions==
[[File:30_moodlemobile_features.png]]

=== Languages ===

Over 15 languages are currently supported: Arabic, Basque, Catalan, Chinese, Czech, Dutch, English, French, German, Hebrew, Hungarian, Italian, Japanese, Mexican Spanish, Portuguese, Russian, Spanish, Swedish.

[[ca:Característiques_Moodle_Mobile]]
[[es:Características de Moodle Mobile]]
[[fr:Fonctionnalités de l'app mobile]]
[[de:Moodle Mobile - 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

File:30 moodlemobile features.png

2017-07-29T07:53:50Z

Jleyva: Jleyva uploaded a new version of File:30 moodlemobile features.png

File:moodlemobile activities resources.png

2017-07-29T07:50:07Z

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

Moodle Mobile FAQ

2017-07-25T07:57:55Z

Jleyva:

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

You must install the [[Moodle Mobile additional features]] plugin. Please, follow all the configuration steps one by one and double check that everything is set-up correctly.

If once installed and configure 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.

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

2017-07-14T09:44:54Z

Jleyva: /* Configuring the app from your site */

Moodle Mobile FAQ

2017-07-10T13:39:08Z

Jleyva: /* SSO is not working with my custom auth plugin */

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

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

You must install the [[Moodle Mobile additional features]] plugin. Please, follow all the configuration steps one by one and double check that everything is set-up correctly.

If once installed and configure 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.

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

2017-07-07T19:52:08Z

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

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

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

You must install the [[Moodle Mobile additional features]] plugin. Please, follow all the configuration steps one by one and double check that everything is set-up correctly.

If once installed and configure 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 CAS 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.

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

2017-07-07T10:27:16Z

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

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

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

You must install the [[Moodle Mobile additional features]] plugin. Please, follow all the configuration steps one by one and double check that everything is set-up correctly.

If once installed and configure 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".

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

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

2017-07-07T10:18:18Z

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

==Administrators==

===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 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'')
# 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===

You must install the [[Moodle Mobile additional features]] plugin. Please, follow all the configuration steps one by one and double check that everything is set-up correctly.

If once installed and configure 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".

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

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

2017-06-27T09:01:39Z

Jleyva: /* Requirements */

{{Mobile}}
==Features==

The Moodle Mobile SCORM player enables the playing of SCORM 1.2 packages online and offline.

When a user loses connectivity, offline mode is enabled automatically and all interactions that are tracked by the SCORM package are saved.

When a user is online again, the offline attempt is synchronised back to the Moodle site, either merging it with other incomplete attempts on the site or saving it as a new attempt.

== Requirements ==

The Moodle Mobile SCORM player requires Moodle 3.0 onwards. In ''Site administration > Plugins > Activity Modules > SCORM Package'' the setting 'Protect package downloads' should be disabled (default setting).

The Moodle Mobile SCORM player may be used on sites running Moodle 2.6 to Moodle 2.9 if the [[Moodle Mobile additional features]] plugin is installed.

If the playing of SCORM packages offline is not desired, the setting 'Protect package downloads' may be enabled. If the Moodle Mobile additional features plugin is being used, the setting can be found in ''Site administration > Plugins > Local plugins > Moodle Mobile additional features''.

The ZIP file containing the SCORM contents should not be Windows specific. If your SCORM package contains directories using the inverted path separator "\" they won't work in Android.

== Technical details ==

The Moodle Mobile SCORM player provides support for:

* SCORM 1.2 packages
* Objectives, interactions and prerequisites
* SCO navigation via nav.event
* Uploaded packages, remote zip packages and zip packages in any type of repository supported by Moodle

The Moodle Mobile SCORM player does not currently support:

* Remote imsmanifest.xml packages or file system repository unzipped SCORMS
* Opening of packages outside the app e.g. in a new browser window
* JavaScript pop-ups via window.open (Mobile device limitation)

==Tips for Moodle Mobile friendly SCORM packages ==

* Try to reduce the size of the images and use mobile-compatible formats e.g. png
* Try to reduce the size of videos and use mobile-compatible formats e.g. mp4
* Avoid using Flash or FLV
* Avoid using images, files or media on remote sites
* Avoid using pop-ups
* Avoid using advanced HTML5 features, as they may not be supported by old devices such as iOS 4 or Android < 4.4
* Avoid having a left navigation menu as part of the SCORM package, as this reduces the space available for the package content

[[Category:SCORM]]

Moodle Mobile FAQ

2017-06-27T08:59:22Z

Jleyva: /* Teachers */

{{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 SCOR packages ===
Please, refer to [[Moodle Mobile SCORM player]]

==Administrators==

===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 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'')
# 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===

You must install the [[Moodle Mobile additional features]] plugin. Please, follow all the configuration steps one by one and double check that everything is set-up correctly.

If once installed and configure 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".

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

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

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

2017-06-24T08:31:15Z

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

Moodle Mobile FAQ

2017-06-19T13:46:57Z

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

Moodle Mobile features

2017-05-26T14:46:44Z

Jleyva: /* Activities & Resources Support */

{{Mobile}}
__NOTOC__
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile01.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:02connectwithcourseparticipants.png|600px]]
<div class="caption">
<h4>Connect with course participants</h4>
<p> Infinite scrolling improves access to the participant view, with the complete user profile now displayed and available from every page. </p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:10PulltoRefresh.png|600px]]
<div class="caption">
<h4>Pull to refresh</h4>
<p>Most screens will allow you to pull to refresh, improving the real-time participation experience.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:Mobile orientation.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:03coursecontent.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:04ActivityCompletionCheckboxes.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:05Grades.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:06Notes.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:07Messages.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:08Calendar.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:09PrivateFiles.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:12Notifications.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: MobileChoice.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:MobileappChat.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:MobileSurvey.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: coursesearchmobile.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:enrolmemobile.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:scorm syncing.png|600px]]
<div class="caption">
<h4>Play SCORM packages on and off-line</h4>
<p>The [[Moodle Mobile 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:MobDownloadAllSections.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:MMobileGlossary.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: MobileQuiz.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:31MO.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: Docs_Mobile_GradesLink.png|600px]]
<div class="caption">
<h4>Students: See your course grades easily</h4>
<p>A new Grades link allows you to quickly view course grades.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:Mobile_app_Teacher_Grading.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: Docs_Mobile_BadgesDisplay.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:Docs_Mobile_Preferences.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>
====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 the book module and IMS CP
* 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
* Participate in choices
* Participate in chats
* Participate in surveys
* Access external tools (LTI)
* Course search
* Self-enrolment in courses
* Access courses with guest access enrolment method enabled
* [[Moodle_Mobile_SCORM_player|SCORM player]]
* Follow app-specific activity links (see [[Creating Moodle Mobile friendly courses]] for details)
* Browse glossary entries
* [[Moodle Mobile quiz|Attempt quizzes]]
* Browse your learning plans
* View competencies of students in your course
* Browse a wiki and edit and create new pages
* [[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 and iOS 6 onwards)

==Activities & Resources Support==

[[File:moodlemobile_activities_resources.png]]

==Comparison of features in different versions==
[[File:30_moodlemobile_features.png]]

=== Languages ===

Over 15 languages are currently supported: Arabic, Basque, Catalan, Chinese, Czech, Dutch, English, French, German, Hebrew, Hungarian, Italian, Japanese, Mexican Spanish, Portuguese, Russian, Spanish, Swedish.

[[ca:Característiques_Moodle_Mobile]]
[[es:Características de Moodle Mobile]]
[[fr:Fonctionnalités de l'app mobile]]
[[de:Moodle Mobile - 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

File:moodlemobile activities resources.png

2017-05-26T14:46:00Z

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

admin/setting/mobilefeatures

2017-04-27T15:25:25Z

Jleyva: Created page with "== Language == Words and phrases displayed in the app can be customised via the "Custom language strings" (customlangstrings) setting in Administration > Site administration..."

== Language ==

Words and phrases displayed in the app can be customised via the "Custom language strings" (customlangstrings) setting in Administration > Site administration > Mobile app > Mobile features

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

For a complete list of string identifiers see [https://raw.githubusercontent.com/moodlehq/moodlemobile-phonegapbuild/master/build/lang/en.json this file]:

There, in each line at the left (before the colons), is the string identifier. See the following example:

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

In the same line, at the right of the colons is the language string (in this case in English)

[[Category:Mobile]]

Moodle Mobile additional features

2017-03-24T07:43:32Z

Jleyva: /* Enable authentication for sites using SSO methods (like Shibboleth and CAS) */

{{Mobile}}
{{Infobox plugin
|type = Local plugin
|entry = http://moodle.org/plugins/view.php?plugin=local_mobile
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/13930
|discussion = https://moodle.org/mod/forum/view.php?id=7798
|maintainer = [[User:Juan Leyva|Juan Leyva]]
}}

The Moodle Mobile additional features plugin provides new features and web services for the Moodle Mobile app which are currently only available in the latest Moodle version.

This plugin is officially developed and maintained by Moodle HQ

== How it works ==

Once installed the plugin creates a new service "Moodle Mobile additional features". The Mobile app checks if this service is enabled. If not, the Mobile app falls backs to the standard core Mobile app service.

Please, open [[Moodle Mobile features]] to check what new features are added to your site depending on your Moodle version.

== Features ==

* Support for sites using SSO authentication methods (Shibboleth, CAS and Google OAuth 2)
* Support for sites using MNet authentication (Moodle Network authentication)
* Support for push notifications in Moodle sites prior to version 2.6

=== Enable authentication for sites using SSO methods (like Shibboleth and CAS) ===

VERY IMPORTANT NOTE: If SSO is not working for your (or it is failing randomly), you'd need to disable the "Auto login guest" option "autologinguests". This setting may not be compatible with the SSO via app in some sites (it should work fine in Moodle 3.2 onwards).

SSO and MNet authentication is not supported in the Windows 8 and Windows Phone 8 apps

Once the plugin is installed, you need to go to Site administration > Plugins > Local plugins > Moodle Mobile additional features

There you can choose the "Type of login":
; '''Via the app''' : Is the default login, the user must introduce his credentials in the app
; '''Via a browser window''' : A new browser instance is open in the mobile device pointing to the login form in the Moodle site (which may again redirect to external identity providers if required). The user must introduce his credentials there. This is the option that must be selected for sites using SSO methods (or for sites that wants to force the user to authenticate in the site, not in the app)

<mediaplayer>https://www.youtube.com/watch?v=cl8rsyyyg9g</mediaplayer>

When using the "Via a browser window" option, you can optionally specify an URL scheme to be used by the system to open the Mobile app. By default, the URL scheme used to open the app will be the one indicated by the own app during the SSO process. If you've developed a custom app using its own URL scheme and you want to allow only SSO logins via your app, you can indicate there an URL scheme. The site will detect that setting and will use it instead of the value indicated by the app.

=== Configuring the app from your site ===

* Disable app functionalities for your site. If there's a feature you don't want to make available via the app you can disable it here.
* Rename app text strings.
* Add new items in the app's main menu (the side menu).
* Replace the Change site option with a "Log out" one to force the users to enter their credentials on their next access.

== Installation ==

# Unpack the zip file into the local/ directory. A new directory will be created called local/mobile.
# Go to ''Site administration > Notifications'' to complete the plugin installation.
# Go to ''Site administration > Mobile app > Mobile settings'' and enable web services for mobile devices (Remember to save the changes)
# Go to ''Site administration > Plugins > Web services > External services'', edit "Moodle Mobile additional features" and check the "Enabled" field, then save changes.
# Go to ''Site administration > Users > Permissions > Define roles'', edit the Authenticated user role and allow the capability moodle/webservice:createtoken.

Note: You need to have upgraded the Moodle Mobile app to version 1.4.4.

If you are currently using the Moodle Mobile app, you will need to log out of all your sites in order for the app to detect the new service.

== Admin users, please read ==

This plugin installs a new service in your Moodle installation, the automatic token creation for this type of services is forbidden for admin users. This means that admin users will not be able to use the Mobile app.

This can be solved easily, administrators must create a token manually in Moodle (''Plugins > Web Services > Manage tokens'') for the local_mobile service. '''Note:''' Be sure to toggle the default "Moodle mobile web services" setting to "Moodle mobile additional features service" before creating the token.

[[de:Moodle Mobile - Zusatzfunktionen]]
[[es:Características adicionales de Moodle Mobile]]
[[fr:Fonctionnalités additionnelles de l'app mobile]]

Moodle Mobile guide for admins

2017-03-01T09:10:25Z

Jleyva: /* Configuring the app from your site */

Moodle Mobile additional features

2017-02-28T08:55:32Z

Jleyva: /* Features */

{{Mobile}}
{{Infobox plugin
|type = Local plugin
|entry = http://moodle.org/plugins/view.php?plugin=local_mobile
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/13930
|discussion = https://moodle.org/mod/forum/view.php?id=7798
|maintainer = [[User:Juan Leyva|Juan Leyva]]
}}

The Moodle Mobile additional features plugin provides new features and web services for the Moodle Mobile app which are currently only available in the latest Moodle version.

This plugin is officially developed and maintained by Moodle HQ

== How it works ==

Once installed the plugin creates a new service "Moodle Mobile additional features". The Mobile app checks if this service is enabled. If not, the Mobile app falls backs to the standard core Mobile app service.

Please, open [[Moodle Mobile features]] to check what new features are added to your site depending on your Moodle version.

== Features ==

* Support for sites using SSO authentication methods (Shibboleth, CAS and Google OAuth 2)
* Support for sites using MNet authentication (Moodle Network authentication)
* Support for push notifications in Moodle sites prior to version 2.6

=== Enable authentication for sites using SSO methods (like Shibboleth and CAS) ===

VERY IMPORTANT NOTE: You need to disable the "Auto login guest" option "autologinguests". This setting is not compatible with the SSO via app.

SSO and MNet authentication is not supported in the Windows 8 and Windows Phone 8 apps

Once the plugin is installed, you need to go to Site administration > Plugins > Local plugins > Moodle Mobile additional features

There you can choose the "Type of login":
; '''Via the app''' : Is the default login, the user must introduce his credentials in the app
; '''Via a browser window''' : A new browser instance is open in the mobile device pointing to the login form in the Moodle site (which may again redirect to external identity providers if required). The user must introduce his credentials there. This is the option that must be selected for sites using SSO methods (or for sites that wants to force the user to authenticate in the site, not in the app)

<mediaplayer>https://www.youtube.com/watch?v=cl8rsyyyg9g</mediaplayer>

When using the "Via a browser window" option, you can optionally specify an URL scheme to be used by the system to open the Mobile app. By default, the URL scheme used to open the app will be the one indicated by the own app during the SSO process. If you've developed a custom app using its own URL scheme and you want to allow only SSO logins via your app, you can indicate there an URL scheme. The site will detect that setting and will use it instead of the value indicated by the app.

=== Configuring the app from your site ===

* Disable app functionalities for your site. If there's a feature you don't want to make available via the app you can disable it here.
* Rename app text strings.
* Add new items in the app's main menu (the side menu).
* Replace the Change site option with a "Log out" one to force the users to enter their credentials on their next access.

== Installation ==

# Unpack the zip file into the local/ directory. A new directory will be created called local/mobile.
# Go to ''Site administration > Notifications'' to complete the plugin installation.
# Go to ''Site administration > Mobile app > Mobile settings'' and enable web services for mobile devices (Remember to save the changes)
# Go to ''Site administration > Plugins > Web services > External services'', edit "Moodle Mobile additional features" and check the "Enabled" field, then save changes.
# Go to ''Site administration > Users > Permissions > Define roles'', edit the Authenticated user role and allow the capability moodle/webservice:createtoken.

Note: You need to have upgraded the Moodle Mobile app to version 1.4.4.

If you are currently using the Moodle Mobile app, you will need to log out of all your sites in order for the app to detect the new service.

== Admin users, please read ==

This plugin installs a new service in your Moodle installation, the automatic token creation for this type of services is forbidden for admin users. This means that admin users will not be able to use the Mobile app.

This can be solved easily, administrators must create a token manually in Moodle (''Plugins > Web Services > Manage tokens'') for the local_mobile service. '''Note:''' Be sure to toggle the default "Moodle mobile web services" setting to "Moodle mobile additional features service" before creating the token.

[[de:Moodle Mobile - Zusatzfunktionen]]
[[es:Características adicionales de Moodle Mobile]]
[[fr:Fonctionnalités additionnelles de l'app mobile]]

Moodle Mobile guide for admins

2017-02-28T08:54:15Z

Jleyva:

Creating Moodle Mobile friendly courses

2017-02-28T08:45:28Z

Jleyva: /* Course content */

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

==Use a mobile-friendly theme==

Recent versions of Moodle allow for responsive themes, which adapt to the browser screen size. Make sure your course uses such a theme and check its contents yourself before your students start the course.

Please, notice that a responsive theme does not have any visual impact in the Mobile app.

==Use the latest Moodle version available or the Moodle Mobile additional features plugin==

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

It is recommended to use the latest Moodle 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.

==Provide a 'how to' guide to Moodle on the mobile==

Consider offering your students a guide (as a PDF or a page resource) on how to access your course on the app, what they can do and not (yet) do from the app. Read up on the [[Moodle Mobile features]] and what's [[New for mobile]].

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*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.
*Site or course blocks are not displayed in the Mobile app, avoid putting important information in blocks.

==Course content==

*Use responsive HTML in pages or mini-sites.
*Try to use a [[Page resource|page resource]] 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, provide them also 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.)
*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 which provide 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, please consider to included them embedded in a label or HTML page content instead as a file. 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 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.

==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 anymore and it was withdrawn from the Windows Store. Its usage is not advised.

==Links to open the Moodle Mobile app==

If required, links which open the Moodle Mobile 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://link=https://yourmoodlesite.org/mod/...</code>

For example, the link <code>moodlemobile://link=https://mysite.es/mod/choice/view.php?id=8</code> will open the mobile app and display a choice activity.

==Learn more==

* A "[http://mobile.moodlebites.com free Moodle Mobile MOOC]" run by [http://www.hrdnz.com HRDNZ] (Moodle Partner) twice a year, specifically focussing on the use of Moodle with mobile devices, and how to best design courses for these environments - including the Moodle Mobile App.
* [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.
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"

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

Creating Moodle Mobile friendly courses

2017-02-23T15:01:16Z

Jleyva: /* Course content */

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

==Use a mobile-friendly theme==

Recent versions of Moodle allow for responsive themes, which adapt to the browser screen size. Make sure your course uses such a theme and check its contents yourself before your students start the course.

Please, notice that a responsive theme does not have any visual impact in the Mobile app.

==Use the latest Moodle version available or the Moodle Mobile additional features plugin==

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

It is recommended to use the latest Moodle 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.

==Provide a 'how to' guide to Moodle on the mobile==

Consider offering your students a guide (as a PDF or a page resource) on how to access your course on the app, what they can do and not (yet) do from the app. Read up on the [[Moodle Mobile features]] and what's [[New for mobile]].

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*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.
*Site or course blocks are not displayed in the Mobile app, avoid putting important information in blocks.

==Course content==

*Use responsive HTML in pages or mini-sites.
*Try to use a [[Page resource|page resource]] 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, provide them also 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.)
*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 which provide 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].

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

==Mobile devices considerations==

The app works better with the following devices:
* Devices running Android 4.4 onwards
* Devices running iOs 6 onwards

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

The first version of the app was supported in Windows Phone and Windows 7. This version is not supported anymore and it was unpublished from the Windows Store. Its usage is unadvised.

==Links to open the Moodle Mobile app==

If required, links which open the Moodle Mobile 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://link=https://yourmoodlesite.org/mod/...</code>

For example, the link <code>moodlemobile://link=https://mysite.es/mod/choice/view.php?id=8</code> will open the mobile app and display a choice activity.

==Learn more==

* A "[http://mobile.moodlebites.com free Moodle Mobile MOOC]" run by [http://www.hrdnz.com HRDNZ] (Moodle Partner) twice a year, specifically focussing on the use of Moodle with mobile devices, and how to best design courses for these environments - including the Moodle Mobile App.
* [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.
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"

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

Creating Moodle Mobile friendly courses

2017-02-23T14:58:40Z

Jleyva: /* Links to open the Moodle Mobile 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.

==Use a mobile-friendly theme==

Recent versions of Moodle allow for responsive themes, which adapt to the browser screen size. Make sure your course uses such a theme and check its contents yourself before your students start the course.

Please, notice that a responsive theme does not have any visual impact in the Mobile app.

==Use the latest Moodle version available or the Moodle Mobile additional features plugin==

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

It is recommended to use the latest Moodle 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.

==Provide a 'how to' guide to Moodle on the mobile==

Consider offering your students a guide (as a PDF or a page resource) on how to access your course on the app, what they can do and not (yet) do from the app. Read up on the [[Moodle Mobile features]] and what's [[New for mobile]].

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*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.
*Site or course blocks are not displayed in the Mobile app, avoid putting important information in blocks.

==Course content==

*Use responsive HTML in pages or mini-sites.
*Try to use a [[Page resource|page resource]] 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, provide them also 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.)
*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 which provide 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].

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

==Mobile devices considerations==

The app works better with the following devices:
* Devices running Android 4.4 onwards
* Devices running iOs 6 onwards

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

The first version of the app was supported in Windows Phone and Windows 7. This version is not supported anymore and it was unpublished from the Windows Store. Its usage is unadvised.

==Links to open the Moodle Mobile app==

If required, links which open the Moodle Mobile 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://link=https://yourmoodlesite.org/mod/...</code>

For example, the link <code>moodlemobile://link=https://mysite.es/mod/choice/view.php?id=8</code> will open the mobile app and display a choice activity.

==Learn more==

* A "[http://mobile.moodlebites.com free Moodle Mobile MOOC]" run by [http://www.hrdnz.com HRDNZ] (Moodle Partner) twice a year, specifically focussing on the use of Moodle with mobile devices, and how to best design courses for these environments - including the Moodle Mobile App.
* [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.
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"

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

Moodle Mobile FAQ

2017-02-18T10:29:18Z

Jleyva: /* How can I enable videos in my course to be downloaded? */

Moodle Mobile guide for admins

2017-02-18T10:27:00Z

Jleyva: /* Customise your app theme */

New for mobile

2017-02-18T10:24:57Z

Jleyva:

{{Mobile}}
__NOTOC__
Moodle Mobile 3.2 is released at the same time as Moodle 3.2 and includes several highly useful new features:

<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: Docs_Mobile_GradesLink.png|600px]]
<div class="caption">
<h4>Students: See your course grades easily</h4>
<p>A new Grades link allows you to quickly view course grades.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:Mobile_app_Teacher_Grading.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: Docs_Mobile_BadgesDisplay.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:Docs_Mobile_Preferences.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>

== See also ==

* Moodle Mobile release notes: https://docs.moodle.org/dev/Moodle_Mobile_release_notes

[[Category:New features]]

[[es:Nuevo para mobile]]
[[de:Neu für Moodle Mobile]]

Mobile app notifications

2017-02-18T10:23:32Z

Jleyva: /* Installing your own notifications infrastructure */

{{Mobile}}

==For students and teachers==
[[File:12Notifications.png|thumb|Forum post notification]]
The Moodle mobile app lets you keep up to date with all that's happening in your courses and on the site. Every time you open the app, events are synchronised with the main website.

You will receive [[Calendar|Moodle calendar]] event notifications automatically. If you don't want to get them, you can turn them all off individually (or globally) in the Calendar events options in the main menu.

You will also receive notifications of messages, forum posts, submitted assignments etc (known as 'push notifications') if your site administrator has enabled these. To receive these notifications you need to enable them for your mobile on the app via Settings -> Notifications (only for Moodle 3.2 onward) or on the main site, from the user menu top right >''Preferences>Messaging.''

==For administrators==

Push notifications can be enabled by an administrator by connecting their Moodle site to a messaging server such https://messages.moodle.net (available for [[Site registration|registered Moodle sites]] only). An access key can be obtained via ''Administration > Site administration > Plugins > Message outputs > Mobile Notifications''.

You can enable by default Mobile notifications for your students, please read the "Default message outputs" section in [[Messaging settings]].

If you have problems requesting the access key, please 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.

Users then need to connect at least once with the latest version of the Moodle Mobile app in order to register their phones with the Moodle site.

=== Event Reminders plugin===

Push notifications can also include calendar event notifications, however this requires the [https://moodle.org/plugins/view/local_reminders Event Reminders plugin] to be installed on the Moodle site.

The Event Reminders plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. It also allows users to control how they receive messages for each type of event in the Moodle calendar.

=== Installing your own notifications infrastructure ===

If you have a customized version of the Moodle Mobile app, or you want to use your own notifications infrastructure, you will have to install a private [http://airnotifier.github.io AirNotifier] (backend server for notifications).

https://messages.moodle.net uses a slightly modified version of Airnotifier: https://github.com/moodlehq/airnotifier/tree/moodle2.

You will have to add your app certificates - see https://github.com/airnotifier/airnotifier/wiki/Installation for further information.

The Airnotifier message plugin allows you to point to your custom Airnotifier instance using your own access keys.

Remember to install using GIT (repository https://github.com/moodlehq/airnotifier.git branch ''moodle2'').

Moodle offers a branded app service including a private notifications infrastructure, for more information visit https://moodle.com/mobileapp/

[[de:Moodle Mobile - Benachrichtigungen]]
[[ca:Notificacions_de_la_app_Mobile]]
[[es:Mobile app Notificaciones Push]]
[[fr:Notifications de l'app mobile]]

Mobile app notifications

2017-02-18T10:20:29Z

Jleyva: /* For students and teachers */

{{Mobile}}

==For students and teachers==
[[File:12Notifications.png|thumb|Forum post notification]]
The Moodle mobile app lets you keep up to date with all that's happening in your courses and on the site. Every time you open the app, events are synchronised with the main website.

You will receive [[Calendar|Moodle calendar]] event notifications automatically. If you don't want to get them, you can turn them all off individually (or globally) in the Calendar events options in the main menu.

You will also receive notifications of messages, forum posts, submitted assignments etc (known as 'push notifications') if your site administrator has enabled these. To receive these notifications you need to enable them for your mobile on the app via Settings -> Notifications (only for Moodle 3.2 onward) or on the main site, from the user menu top right >''Preferences>Messaging.''

==For administrators==

Push notifications can be enabled by an administrator by connecting their Moodle site to a messaging server such https://messages.moodle.net (available for [[Site registration|registered Moodle sites]] only). An access key can be obtained via ''Administration > Site administration > Plugins > Message outputs > Mobile Notifications''.

You can enable by default Mobile notifications for your students, please read the "Default message outputs" section in [[Messaging settings]].

If you have problems requesting the access key, please 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.

Users then need to connect at least once with the latest version of the Moodle Mobile app in order to register their phones with the Moodle site.

=== Event Reminders plugin===

Push notifications can also include calendar event notifications, however this requires the [https://moodle.org/plugins/view/local_reminders Event Reminders plugin] to be installed on the Moodle site.

The Event Reminders plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. It also allows users to control how they receive messages for each type of event in the Moodle calendar.

=== Installing your own notifications infrastructure ===

If you have a customized version of the Moodle Mobile app, or you want to use your own notifications infrastructure, you will have to install a private [http://airnotifier.github.io AirNotifier] (backend server for notifications).

https://messages.moodle.net uses a slightly modified version of Airnotifier: https://github.com/moodlehq/airnotifier/tree/moodle2.

You will have to add your app certificates - see https://github.com/airnotifier/airnotifier/wiki/Installation for further information.

The Airnotifier message plugin allows you to point to your custom Airnotifier instance using your own access keys.

Remember to install using GIT (repository https://github.com/moodlehq/airnotifier.git branch ''moodle2'').

[[de:Moodle Mobile - Benachrichtigungen]]
[[ca:Notificacions_de_la_app_Mobile]]
[[es:Mobile app Notificaciones Push]]
[[fr:Notifications de l'app mobile]]

Mobile app notifications

2017-02-18T10:18:18Z

Jleyva: /* For administrators */

{{Mobile}}

==For students and teachers==
[[File:12Notifications.png|thumb|Forum post notification]]
The Moodle mobile app lets you keep up to date with all that's happening in your courses and on the site. Every time you open the app, events are synchronised with the main website.

You will receive [[Calendar|Moodle calendar]] event notifications automatically. If you don't want to get them, you can turn them all off individually in the Calendar events options in the main menu.

You will also receive notifications of messages, forum posts, submitted assignments etc (known as 'push notifications') if your site administrator has enabled these. To receive these notifications you need to enable them for your mobile on the main site, from the user menu top right >''Preferences>Messaging.''

==For administrators==

Push notifications can be enabled by an administrator by connecting their Moodle site to a messaging server such https://messages.moodle.net (available for [[Site registration|registered Moodle sites]] only). An access key can be obtained via ''Administration > Site administration > Plugins > Message outputs > Mobile Notifications''.

You can enable by default Mobile notifications for your students, please read the "Default message outputs" section in [[Messaging settings]].

If you have problems requesting the access key, please 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.

Users then need to connect at least once with the latest version of the Moodle Mobile app in order to register their phones with the Moodle site.

=== Event Reminders plugin===

Push notifications can also include calendar event notifications, however this requires the [https://moodle.org/plugins/view/local_reminders Event Reminders plugin] to be installed on the Moodle site.

The Event Reminders plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. It also allows users to control how they receive messages for each type of event in the Moodle calendar.

=== Installing your own notifications infrastructure ===

If you have a customized version of the Moodle Mobile app, or you want to use your own notifications infrastructure, you will have to install a private [http://airnotifier.github.io AirNotifier] (backend server for notifications).

https://messages.moodle.net uses a slightly modified version of Airnotifier: https://github.com/moodlehq/airnotifier/tree/moodle2.

You will have to add your app certificates - see https://github.com/airnotifier/airnotifier/wiki/Installation for further information.

The Airnotifier message plugin allows you to point to your custom Airnotifier instance using your own access keys.

Remember to install using GIT (repository https://github.com/moodlehq/airnotifier.git branch ''moodle2'').

[[de:Moodle Mobile - Benachrichtigungen]]
[[ca:Notificacions_de_la_app_Mobile]]
[[es:Mobile app Notificaciones Push]]
[[fr:Notifications de l'app mobile]]

Moodle Mobile guide for admins

2017-02-18T10:15:48Z

Jleyva: /* Moodle Mobile additional features plugin for old Moodle sites */

Moodle Mobile guide for admins

2017-02-18T10:15:34Z

Jleyva:

Moodle Mobile guide for admins

2017-02-18T10:07:15Z

Jleyva: /* Customise your app theme */

Moodle Mobile guide for admins

2017-02-18T10:06:13Z

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

Creating Moodle Mobile friendly courses

2017-02-18T10:01:48Z

Jleyva: /* Course content */ Labels are not collapsed any more

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

==Use a mobile-friendly theme==

Recent versions of Moodle allow for responsive themes, which adapt to the browser screen size. Make sure your course uses such a theme and check its contents yourself before your students start the course.

Please, notice that a responsive theme does not have any visual impact in the Mobile app.

==Use the latest Moodle version available or the Moodle Mobile additional features plugin==

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

It is recommended to use the latest Moodle 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.

==Provide a 'how to' guide to Moodle on the mobile==

Consider offering your students a guide (as a PDF or a page resource) on how to access your course on the app, what they can do and not (yet) do from the app. Read up on the [[Moodle Mobile features]] and what's [[New for mobile]].

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*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.
*Site or course blocks are not displayed in the Mobile app, avoid putting important information in blocks.

==Course content==

*Use responsive HTML in pages or mini-sites.
*Try to use a [[Page resource|page resource]] 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, provide them also 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.)
*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 which provide 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].

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

==Links to open the Moodle Mobile app==

If required, links which open the Moodle Mobile 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://link=https://yourmoodlesite.org/mod/...</code>

For example, the link <code>moodlemobile://link=https://mysite.es/mod/choice/view.php?id=8</code> will open the mobile app and display a choice activity.

==Learn more==

* A "[http://mobile.moodlebites.com free Moodle Mobile MOOC]" run by [http://www.hrdnz.com HRDNZ] (Moodle Partner) twice a year, specifically focussing on the use of Moodle with mobile devices, and how to best design courses for these environments - including the Moodle Mobile App.
* [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.
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"

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

Creating Moodle Mobile friendly courses

2017-02-18T10:01:13Z

Jleyva: /* Media download for offline usage */

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

==Use a mobile-friendly theme==

Recent versions of Moodle allow for responsive themes, which adapt to the browser screen size. Make sure your course uses such a theme and check its contents yourself before your students start the course.

Please, notice that a responsive theme does not have any visual impact in the Mobile app.

==Use the latest Moodle version available or the Moodle Mobile additional features plugin==

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

It is recommended to use the latest Moodle 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.

==Provide a 'how to' guide to Moodle on the mobile==

Consider offering your students a guide (as a PDF or a page resource) on how to access your course on the app, what they can do and not (yet) do from the app. Read up on the [[Moodle Mobile features]] and what's [[New for mobile]].

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*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.
*Site or course blocks are not displayed in the Mobile app, avoid putting important information in blocks.

==Course content==

*Labels are initially collapsed, so include a short text introduction of what is inside any label.
*Use responsive HTML in pages or mini-sites.
*Try to use a [[Page resource|page resource]] 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, provide them also 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.)
*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 which provide 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].

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

==Links to open the Moodle Mobile app==

If required, links which open the Moodle Mobile 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://link=https://yourmoodlesite.org/mod/...</code>

For example, the link <code>moodlemobile://link=https://mysite.es/mod/choice/view.php?id=8</code> will open the mobile app and display a choice activity.

==Learn more==

* A "[http://mobile.moodlebites.com free Moodle Mobile MOOC]" run by [http://www.hrdnz.com HRDNZ] (Moodle Partner) twice a year, specifically focussing on the use of Moodle with mobile devices, and how to best design courses for these environments - including the Moodle Mobile App.
* [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.
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"

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

Creating Moodle Mobile friendly courses

2017-02-18T09:56:40Z

Jleyva: /* Notifications and messages */

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

==Use a mobile-friendly theme==

Recent versions of Moodle allow for responsive themes, which adapt to the browser screen size. Make sure your course uses such a theme and check its contents yourself before your students start the course.

Please, notice that a responsive theme does not have any visual impact in the Mobile app.

==Use the latest Moodle version available or the Moodle Mobile additional features plugin==

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

It is recommended to use the latest Moodle 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.

==Provide a 'how to' guide to Moodle on the mobile==

Consider offering your students a guide (as a PDF or a page resource) on how to access your course on the app, what they can do and not (yet) do from the app. Read up on the [[Moodle Mobile features]] and what's [[New for mobile]].

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*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.
*Site or course blocks are not displayed in the Mobile app, avoid putting important information in blocks.

==Course content==

*Labels are initially collapsed, so include a short text introduction of what is inside any label.
*Use responsive HTML in pages or mini-sites.
*Try to use a [[Page resource|page resource]] 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, provide them also 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.)
*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 which provide 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].

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

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

==Links to open the Moodle Mobile app==

If required, links which open the Moodle Mobile 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://link=https://yourmoodlesite.org/mod/...</code>

For example, the link <code>moodlemobile://link=https://mysite.es/mod/choice/view.php?id=8</code> will open the mobile app and display a choice activity.

==Learn more==

* A "[http://mobile.moodlebites.com free Moodle Mobile MOOC]" run by [http://www.hrdnz.com HRDNZ] (Moodle Partner) twice a year, specifically focussing on the use of Moodle with mobile devices, and how to best design courses for these environments - including the Moodle Mobile App.
* [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.
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"

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

Creating Moodle Mobile friendly courses

2017-02-18T09:54:36Z

Jleyva: /* Use a mobile-friendly theme */

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

==Use a mobile-friendly theme==

Recent versions of Moodle allow for responsive themes, which adapt to the browser screen size. Make sure your course uses such a theme and check its contents yourself before your students start the course.

Please, notice that a responsive theme does not have any visual impact in the Mobile app.

==Use the latest Moodle version available or the Moodle Mobile additional features plugin==

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

It is recommended to use the latest Moodle 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]].

==Provide a 'how to' guide to Moodle on the mobile==

Consider offering your students a guide (as a PDF or a page resource) on how to access your course on the app, what they can do and not (yet) do from the app. Read up on the [[Moodle Mobile features]] and what's [[New for mobile]].

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*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.
*Site or course blocks are not displayed in the Mobile app, avoid putting important information in blocks.

==Course content==

*Labels are initially collapsed, so include a short text introduction of what is inside any label.
*Use responsive HTML in pages or mini-sites.
*Try to use a [[Page resource|page resource]] 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, provide them also 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.)
*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 which provide 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].

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

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

==Links to open the Moodle Mobile app==

If required, links which open the Moodle Mobile 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://link=https://yourmoodlesite.org/mod/...</code>

For example, the link <code>moodlemobile://link=https://mysite.es/mod/choice/view.php?id=8</code> will open the mobile app and display a choice activity.

==Learn more==

* A "[http://mobile.moodlebites.com free Moodle Mobile MOOC]" run by [http://www.hrdnz.com HRDNZ] (Moodle Partner) twice a year, specifically focussing on the use of Moodle with mobile devices, and how to best design courses for these environments - including the Moodle Mobile App.
* [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.
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"

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

Creating Moodle Mobile friendly courses

2017-02-18T09:51:23Z

Jleyva: /* Things to avoid */

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

==Use a mobile-friendly theme==

Recent versions of Moodle allow for responsive themes, which adapt to the browser screen size. Make sure your course uses such a theme and check its contents yourself before your students start the course.

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

==Provide a 'how to' guide to Moodle on the mobile==

Consider offering your students a guide (as a PDF or a page resource) on how to access your course on the app, what they can do and not (yet) do from the app. Read up on the [[Moodle Mobile features]] and what's [[New for mobile]].

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*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.
*Site or course blocks are not displayed in the Mobile app, avoid putting important information in blocks.

==Course content==

*Labels are initially collapsed, so include a short text introduction of what is inside any label.
*Use responsive HTML in pages or mini-sites.
*Try to use a [[Page resource|page resource]] 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, provide them also 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.)
*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 which provide 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].

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

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

==Links to open the Moodle Mobile app==

If required, links which open the Moodle Mobile 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://link=https://yourmoodlesite.org/mod/...</code>

For example, the link <code>moodlemobile://link=https://mysite.es/mod/choice/view.php?id=8</code> will open the mobile app and display a choice activity.

==Learn more==

* A "[http://mobile.moodlebites.com free Moodle Mobile MOOC]" run by [http://www.hrdnz.com HRDNZ] (Moodle Partner) twice a year, specifically focussing on the use of Moodle with mobile devices, and how to best design courses for these environments - including the Moodle Mobile App.
* [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.
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"

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