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

Moodle Mobile: Difference between revisions

From MoodleDocs
m (→‎Requirements: removing 2.1 new feature template)
m (removing mention of Windows Phone Store)
 
(91 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{Managing a Moodle site}}
{{Mobile}}
{{Mobile}}
The official Moodle mobile app for iPhone, developed and maintained by Moodle HQ, is now available for download (free!) from the Apple Online Store:
Moodle Mobile is the Moodle official mobile application for Android and iOS, developed and maintained by Moodle HQ. It's available in Google Play and Apple Market. Note that the app requires Moodle versions 2.4 and later and works with Android 4.1 and iOS 7.
=== Features ===
<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. '''New:''' 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> '''New:''' 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>


   http://itunes.apple.com/app/my-moodle/id461289000
<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 ('''New''')</h4>
            <p>Most screens will allow you to pull to refresh, improving the experience of real time participation</p>
          </div>
        </div>
      </li>
      <li class="span6">
        <div class="thumbnail">
[[File:11OrientationResolution.png|600px]]
          <div class="caption">
            <h4> Orientation and Resolution support </h4>
            <p>The app displays well whethe in Portrait or landscape, IOS or Android and whatever your screen resolution.</p>
          </div>
        </div>
      </li>
    </ul>
  </div>


==Requirements==
 


* This app only works with Moodle 2.1 or later
<div class="contentblock">
* [[Enable mobile web services|Mobile web services must also be enabled]] on the Moodle site.
  <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 and download materials for offline use. '''New:''' Work through Books and IMS Content packages directly in the app, and use the local mobile plugin to make Choices and engage in live chat sessions (simple or Ajax.) Resources downloading status 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 ('''New''')</h4>
            <p>Progress can be tracked now from your device with the arrival of the Activity completion functionality in the app. Automatic completion is registered, and students can also manually mark a task complete on their mobille.</p>
          </div>
        </div>
      </li>
    </ul>
  </div>


This app is not a replacement for the Moodle interface, it just provides you with some useful additional tools.
<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 grades table 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 notes about users.</p>
          </div>
        </div>
      </li>
    </ul>
  </div>


==Adding your Moodle site==
<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 from the Calendar link,ensuring you never miss that important session. '''New''': Calendar events can now be viewed offline and infinite scrolling improves is available.</p>
          </div>
        </div>
      </li>
    </ul>
  </div>


After downloading the app you are prompted to enter the address of your Moodle site and your username and password.
<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>Easily see the contents of your private files and upload media to them on the go. '''New:''' App storage is no longer limited to 5MB. It can be up to 50MB or dependent 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 information on enabling these.  ''New:''  Infinite scrolling is available and local notifications have multi-site support.</p>
          </div>
        </div>
      </li>
    </ul>
  </div>


[[File:Mobile app add a site.jpg]]
====Features Quick list====


==Dashboard==
[[File:moodlemobile_features.png|Comparison of features for different versions|thumb|right|400px]]


Functionalities (tasks) are displayed with icons on the home page of the app.
* 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
* View your activity and course total grades in a course
* * Support for sites using CAS or Shibboleth as auth methods
* * Participate in choices
* * Participate in chats
* * Create new discussions and posts in forums


[[File:Mobile app.jpg]]


==Upload==
'''Note (1):''' All features indicated (*) require the [[Moodle Mobile additional features]] plugin to be installed.


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.
'''Note (2)''' : Moodle Mobile is not a replacement of the MyMobile or Bootstrap/Simple theme. Moodle Mobile offers offline contents, camera & audio features and Push notifications connected to the user messaging preferences. You can use Moodle Mobile app in combination with a Mobile theme.


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


[[File:Mobile app upload.jpg]]
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 record audio.jpg]]


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


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.
The CSS should be placed inside your Moodle installation (in your custom theme or inside a local plugin)


# You can see photos and descriptions of all people (according to your capabilities and privacy settings etc)
Once the user is logged in the app, there is a periodical process that retrieves your remote CSS files for applying your custom styles.  
# 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==
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.


The web icon enables you to access the web version of your Moodle site.
See https://docs.moodle.org/dev/Moodle_Mobile_Themes for documentation.


==Help==
=== Languages ===


The help icon provides access to the Moodle documentation.
Over 15 languages are currently supported:


[[File:Mobile app viewing docs.jpg]]
* Arabic, Basque, Catalan, Chinese, Czech , Dutch, English, French, German, Hebrew, Hungarian, Italian, Japanese, Mexican spanish, Portuguese, Russian, Spanish, Swedish


==Licensing==
==Moodle sites must be enabled for the app to access them==


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.
For Moodle 3.0 and onwards Mobile services are automatically enabled for new installations using SSL Certificates (https)


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.
Moodle 2.4 or above is mandatory.


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


* [[Mobile Moodle FAQ]]
* In ''Administration > Site administration > Plugins > Web services > Mobile'' tick the 'Enable web services for mobile devices' checkbox, then click the button to save changes.
 
If your site uses a SSL certificate it must be a trusted certificate. For security reasons the app doesn't work with self-signed certificates.
 
This presentation is a good guide for creating a Moodle Mobile ready course/site: [http://es.slideshare.net/juanleyva/tips-for-creating-moodle-mobile-friendly-courses-sites-moodlemoot-spain-2014 Tips for creating Moodle Mobile friendly courses sites - MoodleMoot Spain 2014]
 
==Installing the Moodle Mobile app==
 
The Moodle Mobile app is available in Google Play, Apple Store, and the Windows Phone Store. See [https://download.moodle.org/mobile/ Moodle Mobile] for links.
 
You can also install the app directly from your mobile device by searching for "Moodle Mobile" with author/owner "Moodle Pty Ltd".
 
==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 the Mount Orange Moodle School demo site You can use the Moodle School demo site - http://school.demo.moodle.net/ 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.
 
You can refresh the contents of the Mobile app using the refresh button (top right in the left orange menu)
 
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)
 
== Help and support ==
 
* [https://moodle.org/mod/forum/view.php?id=7798 Moodle Mobile forum]
* [https://twitter.com/moodlemobileapp Twitter: @moodlemobileapp]
 
 
== See also ==
 
* [http://es.slideshare.net/juanleyva/tips-for-creating-moodle-mobile-friendly-courses-sites-moodlemoot-spain-2014 Tips for creating Moodle Mobile friendly courses sites - MoodleMoot Spain 2014]
* [[:dev:Moodle Mobile|Moodle Mobile developer docs]]
* [[Mobile web services]]
* [[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!]
* Video demonstration - [http://www.youtube.com/watch?v=5OYt6MOd8A8 Moodle Mobile App for iPhone]
* [[:dev:Mobile app|Mobile app developer notes]] including the Mobile app roadmap


[[Category:Mobile]]
[[ja:モバイルアプリ]]
[[de:Mobile App]]
[[es:Moodle Mobile]]
[[fr:Mobile_app]]

Latest revision as of 09:39, 14 October 2016

Moodle Mobile is the Moodle official mobile application for Android and iOS, developed and maintained by Moodle HQ. It's available in Google Play and Apple Market. Note that the app requires Moodle versions 2.4 and later and works with Android 4.1 and iOS 7.

Features

  • mobile01.png

    See your courses at glance

    Your courses are listed with easy access to contents, participants, grades and notes. A useful filter field lets you find a particular course quickly. New: If your token expires during a session, you're prompted to re-enter your password and continue.

  • 02connectwithcourseparticipants.png

    Connect with course participants

    New: Infinite scrolling improves access to the participant view, with the complete user profile now displayed and available from every page.

  • 10PulltoRefresh.png

    Pull to refresh (New)

    Most screens will allow you to pull to refresh, improving the experience of real time participation

  • 11OrientationResolution.png

    Orientation and Resolution support

    The app displays well whethe in Portrait or landscape, IOS or Android and whatever your screen resolution.


  • 03coursecontent.png

    Easily access course content

    View course activities and and download materials for offline use. New: Work through Books and IMS Content packages directly in the app, and use the local mobile plugin to make Choices and engage in live chat sessions (simple or Ajax.) Resources downloading status is preserved even when changing sections or pages.

  • 04ActivityCompletionCheckboxes.png

    Activity completion (New)

    Progress can be tracked now from your device with the arrival of the Activity completion functionality in the app. Automatic completion is registered, and students can also manually mark a task complete on their mobille.

  • 05Grades.png

    Grades and grading

    A Grades link for each course gives fingertip access to the grades table and teachers can view assignment submissions on the move.

  • 06Notes.png

    Notes

    Teachers can view site, course and personal notes about their students and add notes about users.

  • 07Messages.png

    Message participants

    Send and view private messages to colleagues and students from the Messages link in the side tab

  • 08Calendar.png

    Keep up to date with calendar events

    Site, course and user events can be viewed from the Calendar link,ensuring you never miss that important session. New: Calendar events can now be viewed offline and infinite scrolling improves is available.

  • 09PrivateFiles.png

    View and upload to your Private files

    Easily see the contents of your private files and upload media to them on the go. New: App storage is no longer limited to 5MB. It can be up to 50MB or dependent on your SD card.

  • 12Notifications.png

    Notifications

    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 information on enabling these. New: Infinite scrolling is available and local notifications have multi-site support.

Features Quick list

Comparison of features for different versions
  • 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
  • View your activity and course total grades in a course
  • * Support for sites using CAS or Shibboleth as auth methods
  • * Participate in choices
  • * Participate in chats
  • * Create new discussions and posts in forums


Note (1): All features indicated (*) require the Moodle Mobile additional features plugin to be installed.

Note (2) : Moodle Mobile is not a replacement of the MyMobile or Bootstrap/Simple theme. Moodle Mobile offers offline contents, camera & audio features and Push notifications connected to the user messaging preferences. You can use Moodle Mobile app in combination with a Mobile theme.

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.

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

Moodle sites must be enabled for the app to access them

For Moodle 3.0 and onwards Mobile services are automatically enabled for new installations using SSL Certificates (https)

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.

If your site uses a SSL certificate it must be a trusted certificate. For security reasons the app doesn't work with self-signed certificates.

This presentation is a good guide for creating a Moodle Mobile ready course/site: Tips for creating Moodle Mobile friendly courses sites - MoodleMoot Spain 2014

Installing the Moodle Mobile app

The Moodle Mobile app is available in Google Play, Apple Store, and the Windows Phone Store. See Moodle Mobile for links.

You can also install the app directly from your mobile device by searching for "Moodle Mobile" with author/owner "Moodle Pty Ltd".

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 the Mount Orange Moodle School demo site You can use the Moodle School demo site - http://school.demo.moodle.net/ 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.

You can refresh the contents of the Mobile app using the refresh button (top right in the left orange menu)

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)

Help and support


See also