Skip to content

Repository files navigation

FluentCRM Post Notifier

Publish a WordPress post → your audience gets notified. Automatically.

Email your FluentCRM subscribers and/or ping Discord, Telegram, or any webhook — the moment you hit Publish.

License: GPL v2 WordPress plugin Channels Claude Code: skill included PRs welcome

No Zapier, no external service, no monthly fee. It runs entirely inside your own WordPress + FluentCRM install.


Install

The plugin (WordPress)

# WP-CLI (installs + activates in one line):
wp plugin install https://github.com/albertocolchero/fluentcrm-post-notifier/archive/refs/heads/main.zip --activate

# …or clone straight into your plugins directory:
git clone https://github.com/albertocolchero/fluentcrm-post-notifier.git \
  wp-content/plugins/fluentcrm-post-notifier

Or download the ZIP and upload it via Plugins → Add New → Upload Plugin. Then configure under Post Notifier in wp-admin.

The email feature needs the free FluentCRM plugin active. The Discord / Telegram / webhook channels work without it.

As a Claude Code skill (setup assistant)

Not comfortable in wp-admin? Install the skill and let an AI walk you through it:

npx degit albertocolchero/fluentcrm-post-notifier/skills/fluentcrm-post-notifier ~/.claude/skills/fluentcrm-post-notifier

…or paste to Claude Code:

Install the fluentcrm-post-notifier skill from github.com/albertocolchero/fluentcrm-post-notifier into ~/.claude/skills, then help me configure it to email my subscribers and post to Discord when I publish.

Works in Cursor/Windsurf too — point them at skills/fluentcrm-post-notifier/SKILL.md.

Channels

Channel What you need Requires FluentCRM
Email campaign FluentCRM tag(s) or list(s) Yes
Discord A channel webhook URL No
Telegram A bot token + chat ID No
Generic webhook Any URL that accepts JSON {title,url,excerpt,image,message} (Slack, Zapier, Make, n8n, custom) No

Each channel is independent and only fires when you fill it in.

Configure

Open Post Notifier in wp-admin:

Setting What it does
Trigger categories Comma-separated category slugs. Empty = every published post.
Send to tags / lists Your FluentCRM audience (names or numeric IDs).
When a post is published Create a draft (review & send yourself) or Send immediately.
Email template Subject, eyebrow, intro, button label, accent color, featured image.
Notification channels Discord webhook, Telegram bot, generic webhook, message template.

Tokens: {post_title}, {excerpt}, {url} — plus FluentCRM smartcodes like {{contact.first_name}}.

Then publish, or dry-run with Test with an existing post (keep draft only checked). Per-channel results show in the activity log.

Features

  • Fires on the transition into Published.
  • Target by category, or every post.
  • Email as a draft (safe) or sent immediately (opt-in).
  • Clean, responsive email template with a configurable accent color and featured image.
  • Per-post opt-out checkbox in the editor.
  • Activity log + manual test triggers for email and channels.

A note on "Send immediately"

Immediate mode writes recipients straight into FluentCRM's campaign tables so the send fires with no manual step. It's fast, but it depends on FluentCRM's DB schema — if a future update changes it, the plugin leaves the campaign as a draft and reports the error instead of pretending it sent. Switch to Draft mode (public FluentCRM models only) if you want zero schema coupling. Test before relying on it for a big list.

Roadmap / help wanted

Good contributions to pick up:

  • Per-category routing — different categories → different tags/lists (currently one global rule).
  • Custom post type support.
  • A WP-CLI command to fire a notification for a given post ID.
  • More template presets and a Gutenberg email preview.

See CONTRIBUTING.md.

License

GPL-2.0-or-later — the standard WordPress plugin license.

About

Automatically email your FluentCRM subscribers and notify Discord, Telegram, or any webhook when you publish a WordPress post. Draft or send-immediately. Free and self-hosted.

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages