Note: You are currently viewing documentation for Moodle 2.5. Up-to-date documentation for the latest stable version of Moodle may be available here: Mobile app.

Mobile app: Difference between revisions

From MoodleDocs
 
(38 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{Moodle 2.1}}The official Moodle mobile app for iPhone, developed and maintained by Moodle HQ, is now available for download (free!) from the Apple Online Store http://itunes.apple.com/ie/app/my-moodle/id461289000
{{Mobile}}
<p class="note">'''Mobile app latest''': The ''Moodle Mobile'' app (developed on HTML5 and Phonegap) replaces the old mobile app for iPhone, ''My Moodle''. It requires Moodle 2.4 or above.</p>


NOTE: Moodle 2.1 or later is REQUIRED to use this app. [[Enable mobile web services|Mobile web services must also be enabled]] on the Moodle site.
== Features ==
* 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
* 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 resources
* Quick access to your course contents
* Remote translation (see bellow)
* Remote layout/style customization (see below)
* Upload any type of file from your device to your Moodle private files area
* * Support for sites using CAS or Shibboleth as auth methods
* * View calendar events
* * View your private messages and notifications
* * Mobile Push notifications
* * View your activity and course total grades in a course
* * Browse and download your private and course files
* * View forum discussions


This app is not a replacement for the Moodle interface, it just provides you with some useful additional tools.
Note: All features indicated (*) require the [[Moodle Mobile additional features]] add-on to be installed.


Notice that Moodle Mobile is not a replacement of the MyMobile or Bootstrap/Simple theme. Moodle Mobile offers offline contents, camera & audio features and (in a future) Push notifications.
You can use Moodle Mobile app in combination with a Mobile theme.


==Adding your Moodle site==
=== Screenshots ===


After downloading the app you are prompted to enter the address of your Moodle site and your username and password.
'''Phone'''


[[File:Mobile app add a site.jpg]]
[[File:moodlemobile01.jpg]]
[[File:moodlemobile02.jpg]]
[[File:moodlemobile03.jpg]]
[[File:moodlemobile04.jpg]]
[[File:moodlemobile05.jpg]]


==Dashboard==


Functionalities (tasks) are displayed with icons on the home page of the app.
'''Tablet'''


[[File:Mobile app.jpg]]
[[File:moodlemobileipad01.jpg]]
[[File:moodlemobileipad02.jpg]]


==Upload==


This functionality allows you to select or capture an image, sound recording or video from your mobile device and quickly post it directly to your "Private files" area in Moodle. If you are offline, the file is saved and can be uploaded later when you are online.
=== Style customization ===


Once the files are on Moodle, they are then easily accessible whenever you need to insert an image into a forum post, post an assignment or anything else that uses files.  
The app can also retrieve your custom styles from your Moodle site. Since the app is a HTML5 app, you can apply safely any CSS, CSS2 and CSS3 style.


[[File:Mobile app upload.jpg]]
In your Moodle installation go to Plugins / Web services / Mobile and enter in the mobilecssurl field a valid URL pointing to a CSS file containing your custom styles.  
[[File:Mobile app record audio.jpg]]


==Participants==
The CSS should be placed inside your Moodle installation (in your custom theme or inside a local plugin)


This feature allows you to see all the courses you are enrolled in, and to browse the contact information for all the users in those courses.
Once the user is logged in the app, there is a periodical process that retrieves your remote CSS files for applying your custom styles.  


# You can see photos and descriptions of all people (according to your capabilities and privacy settings etc)
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.
# If they have phone numbers defined, you can call them or send an SMS with a single click.
# If they have email addresses you can send them an email.
# If Moodle messaging is enabled you can also send a private message.  
# If notes are enabled and you have the appropriate capability you can add a private note about someone


==Web==
See https://docs.moodle.org/dev/Moodle_Mobile_Themes for documentation.


The web icon enables you to access the web version of your Moodle site.
==Moodle sites must be enabled for the app to access them==


==Help==
Moodle 2.4 or above is mandatory.


The help icon provides access to the Moodle documentation.
The administrator of your Moodle site must enable mobile access as follows:


[[File:Mobile app viewing docs.jpg]]
* In ''Administration > Site administration > Plugins > Web services > Mobile'' tick the 'Enable web services for mobile devices' checkbox, then click the button to save changes.


==Licensing==
==Installing the mobile app==


The Moodle mobile app for iPhone is available for download for free from the iTunes app store (with FULL functionality).  However the source code is owned by Moodle Pty Ltd and will not be initially distributed under the GPL.
Apps are available in Google Play and also Apple Store. You can install the app directly from your Mobile device, search for "Moodle Mobile" the author/owner must be "Moodle Pty Ltd"


On the Moodle mobile app roadmap is an app for Android. This will definitely be GPL and free for download and modification by other developers. This is in keeping with the philosophy of the Android platform and will allow the community to innovate on that platform.
Android:  https://play.google.com/store/apps/details?id=com.moodle.moodlemobile


==See also==
iOS:  https://itunes.apple.com/es/app/moodle-mobile/id633359593


* [[Mobile Moodle FAQ]]
You can find the app build for other Mobile OS (not supported officially) here:
* [[Enable mobile web services]]
* Using Moodle [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum]
* Tracker area [http://tracker.moodle.org/browse/MOBILE Moodle for Mobiles]
* Blog post [http://www.somerandomthoughts.com/blog/2011/09/09/official-moodle-mobile-app-for-iphone-released Official Moodle Mobile App for iPhone – Released!]
* [[:dev:Mobile app|Mobile app developer notes]] including the Mobile app roadmap


[[Category:Mobile]]
https://build.phonegap.com/apps/314601/builds
 
==Testing the app on a demo site==
 
In the login screen, type "teacher" or "student" in the Username field and click the Add button. You will be logged automatically to a Moodle demo site for testing the app.
 
== Cache ==
If you connect to your Moodle site and update/create/delete anything, and then go to your mobile app, the content will not be displayed. You will have to wait a couple of minutes. The cache time for the app is currently 5 minutes.
 
There are developer options for purging the cache at any time (Settings -> Development)
 
==How to report a bug==
 
# Log in to the Moodle Mobile tracker  [https://tracker.moodle.org/browse/MOBILE https://tracker.moodle.org/browse/MOBILE] (you'll need to [http://tracker.moodle.org/secure/Signup%21default.jspa create a tracker account] if you've not done so previously)
# ''Check whether the issue has already been reported by [https://tracker.moodle.org/issues/?jql=project%20%3D%20MOBILE searching all the issues]''
# If not, report the bug by clicking the 'Create Issue' link at the top right of the page, selecting 'Moodle Mobile' as the project
# Add a detailed description then click the Create button
# Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
#* 'Device information' - this can be found in the app (Settings -> Development -> Device info, you can send yourself this information by email using the e-mail button at the bottom)
#* App Log (''Settings -> Development -> Show Log'', again you can send yourself this information by email)
 
=== Report a bug by email ===
 
You can send us the same report by email using ''Settings -> Report a bug''. As the report is sent by email to mobile@moodle.com, the report will take more time to be filed in the tracker.
 
== See also ==
 
* [[:dev:Moodle Mobile|Moodle Mobile developer docs]]
* [[Mobile web services]]
 
[[ja:モバイルアプリ]]
[[de:Mobile App]]

Latest revision as of 10:10, 20 February 2015

Mobile app latest: The Moodle Mobile app (developed on HTML5 and Phonegap) replaces the old mobile app for iPhone, My Moodle. It requires Moodle 2.4 or above.

Features

  • 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
  • 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 resources
  • Quick access to your course contents
  • Remote translation (see bellow)
  • Remote layout/style customization (see below)
  • Upload any type of file from your device to your Moodle private files area
  • * Support for sites using CAS or Shibboleth as auth methods
  • * View calendar events
  • * View your private messages and notifications
  • * Mobile Push notifications
  • * View your activity and course total grades in a course
  • * Browse and download your private and course files
  • * View forum discussions

Note: All features indicated (*) require the Moodle Mobile additional features add-on to be installed.

Notice that Moodle Mobile is not a replacement of the MyMobile or Bootstrap/Simple theme. Moodle Mobile offers offline contents, camera & audio features and (in a future) Push notifications. You can use Moodle Mobile app in combination with a Mobile theme.

Screenshots

Phone

moodlemobile01.jpg moodlemobile02.jpg moodlemobile03.jpg moodlemobile04.jpg moodlemobile05.jpg


Tablet

moodlemobileipad01.jpg moodlemobileipad02.jpg


Style customization

The app can also retrieve your custom styles from your Moodle site. Since the app is a HTML5 app, you can apply safely any CSS, CSS2 and CSS3 style.

In your Moodle installation go to Plugins / Web services / Mobile 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)

Once the user is logged in the app, there is a periodical process that retrieves your remote CSS files for applying your custom styles.

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.

See https://docs.moodle.org/dev/Moodle_Mobile_Themes for documentation.

Moodle sites must be enabled for the app to access them

Moodle 2.4 or above is mandatory.

The administrator of your Moodle site must enable mobile access as follows:

  • In Administration > Site administration > Plugins > Web services > Mobile tick the 'Enable web services for mobile devices' checkbox, then click the button to save changes.

Installing the mobile app

Apps are available in Google Play and also Apple Store. You can install the app directly from your Mobile device, search for "Moodle Mobile" the author/owner must be "Moodle Pty Ltd"

Android: https://play.google.com/store/apps/details?id=com.moodle.moodlemobile

iOS: https://itunes.apple.com/es/app/moodle-mobile/id633359593

You can find the app build for other Mobile OS (not supported officially) here:

https://build.phonegap.com/apps/314601/builds

Testing the app on a demo site

In the login screen, type "teacher" or "student" in the Username field and click the Add button. You will be logged automatically to a Moodle demo site for testing the app.

Cache

If you connect to your Moodle site and update/create/delete anything, and then go to your mobile app, the content will not be displayed. You will have to wait a couple of minutes. The cache time for the app is currently 5 minutes.

There are developer options for purging the cache at any time (Settings -> Development)

How to report a bug

  1. Log in to the Moodle Mobile tracker https://tracker.moodle.org/browse/MOBILE (you'll need to create a tracker account if you've not done so previously)
  2. Check whether the issue has already been reported by searching all the issues
  3. If not, report the bug by clicking the 'Create Issue' link at the top right of the page, selecting 'Moodle Mobile' as the project
  4. Add a detailed description then click the Create button
  5. Attach the following files to the issue by selecting 'Attach Files' in the 'More actions' dropdown menu:
    • 'Device information' - this can be found in the app (Settings -> Development -> Device info, you can send yourself this information by email using the e-mail button at the bottom)
    • App Log (Settings -> Development -> Show Log, again you can send yourself this information by email)

Report a bug by email

You can send us the same report by email using Settings -> Report a bug. As the report is sent by email to mobile@moodle.com, the report will take more time to be filed in the tracker.

See also