| @@ -1,24 +1,52 @@ | ||
| 1 | 1 | === Visual Website Optimizer === |
| 2 | -Contributors: VWO | |
| 2 | +Contributors: vwointegrations | |
| 3 | 3 | Plugin Name: VWO |
| 4 | 4 | Plugin URI: https://vwo.com/ |
| 5 | -Tags: split testing, analytics, stats, visual web optimizer, vwo, cro | |
| 5 | +Tags: vwo, a/b testing, wordpress optimization, woocommerce tracking, split testing | |
| 6 | 6 | Requires at least: 2.7 |
| 7 | -Tested up to: 5.6 | |
| 8 | -Stable tag: 3.5 | |
| 7 | +Tested up to: 6.7.2 | |
| 8 | +Stable tag: 4.7 | |
| 9 | +License: GPLv2 or later | |
| 10 | +License URI: https://www.gnu.org/licenses/gpl-2.0.html | |
| 9 | 11 | |
| 10 | 12 | VWO is the all-in-one platform that helps you conduct visitor research, build an optimization roadmap, and run continuous experimentation. |
| 11 | 13 | |
| 12 | 14 | == Description == |
| 13 | -This plugin will allow you to automatically insert the VWO tracking code. Just enter your VWO Account ID from https://app.vwo.com/#/settings | |
| 14 | 15 | |
| 16 | +This plugin simplifies the process of adding the VWO SmartCode to your WordPress site and enables automatic tracking of WooCommerce events like product views, add-to-cart actions, and completed purchases. It also offers optional server-side tracking to bypass client-side blockers and improve event reliability. | |
| 17 | + | |
| 18 | +=== Key Features === | |
| 19 | +* Easy VWO SmartCode integration | |
| 20 | +* Automatic WooCommerce event tracking | |
| 21 | +* Event-level data passed to VWO for advanced reporting | |
| 22 | +* Support for asynchronous and synchronous SmartCode types | |
| 23 | +* Optional server-side tracking for more accurate analytics | |
| 24 | +* Works seamlessly with WooCommerce | |
| 25 | + | |
| 15 | 26 | == Installation == |
| 16 | -Wordpress : Extract the zip file and just drop the contents in the wp-content/plugins/ directory of your WordPress installation and then activate the Plugin from Plugins page. | |
| 17 | 27 | |
| 18 | -WordpressMu : Same as above | |
| 28 | +1. Log in to your WordPress dashboard. | |
| 29 | +2. Navigate to Plugins > Add New. | |
| 30 | +3. Click "Upload Plugin" and select the plugin ZIP file. | |
| 31 | +4. Click "Install Now", then "Activate". | |
| 32 | +5. Go to **Settings > VWO** to configure your plugin. | |
| 19 | 33 | |
| 20 | 34 | == Frequently Asked Questions == |
| 35 | + | |
| 36 | += What is my VWO Account ID? = | |
| 37 | +You can find your VWO Account ID in your VWO dashboard under Account Settings. | |
| 38 | + | |
| 39 | += Does this plugin support server-side tracking? = | |
| 40 | +Yes, server-side tracking is available and can be enabled in the WooCommerce tab of the plugin settings. | |
| 41 | + | |
| 42 | += What WooCommerce events are tracked automatically? = | |
| 43 | +- Product Viewed | |
| 44 | +- Add to Cart | |
| 45 | +- Remove from Cart | |
| 46 | +- Purchase (Order Completed) | |
| 47 | + | |
| 48 | +== Frequently Asked Questions == | |
| 21 | 49 | = I can't see any code added to my header or footer when I view my page source = |
| 22 | 50 | Your theme needs to have the header and footer actions in place before the `</head>` and before the `</body>` |
| 23 | 51 | |
| 24 | 52 | = If I use this plugin, do I need to enter any other code on my website? = |
| @@ -24,12 +52,118 @@ | ||
| 24 | 52 | = If I use this plugin, do I need to enter any other code on my website? = |
| 25 | 53 | No, this plugin is sufficient by itself |
| 26 | 54 | |
| 27 | 55 | == Screenshots == |
| 28 | -1. Settings page (Asynchronous Code) | |
| 29 | -2. Settings page (Synchronous Code) | |
| 56 | +1. General Settings | |
| 57 | +2. Advanced Settings | |
| 58 | +3. WooCommerce Settings | |
| 30 | 59 | |
| 60 | +== Configuration and Setup == | |
| 61 | + | |
| 62 | +=== Configuring General Settings === | |
| 63 | +1. Go to **Settings > VWO**. | |
| 64 | +2. Enter your VWO Account ID. | |
| 65 | +3. Choose your preferred code type: | |
| 66 | + - **Asynchronous (Recommended)**: Loads faster, doesn't block elements. | |
| 67 | + - **Synchronous**: Not recommended for performance reasons. | |
| 68 | +4. Click **Save Changes**. | |
| 69 | + | |
| 70 | +=== Configuring WooCommerce Settings === | |
| 71 | +1. Open the **WooCommerce** tab in the VWO settings. | |
| 72 | +2. Enable WooCommerce Event Tracking. | |
| 73 | +3. Enable the specific events you want to track: | |
| 74 | + - Product Viewed | |
| 75 | + - Add to Cart | |
| 76 | + - Product Removed From Cart | |
| 77 | + - Purchase Order | |
| 78 | +4. Click **Save Changes**. | |
| 79 | + | |
| 80 | +=== Configuring Server-Side Tracking (Optional) === | |
| 81 | +1. Enable **Server-Side Tracking** from the WooCommerce tab. | |
| 82 | +2. Click **Save Changes**. | |
| 83 | + | |
| 84 | +=== Verifying Event Tracking in VWO === | |
| 85 | +1. Log in to your VWO account. | |
| 86 | +2. Go to **Data360 > Events**. | |
| 87 | +3. Perform sample actions on your WooCommerce store. | |
| 88 | +4. Check the events list in Data360. | |
| 89 | +5. Register any events listed under “Unregistered Events”. | |
| 90 | + | |
| 91 | +== WooCommerce Events Imported Into VWO == | |
| 92 | + | |
| 93 | +=== Product Viewed === | |
| 94 | +- **Event API Name**: `woocommerce.productViewed` | |
| 95 | +- Payload: | |
| 96 | + - price, currency, productId, productTitle, productUrl, productCategory, productSku, quantity, variantId | |
| 97 | + | |
| 98 | +=== Add To Cart === | |
| 99 | +- **Event API Name**: `woocommerce.addToCart` | |
| 100 | +- Payload: | |
| 101 | + - price, currency, productId, productTitle, productUrl, productCategory, productSku, quantity, variantId | |
| 102 | + | |
| 103 | +=== Remove from Cart === | |
| 104 | +- **Event API Name**: `woocommerce.removeFromCart` | |
| 105 | +- Payload: | |
| 106 | + - price, currency, productId, productTitle, productUrl, productCategory, productSku, quantity, variantId | |
| 107 | + | |
| 108 | +=== Purchase === | |
| 109 | +- **Event API Name**: `woocommerce.purchase` | |
| 110 | +- Payload: | |
| 111 | + - orderId, productId, productSku, productPrice, productQuantity, discount, shippingPrice, totalTax, totalPrice, currencyCode | |
| 112 | + | |
| 113 | +== Upgrade Notice == | |
| 114 | += 4.7 = | |
| 115 | +* Minor bug fix | |
| 116 | + | |
| 117 | += 4.6 = | |
| 118 | +Major update: New settings UI, WooCommerce support added, and multiple bug fixes. Upgrade recommended for improved tracking and compatibility. | |
| 119 | + | |
| 31 | 120 | == ChangeLog == |
| 121 | += 4.6 = | |
| 122 | +* Revamped plugin settings UI for improved usability. | |
| 123 | +* Added support for WooCommerce event tracking (Product Viewed, Add to Cart, Purchase, etc.). | |
| 124 | +* Optional server-side tracking for WooCommerce events added. | |
| 125 | +* Multiple bug fixes and performance improvements. | |
| 126 | + | |
| 127 | += 4.5 = | |
| 128 | +* Tested with latest version | |
| 129 | +* VWO SmartCode 2.1 updated | |
| 130 | + | |
| 131 | += 4.4 = | |
| 132 | +* Tested with latest version | |
| 133 | +* Minor bug fix | |
| 134 | + | |
| 135 | += 4.3 = | |
| 136 | +* Minor bug fix | |
| 137 | + | |
| 138 | += 4.2 = | |
| 139 | +* Tested with latest version | |
| 140 | +* VWO SmartCode 2.1 updated | |
| 141 | + | |
| 142 | += 4.1 = | |
| 143 | +* Tested with latest version | |
| 144 | +* PHPCS Errors resolved | |
| 145 | +* WP Rocket support added | |
| 146 | + | |
| 147 | += 4.0 = | |
| 148 | +* Tested with latest version | |
| 149 | +* VWO SmartCode updated | |
| 150 | + | |
| 151 | += 3.9 = | |
| 152 | +* Tested with latest version | |
| 153 | +* Code improvement and add Rocket loader handling | |
| 154 | + | |
| 155 | += 3.8 = | |
| 156 | +* Tested with latest version | |
| 157 | +* Fix WP Rocket Issue | |
| 158 | + | |
| 159 | += 3.7 = | |
| 160 | +* Tested with latest version | |
| 161 | +* Fix Divi Frontend Editor Issue | |
| 162 | + | |
| 163 | += 3.6 = | |
| 164 | +* Tested with latest version | |
| 165 | + | |
| 32 | 166 | = 3.5 = |
| 33 | 167 | * Tested with latest version |
| 34 | 168 | * Rename label "Handle Rocket Loader Issue" to "Skip Deferred Execution" |
| 35 | 169 | * Set field default value of "Skip Deferred Execution" to "yes" |
| @@ -91,18 +225,4 @@ | ||
| 91 | 225 | |
| 92 | 226 | = 1.0 = |
| 93 | 227 | * First Version |
| 94 | 228 | |
| 95 | -== Upgrade Notice == | |
| 96 | -Option to choose the new asynchronous code. This will make the website load faster | |
| 97 | - | |
| 98 | -== Configuration == | |
| 99 | - | |
| 100 | -Enter your ID in the field marked 'YOUR VWO ACCOUNT ID' | |
| 101 | - | |
| 102 | -== Adding to your template == | |
| 103 | - | |
| 104 | -header code : | |
| 105 | -`<?php wp_head();?>` | |
| 106 | - | |
| 107 | -footer code : | |
| 108 | -`<?php wp_footer();?>` | |
