Moodle App FAQ: Difference between revisions

Revision as of 07:06, 7 September 2021

How can I contribute to the Moodle App?

You can help with any issue marked with the "contribfriendly" label.

If you want to help with another issue, please let us know first via the tracker, you can a comment in the issue itself.

You have a detailed description of our development process here: Moodle App Development Process.

I see this error: "Cannot connect: Verify that your have typed correctly the URL and that your site uses Moodle 2.4 or later"

Ensure that debugging is disabled in your site: Administration > Development > Debugging.
Check that the ADOdb option is disabled if you are using the external database auth or enrolment plugin. You can do that in "Plugins > Authentication > External database" and in "Plugins > Enrolment > External database".
If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. You can use this tool or a similar one to check that your certificate is fine: SSL Checker. All the checks must be ok, including the "Certificate Chain Complete". Otherwise the app might work on iOS but not on Android.

The app starts but it says it cannot connect to any site I try

This may happen because you need to use a different browser with special flags enabled so cross domains XHR requests are allowed.

In short, you need to download Chromium from the official download page and open it with this command:

chromium-browser --allow-file-access-from-files --disable-web-security

For additional information please, read the Using the Moodle App in a browser page.

Some features like IMSCP, resource mini sites, local notifications are not working in the browser

Some features must be tested directly in a mobile device. You can do that using the application in the appstores, or you can learn how to compile it yourself in the Setting up your development environment for the Moodle App page.

What is the difference between a native app and a Mobile specific theme or responsive theme?

You can read about that in the following forum posts:

I am having running the app from the source code

If you are having issues getting the app to compile, make sure to check out the troubleshooting section of the Setting up your development environment for the Moodle App page.

@@ Line 1: / Line 1: @@
 {{Moodle App (Ionic 5)}}
-== How can I contribute to Moodle App? ==
+== How can I contribute to the Moodle App? ==
-You can help with any issue marked with the tag contribfriendly: https://tracker.moodle.org/issues/?jql=project%20%3D%20MOBILE%20AND%20status%20%3D%20Open%20AND%20labels%20%3D%20contribfriendly
+You can help with [https://tracker.moodle.org/issues/?jql=project%20%3D%20MOBILE%20AND%20status%20%3D%20Open%20AND%20labels%20%3D%20contribfriendly any issue marked with the "contribfriendly" label].
-If you want to help with another issue, please let us know first via the tracker (a comment in the issue itself).
+If you want to help with another issue, please let us know first via the tracker, you can a comment in the issue itself.
-You have a detailed description of our development process here: [[Moodle App Development Process]]
+You have a detailed description of our development process here: [[Moodle App Development Process]].
-== Everything seems to be correctly configured but I see this error: Cannot connect: Verify that your have typed correctly the URL and that your site uses Moodle 2.4 or later ==
+== I see this error: "Cannot connect: Verify that your have typed correctly the URL and that your site uses Moodle 2.4 or later" ==
-* Ensure that debugging is disabled in your site: Administration > Development > Debugging
+* Ensure that debugging is disabled in your site: Administration > Development > Debugging.
-* Check that the ADOdb 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).
+* Check that the ADOdb option is disabled if you are using the external database auth or enrolment plugin. You can do that in "Plugins > Authentication > External database" and in "Plugins > Enrolment > External database".
-* If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. Please use this tool or a similar one to check that your certificate is fine: [https://www.geocerts.com/ssl_checker SSL Checker]. All the checks must be ok, including the "Certificate Chain Complete". Otherwise the app might work on iOS but not on Android.
+* If your site uses an SSL certificate, it must be a trusted certificate, not self-signed. You can 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.
 == The app starts but it says it cannot connect to any site I try ==
-This is because you need to use a different browser with special flags enabled so cross domains XHR requests are allowed.
+This may happen because you need to use a different browser with special flags enabled so cross domains XHR requests are allowed.
-In sort, you need to download Chromium from https://download-chromium.appspot.com/ and open it with this command:
+In short, you need to download Chromium from [https://www.chromium.org/getting-involved/download-chromium the official download page] and open it with this command:
- chromium --allow-file-access-from-files --disable-web-security
+<syntaxhighlight lang="bash">
+chromium-browser --allow-file-access-from-files --disable-web-security
+</syntaxhighlight>
-For additional information please, read: [[Moodle Mobile development using Chrome or Chromium]]
+For additional information please, read the [[Using the Moodle App in a browser]] page.
-== I get a blank page in Chrome/Chromium when launching the app in Windows ==
+== Some features like IMSCP, resource mini sites, local notifications are not working in the browser ==
-* Ensure that you have downloaded the latest master version from github (git checkout master; git pull master; git checkout mybranch; git rebase master)
+Some features must be tested directly in a mobile device. You can do that using the application in the appstores, or you can learn how to compile it yourself in the [[Setting up your development environment for the Moodle App#Running_the_app_in_Android_and_iOS|Setting up your development environment for the Moodle App]] page.
-* Ensure that gulp-slash is installed: npm install gulp-slash
-* Run gulp again
-== Some features like IMSCP, resource mini sites, local notifications are not working in the browser ==
+== What is the difference between a native app and a Mobile specific theme or responsive theme? ==
-Some features must be tested directly in a mobile device via ionic run android or ionic run ios.
+You can read about that in the following forum posts:
-It will require you to install the platform specific SDK or development tools, follow your platform guide here: http://cordova.apache.org/docs/en/edge/guide_platforms_index.md.html#Platform%20Guides
+* https://moodle.org/mod/forum/discuss.php?d=206736#p901475
+* https://moodle.org/mod/forum/discuss.php?d=206736#p901751
-== What is the difference between a native app and a Mobile specific theme or responsive theme? ==
-See http://moodle.org/mod/forum/discuss.php?d=206736#p901475
+== I am having running the app from the source code ==
-Also http://moodle.org/mod/forum/discuss.php?d=206736#p901751
+If you are having issues getting the app to compile, make sure to check out the troubleshooting section of the [[Setting up your development environment for the Moodle App#Troubleshooting|Setting up your development environment for the Moodle App]] page.

Documentation