Init Pulse For Discord – Webhooks, Roles, Instant

Description

Init Pulse For Discord sends automatic notifications to your Discord channel whenever a post is published or updated.

This plugin is part of the Init Plugin Suite — a collection of minimalist, fast, and developer-focused tools for WordPress.

GitHub repository: https://github.com/brokensmile2103/init-pulse-for-discord

Perfect for:

• Blog / community announcements
• Internal editorial workflow
• Discord-driven audiences

Straightforward configuration:

• Paste your webhook URL
• (Optional) Configure Discord role IDs — or a dedicated per-term webhook — inside Categories or Tags
• Done — your server receives updates instantly

Clean, minimal, and built for performance — no bloat, no external SDKs.

Key design goals:

• Minimal setup (Webhook + 1 settings page)
• No database clutter
• No JS/CSS overhead on frontend
• Role-aware mentions through taxonomies

Features

• Auto-send notifications when content is published
• Optional notifications when content is updated
• Custom Post Type support — choose exactly which post types (posts, pages, products, or any custom type) should trigger a notification
• Role tagging based on Categories & Tags
  → When a post is in that taxonomy, that role is mentioned
• Per-Category/Tag Webhook routing — optionally send a term’s posts to their own dedicated Discord webhook (own Username/Avatar), with a per-term “Only send to this webhook” switch to skip the global webhook entirely
• Per-post “Do not send to Discord” checkbox — opt an individual post out of every Discord notification (publish/update and Hot Post Milestones), shown while the post is unpublished, or after publishing if “Notify on update” is enabled
• Rich Discord embeds — title, description, accent color, footer, and timestamp (with a plain-text fallback mode)
• Send Test Message button on the settings screen — verify your webhook without publishing a post
• Delivery Log — a rolling snapshot of the most recent deliveries (success/error) for troubleshooting, stored lightly in wp_options with autoload = no
• Custom message template with placeholders:
  • {title} — post title
  • {title_url} — markdown title linking to URL
  • {url} — post URL
  • {excerpt} — trimmed excerpt
  • {site_name} — your site’s name
  • {author} — post author display name
  • {categories} — comma-separated category names
  • {tags} — comma-separated tag names
  • {post_type} — post type label
  • {date} — published date (site format)
• Optional featured image embed
• Retry logic & timeout controls
• No action removals — plays well with all other plugins
• Compact, modern codebase
• Hot Post Milestones (optional, requires Init View Count) — automatically notify Discord when a post’s total view count crosses a configured threshold (e.g. 1,000 / 10,000 / 100,000 views), with its own message template and {views}, {views_short}, {milestone} placeholders. Each milestone is sent once per post. Gracefully inactive (with a link to install it) when Init View Count isn’t active — no errors, no broken settings.

Usage

Navigate to:

Settings → Init Pulse For Discord

Available fields:

Field
Purpose

Post Types
Which post types trigger a notification

Webhook URL
Where notifications are sent (with a Send Test Message button)

Username
Display name of your bot

Avatar URL
Custom bot avatar (optional)

Include Featured Image
Adds featured image as embed

Use Rich Embed
Toggle formatted embed vs. plain-text message

Embed Color
Accent color for the embed sidebar

Timeout / Retries
Reliability controls

Message Template
Markdown-ready content, used as the embed description or full message

Notify on View Milestones
Enable Discord alerts when a post’s view count crosses a threshold (requires Init View Count)

View Milestones
Comma-separated view counts (e.g. 1000, 5000, 10000)

Milestone Message Template
Separate template for milestone alerts, with {views}, {views_short}, {milestone} placeholders

The settings screen also shows a Delivery Log with the outcome of your most recent notifications.

Role IDs can be configured in:

• Posts → Categories → Edit
• Posts → Tags → Edit

Example mention result:

<@&123456789012345678> New post published!

Filters for Developers

init_plugin_suite_pulse_for_discord_payload  

Modify the final webhook payload before sending.
Params: array $payload, int $post_id, string $context

init_plugin_suite_pulse_for_discord_milestone_payload  

Modify the webhook payload for a milestone notification before sending.
Params: array $payload, int $post_id, int $views, int $milestone

Example:

add_filter(‘init_plugin_suite_pulse_for_discord_payload’, function($payload) {
$payload[‘content’] .= “\nCustom footer”;
return $payload;
});

License

This plugin is licensed under the GPLv2 or later.
You are free to use, modify, and distribute it under the same license.