Getting Started

Before you start

It’s important that your server requirements meet the minimum that WooCommerce ask for in order to run CoCart.

If you already have WooCommerce installed and your store filled with products ready to sell. Congrats, you meet the requirements to install CoCart and can now start decoupling.

Install CoCart directly via the plugins page automatically by search, upload or by FTP.

Still not sure? Explore the API in your own sandbox. Try CoCart →

Automatic Install

Only the core of CoCart can be installed automatically.

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser.

To do an automatic install of CoCart, log in to your WordPress dashboard, navigate to the ‘Plugins’ menu and press ‘Add New’.

In the search field type CoCart and press ‘Search Plugins’. Once you’ve found the plugin, you can install it by simply pressing ‘Install Now’. Make sure it is the main plugin as shown highlighted. Once installed the button will change to ‘Activate’.

CoCart plugin is highlighted with a red border
Make sure you install the right plugin. Others are add-ons.

Manual Upload Install

If you have the plugin downloaded manually, log in to your WordPress dashboard, navigate to the ‘Plugins’ menu and press ‘Add New’. Then press ‘Upload Plugin’.

You will either be redirected to a new page or the upload field will simple appear at the top allowing you to upload the plugin. Once the file is selected, press ‘Install Now’.

Upload file field where you drag and drop to or choose a file and press "Install Now"

Once the plugin is installed. Press ‘Activate Plugin’.

Manual Install via FTP

Open your FTP program of choice and login to your FTP server. Access where your WordPress plugins folder is stored and upload the folder of the plugin that is in the zip file and put it in the plugins directory.

Now log in to your WordPress dashboard, navigate to the ‘Plugins’ menu and press ‘Activate’ where CoCart is listed.

Plugins page listing installed plugins where CoCart is highlighted to press Activate.
Activate CoCart where the green arrow is pointed at.

Requirement

A main requirement if not already done is setting the permalinks. In order to access the REST API using the standard endpoint URI structure (e.g. cocart/v2/products), you must have your WordPress permalinks configured to something other than “Plain”. Go to Settings > Permalinks and choose an option.

Permalink settings showing the options available with "Plain" option crossed out in red.

Now that you have that configured, your ready to use CoCart.

Forgot to setup WooCommerce?

If you have not installed or disabled WooCommerce, CoCart will inform you that it requires WooCommerce to be installed and activated first. If you are seeing this message, CoCart disables itself automatically to prevent any technical issues but only during the activation process.

A button will display asking you to install or activate WooCommerce.

Admin notice warning the user that they need WooCommerce installed as a requirement for CoCart.

Server does not support POST/DELETE/PUT

Ideally, your server should be configured to accept these types of API request, but if not you can use the _method property.