# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.cartmojo.com/store-connection/dashboard/connection/woocommerce.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.