Notifications Push
Notifications Push gives WinnerWare a push-delivery channel for mobile users and a simple admin tool for testing notification delivery.
Overview
This module is used when WinnerWare needs to send notification messages to users on their registered devices instead of relying only on email or in-app alerts.
Key Features
- Adds a push notification method for supported users.
- Sends to registered mobile devices linked to the user profile.
- Includes an optional provider-specific delivery feature.
- Adds an admin test screen for sending sample push messages.
- Supports subject and message text in the test workflow.
How It Works
The module has two features:
| Admin display name | Feature ID | Purpose |
|---|---|---|
| Push Notifications | CloudSolutions.Notifications.Push | Adds the core push notification method. |
| Push Notifications (OneSignal) | CloudSolutions.Notifications.Push.OneSignal | Connects the push method to the configured delivery service and exposes the admin test screen. |
When a notification is sent, WinnerWare looks for registered devices on the target user's profile. If valid device IDs are available, the notification is sent to those devices. If no registered devices exist, the message is not delivered.
Configuration
Admin navigation
- Tools -> Testing -> Push Notifications Test
Permission
| Permission | Purpose |
|---|---|
| Test Push Notification | Lets administrators open the push test screen and send sample messages. |
Test screen fields
| Field | Purpose |
|---|---|
| Users | Selects the target users. |
| Subject | Sets the notification title or summary. |
| Message | Sets the notification body text. |
Operational note
The provider-specific feature expects its API settings to be configured in the tenant configuration before notifications can be delivered successfully.
Usage
Use this module when teams need to reach mobile users quickly with reminders, alerts, or announcements. The built-in test screen is useful during rollout and troubleshooting because administrators can confirm whether registered devices are receiving messages.
Example setup
One clear rollout pattern is:
- enable the core push feature and the delivery-provider feature
- confirm mobile users have registered devices
- open Tools -> Testing -> Push Notifications Test
- choose a user, enter a subject and message, and send a test notification
- confirm the message reaches the expected mobile device before using push in live workflows
Developer Notes
- Delivery depends on users having registered device records.
- The provider-specific service validates device IDs and sends localized title/body content when available.
- The admin test flow sends one message per selected enabled user and reports success or warning notifications in the admin UI.