Skip to main content

WordPress Plugin

If your site runs WordPress, the OCM Pulse plugin replaces the manual Web Push Installation steps entirely — connecting your site through the plugin sets up the SDK and service worker automatically. It also adds a way to send notifications directly from the post editor, without opening the OCM Pulse dashboard.

Get the plugin from wordpress.org/plugins/ocm-pulse and install it the same way as any other WordPress plugin.

Admin: One-Time Setup

Someone with access to the site's WordPress settings does this once. If the site already shows Connected on the OCM Pulse settings page, skip to Sending a Notification below.

Prerequisites

  • The site must be served over HTTPS
  • The site's domain must exactly match the domain configured for the app in OCM Pulse — the settings page shows the exact domain it expects. If it doesn't match yet, get that updated on the app before connecting.

Connecting Your Site

  1. Open Settings → OCM Pulse in the WordPress admin menu.
  2. Enter your OCM Pulse server address and save — use https://pulse.orangeclickmedia.com. This only needs to be done once.
  3. Click Connect to OCM Pulse. You're sent to OCM Pulse to sign in (if not already), then shown a consent screen to approve access and choose which app to connect.
  4. Approve, and you're brought back. The settings page now shows a green Connected status with the organisation and app name. From this point on, anyone with posting access can send notifications.
info

Connecting via the plugin handles SDK and service worker injection automatically — there's no separate manual installation step, unlike the standard Web Push Installation path.

Disconnecting

Click Disconnect on the same settings page — for example, to switch to a different app. No notifications can be sent again until someone reconnects.

Sending a Notification

Available to anyone with posting access — no admin permissions needed.

Where to Find It

The panel shows up differently depending on which editor the site uses. Whichever one is open is the one to use — most sites only use one.

EditorLocation
Block Editor (Gutenberg)Open the post, then the Document tab on the right (same panel as Categories and Tags) → scroll to OCM Pulse — Push Notification. Always there, can't be accidentally hidden.
Classic EditorOpen the post, then look in the right-hand sidebar below the Publish box for a box titled OCM Pulse — Push Notification.

The Fields

Title, body, and URL are pre-filled from the post — check them, don't assume they're right, then edit as needed.

FieldDescription
TitleWhat appears in bold on the notification. Pulled from the post title. Required, max 255 characters.
BodyThe message text below the title. Pulled from the post excerpt — write a real excerpt if you want control over this. Required, max 255 characters.
URLWhere the reader lands after tapping the notification. Defaults to the post's link. Required.
Image URLDefaults to the post's featured image. Leave blank for a text-only notification.
CategoryOptional. Lets subscribers who follow a specific topic get this notification.
SegmentOptional. Sends only to a chosen audience segment instead of everyone.
ScheduleOptional. Leave off to send immediately; turn on to pick a future date and time.

Sending One, Step by Step

  1. Check the pre-filled text. Title, body, URL, and image are filled in automatically — read them. The body in particular is the post excerpt, which may need trimming to read well as a notification.
  2. Optional — try Generate with AI. Writes a punchier title and body from the article for review and tweaking. If this button isn't visible, AI generation isn't switched on for the site yet — nothing to worry about.
  3. Optional — set category, segment, or a schedule. Leave these alone to notify everyone right away. Fill them in only to target an audience or send later.
  4. Click Send Push Notification. This is completely separate from saving or publishing the post — sending the notification doesn't touch the post, and saving the post doesn't send a notification.
  5. Watch for the confirmation. A green "Notification sent successfully" message appears above the button. A red message explains what went wrong — see Troubleshooting below.

Messages You Might See

MessageMeaning
"This app has an active RSS feed trigger."The site may already auto-send a notification for new posts. Sending manually too could mean subscribers get two. This is a warning, not a block — send if sure, skip if unsure and ask a teammate.
"Notification sent successfully."It's on its way (or scheduled, if a time was set). No further action needed.

Good Habits

  • Keep title and body short — the character counters under each field show exactly how much room is left.
  • Read the body once as a notification, not as an excerpt — trim to a sentence that stands on its own.
  • Don't resend "just to be sure." If there's no green success message, check the text and try again once — sending twice means two notifications land on every phone.
  • Scheduling is for timing a send around an event (a match kickoff, an embargo lift) — for everything else, send immediately.

Troubleshooting

I don't see the OCM Pulse panel at all. Either no posting permission on this site, or the plugin isn't connected yet. Ask whoever manages the WordPress settings to check the OCM Pulse connection status.

Clicking Send does nothing. Title, body, and URL can't be empty — fill in any that are blank and try again. If all three are filled and it still does nothing, refresh once and retry.

The red error message mentions a "URL." The URL field needs a complete web address (e.g. https://yoursite.com/your-post), not a partial path.

I don't see a "Generate with AI" button. That feature isn't enabled on this site yet. Write the title and body directly — everything else works the same way.

The settings page says the domain doesn't match. The domain configured for the app in OCM Pulse must exactly match the site's address. Get that updated, then try connecting again.

The settings page shows "disconnected." Someone may have changed the server address or clicked Disconnect. The site administrator needs to reconnect via Settings → OCM Pulse — nothing can be sent until they do.

Next Steps