This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Safari Push

Description

What does this plugin do?

This plugin lets you prompt users to allow Safari Push notifications from your WordPress site, and then send out Safari Push notifications to every user each time you publish a new post from WordPress. There’s also an option to send notifications directly from the plugin’s settings page.

Additionally, it lets you use the shortcode [safari-push] anywhere you like that will provide feedback to visitors on their notification status, and the shortcode [safari-push-count] to show how many subscribers you have (there’s also a dashboard widget to tell you this too).

This plugin is intentionally kept simple, feel free to fork the source and modify it to suit your needs.

The source is maintained on GitHub: https://github.com/surrealroad/wp-safari-push

What this plugin won’t do

This plugin doesn’t communicate with Apple’s Push Notification Service (APNS) directly. You need a dedicated, secure server for that, which is beyond the scope of this plugin. See below for more details.

What are Safari Push Notifications?

Push notifications are a feature in Safari 7 and Mac OS 10.9 “Mavericks” that allow websites to send users notifications to their desktop, even when Safari is closed.

For much more information on this, see https://developer.apple.com/notifications/safari-push-notifications/

What else do I need in order to use this plugin?

You’ll also need a seperate, working HTTPS server for communicating with Safari and Apple Push Notification Server (referred to as the “Web Service”).

For a PHP implementation of the Web Service, refer to our reference project at https://github.com/surrealroad/Safari-Push-Notifications.

Can I see it in action?

Sure, go to http://www.controlcommandescape.com/push/ (you’ll probably want to open that URL in Safari 7)

TODO:

  • Comply with WordPress security guidelines

Additional credits

  • Localisation and French-language version by Rémy Perona (http://remyperona.fr/)

Installation

  1. Install the plugin as you would any other WordPress plugin and enable it
  2. Go to Settings > Safari Push
  3. Fill in the details for your push service
  4. (Optional) Visit your site in Safari 7.0+ and wait for the prompt to subscribe to notifications
  5. (Optional) Add the shortcode [safari-push] somewhere on your site to view the status of push notifications
  6. (Optional) Fill in the form at the bottom of the settings page to send a test psuh notification
  7. (Optional) Edit the HTML displayed for the shortcode in the settings page

Note that your theme must include wp_footer()

FAQ

Where can I get information on how to get the push service working?

Right here

How can I make my push service compatible with this plugin?

See our reference server for example, but you need to have it receive a POST request that accepts “title”, “body”, “action”, “urlargs” and “authentication” tags, and sends a notification to all registered devices.

The notification status says denied, without ever prompting to allow it

Your push package is probably incorrectly configured.
A common problem is to forget to include the “www.” part of the domain in the “allowed domains” list. You need, for example, ‘”http://example.com”, “http://www.example.com”‘

When are notifications sent?

Notifications will be sent whenever a post is published for the first time. You can select which post types to exclude, and you can configure settings for each post from the add/edit post page.

What about Pushwoosh/other third-party support?

This plugin will not provide support for paid-for services.

Are there any plugin hooks I can use?

There’s safaripush_post_notification and safaripush_post_notification which are called immediately before and after sending a notification.

Can I customise what gets sent to which device?

Not right now, maybe never. Depends if this is something that a lot of people would want.

Contributors & Developers

“Safari Push” is open source software. The following people have contributed to this plugin.

Translate “Safari Push” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0

  • Notification settings can be configured for each post when publishing the post
  • Corrected date displayed in notification logs
  • Dates and times are displayed in accordance with WordPress settings where possible
  • Removed the option to restrict push notifications per category, as this can be controlled with more granularity at the post level now
  • Added a dashboard widget that displays the current number of push subscribers
  • Added some missing localisation strings
  • Fixed the settings link from the plugins page

0.9.1

  • Sending a manual push now includes the server response in the result
  • Fix for PHP unexpected T_PAAMAYIM_NEKUDOTAYIM error

0.9

  • Notifications are now logged and can be viewed on the settings page
  • Added two plugin hooks, safaripush_pre_notification and safaripush_post_notification

0.8.2

  • Allow inclusion of categories with no posts (thanks MuViMoTV)

0.8.1

  • Include all valid post types and categories by default

0.8

  • Added [safari-push-count] shortcode to print count of subscribed devices (this will require you to update your push service)
  • Added option to choose which post types to notify for
  • Added option to choose which categories to notify for

0.7.3

  • Use short link instead of permalink to reduce APNS packet size (thanks Djib’s)
  • You can specfiy whether to load Javascript in footer or not from the options screen (thanks Djib’s)

0.7.2

  • Fixed an issue that would prevent registered count not to display in a non-Safari browser
  • Javascript is now called from footer (thanks Djib’s)
  • Fix for Javascript crash on Mobile Safari browsers (thanks mart03)

0.7.1

  • Added missing default for “auth tag” field
  • Fixed permalinks not being pushed (thanks MuViMoTV!)

0.7

  • Security improvements
  • A count of current subscribers is now shown on the options page, as well as a link to show all registered users that have subscribed via push (this will require you to update your push service)
  • Added link to settings from plugins page
  • Push notifications sent from the settings page now use AJAX and can be restricted to a specific device

0.6.5

  • Minified Javascript, corrected a regression that broke Safari detection

0.6.4

  • Workaround for Google Chrome for Mac identifying itself as Safari

0.6.3

  • Fix for future versions of Safari

0.6.2

  • Notification title and button text can now be changed in settings

0.6.1

  • Fixed an issue that was generating a PHP warning
  • Added some documentation and FAQ to the plugin page

0.6

  • French localisation with thanks to Rémy Perona (http://remyperona.fr/)

0.5.3

  • Remove subfolder for better compatibility

0.5.2

  • Fixed folder structure for automatic downloads

0.5.1

  • Added readme.

0.5

  • First WordPress release