b2c-business-manager-extensions_skill

Overview

This skill helps you create Business Manager extension cartridges for Salesforce B2C Commerce to add admin tools, menu items, dialog buttons, and form fields. It focuses on bm_extensions.xml definitions, menuaction/menuitem entries, dialogaction hooks, and formextension definitions for bm_* cartridges. Use it when building custom Business Manager pages, controllers, templates, and resource bundles for localization.

How this skill works

Define extensions in a bm_extensions.xml inside a dedicated BM cartridge and provide controllers, templates, static assets, and resource bundles. The skill shows how to register menu items and actions, add dialog buttons to extension points, and extend existing forms with extra inputs. It also covers wiring controller pipelines, rendering ISML templates, static icons, and enabling the cartridge and permissions in Business Manager.

When to use it

• Adding a top-level admin section or new menu action inside Business Manager
• Creating custom Business Manager pages rendered by controllers and ISML templates
• Injecting dialog buttons into existing BM pages (order, product, customer)
• Extending existing BM forms with custom inputs or select options
• Building admin-only features separated from storefront cartridges

Best practices

• Prefix all IDs with an organization or project short name to avoid collisions
• Use resource keys for every user-facing string and include localized bundles
• Keep Business Manager cartridges separate from storefront code and assets
• Declare public controller actions deliberately and protect sensitive operations with role permissions
• Test behavior with multiple roles and cartridge path orders to validate access and rendering

Example use cases

• Add a ‘Custom Tools’ menu that links to a CSV product export controller
• Add an Export button to Order Details that passes OrderNo to a pipeline
• Extend the order search form with a custom status filter and options
• Create a dashboard page that renders reports with ISML and controller-supplied data
• Provide role-restricted admin actions for bulk item processing via menuactions