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: Mobile app notifications.

Mobile app notifications: Difference between revisions

From MoodleDocs
No edit summary
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Mobile}}
{{Mobile}}
==Types of notification==
The Moodle Mobile app has two types of notifications: local and push.


== Local notifications ==
== Local notifications ==


Local notifications are [[Calendar|Moodle calendar]] event notifications only.
Local notifications are enabled by default and you don't have to configure anything. Every time you open the Moodle Mobile app, events are re-synchronized and old events are deleted. Note that groups events are not yet supported.
Local notifications  may be disabled in the app via ''Settings > General'' or individually for each event via the 'Calendar events' option in the main menu.


== Push notifications ==
== Push notifications ==


Starting from versions 1.4 (iOS, iPhone, iPad) and 1.4.3 (Android) Moodle Mobile supports push notifications:
Push notifications are all notifications related to the [[Messaging|messaging system]] in Moodle, such as notifications of [[Using Messaging|instant messages]], new forum posts, submitted assignments etc.
 
Push notifications need to be enabled by a site administrator and configured by users in their messaging profile settings (''Administration > My profile settings > Messaging'').
 
===Enabling push notifications===
 
Note: If your Moodle installation is 2.6 or below, you will need to install the [https://moodle.org/plugins/view.php?plugin=message_airnotifier Mobile notifications plugin]. For Moodle 2.7 and onwards you just need to enable the plugin. For Moodle versions 2.4 and 2.5 the [[Moodle Mobile additional features]] plugin must also be installed. (See note marked * below.)
 
Push notifications can be enabled by an administrator by connecting their Moodle site to a messaging server such https://messages.moodle.net (available for [[Site registration|registered Moodle sites]] only). An access key can be obtained via ''Administration > Site administration > Plugins > Message outputs > Mobile Notifications''. (If you have problems requesting the access key, please fill in the [http://goo.gl/forms/WLwkbe8b7c  Airnotifier access key manual request form]. Your site registration will be checked and you will be sent an access key in a few days if everything is correct.)


1.  Optional step, if your Moodle installation is 2.6 or bellow you 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. *
Users then need to connect at least once with the latest version of the Moodle Mobile app in order to register their phones with the Moodle site.


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 check and we will send you and access key if everything seems to be ok).
<nowiki>*</nowiki> Only for Moodle 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-27374 for more information.


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


4. Users must configure notifications in the Moodle messaging preferences (''Administration > My profile settings > Messaging'').
Push notifications can also include calendar event notifications, however this requires the [https://moodle.org/plugins/view/local_reminders Event Reminders plugin] to be installed on the Moodle site.


<nowiki>*</nowiki> For Moodle versions 2.4 and 2.5 the [[Moodle Mobile additional features]] must be also installed.
The Event Reminders plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. It also allows users to control how they receive messages for each type of event in the Moodle calendar.
<br /><nowiki>**</nowiki> 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.


=== 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 Moodle Mobile app, or you want to use your own notifications infrastructure, 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.  
https://messages.moodle.net uses a slightly modified version of Airnotifier: https://github.com/moodlehq/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 - see https://github.com/airnotifier/airnotifier/wiki/Installation for further information.


The message AirNotifier plugin allow you to point to your custom AirNotifier instance using your own access keys.
The Airnotifier message plugin allows 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'').
Remember to install using GIT (repository https://github.com/moodlehq/airnotifier.git branch ''moodle2'').


[[de:Mobile App - Push-Mitteilungen]]
[[de:Mobile App - Push-Mitteilungen]]
[[es:Mobile app Notificaciones Push]]
[[es:Mobile app Notificaciones Push]]

Latest revision as of 15:27, 19 November 2015


Types of notification

The Moodle Mobile app has two types of notifications: local and push.

Local notifications

Local notifications are Moodle calendar event notifications only.

Local notifications are enabled by default and you don't have to configure anything. Every time you open the Moodle Mobile app, events are re-synchronized and old events are deleted. Note that groups events are not yet supported.

Local notifications may be disabled in the app via Settings > General or individually for each event via the 'Calendar events' option in the main menu.

Push notifications

Push notifications are all notifications related to the messaging system in Moodle, such as notifications of instant messages, new forum posts, submitted assignments etc.

Push notifications need to be enabled by a site administrator and configured by users in their messaging profile settings (Administration > My profile settings > Messaging).

Enabling push notifications

Note: If your Moodle installation is 2.6 or below, you will need to install the Mobile notifications plugin. For Moodle 2.7 and onwards you just need to enable the plugin. For Moodle versions 2.4 and 2.5 the Moodle Mobile additional features plugin must also be installed. (See note marked * below.)

Push notifications can be enabled by an administrator by connecting their Moodle site to a messaging server such https://messages.moodle.net (available for registered Moodle sites only). An access key can be obtained via Administration > Site administration > Plugins > Message outputs > Mobile Notifications. (If you have problems requesting the access key, please fill in the Airnotifier access key manual request form. Your site registration will be checked and you will be sent an access key in a few days if everything is correct.)

Users then need to connect at least once with the latest version of the Moodle Mobile app in order to register their phones with the Moodle site.

* Only for Moodle 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-27374 for more information.

Event Reminders plugin

Push notifications can also include calendar event notifications, however this requires the Event Reminders plugin to be installed on the Moodle site.

The Event Reminders plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. It also allows users to control how they receive messages for each type of event in the Moodle calendar.

Installing your own notifications infrastructure

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

https://messages.moodle.net uses a slightly modified version of Airnotifier: https://github.com/moodlehq/airnotifier/tree/moodle2.

You will have to add your app certificates - see https://github.com/airnotifier/airnotifier/wiki/Installation for further information.

The Airnotifier message plugin allows you to point to your custom Airnotifier instance using your own access keys.

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