WP Manifestindependent plugin directory
manifest / seo / bligence-publisher

Bligence Publisher self-updates

WordPress plugin that sends published posts to n8n webhook for syndication and indexing

by Internete · github.com/internetebiz/bligence-publisher · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/internetebiz/bligence-publisher/archive/refs/heads/main.zip

Ships its own WordPress updater (built-in updater), so new versions show up under Dashboard → Updates.

Readme github.com/internetebiz/bligence-publisher ↗

A WordPress plugin that sends published blog posts to an n8n webhook for syndication, indexing, and ROI tracking.

Description

Bligence Publisher automatically sends post data to your n8n webhook endpoint when posts are published. This enables:

  • Automatic syndication of new blog posts
  • IndexNow submission for faster search engine indexing
  • ROI tracking via MySQL and Supabase integration
  • Multi-client support with configurable settings per site

Installation

  1. Download or clone this repository
  2. Upload the bligence-publisher folder to /wp-content/plugins/
  3. Activate the plugin through the 'Plugins' menu in WordPress
  4. Configure settings under Settings > Bligence

Configuration

Navigate to Settings > Bligence in your WordPress admin panel and configure:

Setting Description
n8n Webhook URL Your n8n webhook URL (e.g., https://n8n.internete.biz/webhook/bligence-publish)
Webhook Token Bearer token for authentication (optional)
Bligence Client ID UUID from Bligence Supabase clients table
Client Name Human-readable name for this site (e.g., "RMFW Law")
Domain ID UUID from Bligence client_domains table (optional)
Category Filter Only send posts in this category (leave blank for all posts)

How It Works

The plugin hooks into WordPress publish events:

  1. transition_post_status - Triggers when a post status changes (draft -> publish)
  2. save_post - Triggers when a published post is updated
  3. future_to_publish - Triggers when a scheduled post goes live

When a post is published, the plugin sends a JSON payload to your webhook:

{
  "wp_post_id": 12345,
  "domain": "example.com",
  "domain_id": "uuid-optional",
  "client_id": "bligence-client-uuid",
  "client_name": "Your Site Name",
  "title": "Post Title",
  "slug": "post-slug",
  "content": "Full HTML content",
  "date": "2025-01-01T12:00:00+00:00",
  "author": "Author Name",
  "link": "https://example.com/blog/post-slug/",
  "tags": ["tag1", "tag2"],
  "categories": ["Blogs"],
  "image": "https://example.com/wp-content/uploads/image.jpg",
  "post_id": "bligence-post-uuid-if-linked"
}

Features

  • Multi-Client Support: Configurable client_id, client_name, and domain_id per site
  • wp_post_id Included: Enables MySQL upsert operations in n8n
  • Category Filter: Only sync posts in specific categories (e.g., "Blogs")
  • Re-sync Feature: Admin button to re-sync recent posts to n8n
  • Update Detection: Triggers webhook when published posts are modified
  • Duplicate Prevention: Uses _bligence_sent post meta to prevent duplicate sends
  • Test Webhook: Send test post to verify n8n connection
  • Comprehensive Logging: Check your PHP error log for [Bligence] entries

Admin Tools

The settings page includes:

  • Test Webhook Connection: Send a test post to verify your webhook configuration
  • Re-sync Recent Posts: Manually trigger the webhook for 1-25 recent posts (useful for syncing existing content)

Requirements

  • WordPress 5.0 or higher
  • PHP 7.4 or higher
  • A configured n8n webhook endpoint

wp-cron Requirement

For scheduled posts to trigger the webhook, wp-cron must be running. Add this cron job to your server:

*/5 * * * * wget -q -O - https://yourdomain.com/wp-cron.php?doing_wp_cron > /dev/null 2>&1

Changelog

1.7.0

  • Added wp_post_id to webhook payload for MySQL upsert
  • Added domain_id field for Bligence client_domains lookup
  • Added category filter option (only sync posts in specific category)
  • Added re-sync feature to send recent posts to webhook
  • Added update detection for published posts
  • Improved settings page with better descriptions
  • Added nonce verification for admin actions
  • Cleaner code structure with separate webhook sender function

1.6

  • Added debug tools panel
  • Added post status checker
  • Added clear sent flag functionality
  • Improved logging with [Bligence] prefix

1.5

  • Added future_to_publish hook for scheduled posts
  • Added duplicate prevention

1.0

  • Initial release

License

GPL v2 or later