Weekly Digest for BuddyBoss

⚠ Independent third-party add-on. This plugin is developed and maintained entirely by Adviespraktijk OCW. It is not affiliated with or endorsed by BuddyBoss LLC. "BuddyBoss" is a trademark of BuddyBoss LLC, used here purely to describe what this add-on integrates with. ⚠ Requires BuddyBoss Platform or BuddyPress. The plugin reads the activity stream from one of those plugins. Without either active, the digest has no activity to collect — an admin notice warns you and the cron is skipped automatically.

• Weekly digest of recent community activity
• Manual cadence — send on demand
• Two delivery transports — default WordPress mail, or Gravity SMTP (per-recipient delivery tracking when Gravity SMTP is active)
• All WP users as recipients
• Full BuddyBoss activity type picker — status updates (incl. photos/videos), comments, new members, profile updates, group activity, group joins/creations, connections, forum topics & replies, blog posts & comments, plus any third-party activity types your community registers
• Per-item exclusions — fetch the activities for the next digest and uncheck anything you don't want to include
• RFC 8058 one-click unsubscribe with per-user token + opt-out tracking
• Queue + batch processing — 10 emails per 30 seconds, with live progress and stall recovery
• Send-now + send-test admin actions
• Send history — review the exact HTML of every digest that went out
• Onboarding wizard — 4 steps to a working digest
• Tutorial submenu with progress detection
• OCW house-style admin (teal / navy / pink)

• Biweekly cadence (every 14 days)
• Targeting a single community group instead of all users
• Branding customization (brand color, accent color, heading font, personal intro message)
• Custom post types in the digest
• In-page live email preview with demo data
• Claude AI subject lines (uses the Anthropic API — an external service you provide a key for)
• Automatic updates via the OCW License Server

• WordPress 6.0 or higher
• PHP 8.0 or higher
• BuddyBoss Platform 2.x OR BuddyPress 11+ (required — the digest reads the activity stream from one of these)

1. Upload the weekly-digest-for-buddyboss folder to /wp-content/plugins/
2. Activate the plugin — the Tutorial opens automatically
3. Run the 4-step onboarding wizard
4. Confirm the schedule under BB Digest → Schedule

• Fixed: the 2.3.3 download from WordPress.org was missing its admin/ folder, which made every wp-admin page fatal — not just this plugin's. The front end kept working, so it was easy to miss. uninstall.php was missing from that package too. No code was wrong; two files never reached SVN.
• Fixed: the settings page printed a PHP deprecation with debugging on, and that output stopped two cookies being set. The hidden setup wizard was registered with no parent and no menu title, which left the settings page itself unable to find its own title.
• Changed: the banner and icon no longer ship inside the download. They were 100 KB of a 152 KB package and WordPress.org serves both itself. The download is 80 KB.
• Changed: the screenshot captions now describe the screenshots. The readme promised seven screens that no image showed.
• Changed: PRO declares the free plugin in the Requires Plugins header, so WordPress refuses the wrong activation order itself.
• Note: version 3.0.0 puts both editions on the same number. Your settings, schedule and licence are untouched.

• Fixed: the 2.3.3 package published to WordPress.org was missing its admin/ folder, so opening any page in wp-admin ended in a fatal error ("Failed opening required .../admin/class-activity-types-registry.php"). The front end of the site was unaffected. No code changed — the files were simply absent from the release. Upgrade if you installed 2.3.3.
• Changed: the plugin banner and icon are no longer shipped inside the download. WordPress.org already serves them from the plugin page, so this cuts the download by roughly two thirds without changing anything you see.

• Fixed: members could receive duplicate digests. Batches are now reserved atomically before sending, so two concurrent processes (WP-Cron + the admin status page + Redis) can never mail the same recipient twice.
• Fixed: an old digest job stuck on "Sending…" could be delivered weeks later when sending resumed. Jobs stuck for more than 2 days are now auto-cancelled and never sent.
• Fixed: triggering a send while one was already in progress no longer creates a second job (which would have mailed everyone twice); it resumes the existing send instead.
• Added: a "Delete" button in the History tab to remove a digest run — deleting a run that is still sending stops its remaining recipients from being mailed.

• Fixed: a fatal error ("Class BBWD_Email_Builder not found") could occur when WP-Cron processed the send queue in its own request, stalling the digest after the first batch. The queue processor now loads the email builder it needs. Recommended for everyone on 2.3.1.

• Fixed: digest could get stuck on "Sending…" with 0 delivered (and nothing in the SMTP log) on hosts where WP-Cron does not fire follow-up events. Delivery no longer depends on WP-Cron alone — it now starts in the same request that queues the digest, the admin Status page drives the queue while open, the "Resume sending" button delivers in-request, and a stranded job self-heals on the next load.
• Fixed: a PHP fatal mid-send could leave the queue lock dangling and freeze sending; the lock is now always released (finally + shutdown backstop).

• Restructured to comply with the WordPress.org Plugin Directory Guidelines: this plugin now contains zero locked, trial or license-gated functionality.
• Gravity SMTP delivery is now a fully free transport.
• Features that were previously license-locked (biweekly cadence, group targeting, branding customization, custom post types, in-page preview, Claude AI subject lines) have been removed from this plugin entirely and moved to a separate, optional PRO add-on hosted off-site. This plugin exposes documented hooks the add-on uses; no PRO code ships here.
• All inline admin <script> / <style> output moved to a properly enqueued assets/admin.js (+ wp_localize_script) and the existing enqueued stylesheet.
• Removed the no-longer-needed load_plugin_textdomain() call (WordPress loads translations automatically since 4.6).

• Fixed fatal error on activation when the host runs MySQL with NO_ZERO_DATE in sql_mode — the queue-store DATETIME columns are now NULL-able.
• Hardened activation / deactivation hooks: dbDelta failures are caught and logged.
• sanitize_options now coerces non-array Settings API payloads safely.
• Renamed languages/bb-weekly-digest.pot → languages/weekly-digest-for-buddyboss.pot to match the Text Domain.

• Renamed to "Weekly Digest for BuddyBoss" (was "BuddyBoss Weekly Digest"). New slug: weekly-digest-for-buddyboss.
• Independent-add-on disclaimer visible in plugin header, plugin row meta, Settings header and Tutorial header.
• New Tutorial submenu with 4 progress-detected steps. Auto-opens on first activation.
• OCW house-style admin design (teal / navy / pink).
• English placeholder aliases {first_name} / {full_name} (Dutch aliases still work).
• BBWD_* constants kept as back-compat aliases for WDFB_*.

• Settings sanitizer no longer wipes other tabs' data when one tab is saved.
• Cron reschedule only fires when frequency / day / time actually changes.

• Queue store + batch processing (10 emails per 30 seconds).
• RFC 8058 one-click unsubscribe with token-based tracking.
• Admin progress polling for in-flight digest jobs.

• Initial release.