The following guide outlines the steps for installing and configuring the Stackla SalesForce Commerce Cloud Cartridge.

Download Cartridge:

Please download the latest version of the Stackla SalesForce Commerce Cartridge from the SalesForce LINK Marketplace here before progressing.

Install the Cartridge:
To install the cartridge:

  1. Compile the Javascript (run the command npm run compile:js) and upload the cartridge.

  2. Add the cartridge to the beginning of the site’s cartridge path (int_stackla:app_storefront_base)

  3. Import the metadata.

  4. Configure the site preferences.

  5. Configure the job settings.

Import the Metadata:
In Business Manager, navigate to Administration > Site Development > Site Import & Export. Upload and import metadata.zip.

Configure Site Preferences:
Within the Cartridge you can define the following preferences:

Name

ID

Description

Stackla Tracking Enabled

stacklaTrackingEnabled

Enable the Stackla Tracking Pixel on your Site.

Stackla Tracking Pixel URL

stacklaTrackingPixelUrl

Define the Stackla Tracking Pixel URL.

Stackla Widget ID

stacklaWidgetId

Define the Widget ID for your PDP Widgets

Stackla Widget Available Products Only

stacklaWidgetAvailableProductsOnly

Hide product information for unavailable products

Stackla Widget Filter

stacklaWidgetFilter

Define a specific Stackla Filter to Display

Stackla Widget Tag Group

stacklaWidgetTagGroup

Show Products for a specific locale only.

Stackla Widget Tags Grouped As

stacklaWidgetTagsGroupedAs

Apply 'AND'/'OR' grouping to Tags

Stackla PDP Widget Enabled

stacklaWidgetEnabled

Enable the Stackla Widget on PDPs



Configure Job Settings (Optional):
The Stackla-ProductFeed job builds and exports a product feed from the site catalog. By default, the job is scheduled to run every 24 hours. Configure the parameters of the custom.stackla.ExportProductFeed job step.

Specific product IDs (separated by commas) may be entered for the “Products” parameter. If no product IDs are specified, all products assigned to the current site will be exported to the product feed.

The default value for the “TargetFolder” parameter is “default/feeds” and the default value for the "Filename" parameter is “stackla_product_feed”.

The scope of the custom.stackla.ExportProductFeed job step must be set to “Specific Sites”. Assign to the appropriate site(s).


Enable Tracking Pixel 'Add to Wishlist' Event (Optional):
In order to enable the tracking pixel “add_to_wishlist” event for use with the “plugin_wishlists” cartridge, uncomment the lines containing “processInclude(require('./product/wishlist'))” in the productDetail.js, productTile.js, and search.js files located in the “cartridge/client/default/js” directory.

In the main.js file located in the same directory, change the path for miniCart to “./components/miniCart”.

In the “paths” property of the package.json file located in the top level of the cartridge, add a “wishlists” property with a path to your “plugin_wishlists” cartridge.

Did this answer your question?