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:
Compile the Javascript (run the command npm run compile:js) and upload the cartridge.
Add the cartridge to the beginning of the site’s cartridge path (int_stackla:app_storefront_base)
Import the metadata.
Configure the site preferences.
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.