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

Moodle app notifications: Difference between revisions

From MoodleDocs
m (improving wording)
Line 41: Line 41:
== Troubleshooting ==
== Troubleshooting ==


If your users are not receiving correctly Push notifications please double check:
If your users are not receiving push notifications please check:
* You have correctly configured your "Mobile message output, you see an "Airnotifier access key" in Site administration > Plugins > Message outputs > Mobile
* The eye is open for the Mobile row in Site administration > Plugins > Message outputs > Manage message outputs
* The user not receiving notifications has enabled correctly Mobile notifications in the Mobile app (App settings > Notification preferences and check that "Disable notifications" is not selected)
* The user not receiving notifications has enabled correctly the type of notifications he wants to receive (App settings > Notification preferences)
* The user not receiving notifications didn't disable his current device (App settings > Notification preferences > 3 dots menu > Configure devices)
* Mobile notifications were not disallowed by an administrator in Site administration > Plugins > Message outputs > Default message outputs
* Mobile notifications are enabled in the user Android phone (Settings > Apps > Moodle Mobile > Show notifications ticked) or iOS phone (in iOS in Settings -> Moodle Mobile > Notifications)
* The server where your Moodle site is installed is able to connect to messages.moodle.net (port 443) via telnet.
* You are using the Moodle Mobile official app, if you are using a custom/branded app for your instution please contact your institution since custom apps need their own notifications infrastructure (see above)


=== Testing Push notifications ===
* You have entered an Airnotifier access key in the Mobile settings in the Site administration
* Mobile is enabled (open eye) in 'Manage message outputs' in the Site administration
* Any user not receiving notifications has enabled mobile notifications in the mobile app in App settings > Notification preferences then check that "Disable notifications" is not selected
* Any user not receiving notifications has enabled the type of notifications they want to receive in App settings > Notification preferences
* Any user not receiving notifications hasn't disabled his current device in App settings > Notification preferences > 3 dots menu > Configure devices
* Mobile notifications are not disallowed by an administrator in 'Default message outputs' in the Site administration
* Mobile notifications are enabled in the user's Android phone (Settings > Apps > Moodle Mobile > Show notifications ticked) or iOS phone (in iOS in Settings -> Moodle Mobile > Notifications)
* The server where your Moodle site is installed is able to connect to messages.moodle.net (port 443) via telnet
* You are using the Moodle Mobile official app. If you are using a custom/branded app for your institution, please contact your institution since custom apps need their own notifications infrastructure (see above).


If you want to test Push notifications please, do the following:
=== Testing push notifications ===


* As admin, enable Mobile notification following this page documentation.
To test push notifications:
* In a course, create a forum with "Forced subscription"
 
* As a student user, log in on the site and create a new discussion in the forum
# Ensure that mobile notifications are enabled (as described above).
* As the same student, log in on the Mobile app, go to App settings > Notification preferences > Forum and enable all the notifications
# Go to a course and create a forum with forced subscription.
* In the same page, check that at the top of the page you see "You are configuring Mobile notifications", if it says "You are configuring notifications for Web (or Email)" switch to Mobile via the three dots menu at the top right.
# Log in as a student and create a new discussion in the forum.
* In the same page, tap the three dots menu (top right), go to Configure devices and check that your current device is enabled
# As the same student, log in on the mobile app, go to App settings > Notification preferences > Forum and enable all the notifications.
* Now, put the Moodle Mobile app in background (switching to a different app or going to your device home)
# In the same page, check that at the top of the page you see "You are configuring Mobile notifications". If it says "You are configuring notifications for web (or email)", switch to mobile via the three dots menu at the top right.
* As admin, log in to the site (in the web) post a reply to the discussion started by the student, when posting please double check that you ticked the "Send forum post notifications with no editing-time delay " option
# In the same page, tap the three dots menu (top right), go to Configure devices and check that your current device is enabled.
* You should receive a Push notification in the student device.
# Now, put the Moodle Mobile app in background (switching to a different app or going to your device home).
# Log in to the site (on the web) and post a reply to the discussion started by the student., ticking the option "Send forum post notifications with no editing-time delay".
# Verify that the student receives a push notification on their mobile device.


[[de:Moodle Mobile - Benachrichtigungen]]
[[de:Moodle Mobile - Benachrichtigungen]]

Revision as of 18:06, 13 December 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/

Troubleshooting

If your users are not receiving push notifications please check:

  • You have entered an Airnotifier access key in the Mobile settings in the Site administration
  • Mobile is enabled (open eye) in 'Manage message outputs' in the Site administration
  • Any user not receiving notifications has enabled mobile notifications in the mobile app in App settings > Notification preferences then check that "Disable notifications" is not selected
  • Any user not receiving notifications has enabled the type of notifications they want to receive in App settings > Notification preferences
  • Any user not receiving notifications hasn't disabled his current device in App settings > Notification preferences > 3 dots menu > Configure devices
  • Mobile notifications are not disallowed by an administrator in 'Default message outputs' in the Site administration
  • Mobile notifications are enabled in the user's Android phone (Settings > Apps > Moodle Mobile > Show notifications ticked) or iOS phone (in iOS in Settings -> Moodle Mobile > Notifications)
  • The server where your Moodle site is installed is able to connect to messages.moodle.net (port 443) via telnet
  • You are using the Moodle Mobile official app. If you are using a custom/branded app for your institution, please contact your institution since custom apps need their own notifications infrastructure (see above).

Testing push notifications

To test push notifications:

  1. Ensure that mobile notifications are enabled (as described above).
  2. Go to a course and create a forum with forced subscription.
  3. Log in as a student and create a new discussion in the forum.
  4. As the same student, log in on the mobile app, go to App settings > Notification preferences > Forum and enable all the notifications.
  5. In the same page, check that at the top of the page you see "You are configuring Mobile notifications". If it says "You are configuring notifications for web (or email)", switch to mobile via the three dots menu at the top right.
  6. In the same page, tap the three dots menu (top right), go to Configure devices and check that your current device is enabled.
  7. Now, put the Moodle Mobile app in background (switching to a different app or going to your device home).
  8. Log in to the site (on the web) and post a reply to the discussion started by the student., ticking the option "Send forum post notifications with no editing-time delay".
  9. Verify that the student receives a push notification on their mobile device.