Mobile app notifications: Difference between revisions

Latest revision as of 10:23, 18 February 2017

For students and teachers

Forum post notification

The Moodle mobile app lets you keep up to date with all that's happening in your courses and on the site. Every time you open the app, events are synchronised with the main website.

You will receive Moodle calendar event notifications automatically. If you don't want to get them, you can turn them all off individually (or globally) in the Calendar events options in the main menu.

You will also receive notifications of messages, forum posts, submitted assignments etc (known as 'push notifications') if your site administrator has enabled these. To receive these notifications you need to enable them for your mobile on the app via Settings -> Notifications (only for Moodle 3.2 onward) or on the main site, from the user menu top right >Preferences>Messaging.

For administrators

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.

You can enable by default Mobile notifications for your students, please read the "Default message outputs" section in Messaging settings.

If you have problems requesting the access key, please fill in the Airnotifier access key manual request form. (If your site is hosted so you can't obtain your siteidentifier, enter "cannot obtain" in the field.) 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.

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).

Moodle offers a branded app service including a private notifications infrastructure, for more information visit https://moodle.com/mobileapp/

@@ Line 1: / Line 1: @@
 {{Mobile}}
-The app supports two types of notifications: Local and Push.
+==For students and teachers==
+[[File:12Notifications.png|thumb|Forum post notification]]
+The Moodle mobile app lets you keep up to date with all that's happening in your courses and on the site. Every time you open the app, events are synchronised with the main website.
-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 sent by any Moodle module that can be configured in your Messaging profile option.
+You will receive [[Calendar|Moodle calendar]] event notifications automatically. If you don't want to get them, you can turn them all off individually (or globally) in the Calendar events options in the main menu.
-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.
+You will also receive notifications of messages, forum posts, submitted assignments etc (known as 'push notifications') if your site administrator has enabled these. To receive these notifications you need to enable them for your mobile on the app via Settings -> Notifications (only for Moodle 3.2 onward) or on the main site, from the user menu top right >''Preferences>Messaging.''
-== Local notifications ==
+==For administrators==
-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.
+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''.
-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.
+You can enable by default Mobile notifications for your students, please read the "Default message outputs" section in [[Messaging settings]].
-== Push notifications ==
+If you have problems requesting the access key, please fill in the [http://goo.gl/forms/WLwkbe8b7c  Airnotifier access key manual request form]. (If your site is hosted so you can't obtain your siteidentifier, enter "cannot obtain" in the field.)  Your site registration will be checked and you will be sent an access key in a few days if everything is correct.
-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 sent by any Moodle module that can be configured in your Messaging profile option.
+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.
-Enabling push notifications:
+=== Event Reminders plugin===
-.  (Optional step) 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 need to enable the plugin. For Moodle versions 2.4 and 2.5 the [[Moodle Mobile additional features]] plugin must also be installed.  *
+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.
-.  Connect it to a messaging server (you can use ours if 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 in 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).
+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.
-.  Users need to connect at least once with the latest version of the app in order to register their phones with your site.
+=== Installing your own notifications infrastructure ===
-.  Users must configure notifications in the Moodle messaging preferences (''Administration > My profile settings > Messaging'').
+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).
-<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.
+https://messages.moodle.net uses a slightly modified version of Airnotifier: https://github.com/moodlehq/airnotifier/tree/moodle2.
-=== Receiving calendar notifications via Push messages ===
+You will have to add your app certificates - see https://github.com/airnotifier/airnotifier/wiki/Installation for further information.
-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]
+The Airnotifier message plugin allows you to point to your custom Airnotifier instance using your own access keys.
-This 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 Moodle calendar.
+Remember to install using GIT (repository https://github.com/moodlehq/airnotifier.git branch ''moodle2'').
-=== Installing your own Notifications infrastructure ===
+Moodle offers a branded app service including a private notifications infrastructure, for more information visit https://moodle.com/mobileapp/
-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).
+[[de:Moodle Mobile - Benachrichtigungen]]
+[[ca:Notificacions_de_la_app_Mobile]]
-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'').
-[[de:Mobile App - Push-Mitteilungen]]
 [[es:Mobile app Notificaciones Push]]
+[[fr:Notifications de l'app mobile]]

Documentation