Installation

Installation

OConvert is a lightweight conversion optimization toolkit: sticky-variant A/B testing, heatmap-lite click tracking, and a configurable exit-intent layer. It runs anywhere on a WordPress site (not Woo-specific).

Requirements

• WordPress 6.5+
• PHP 8.0+
• Orravo Core (recommended; the in-admin Cmd+K palette and license badge come from Core)

Install steps

1. Upload the oconvert folder to /wp-content/plugins/.
2. Activate OConvert in Plugins, Installed Plugins.
3. Visit OConvert in wp-admin to confirm the dashboard loads.

What activation creates

OConvert_Core::on_activate() runs create_tables(), which uses dbDelta to create three tables:

• wp_oconvert_tests - test definitions with a unique test_key and a variants JSON column
• wp_oconvert_events - single events table for clicks, exits, conversions, exposures
• wp_oconvert_assignments - sticky visitor-to-variant mapping, unique on (vid, test_key)

It also stores ocv_db_ver in wp_options and re-runs the migration if that version drifts from OCV_DB_VER.

Visitor cookie

On init, OConvert sets a 365-day cookie called ocv_vid (32-char random) for any non-admin request. The cookie is the join key for sticky variant assignment and event attribution. SameSite is Lax, secure when on HTTPS, not HttpOnly (the runtime JS reads it).