BrightLeaf Digital Code Snippet Library

A production-ready, client-first A/B testing utility designed for WordPress. This utility handles A/B test resolution in the browser, making it fully compatible with page caching (Cloudflare, Varnish, WP Rocket).

--- USAGE: GUTENBERG BLOCKS ---
1. Create two blocks in the editor (e.g., two different Buttons).
2. In the "Advanced" sidebar for BOTH blocks, add the class: abtestcontainer-{slug}
Example: abtestcontainer-hero-cta
3. The first block found with that slug becomes Version A, the second becomes Version B.

--- USAGE: SHORTCODES ---
Wrap your content versions like this:
[abtest title="my-test-slug"]
[abcontent contentversion="contentversiona"] Version A Content [/abcontent]
[abcontent contentversion="contentversionb"] Version B Content [/abcontent]
[/abtest]

--- USAGE: GRAVITY FORMS ---
A. Tracking which version of your tested item (even if not on form) was seen:
1. Add a Hidden Field to your form.
2. Advanced Tab -> Enable Dynamic Population.
3. Parameter Name: abtestversion_{slug} (e.g., abtestversion_hero-cta).
4. The value saved will be "{slug}:{version}" (e.g., hero-cta:contentversionb).

B. Using Merge Tags:
Use {abtestversion:slug} in notifications or confirmations to display the visitor's version.

--- USAGE: EXTERNAL TRACKING (GA4, etc.) ---
Automatic Resolution Events:

a) 'bl_abtest_resolved' — dispatched on every page where a test is resolved. Use this to set GA4 User Properties to tie the version to ALL future events.

document.addEventListener('bl_abtest_resolved', function(e) {
const { slug, version } = e.detail;
// GA4 User Property (Ties ALL future events like clicks/purchases to this version)
if (window.gtag) {
gtag('set', 'user_properties', { ['ab_test_' + slug]: version });
gtag('event', 'ab_test_view', { 'test_name': slug, 'test_version': version });
}
});

b) 'bl_abtest_first_resolved' — dispatched exactly once per slug when the cookie is first created. Use this to associate a user with a cohort a single time.

https://raw.githubusercontent.com/BrightLeaf-Digital/snippets/main/AB%20Testing%20Utilities.php