# WooCommerce

### Installation

**Step 1 – Enable the WooCommerce API**

If it’s not already been activated, enable the WooCommerce API. This will allow us to transfer order/product/customer data from your store and send it to any app or initiate a Cartmojo workflow.

1. Log in to your WooCommerce powered store
2. Enable the REST API by [following these instructions](https://docs.woothemes.com/document/woocommerce-rest-api/)

**Step 2 – Add your WooCommerce store to Cartmojo**

Once the API is enabled, you will be able to connect your WooCommerce store with Cartmojo.

1. [Download](https://wordpress.org/plugins/vextras-woocommerce/) and activate the Cartmojo plugin. You may also download it inside of Cartmojo if you have an account with us already **Add New > Store > WooCommerce**
2. After activation of the plugin, log in with your existing Cartmojo username and password or create a new account with us inside of WordPress.
3. Once you’re connected, login to your [Cartmojo account](https://app.vextras.com/auth/login) and use any features you'd like.

**Plugin notes**

* If you already have an account with us, log in with your existing e-mail address and password.
* If you don’t have a Cartmojo account, we will create a new account for you on the fly inside of WordPress.
* After activation, apply plugin updates as you normally would.
* All configuration of apps and workflows will occur in your Cartmojo dashboard.

### **Connection**

When your WooCommerce store is active with Cartmojo, the **Connection** tab for your store will show key indicators about the installation.

* Status
* Platform
* Store Name
* Store URL
* Plugin Status
* Plugin Version

### Settings

* Store information – basic contact details for your store, this is required for CAN-SPAM compliance if you want to use any of our workflows.
* Social links – attach your social links to any of our workflow e-mail templates. When added, the URLs will automatically link to your social profiles.
* Opt-in preferences – this setting displays choices for the opt-in box, including its location and optional text to display at checkout.
* Locale settings – set your country and currency
* Google Analytics integration – activate Google Analytics to display key metrics in your store’s dashboard.

### Removal

1. Log in to your WooCommerce powered store.
2. Navigate to **Plugins > Installed Plugins > Deactivate** the Cartmojo plugin.
3. After deactivation, the plugin can be deleted manually.

### More Information

* Before installing our plugin on your WordPress site, it’s good practice to either make a full backup or add the plugin in a staging area.
* The Cartmojo plugin will inject a newsletter opt-in box on your WooCommerce checkout page. Minor HTML or CSS adjustments may be needed in order for it to look correct on your site.

**Requirements**

* [WordPress](https://wordpress.org/) enabled site running [the most up to date version](https://codex.wordpress.org/WordPress_Versions)
* [WooCommerce](https://www.woothemes.com/woocommerce/) enabled site running [the most up to date version](https://github.com/woothemes/woocommerce/releases)
* Your website must have SSL enabled. If you don’t have an SSL for your store, contact your hosting provider for options.

### Limitations

**Platform**

* An order must be placed through the standard web checkout before any phone or manual orders will process.
* Certain plugins and hosts may prevent the WooCommerce REST API from functioning correctly. Known issues exist with:
  * [WP-cerber](http://wpcerber.com/) – under the Hardening setting can block the Woo REST API