Urban Airship Web Push Notifications

This module connects your Drupal site to Urban Airship’s web push notification delivery service so that you can selectively deliver on-demand notifications to your site visitors as you publish your content.

Urban Airship is trusted by thousands of businesses looking to grow with mobile. Every day, marketers and developers depend on Urban Airship to deliver more than one billion mobile moments that inspire interest and drive action. Urban Airship’s digital growth platform is used by many of the world’s most admired companies, including Adidas, Alaska Airlines, The Home Depot, NBC Universal, Sky Media, and Zillow.

Features

• Support for Chrome, Firefox, and Opera browsers on desktop and Android mobile web.
• Customizable opt-in prompt allowing you to choose how and when to prompt users to opt-in to notifications.
• A "Send web notification" checkbox on the content page
• Option to customize the notification title, icon, notification text, and action URL for each notification
• The ability to automatically send a web push notification when publishing or updating any piece of content
• Option to enable notifications for each content type and set default notification text, such as post title
• Support for Drupal 7 & 8

Requirements

To use this plugin, you’ll need to set up a Web Notify account from Urban Airship. You can sign up for a free starter plan with unlimited web push notifications and up to 1,000 addressable users.

For more information on Urban Airship’s Web Push Notification solution, please visit the following links:

• Web Push Notifications Explained
• Technical documentation
• Pricing Plans
• Message Reporting
• Opted-In User Reporting

How to use

1. Install module and visit the configuration page at admin/config/services/urban-airship-web-push-notifications.
2. In the Credentials tab, set the App Key and the App Master Secret form items. Credentials can be found in your Urban Airship dashboard.
3. In the SDK Bundle tab, upload the SDK zip file from your Urban Airship account. For more information about the contents of the SDK bundle, please see the Urban Airship documentation.
4. In the Opt-in Prompt tab, configure the behavior and appearance of your opt-in prompt. For additional details on creating or using a custom opt-in, please see the Urban Airship documentation.
5. Enable notifications on the desired content types by visiting that content types edit page. Select the Urban Airship Web Push Notifications tab and check the Enable notifications checkbox. You may also set the default notification text to be used by all nodes of that content type.
6. Once web notifications are enabled for a specific content type, add a new node or edit an existing node.
7. Select the Urban Airship Web Push Notifications tab. From here, you can set the notification title, icon, text and action URL for the notification you wish to send. If the title, icon, or action URL fields are left blank, the defaults from your configuration file will be used for these fields. Check the Send web notification on save box to instantly send a web push notification upon saving your node.

Important

Mixed HTTPS sites will need to ensure that both of these paths are available on the secure site:

• /push-worker.js
• /web-push-secure-bridge.html

Make sure to clear Drupal cache after you switch Prompt for Notifications mode in order to see the changes.

In addition, these sites will need to have a registration page that is served over HTTPS for users to opt in to notifications. For more information, see the Urban Airship documentation on secure integration.

See README.md file in the module for more details.