Urban Airship Web Push Notifications

Description

Seamlessly connect your WordPress site to Urban Airship’s web push notification delivery service so that you can selectively deliver on-demand notifications to your readers 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.

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.

Plugin Features:

  • Support for Chrome, Firefox, and Opera browsers on desktop and Android mobile web.
  • Two methods for your site visitors to opt-in for notifications:
    • Apply a custom CSS class to any element to turn it into an opt-in prompt
    • Automatically display the browser opt-in prompt based upon page views
  • A “Send web notification” checkbox right below your publish button.
  • The ability to customize notification interaction, text, action URL, and icon per post
  • The ability to automatically send a web push notification when publishing or updating any public post type (including custom post types).
  • A custom web notification content type allowing you to send one-off notifications from within WordPress.

Screenshots

  • Your website visitors simply click “Allow” to start receiving notifications.
  • All it takes is a single click. Simply check the “send web notification on publish” option, make optional custom adjustments to your notification, and click publish.
  • Instantly deliver web notifications upon publish or update.
  • Use the custom web push notification content type to send one-off notifications directly within WordPress.
  • Seamlessly integrate Urban Airship Web Push Notifications with your WordPress site.
  • Configure your settings in the Urban Airship dashboard, including your default title and icon.
  • Check out your message reports in the Urban Airship dashboard to see important metrics for your sent messages, such as click through rates and attributed sessions.
  • Visit the Devices report in your Urban Airship dashboard to see how many website visitors have opted in to notifications.

Installation

  1. Upload the plugin folder to the /wp-content/plugins/ directory, or simply install from the plugin repository.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Setup plugin in plugin settings screen

FAQ

For full technical documentation on Urban Airship’s Web Push Notification solution, please visit the Urban Airship documentation website.

Installation Instructions
  1. Upload the plugin folder to the /wp-content/plugins/ directory, or simply install from the plugin repository.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Setup plugin in plugin settings screen
What are web push notifications?

Web push notifications are notifications that can be sent to a user via desktop web and mobile web. Please [see Web Push Notifications Explained](https://www.urbanairship.com web-push-notifications-explained) for more information.

Which browsers is this plugin and Urban Airship service compatible with?

Currently Chrome (52+), Firefox (48+), and Opera (39+) support web push notifications.

How can users unsubscribe from receiving notifications?

Each browser has settings to manually/disable push notifications:

  1. Chrome: https://support.google.com/chrome/answer/3220216
  2. Firefox: https://support.mozilla.org/en-US/kb/push-notifications-firefox#w_how-do-i-revoke-web-push-permissions-for-a-specific-site
  3. Opera: http://help.opera.com/opera/Mac/2393/en/controlPages.html#manageNotifications
How much does Urban Airship Web Notify cost?

The free starter plan includes unlimited web push notifications and up to 1,000 addressable users. See the Web Notify plan comparison page for more details.

How can I use web push notifications on a website that is not fully HTTPS?

Urban Airship provides a “secure bridge” component that is required for integration on sites that are not fully HTTPS. To use the plugin on a mixed HTTPS site, check the box next to “Yes, I will be integrating the SDK on a mixed HTTPS site.” in the Urban Airship Dashboard when configuring your setup files. From there, reference Urban Airship’s Secure Integration documentation for details on how to host the necessary files and registration page securely.

Where can I see analytics for my web push notifications?

Analytics are available in the Urban Airship dashboard, where you can see the number of people who have opted-in to your notifications, the number of notifications sent, the click through rate, and the number of sessions attributed to your push notification. For more details, view the documentation on message reports and opt-in report.

Why I am not receiving notifications?

There are several causes as to why you are not receiving notifications:

  1. Make sure your have opted in to receive notifications/have not blocked receiving notifications from your website in browser settings.
  2. Ensure “Do Not Disturb” (Apple devices) or “Quiet Hours” (Windows devices) is off so that notifications are not muted.
  3. Visit (https://status.urbanairship.com/) to determine if Urban Airship’s systems are operational
  4. Make sure push worker is accessible. To do that, try accessing {site URL}/push-worker.js is accessible, if not, try saving permalinks again.
  5. If none of the above helps, Contact Urban Airship Support to further troubleshoot.

Please refer to Urban Airship’s Web Push Notifications page for more information.

Contributors & Developers

“Urban Airship Web Push Notifications” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.1

  • Added ability to customize notification interaction, text, action URL, and icon per post
  • Added custom web notification content type allowing you to send one-off notifications from within WordPress

1.0

  • First version