1. GENERAL INFORMATION

1.1 System Overview

Swift Commerce is an app that lets you manage your online store through multiple channels in one dashboard. Available features include managing orders, products, inventory, and shipping.

Having a Swift Commerce app provides many benefits, such as data entry is not done manually anymore. The existence of this application aims to reduce human error and increase efficiency and accuracy.

That's why ICUBE built a unified app that integrates all of your sales channels into one easy-to-use dashboard so you can focus on something else. In addition, you can register several users with certain access restrictions based on branch offices or work units to make it easier to control your sales activities.

1.2 Authorized Use Permission

Swift Commerce is available to clients who have worked with ICUBE. Clients can register accounts as admins, where administrators can define access restrictions for each specific account. These access restrictions can be in the form of certain menu restrictions or certain actions such as importing data or deleting products.

1.3 Points of Contact

For additional information please contact the developer team.


2. FEATURES

2.1 Dashboard

Dashboard is the main page after successfully logging into the application. This page provides a preview of lifetime sales, average orders, last orders, last search terms, and top search terms.


Image 1. Dashboard display

2.2 PWA CONFIGURATION

Before we develop this feature, in the event we need something config to change like enable or disable button add to cart at product item PLP, we must be config at swift.config.js and we must re-deploy the PWA site. So we develop this for easier change config from back-office admin.


Go to backoffice > stores > Configuration >  Icube Extension > PWA. The system will redirect to the PWA configuration page.


Image 2. Backoffice display menu

Here are the parts of the Swift PWA configuration:

  1. General

This is a section for general on config swift PWA which includes:

Image Placeholder
Image 3. Configuration image

Enable PWA: Select Yes to enable PWA configuration on the frontend. Select No to disable PWA Configuration on the frontend.
  1. PWA URL: Enter a PWA URL

  2. Encryption Key: This is the config key for encrypting/decrypting tokens like checkout tokens, and auth tokens.


Note: Encryption key value is a random string with length 32.



Image 4. Configuration display

Share Icon Facebook: This is the config for the icon Facebook which icon will be displayed on PDP (share product to social media).
  1. Share Icon Twitter: This is the config for the icon Twitter which icon will be displayed on PDP (share product to social media).

  2. Share Icon Line: This is the config for the icon Line which icon will be displayed on PDP (share product to social media).

  3. Share Icon EMail: This is the config for the icon Email which icon will be displayed on PDP (share product to social media).

  4. Share ICon Telegram: This is the config for the icon Telegram which icon will be displayed on PDP (share product to social media).

  5. Share Icon Pinterest: This is the config for the icon Pinterest which icon will be displayed on PDP (share product to social media).

  6. Share Icon Linkedin: This is the config for the icon Linkedin which icon will be displayed on PDP (share product to social media).

  7. Default Robot: This is the default setting for google robot crawl.

The image below is an example of the icon configuration displayed on the front end.


Image 5. Icon configuration

  1. Header in General Configuration


Image 6. Header general config


Header Version: This is to set up a cms identifier to render header content based on the PWA version 1 - 4.
  • Enable Sticky Header: This is to enable and disable the sticky header. If the sticky header is activated

when the web is scrolled, the header will continue to follow

  • Mobile Navigation: Navigation for mobile there are 2 options, namely bottom navigation and burger menu.

The navigation menu button is below, the burger menu is at the top and when we click on the burger menu a slide will appear on the right.


This is the display of the cms identifier for the header on the front end base on the PWA version:

Desktop version 1

Image Placeholder
Image 7. desktop ver. 1 

Sticky Header Version 1

Image Placeholder
Image 8. Sticky header ver. 1 

Desktop version 2

Image Placeholder
Image 9. desktop ver. 2 

Sticky Header Version  2

Image Placeholder
Image 10. Sticky header ver. 2

Desktop Version 3

Image Placeholder
Image 11. Desktop ver. 2



Sticky Header Version 3

Image Placeholder
Image 12. Sticky header ver. 3

Desktop Version 4

Image Placeholder
Image 13. Desktop ver. 2

Sticky Header Version 4

Image Placeholder
Image 14. Sticky header ver. 4



Mobile Bottom Navigation


Image 15. Mobile bottom navigation

Mobile Burger Menu

Image 16. Mobile burger menu


  1. Footer in General Configuration



Image 17. Footer configuration

  • Footer Version: This is to set up a cms identifier to render footer content based on the PWA version 1 - 4.

  • Enable Footer Mobile: This is to enable and disable footer content on mobile. 


CMS Block for 4 version Footer: To manage or editing the content footer can be done on the CMS block

Image Placeholder
Image 18. PWA footer CMS


This is the display of the CMS identifier for the footer on the front end base on the PWA version:

Version 1 in desktop and mobile







Image 19. footer in mobile and desktop ver. 1

Version 2 in desktop and mobile











Image 20. footer in mobile and desktop ver. 2

Version 3 in desktop and mobile












Image 21. footer in mobile and desktop ver. 3

Version 4 in desktop and mobile









Image 22. footer in mobile and desktop ver. 4


  1. General Frontend: Users can customize colors, fonts, style buttons, and links from the back office without asking the developer for help to customize.



Image 23. Customize color

  • Primary color: By default, all components that use Material UI as the base component will use this primary color as their base color, for example button color, text color

  • Secondary color: To override the primary color used in Material UI. *Currently unused.

  • Background color: To set the background color of the PWA page body

  • Error color, warning message color, success message color:  For alert color, error field

  • Font: To set the text and heading font type and set the font color

  • Button: To set button styling such as font color, background and hover color

  • Link: To set link styling such as color, hover color, text-decoration, and text-decoration hover


  1. PWA Popup Installation

This section is config about custom button installation PWA, which includes:


Image 24.PWA Pop up instalation config

Icon Apple Touch: Enter the image you want to make the icon Apple Touch.
  1. Install Message: This is to config Install message will be displayed at custom button installation PWA.

  2. App Name: This is to config App name will be displayed at custom button installation PWA.

  3. Custom Install App Enable: This is to disable/enable render custom button installation PWA.


This is the display of the PWA popup installation on the front end.


Image 25. Display on front end


  1. Contact

CMS Contact Identifiers: This is to set up a cms identifier to render contact us content.


Image 26.CMS Contact

This is the display of config contact on the front end.


Image 27. CMS Contact front end

Images

This is a section to config about all image size configs used in swift-PWA, which includes:

  1. Product: This is to config width and height image size on the product item list



Image 28. Images product

This is what the product configuration looks like in the image section on the front end.


Image 29. Images product front end


Note: For the config Image width and height, must match with view.xml in magento theme.


  1. Home Slider: This is to config width and height image size on the home-slider desktop view and home-slider mobile view.



Image 30. Home slider configuration

This is the display of the config home slider on the front end.


Image 31. Home slider front end

  1. Magezon Slider: This is to config width and height image size on the magezon-slider desktop view and magezon-slider mobile view.


Image 32. Magezon slider config

This is the display of the config megazon slider on the front end.


Image 33. Magezon slider front end

  1. Category: This is to config width and height image size category banner on PLP.


Image 34. category config


This is the display of the config home slider on the front end.


Image 35. Category front end

  1. Promo Banner Lite: This is to config width image promo banner lite.


Image 36. Promo banner lite config

  1. Megamenu

This section to config about megamenu feature on PWA. Which includes:


Image 37. Megamenu config

  1. Ves Menu Enable: This is to config enable/disable PWA to use vesmenu or not.

  2. Ves Menu Alias: This is to config vesmenu alias to get the list menu (vesmenu) from graphql.


  1. Pricing

This section to config about pricing feature on PWA.


Image 38. Pricing config

Remove Decimal Price Enable: This config to enable/disable on all price PWA will be rendered price with decimal or not.


  1. Product Listing

This section to config about Product list page/category page, Which includes:


Image 39. Product listing config

  1. Catalog Enable: This is config to enable/disable catalog on PLP.

  2. Page Size: This is to config the amount of data that will be obtained from the graphql query.

  3. Drawer Filter On Desktop Enable: This is to config enable/disable filter PLP will be rendered on left section PLP.

This is the display of the config drawer filter on desktop enable on the front end.


Image 40. PLP front end


  1. Label Enable: This is config to enable/disable render all labels on PLP.

  2. Label New Enable: This is config to enable/disable render new label on PLP.


Image 41. Label config

  1. Label Sale Enable: This is config to enable/disable render sale label on PLP.

  2. Label Weltpixel Enable: This is config to enable/disable the render weltpixel label on PLP.

  3. Configurable Options Enable: This is config to enable/disable the render configurable option on the product item.

  4. Rating Enable: This is config to enable/disable displaying count rating on the product item.

  5. Add to Cart Enable: This is config to enable/disable button add to the cart product item.

  6. Quick View ENable: This is config to enable/disable button quick view product item.


  1. PDP

This section to config about PDP feature on PWA.


Image 42. Popup detail image config

Popup Detail Image Enable: This is config to enable/disable feature popup detail image on PDP.

This is the display of the config popup detail image enable on the front end.


Image 43. Pop up detail image front end
  1. Home

This section to config about a home page, Which includes:


Image 44. Home config

  1. Use CMS Page Enable: This is to enable/disable the home page will render use cms page or static content.

  2. Use CMS Page Identifier: This is to config the cms identifier home page if the home page renders use the cms page.

  3. CMS Social Media Link Identifier: This is to config cms social media if the home page renders uses static content.

  4. Features Product Enable: This is to config enable/disable feature product if the home page renders use static content.

  5. Features Product Url Key: This is to config URL key feature product to get data feature product if the home page renders use static content.

  6. Category List Enable: This is to config enable/disable category list (some category) if the home page renders use static content.


Image 45. Homepage config

  1. Category List Url Key: This is to config the URL key category list (some category) if the home page renders use static content.

  2. Category List Image Size Mobile Width: This is to config image size width banner category list (some category) on mobile view if the home page renders use static content.

  3. Category List Image Size Mobile Height: This is to config image size height banner category list (some category) on mobile view if the home page renders use static content.

  4. Category List Image Size Desktop WIdth: This is to config image size width banner category list (some category) on desktop view if the home page renders use static content.

  5. Category List Image Size Desktop Height: This is to config image size height banner category list (some category) on desktop view if the home page renders use static content.

  6. Banner Slider Enable: This is config to enable/disable banner slider if the home page renders use static content.

  7. Banner Slider Title: This is the config banner slider title (to get data banner from graphql) if the home page renders use static content.


  1. Facebook Meta

This section to config about facebook meta, Which includes:


Image 46. Facebook meta config

  1. Module Enable: This is to config PWA will be using Facebook meta or not.

  2. Facebook Meta Id: This is to config facebook meta id.


  1. Recaptcha

This section to config about Recaptcha, which includes:


Image 47. ReCAPTCHA Config 

  1. Module Enable: This is to config enable or disable general Recaptcha.

  2. Recaptcha Environment Key: Is configuration to set Site key from Recaptcha configuration (detail at here). With environment local, dev, stage, and prod.

    • Recaptcha Local Key

    • Recaptcha Dev Key

    • Recaptcha Stage Key

    • Recaptcha Prod Key

    • Server Local Key

    • Server Dev Key

    • Server Stage Key

    • Server Prod Key


Image 48. ReCAPTCHA module config 

  1. Recaptcha Login Enable: Is configuration to set Secret key from Recaptcha configuration (detail at here).

  2. Recaptcha Register Enable: This is to config enable or disable Recaptcha at the registration page.

  3. Recaptcha Contact Enable: This is to config enable or disable Recaptcha at the contact us page.


  1. Paypal

This section to config about Paypal feature on PWA, Which includes:


Image 49. Paypal config

  1. Module Enable: This is to config swift PWA will be using Paypal express button or not.

  2. Debug: This is to config enable/disable debugging PayPal express button on PWA.


  1. Customer

This section to config about Customer features on PWA, Which includes:


Image 50. Customer config

  1. Forgot Password Template: This is to config identifier template email forgot password.

  2. New Account Confirmation Template: This is to config identifier template email new account confirmation.