WordPress plugin for handling devices registration and sending push notifications when posts are added/updated
Before using the plugin build the actual sender component (push-notif-sender
, you'll need Go SDK):
go build push-notif-sender.go
Zip the folder containing index.html
, push-notif-for-posts.php
and push-notif-sender
binary and upload/install it on WordPress. You may need to enable uploading large files in PHP config for your server.
After installation and activation, plugin is available in WordPress side menu.
Before using the plugin, you should provide your FCM Server Key.
After installation and activation, plugin exposes endpoint that mobile apps use for registration. App can call this endpoint whenever it wants.
POST http://www.example.com/?rest_route=/pn4p/v1/token
Parameters:
Parameter | Value |
---|---|
token | Device token |
platform | ios or android |
device | Device Name, e.g. Galay S8 |
Successful registration response:
{
"success": true,
"message": "Token registration successful"
}
Error response:
{
"code": "rest_invalid_param",
"message": "Invalid parameter(s): platform",
"data": {
"status": 400,
"params": {
"platform": "Invalid parameter."
}
}
}
Push notification delivered to a device will have payload like this:
{
"type": "post_notification",
"post": {
"id": 55,
"slug": "some-post-title",
"title": "Some Post Title",
"summary": "Post sumarry here",
"photo": "http://example.com/wor2-07-16-29-12.png"
}
}
Settings
tab exposes plugin settings.Registrations
tab shows list of registrations.Log
tab shows message log frompush-notif-sender
binary after post is created or updated.
When creating or editing post, check Send Push Notifications
option in the Publish
WordPress menu if you want to send push notifications for that post. Note that failed deliveries of push notifications to certain devices (e.g. due to expired token) will remove that devices from registrations untill devices register again.