README

⚠️ This is the development branch for future version of CoCart. For current stable branch browse trunk. ⚠️

Welcome to the CoCart repository on GitHub. Here you can browse the source of the plugin and packages used in the development of the core of CoCart plugin. You can look at open issues, contribute code and keep track of ongoing development.

We recommend all developers to follow the CoCart development blog to stay up to date about everything happening in the project. You can also follow @cocartapi on Twitter for the latest development updates.

If you are looking for documentation, head over here: https://docs.cocart.xyz

Click here to download the latest release package of CoCart.

What does it provide?

CoCart provides support for managing the user session, alternative options for doing this task do exist; however, their usage can be limited to applications of the same origin as the WordPress installation. This is due to WooCommerce using cookies to store user session tokens.

CoCart provides the utilities to change this behavior during any cart request and passes the required information to HTTP Header so it can be cached client-side. The use of an HTTP Authorization header is optional allowing users to shop as a guest.

Quick Start

📢 This repo is not package ready and must be built in order to activate the plugin.

Step 1

Clone the repo to your WordPress development wp-content/plugins folder. Don't forget the folder name "cocart-dev" at the end of the command.

git clone https://github.com/co-cart/co-cart.git cocart-dev

Step 2

Then go into the cloned folder cd cocart-dev and proceed with the following commands.

composer install
npm install
composer ready-build

Now you will have another folder cocart within your plugins folder. This makes CoCart package ready. You will then be able to activate it from your WordPress Dashboard > Plugins.

If you have made changes to the core of CoCart and want to test those changes locally, simply run composer ready-build and CoCart will be packaged together for you again.

Updating CoCart Packages

As CoCart is now built modular, to keep up to date with all the development changes in all the default set modules you will need to pull them from their individual repositories.

composer update
composer ready-build

This will pull the master branch of each package which is the development branch unless a tag is specified instead.

External Packages

Are you looking to build your own package?

For Developers

Here are a few other resources you may find helpful.

CoCart Beta Tester allows you to test with bleeding edge versions of CoCart from the GitHub repo.
CoCart VSCode extension for Visual Studio Code adds snippets and autocompletion of functions, classes and hooks.
CoCart Carts in Session allows you to view all the carts in session via the WordPress admin.
CoCart Product Support Boilerplate provides a basic boilerplate for supporting a different product type to add to the cart with validation including adding your own parameters.
CoCart Cart Callback Example provides you an example of registering a callback that can be triggered when updating the cart.
CoCart Tweaks provides a starting point for developers to tweak CoCart to their needs.
Node.js Library provides a JavaScript wrapper supporting CommonJS (CJS) and ECMAScript Modules (ESM).

Support

This repository is not suitable for support. Please don't use our issue tracker for support requests, but for core CoCart issues only. Support can take place through the appropriate channels:

Our community forum on wp.org which is available for all CoCart users.
Our community Slack chat room on the #support channel.
Our community group on Facebook
Our community on Reddit

Support requests in issues on this repository will be closed on sight.

CoCart is not supported via the WooCommerce help desk as the plugin is not sold via WooCommerce.com, the support team at WooCommerce.com is not familiar with it and may not be able to assist.

Roadmap

Check out the roadmap to get informed of the latest features released and the upcoming ones.

CoCart Channels

We have different channels at your disposal where you can find information about the CoCart project, discuss it and get involved:

📖 Docs: this is the place to learn how to use CoCart API. Get started!
🧰 Resources: this is the hub of all CoCart resources to help you build a headless store. Get resources!
👪 Community: use our Slack chat room to share any doubts, feedback and meet great people. This is your place too to share how are you planning to use CoCart!
🐞 GitHub: we use GitHub for bugs and pull requests, doubts are solved with the community.
🐦 Social media: a more informal place to interact with CoCart users, reach out to us on Twitter.
💌 Newsletter: do you want to receive the latest plugin updates and news? Subscribe here.

Contributing to CoCart

If you have a patch or have stumbled upon an issue with CoCart (Core), you can contribute this back to the code. Please read our contributor guidelines for more information how you can do this.

Join the Community

Do you like the idea of creating a headless e-commerce with WooCommerce? Have questions or feedback? We'd love to hear from you. Come join the CoCart community! ❤️

Credits

CoCart is developed and maintained by Sébastien Dumont.

Founder of CoCart - Sébastien Dumont.

Website sebastiendumont.com · GitHub @seb86 · Twitter @sebd86

co-cart / co-cart

Maintainers

Details

Add Maintainer

Remove Maintainer