To be able to use the OneSignal plugin, you first have to create an account at OneSignal.com.

Now that you have installed the plugin and have created your OneSignal account, we can begin setting them up so that visitor will receive push notifications from your web app.

Follow the instructions on the OneSignal plugin Setup tab and configure a OneSignal app associated with your WordPress install.

The next step will depend on whether your site is on http or https. If your site is on http, make sure you have set the subdomain correctly and skip to step 4.

If your site is on https check the "Use my own manifest.json" in the OneSignal plugin Configuration tab and fill in the "Custom manifest.json URL" field with the URL found in the WP Mobile Pack PROPush Notifications tab.

Activate the "Automatically prompt new site visitors to subscribe to push notifications" option in the OneSignal plugin Configuration tab.

Now you can use the OneSignal dashboard to start monitoring your users and send them push notifications.

Sending Push Notifications To Your Mobile Users

Notifications can be sent via your OneSignal.com dashboard on the New Message page.

You can send your notification to all users, a particular segment if you have segments setup or just a few users as a test.

To send a link, find the Launch URLoption and type in the link. Be sure to include the full URL includinghttp://orhttps://. This will open an external link when the notification is tapped.

Clicking the Scheduleitem lets you select among different notification delivery scheduling options:

When your mobile users access your Web App they will be prompted to subscribe to your notifications. Once they subscribe, every time you send out messages to them, they will receive a notification on their mobile device.

User Segments

Segments allow you to target a subset of your users with notifications. You may create any number of segments. Segments are created by adding filtersbased on certain data attributes.

When creating segments with multiple filters, the users in that segment are those that pass allthe filters. In other words, results are the intersection of all filters combined together. This allows for precise user targeting.

The Segments page of your dashboard on OneSignal.com is where you can view an overview of your segments and add / edit / delete segments:

To view the individual users within a segment, use the segments drop-down filter in All Users. Below is an example of viewing users within the 'Test Users' segment:

Troubleshooting – Common Problems

Users aren't prompted for push notifications on your web app that uses https://
You have to make sure that all links to your site redirect to https://. Otherwise when a user gets to your site without the https://protocol, OneSignal will not send the prompt.

Users aren't prompted for push notifications regardles of security protocol
Make sure that the "Automatically prompt new site visitors to subscribe to push notifications" option is enabled, else the plugin will not trigger a prompt when new users visit your web app.

My browser theme color and other manifest options are being ignored by the browser on https://
This usually happens if you are using https://and don't have the "Use my own manifest.json" option configured correctly. Make sure you enable the option when using https:// and have the correct address in the "Custom manifest.json URL" field.