Comments feature overview

Edit on GitHub

The Comments feature provides the ability for online owners to add the comments widget. The widget allows the customers to leave comments, special requests or instructions to any entity in the Spryker shop and tag these comments depending on your project specification.

An entity is a unit or a component that has some properties and may have relationships with other entities within a system. So, in terms of Spryker Commerce OS, an entity is represented by a Shopping Cart, a Shopping List, a CMS page, etc. It is where the Comments Widget can be located.

As an example of this generic solution, we have implemented Comments on the Shopping Cart page.

Comments help multiple customers to have a dialog on the cart contents. How does it work? Let’s imagine a situation where you have a company account and three HR members (HR assistant, HR manager, and the head of HR department) who are responsible for purchasing the products for the whole office. They share the same shopping cart. The HR assistant adds the products to the shopping cart and includes a comment requesting to review the shopping cart by an HR manager. With the help of comments, they decide on the final quantity of the products and finalize the shopping cart contents. After the shopping cart is ready, the HR manager adds a comment for the head of the HR department to approve the total price. By means of the conversation in the cart comments, the head of the department makes the latest corrections to the cart’s contents and attaches the important comments concerning the shipping of some products to the shopping cart. From now on, the HR assistant can proceed to Checkout. The attached comments will be available on the Checkout page and if the order is successfully placed - in the order history.

Thus, the Comments feature enables your B2B customers to effectively communicate and discuss the purchases with colleagues, thereby improve customer satisfaction and speed up the process by avoiding additional communication outside of the context.

Comments widget

Within the Comments feature, we have created the Comments widget. The widget can be placed on any entity page. In our case, it is the Shopping Cart page.

The comment contains the following information:

  • Company user’s name
  • Date when the comment was left
  • Contents of the comment
  • Comment Tag

Company users can add comments to a shared cart in both Read-only and Full Access permissions. A user can also add a comment before submitting the order, on the Checkout Summary page as well as post factum, after the order has been placed, on the Order History page:

Note

When reordering the existing order, the comments attached to the order are not duplicated.

When the order with the attached comments is placed, the Back Office user can view it with the comments in the Orders section of the Back Office.

Comment tags

Every comment may be tagged. Tags are keywords associated with the comments. The tags are added to group the comments sharing a similar idea or topic. For example, you may have several comments where colleagues have covered the details on how the order should be delivered, so you may tag these comments with the Delivery tag for convenience. Also, in the drop-down menu, you can filter the comments according to tags added.

Comments on the Storefront

Company users can perform the following actions using the Comments widget on the Storefront:

Create and edit comments

image

Remove comments

image

Tag comments

image

Filter comments by tags

image

Developer guides

Are you a developer? See Comments feature walkthrough for developers.