README

A/B testing and experimentation plugin for Craft CMS 5. Create experiments with content variants, track conversions, and determine winners with statistical significance — all from within the Control Panel.

Requirements

Craft CMS 5.0+
PHP 8.2+

Installation

composer require justinholtweb/craft-wink
php craft plugin/install wink

Features

Experiments as Elements — full Craft element index with statuses, search, and filtering
Server-side variant assignment — deterministic hashing means no flicker and cache-safe
Conversion goals — page views, clicks, form submissions, or custom events
Statistical significance — two-proportion z-test with Wilson score confidence intervals
Reports dashboard — conversion rates, uplift, confidence levels, and time-series charts
Twig integration — functions, block tags, and template variables
Frontend tracker — lightweight JS (~3KB gzipped) with event batching
GA4/GTM forwarding — optional integration with Google Analytics and Tag Manager
Privacy-first — respects Do Not Track, IP anonymization, configurable retention

Usage

Twig Functions

{# Output variant content directly #}
{{ winkVariant('headline-test') }}

{# Full control over variant rendering #}
{% set test = winkExperiment('headline-test') %}
{% if test and test.variant.handle == 'variant-a' %}
    <h1>Discover Something New</h1>
{% else %}
    <h1>Welcome</h1>
{% endif %}

{# Block syntax with inline variants #}
{% experiment 'headline-test' %}
    {% variant 'control' %}<h1>Welcome</h1>{% endvariant %}
    {% variant 'variant-a' %}<h1>Discover</h1>{% endvariant %}
{% endexperiment %}

{# Add tracking script before </body> #}
{{ winkTrackingScript() }}

Template Variables

{# Query experiments #}
{% set experiments = craft.wink.experiments.experimentStatus('running').all() %}

{# Get assigned variant handle #}
{% set variant = craft.wink.variant('headline-test') %}

JavaScript Conversions

// Record a conversion
Wink.convert('signup-goal', { plan: 'pro' });

License

Proprietary. See LICENSE.md.

jholt / craft-wink

Maintainers

Package info

Statistics

Security