Arc.js is a development framework that allows developers to execute custom code whenever certain actions occur in Kibo eCommerce. To learn the basics of Arc.js, refer to:
|Domain Name||Domain Description|
|commerce.carts||This domain contains actions associated with the cart.|
|commerce.catalog.admin||This domain contains actions associated with your catalog.|
|commerce.catalog.storefront.products||This domain contains actions associated with storefront products.|
|commerce.catalog.storefront.shipping||This domain contains actions associated with shipping.|
|commerce.catalog.storefront.tax||This domain contains actions associated with tax.|
|commerce.customer||This domain contains actions associated with shopper accounts.|
|commerce.orders||This domain contains actions associated with orders.|
|commerce.payments||This domain contains actions associated with payments.|
|commerce.return||This domain contains actions associated with returns.|
|commerce.settings||This domain contains actions associated with settings for sites, checkout, installed applications, locations, shipping, and general Kibo eCommerce settings.|
|platform.applications||This domain contains actions associated with Kibo eCommerce applications.|
|storefront||This domain contains actions associated with storefront pages.|
Install the following software on your local machine in order to code actions:
- Command Line Interface—Provides a console or terminal environment in which to execute commands.If you are developing on a Windows machine, Kibo eCommerce recommends you use the Windows command prompt. However, due to known Windows compatibility issues in Node.js, you may encounter issues when using the Arc.js tools (for example, the tools may not register your keystrokes). If you encounter such issues, Kibo eCommerce recommends you use a third-party console emulator, such as cmder, which plays nicer with Node.js.
- Node.js—Provides a platform for creating scalable network applications. Includes the npm package manager, which you can use to install the Yeoman generator and the helper function described in the Tools section of this topic.
- Grunt.js—Provides a task manager that automates repetitive tasks. You use Grunt to build your project files and upload them to the Kibo eCommerce Dev Center.
- Git (optional)—Provides a version control system to manage your project files. When you set up your project files using the Yeoman tool, you have the option of creating a Git repository for those files.
Arc.js provides the following tools to facilitate development:
- Kibo eCommerce Yeoman Generator—Provides a scaffolding tool that enables you to quickly create a project folder on your local machine that contains all the necessary files to code actions.
- Action Management JSON Editor—Available within a sandbox, this editor allows you to enable or disable actions for the sandbox. It also allows you to specify settings and pass custom data to the actions.
- JSON Configuration Helper Function—Provides code that you can insert into the embedded.platform.applications.install action so that the actions installed in your project files are automatically enabled when you install the application that contains the actions to a sandbox. Note that you can also achieve this functionality through a setting available in the Kibo eCommerce Yeoman Generator.