Note: You are currently viewing documentation for Moodle 3.4. Up-to-date documentation for the latest stable version of Moodle is likely available here: Mobile app notifications.

Mobile app notifications: Difference between revisions

From MoodleDocs
No edit summary
No edit summary
Line 21: Line 21:
1.  (Optional step), if your Moodle installation is 2.6 or bellow you will need to Install the [https://moodle.org/plugins/view.php?plugin=message_airnotifier Mobile notifications plugin]. For Moodle 2.7 and onward you need to enable the plugin. For Moodle versions 2.4 and 2.5 the [[Moodle Mobile additional features]] plugin must be also installed.  *
1.  (Optional step), if your Moodle installation is 2.6 or bellow you will need to Install the [https://moodle.org/plugins/view.php?plugin=message_airnotifier Mobile notifications plugin]. For Moodle 2.7 and onward you need to enable the plugin. For Moodle versions 2.4 and 2.5 the [[Moodle Mobile additional features]] plugin must be also installed.  *


2.  Connect it to a messaging server, you can use ours in case your Moodle site is registered. Go to ''Site administration > Plugins > Message outputs > Mobile Notifications'' and click in ''Request access key''. If you have problems requesting the access key, please fill this form: http://goo.gl/forms/WLwkbe8b7c (your site registration will be checked and we will send you in a few days an access key if everything seems to be ok).
2.  Connect it to a messaging server (you can use ours in case your Moodle site is registered). Go to ''Site administration > Plugins > Message outputs > Mobile Notifications'' and click in ''Request access key''. If you have problems requesting the access key, please fill this form: http://goo.gl/forms/WLwkbe8b7c (your site registration will be checked and we will send you an access key in a few days if everything is correct).


3.  Users need to connect at least once with the latest version of the app to register their phones with your site.
3.  Users need to connect at least once with the latest version of the app to register their phones with your site.
Line 33: Line 33:
You can receive calendar notifications via Push messages, it requires a plugin to be installed in your Moodle site: [https://moodle.org/plugins/view/local_reminders Event Reminders]
You can receive calendar notifications via Push messages, it requires a plugin to be installed in your Moodle site: [https://moodle.org/plugins/view/local_reminders Event Reminders]


This plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. This plugin allows users to control how they receive messages for each event types in Moodle calendar.
This plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. This plugin allows users to control how they receive messages for each event type in Moodle calendar.


=== Installing your own Notifications infrastructure ===
=== Installing your own Notifications infrastructure ===


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


We use a slightly modified version of Airnotifier: https://github.com/jleyva/airnotifier/tree/moodle2.  
We use a slightly modified version of Airnotifier: https://github.com/jleyva/airnotifier/tree/moodle2.  


You have to add your app certificates there, see https://github.com/airnotifier/airnotifier/wiki/Installation.
You will have to add your app certificates there, see https://github.com/airnotifier/airnotifier/wiki/Installation.


The message AirNotifier plugin allow you to point to your custom AirNotifier instance using your own access keys.
The message AirNotifier plugin allow you to point to your custom AirNotifier instance using your own access keys.

Revision as of 12:49, 5 February 2015


The app supports two types of notifications: Local and Push.

Local notifications are only for events in your Moodle calendar. Push notifications are connected to the messaging system in Moodle, so you receive notifications for internal messages, new forum posts, submitted assignments and every message send by any Moodle module that can be configured in your Messaging profile option.

Local notifications are enabled by default and you don't have to configure anything, Push notifications need to be enabled by your site administration and configured in your message profile.

Local notifications

Local notifications are enabled by default: the app creates local notifications based in your calendar events (every time you open the app, the events are re-synchronized deleting the old ones). Note that groups events are not currently supported.

You can disable local notifications in the app Settings > General section or individually for each event via the "Calendar events" option in the main menu.

Push notifications

Push notifications are connected to the messaging system in Moodle so you receive notifications for internal messages, new forum posts, submitted assignments and every message send by any Moodle module that can be configured in your Messaging profile option.

Enabling push notifications:

1. (Optional step), if your Moodle installation is 2.6 or bellow you will need to Install the Mobile notifications plugin. For Moodle 2.7 and onward you need to enable the plugin. For Moodle versions 2.4 and 2.5 the Moodle Mobile additional features plugin must be also installed. *

2. Connect it to a messaging server (you can use ours in case your Moodle site is registered). Go to Site administration > Plugins > Message outputs > Mobile Notifications and click in Request access key. If you have problems requesting the access key, please fill this form: http://goo.gl/forms/WLwkbe8b7c (your site registration will be checked and we will send you an access key in a few days if everything is correct).

3. Users need to connect at least once with the latest version of the app to register their phones with your site.

4. Users must configure notifications in the Moodle messaging preferences (Administration > My profile settings > Messaging).

* Only for Moodle different from 2.7 and onwards: If you upgrade your Moodle installation, you will have to reinstall the plugin since it adds a couple of functions to the core Moodle Mobile service. See https://tracker.moodle.org/browse/MDLSITE-2815?focusedCommentId=273741&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-273741 for more information.

Receiving calendar notifications via Push messages

You can receive calendar notifications via Push messages, it requires a plugin to be installed in your Moodle site: Event Reminders

This plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. This plugin allows users to control how they receive messages for each event type in Moodle calendar.

Installing your own Notifications infrastructure

If you have a customized version of the Mobile app, or you want to use your own Notifications infrastructure, then you will have to install a private AirNotifier (backend server for notifications).

We use a slightly modified version of Airnotifier: https://github.com/jleyva/airnotifier/tree/moodle2.

You will have to add your app certificates there, see https://github.com/airnotifier/airnotifier/wiki/Installation.

The message AirNotifier plugin allow you to point to your custom AirNotifier instance using your own access keys.

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