mbuzz-wp

WordPress plugin for the Mbuzz multi-touch attribution platform. Wraps the mbuzz/mbuzz-php SDK with WordPress-native hooks: WooCommerce, EDD, form plugins, identity, consent, multisite.

Ships to WP.org under the slug mbuzz-attribution (the user-facing plugin name) — mbuzz-wp is just the repo name, matching the mbuzz-php / mbuzz-ruby SDK repos.

Status: 0.1.0-alpha — scaffold only. Wiring per lib/specs/wordpress-plugin.md (in the SDK repo) is in progress; see the spec for the full design and the per-section TODOs below.

Repo layout

mbuzz-attribution/
├── mbuzz-attribution.php       # WP plugin bootstrap (headers, autoload, PHP-floor guard)
├── composer.json               # Pulls mbuzz/mbuzz-php ^1.2
├── readme.txt                  # WP.org format
├── uninstall.php               # Option + transient cleanup
├── src/
│   ├── helpers.php             # mbuzz_event/conversion/identify — scope-stable theme surface
│   ├── Plugin.php              # Singleton, hook registration, switch_blog handling
│   ├── Bootstrap.php           # boot(settings): Mbuzz::init + onSuccess/onError wiring
│   ├── Settings/
│   │   ├── Page.php            # Settings → Mbuzz screen (stub)
│   │   ├── Fields.php          # Sanitization (stub)
│   │   └── Repository.php      # Single-option storage + wp-config.php overrides
│   ├── Identity/               # (planned) wp_login, user_register, profile_update hooks
│   ├── Integrations/           # (planned) WooCommerce, EDD, CF7, Gravity, WPForms, ...
│   ├── Cli/                    # (planned) WP-CLI commands
│   ├── Privacy/                # (planned) Consent API + exporters/erasers
│   └── Block/                  # (planned) Tracked Button Gutenberg block
└── tests/Unit/                 # PHPUnit + Brain Monkey

Local development

composer install
composer test:unit

To run against a live WordPress, symlink the plugin into a wp-env install:

# In the mbuzz-attribution directory
ln -s "$(pwd)" /path/to/wordpress/wp-content/plugins/mbuzz-attribution

Or use the wp-env integration once tests/Integration/ is added.

Configuration

Settings UI is stubbed. For now, configure via wp-config.php:

define('MBUZZ_API_KEY', 'sk_live_…');
define('MBUZZ_ENABLED', true);
define('MBUZZ_DEBUG', false);

What's left

Roadmap follows lib/specs/wordpress-plugin.md in the SDK repo:

• Plugin bootstrap, autoload, PHP-floor guard (§2, §3)
• Settings storage + wp-config.php overrides (§4)
• Switch_blog reset + re-init for multisite (§10)
• Scope-stable theme helpers (§2)
• onSuccess/onError observers wired to diagnostics transient (§4)
• Identity hooks: wp_login, user_register (+ signup conversion), profile_update (§5)
• WooCommerce: thankyou + processing + completed dedupe, refunds, first-paid detection, HPOS-safe meta, cookieless guest attribution via billing email (§6)
• Settings page UI: form, validation, diagnostics card (§4)
• WooCommerce Subscriptions renewal hook (§6 — deferred, paid extension)
• Other plugin integrations: EDD, CF7, Gravity, WPForms, Fluent, MemberPress, LearnDash (§7)
• Tracked Button Gutenberg block (§8)
• WP-CLI commands: status, test, flush, identify, conversion (§9)
• WP Consent API gating (§11)
• Privacy exporter + eraser (§11)
• php-scoper build pipeline (§2)
• WP.org submission (§14)

License

GPL-2.0-or-later. See WordPress.org plugin guidelines.