Moodle app FAQ: Difference between revisions
mNo edit summary |
|||
(36 intermediate revisions by 3 users not shown) | |||
Line 3: | Line 3: | ||
Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal] | Please see the official FAQs in the [https://apps.moodle.com/local/apps/portal_faqs.php Moodle Apps portal] | ||
==Students== | ==Students== | ||
===Who can I contact for help with the app?=== | |||
If you’re a student and need help with issues related to logging in, registering to a Moodle site or trouble connecting to the app, you should contact your school or learning organisation. For example, one of your teachers, or the person who takes care of Moodle. | |||
Moodle HQ make the Moodle software and the Moodle app, but they don’t manage nor have access to your Moodle site or your user data. | |||
===How can I get the Moodle app?=== | ===How can I get the Moodle app?=== | ||
You can download the Moodle App for free from [https://play.google.com/store/apps/details?id=com.moodle.moodlemobile Google Play] and the Apple [https://itunes.apple.com/app/moodle-mobile/id633359593?mt=8 App Store]. You will find it by searching “Moodle”, and the author/owner is “Moodle Pty Ltd”. | |||
===I can't get the app to work. | If you are unable to download the app from Google play, please visit [https://download.moodle.org/mobile/ Moodle app downloads] | ||
The | |||
===I can't get the app to work. === | |||
The app only works with Moodle sites that have been set up to allow it, and that are running on at least Moodle 3.5. If you have any trouble connecting to your site, please contact the person who takes care of Moodle in your school or learning organisation. | |||
===I can’t find my Moodle site in the app. === | |||
To find your Moodle site on the app login screen, try searching for the name of your school or learning organisation. | |||
If your school or organisation doesn’t appear in the search, you can try searching by your Moodle site URL address instead. If you don’t know the address of your Moodle site, here’s how you can find it: | |||
# Open a web browser (like Chrome or Safari) and go to your school’s Moodle site login page. | |||
# At the top of the page in the address bar, you'll see the URL address of your Moodle site, e.g. “campus.example.edu”. [[File:FAQ I cant find my site 1.png|alt=URL|thumb|none|''campus.example.edu'']] | |||
# Copy the URL (don’t copy the /login nor what comes after), paste it into Your site in the app, then select Connect to your site. [[File:FAQ I cant find my site 2.png|alt=Adding an URL to the app|thumb|none|Adding an URL to the app]] | |||
# Now you can log in to your site with your username and password. | |||
If you tried searching by URL address and still can’t find your Moodle site, please get in touch with the person who takes care of Moodle in your school or learning organisation. | |||
===I can’t log in with the app=== | |||
To log in to your Moodle site using the app, you first need to connect to your school’s Moodle site (view [[I can’t find my Moodle site in the app]] if you can’t find your site). | |||
Once you’ve connected to your Moodle site, you should be able to log in with your usual username and password. | |||
If you forgot your username or password, select the option '''Forgotten your username or password?'''. If you still have trouble logging in or can’t see any options for retrieving your username or password, please get in touch with the person who takes care of Moodle in your school or learning organisation. | |||
===I see an error message when I try to use the app=== | |||
If you see an error message that prevents you from using the app, please get in touch with the person who takes care of Moodle in your school or learning organisation. | |||
Some of the most common errors that your school or learning organisation will be able to fix are: | |||
* Your token is expired or not valid. | |||
* An error mentioning the parameter “includestealthmodules”. | |||
* An error mentioning ''version.php file missing for the component'' | |||
* The web service function is not available. | |||
* A message about site maintenance. | |||
If you’re experiencing any of these errors, contact your school or learning organisation for help. | |||
===What permissions does the app require?=== | ===What permissions does the app require?=== | ||
The app requires the following permissions: | The app requires the following permissions: | ||
Line 14: | Line 49: | ||
* Run at startup - to receive local notifications even when the app is running in the background. | * 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. | * Prevent phone from sleeping - to receive push notifications anytime. | ||
===What are the minimum device requirements to use the Moodle app?=== | |||
Android devices: Require Android 5.1 or later. | |||
iOS devices (iPhones/iPads): Require iOS 11 or later. | |||
===I can't see my course on the app. What do I do?=== | ===I can't see my course on the app. What do I do?=== | ||
Check with your course tutor that you are correctly enrolled. | Check with your course tutor that you are correctly enrolled. | ||
=== Why can't I upload my assignment on the app?=== | === Why can't I upload my assignment on the app?=== | ||
If you’re experiencing any issue uploading assignment, please contact your school or learning organisation for help. | |||
===Why can't I sometimes access the app or submit anything to it?=== | ===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 | This could be because of interruptions in your internet connection. Wait a while and try again. If you continue to have problems, contact your school or learning organisation for help. | ||
===Is there a space limit on my files?=== | ===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 | Assignments will have a size limit which you can see, those are set by your teachers. For other space limit questions, check with your your school or learning organisation . | ||
===When are activities completed offline synchronized?=== | ===When are activities completed offline synchronized?=== | ||
See [[Moodle app synchronization]]. | See [[Moodle app synchronization]]. | ||
===Why the site is asking for my username and password when an activity is opened in the browser?=== | ===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). | 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). | ||
=== The Moodle app might seem slow (especially on Android devices) === | |||
There are several factors that could be causing this issue. It could be due to outdated or underperforming devices, or perhaps there are too many applications open, causing limited memory in your mobile device. Other factors could be connectivity issues such as slow Internet or the server where the Moodle site is hosted being unresponsive/slow. | |||
To troubleshoot this problem, we recommend trying the application with our demo site: https://school.moodledemo.net. Simply use the username "student" and the password "moodle" to access the site. If you find that the navigation and overall experience with the app are improved, then the issue may be at the server level. In this case, we suggest contacting your school or learning organisation for further assistance. | |||
=== The Moodle app restarts/ closes / reopenes itself === | |||
This is likely because there are too many apps opened on your mobile device. Mobile devices have a finite amount of memory, and the device's memory manager is responsible for determining which applications to keep open and which to close. | |||
To optimise your device's performance, we recommend closing all applications that are not currently in use. This will free up valuable memory and ensure that your device runs smoothly. | |||
===I use LineageOS and I'm having problems using the app=== | ===I use LineageOS and I'm having problems using the app=== | ||
LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation. | LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation. | ||
===H5P packages are not working on iOS === | ===H5P packages and external content embedded via iframes are not working on iOS === | ||
This is caused by a new feature of iOS 14 called ITP that blocks cookies for external sites embedded in the app (the H5P content is played embedded in an iframe pointing to the Moodle website) unless the user enables a setting in the app to allow those cookies. | This is caused by a new feature of iOS 14 called ITP that blocks cookies for external sites embedded in the app (the H5P content is played embedded in an iframe pointing to the Moodle website) unless the user enables a setting in the app to allow those cookies. | ||
The quick workaround is | The quick workaround is to enable the setting "Allow Cross-Website Tracking" available via the Settings app (look for the Moodle app, at the bottom) on your iPhone/iPad with iOS 14. | ||
==Teachers== | ==Teachers== | ||
===How can I enable videos in my course to be downloaded?=== | ===How can I enable videos in my course to be downloaded?=== | ||
Line 50: | Line 95: | ||
See [[Mobile app notifications]]. Chat, forums and messaging are all supported by the app. | See [[Mobile app notifications]]. Chat, forums and messaging are all supported by the app. | ||
===My Vimeo videos are not playing in the app=== | ===My Vimeo videos are not playing in the app=== | ||
In older versions of Moodle (pre-Moodle 3.7), it may be necessary to activate the "Allow frame embedding" admin setting. However, for those using Moodle version 3.7 or later, it is important to check whether a Proxy/Firewall/Web Server security module is setting the X-Frame-Options header in your HTTP request responses. If this is the case, it is recommended to deactivate this feature as it may cause conflicts, as Moodle already sets this header by default. | |||
You may also use Bootstrap responsive classes: https://getbootstrap.com/docs/4.0/utilities/embed/, for example, <div class="embed-responsive"> | You may also use Bootstrap responsive classes: https://getbootstrap.com/docs/4.0/utilities/embed/, for example, <div class="embed-responsive"> | ||
Line 56: | Line 102: | ||
If the issue is with vimeo videos on Moodle sites 3.10 or 3.11, please update the Moodle site to the latest version possible (at least 3.10.10 or 3.11.6). (See https://tracker.moodle.org/browse/MDL-74042) | If the issue is with vimeo videos on Moodle sites 3.10 or 3.11, please update the Moodle site to the latest version possible (at least 3.10.10 or 3.11.6). (See https://tracker.moodle.org/browse/MDL-74042) | ||
===ReCaptcha doesn't work on my site=== | ===ReCaptcha doesn't work on my site=== | ||
In older versions of Moodle (pre-Moodle 3.7), it may be necessary to activate the "Allow frame embedding" admin setting. However, for those using Moodle version 3.7 or later, it is important to check whether a Proxy/Firewall/Web Server security module is setting the X-Frame-Options header in your HTTP request responses. If this is the case, it is recommended to deactivate this feature as it may cause conflicts, as Moodle already sets this header by default. | |||
===H5P packages don't work on my site=== | ===H5P packages don't work on my site=== | ||
In | In older versions of Moodle (pre-Moodle 3.7), it may be necessary to activate the "Allow frame embedding" admin setting. However, for those using Moodle version 3.7 or later, it is important to check whether a Proxy/Firewall/Web Server security module is setting the X-Frame-Options header in your HTTP request responses. If this is the case, it is recommended to deactivate this feature as it may cause conflicts, as Moodle already sets this header by default. | ||
This can also happen when you are using the non-official H5P plugin (mod_hvp), in that case you will see the following message: This site is not configured properly for displaying mobile H5P content. Please contact a site administrator so they can apply the suggested configuration changes. | This can also happen when you are using the non-official H5P plugin (mod_hvp), in that case you will see the following message: This site is not configured properly for displaying mobile H5P content. Please contact a site administrator so they can apply the above suggested configuration changes. | ||
'''Cookies issues''' | '''Cookies issues''' | ||
Line 118: | Line 166: | ||
Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header. | Please, review if you have a Proxy/Firewall/Web Server adding automatically values to that HTTP header. | ||
'''Security rules are blocking requests using the Accept-Charset header''' | |||
Some security rules, such as OWASP ModSecurity, are blocking requests with this header that is sent by the Moodle App. In future releases of the app, this problem will be fixed. But in the meantime, you should disable it. Find more about this in MOBILE-4342. | |||
=== My certificate is fine but the Moodle app is detecting http instead of https === | === My certificate is fine but the Moodle app is detecting http instead of https === | ||
If the Moodle app is detecting http instead of https, please revise config.php (check "wwwroot" as well as "httpswwwroot") | If the Moodle app is detecting http instead of https, please revise config.php (check "wwwroot" as well as "httpswwwroot") | ||
Line 180: | Line 233: | ||
* Make sure that the "Access-Control-Allow-Origin" header only contains one item. For example, a header like this: Access-Control-Allow-Origin: *, <nowiki>https://mydomain.com</nowiki> will cause problems. | * Make sure that the "Access-Control-Allow-Origin" header only contains one item. For example, a header like this: Access-Control-Allow-Origin: *, <nowiki>https://mydomain.com</nowiki> will cause problems. | ||
===Error messages=== | ===Error messages=== | ||
==== version.php file missing for the component ==== | ==== 'Error code: webservicenotenabled' ==== | ||
This error message indicates that that plugin is not correctly installed (or uninstalled) on the Moodle site you use (see [[Installing plugins]]). | This error message indicates that web service is not enabled for that site. Please visit [https://docs.moodle.org/en/Moodle_app_guide_for_admins#Enable_mobile_services_on_your_site Moodle app guide for admins - Enable mobile services on your site]. | ||
==== 'Coding error: version.php file is missing for the component' ==== | |||
This error message indicates that that plugin is not correctly installed (or uninstalled) on the Moodle site you use (see [[Installing plugins]]). Please review the mod/certificate folder to check if the version.php file is missing (or has incorrect permissions) as well as purge cache too. | |||
==== 'Can not find data record in database table external_functions' ==== | ==== '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: | This error usually happens due to a bad configuration or setting value in your Moodle site, please check: | ||
Line 194: | Line 248: | ||
# The user is entering the correct URL for the site (see FAQ above) | # The user is entering the correct URL for the site (see FAQ above) | ||
# For https sites, the certificate is valid (see FAQ above) | # For https sites, the certificate is valid (see FAQ above) | ||
===='Invalid Moodle site version. The Moodle app only supports Moodle systems 3.5 onwards'==== | |||
The app will only connect to Moodle LMS sites version 3.5 onward (see [https://docs.moodle.org/35/en/Upgrading Upgrade to 3.5] as well as [[Upgrade overview]]). | |||
===='We lost connection; you need to reconnect. Your token is now invalid.' on my custom version of the Moodle app ==== | ===='We lost connection; you need to reconnect. Your token is now invalid.' on my custom version of the Moodle app ==== | ||
Please check: | Please check: | ||
Line 243: | Line 298: | ||
# Enter the IP of your proxy (or range of IPs). | # Enter the IP of your proxy (or range of IPs). | ||
# Click the 'Save changes' button. | # Click the 'Save changes' button. | ||
If you are still experiencing issues please try to change this setting "getremoteaddrconf" (Logged IP address source) to the different existing values. | |||
Finally, it is possible to disable the IP restriction checks for functionality such as the QR login, to do that, go to Site administration > Mobile app > Mobile app authentication, and disable the "QR authentication same IP check" setting. | |||
==== 'The param "includestealthmodules" is invalid' ==== | |||
Please contact your learning organisation so they upgrade to at least Moodle 3.5.3 (see [https://docs.moodle.org/35/en/Upgrading Upgrade to 3.5] as well as [[Upgrade overview]]) or they manually apply the patch listed here [https://tracker.moodle.org/browse/MDL-63542 MDL-63542]. | |||
===The Moodle app does not connect to MoodleBox (or other internal self-hosted systems)=== | ===The Moodle app does not connect to MoodleBox (or other internal self-hosted systems)=== | ||
Line 256: | Line 316: | ||
If the Moodle app is not yet available in your language, please contribute a translation! See [[:dev:Translating Moodle Mobile|Translating Moodle Mobile]] for details of what to do. | If the Moodle app is not yet available in your language, please contribute a translation! See [[:dev:Translating Moodle Mobile|Translating Moodle Mobile]] for details of what to do. | ||
=== Changes made to a Moodle site URL can cause logged-in users’ data to fail when synchronising. === | |||
We recommend that administrators manually log out all users after a site rename. If your site URL changes and have site users that are using the mobile Moodle App we suggest the following: | |||
* For users that have not yet logged in - we recommend sending them the new URL | |||
* For users already using the mobile Moodle App and potentially logged in request them to: | |||
** log out of the mobile Moodle App, | |||
** delete the old site, and | |||
** log in using the new URL | |||
Logged in Moodle users can continue working with the previous URL (with cached information) but they will not be able to synchronise the new information (therefore not receiving new information from their teachers, and teachers not receiving data or submissions from those students). | |||
* To avoid the risk of data not synchronising, we recommend the site administrator logs out all app users, by manually deleting their tokens: | |||
** Go to Site administration | |||
** Click Server | |||
** Click Web services | |||
** Click Manage tokens | |||
** Delete the tokens | |||
Take into account that you still need to request your users to log in using the new URL. | |||
==Any further questions?== | ==Any further questions?== | ||
Please post in the [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum] on moodle.org. | Please post in the [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum] on moodle.org. |
Latest revision as of 12:58, 17 May 2023
New Moodle App Plans (starting 2 April 2020)
Please see the official FAQs in the Moodle Apps portal
Students
Who can I contact for help with the app?
If you’re a student and need help with issues related to logging in, registering to a Moodle site or trouble connecting to the app, you should contact your school or learning organisation. For example, one of your teachers, or the person who takes care of Moodle. Moodle HQ make the Moodle software and the Moodle app, but they don’t manage nor have access to your Moodle site or your user data.
How can I get the Moodle app?
You can download the Moodle App for free from Google Play and the Apple App Store. You will find it by searching “Moodle”, and the author/owner is “Moodle Pty Ltd”. If you are unable to download the app from Google play, please visit Moodle app downloads
I can't get the app to work.
The app only works with Moodle sites that have been set up to allow it, and that are running on at least Moodle 3.5. If you have any trouble connecting to your site, please contact the person who takes care of Moodle in your school or learning organisation.
I can’t find my Moodle site in the app.
To find your Moodle site on the app login screen, try searching for the name of your school or learning organisation.
If your school or organisation doesn’t appear in the search, you can try searching by your Moodle site URL address instead. If you don’t know the address of your Moodle site, here’s how you can find it:
- Open a web browser (like Chrome or Safari) and go to your school’s Moodle site login page.
- At the top of the page in the address bar, you'll see the URL address of your Moodle site, e.g. “campus.example.edu”.
- Copy the URL (don’t copy the /login nor what comes after), paste it into Your site in the app, then select Connect to your site.
- Now you can log in to your site with your username and password.
If you tried searching by URL address and still can’t find your Moodle site, please get in touch with the person who takes care of Moodle in your school or learning organisation.
I can’t log in with the app
To log in to your Moodle site using the app, you first need to connect to your school’s Moodle site (view I can’t find my Moodle site in the app if you can’t find your site).
Once you’ve connected to your Moodle site, you should be able to log in with your usual username and password.
If you forgot your username or password, select the option Forgotten your username or password?. If you still have trouble logging in or can’t see any options for retrieving your username or password, please get in touch with the person who takes care of Moodle in your school or learning organisation.
I see an error message when I try to use the app
If you see an error message that prevents you from using the app, please get in touch with the person who takes care of Moodle in your school or learning organisation.
Some of the most common errors that your school or learning organisation will be able to fix are:
- Your token is expired or not valid.
- An error mentioning the parameter “includestealthmodules”.
- An error mentioning version.php file missing for the component
- The web service function is not available.
- A message about site maintenance.
If you’re experiencing any of these errors, contact your school or learning organisation for help.
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.
What are the minimum device requirements to use the Moodle app?
Android devices: Require Android 5.1 or later. iOS devices (iPhones/iPads): Require iOS 11 or later.
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?
If you’re experiencing any issue uploading assignment, please contact your school or learning organisation for help.
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 school or learning organisation for help.
Is there a space limit on my files?
Assignments will have a size limit which you can see, those are set by your teachers. For other space limit questions, check with your your school or learning organisation .
When are activities completed offline synchronized?
See Moodle app synchronization.
Why the site is asking for my username and password when an activity is opened in the browser?
Auto-login from the app is only supported in sites using Moodle 3.2 onwards. Also, for security reasons, between auto-logins you must wait 6 minutes (this should not be a problem because most of the browsers will keep your Moodle session open).
The Moodle app might seem slow (especially on Android devices)
There are several factors that could be causing this issue. It could be due to outdated or underperforming devices, or perhaps there are too many applications open, causing limited memory in your mobile device. Other factors could be connectivity issues such as slow Internet or the server where the Moodle site is hosted being unresponsive/slow.
To troubleshoot this problem, we recommend trying the application with our demo site: https://school.moodledemo.net. Simply use the username "student" and the password "moodle" to access the site. If you find that the navigation and overall experience with the app are improved, then the issue may be at the server level. In this case, we suggest contacting your school or learning organisation for further assistance.
The Moodle app restarts/ closes / reopenes itself
This is likely because there are too many apps opened on your mobile device. Mobile devices have a finite amount of memory, and the device's memory manager is responsible for determining which applications to keep open and which to close. To optimise your device's performance, we recommend closing all applications that are not currently in use. This will free up valuable memory and ensure that your device runs smoothly.
I use LineageOS and I'm having problems using the app
LineageOS uses a different WebView implementation not compatible vith the app. You need to install "Android System WebView" from Google Play (or via a trusted apk) and enabling it via Settings > Developer options > WebView implementation.
H5P packages and external content embedded via iframes are not working on iOS
This is caused by a new feature of iOS 14 called ITP that blocks cookies for external sites embedded in the app (the H5P content is played embedded in an iframe pointing to the Moodle website) unless the user enables a setting in the app to allow those cookies.
The quick workaround is to enable the setting "Allow Cross-Website Tracking" available via the Settings app (look for the Moodle app, at the bottom) on your iPhone/iPad with iOS 14.
Teachers
How can I enable videos in my course to be downloaded?
See the section 'Media download for offline usage' in Creating Moodle-app-friendly courses.
Video subtitles are not working
This may happen in old Android versions (Android < 4.4), in modern Android and iOS versions they should work fine.
Which course format is it best to use?
Topics or weekly course format is best suited to mobile devices.
How do I make YouTube links open automatically in the app?
Add YouTube links as a URL resource.
Why can't my students see their courses?
If you or an administrator have correctly enrolled them in a course, they can see it in their mobile app. If they are correctly enrolled but can still not see their course, ask them to check with your Moodle site administrator.
I can't mark assignments in the app
If you are experiencing problems when grading, please review that you are using the correct decimal separators (if the app interface is in English, you must use a period).
What communications tools can I use in the app to engage with my learners?
See Mobile app notifications. Chat, forums and messaging are all supported by the app.
My Vimeo videos are not playing in the app
In older versions of Moodle (pre-Moodle 3.7), it may be necessary to activate the "Allow frame embedding" admin setting. However, for those using Moodle version 3.7 or later, it is important to check whether a Proxy/Firewall/Web Server security module is setting the X-Frame-Options header in your HTTP request responses. If this is the case, it is recommended to deactivate this feature as it may cause conflicts, as Moodle already sets this header by default.
You may also use Bootstrap responsive classes: https://getbootstrap.com/docs/4.0/utilities/embed/, for example,