Coupons Selection for eCommerce

This module brings the promotion selection wizard to the eCommerce frontend, so customers can set up complex promotions themselves without staff help.

On the promotions page, each published promotion that is not already applied and is available for the current cart now shows an Apply button. Clicking it either applies the promotion or, for configurable promotions, redirects the customer to the cart.

In the cart, a warning banner appears when a promotion needs configuration, with a Configure button that opens a pop-up. There the customer chooses the gift products and quantities and any reward options, then clicks Apply. The selection is sent to the server, the promotion is applied to the order, and the cart reloads. If the promotion cannot be applied, an error message is shown in the pop-up.

The cart also shows suggested promotions: a gift icon next to eligible lines and a Suggested Promotions table with an Add button for each suggestion.

Business rules handled by the code: only active and published promotions can be applied; promotions already on the order are skipped; promotions not available for the current order are not offered; applying a promotion code that needs configuration opens the configuration flow instead of applying it directly; and the promotion selection is cleared after applying or dismissing it.