Connect WordPress SDK to Bento.

How it works.

The WordPress SDK is the repo behind the Bento Helper plugin. It sends events from WooCommerce, WooCommerce Subscriptions, LearnDash, Easy Digital Downloads, SureCart, and form plugins, and can load Bento.js for site tracking.

It also hooks into the native wp_mail() function, so password resets, new user notices, and WooCommerce order confirmations go out through Bento. Emails with attachments fall back to WordPress mail.

Set it up in five steps.

1. 1

   Get the latest release

   Download the source zip from the latest bento-wordpress-sdk release on GitHub and upload it in Plugins > Add New. The plugin is not listed on WordPress.org.

2. 2

   Add your API keys

   Open Bento in the WordPress admin menu and enter your Site Key, Publishable Key, and Secret Key from the Bento teams screen. Click Save & Validate Connection.

3. 3

   Route wp_mail() through Bento

   Turn on Enable Transactional Emails. Then pick a From Email from the list of your Bento authors.

4. 4

   Send a test event

   Turn on Debug Logging, then click Test Event. The plugin sends a $test_event event to Bento so you can confirm the keys work.

5. 5

   Turn off debug logging for production

   Debug logging writes to wp-content/debug.log. It is verbose, so turn it off in production.

What syncs.

• $OrderPlacedInto Bento

  Sent when a WooCommerce order is marked completed, with the order total added to lifetime value.

• $SubscriptionCreatedInto Bento

  Sent when a WooCommerce subscription is created at checkout, in any status.

• learndash_course_completedInto Bento

  Sent when a LearnDash user completes a course.

• $thrive.optin.{form_identifier}Into Bento

  The event format for ThriveLeads opt-ins, ending in the form identifier.

• Page viewsInto Bento

  Site Tracking loads Bento.js on your site so page views reach Bento.

• wp_mail() messagesFrom Bento

  WordPress email is delivered by Bento as transactional email instead of local mail.

Send a custom event from your theme.

add_action( 'user_register', function ( $user_id ) {
  if ( ! class_exists( 'Bento_Events_Controller' ) ) {
    return;
  }

  $user = get_userdata( $user_id );

  // Adds the user's name, login, and roles as fields.
  Bento_Events_Controller::trigger_event(
    $user_id,
    '$UserRegistered',
    $user->user_email,
    array( 'source' => 'wordpress' )
  );
} );