Solidshop’s core ships with a built-in discount engine for running promotions. You can configure automatic discounts that apply when a cart meets certain conditions, or coupon codes that customers enter at checkout.
Core vs. Advanced plugin. This section describes the discount features built into the core component. The Discount & Coupons plugin extends this engine with an AND/OR rule builder (customer group, purchase history, category, cart quantity, SKU, SKU quantity and location conditions), five more action types, exclusive stacking and bulk coupon generation — see the plugin documentation. The core engine and the plugin share the same data model — promotions you create in the core continue to work after installing the plugin.
Creating a discount
Go to Solidshop → Discounts → New. The form has three tabs: General, Conditions, and Action.
- Name — a label for your reference (e.g. “Spring Sale 10%”). Not shown to customers.
- Status — Published, Unpublished, or Trashed. Unpublished discounts never apply.
- Trigger type — Automatic applies to every qualifying cart with no action from the customer; Coupon code only applies when the customer enters the exact code at checkout.
- Coupon code — the coupon string (shown only when trigger type is Coupon code). Click the randomise button to generate a short unique code.
- Priority — the order of evaluation when multiple discounts qualify. A lower number means a higher priority and runs first.
- Combinable — whether this discount can stack with other combinable discounts. Non-combinable discounts never stack on the same product: they are taken in priority order, and one that reaches a product an earlier one already discounts is skipped. A discount reaches the whole cart unless its scope is Product level (a setting the Discount & Coupons plugin adds), so with core alone the highest-priority non-combinable discount is the only one that applies.
- Start / end date — schedule the discount. Empty start or end means “always on” from that side.
- Minimum cart total — the discount applies only when the cart subtotal reaches this amount.
- Total usage limit — the maximum number of orders this discount can apply to, in total, across all customers.
- Usage limit per customer — the maximum number of times a single customer can redeem this discount.
- Discount type — Percentage off (e.g. 10 = 10% off) or Fixed amount off (a currency amount off).
- Value — the percentage or amount.
The core engine always applies the discount to the full cart subtotal. The Discount & Coupons plugin adds an Scope selector (Cart total vs. Product level, working together with the SKU and category rules in the Advanced Conditions tab) and five more action types, each with its own settings on the same tab:
- Buy X get Y — every buy + get units form a group; the cheapest get units in each group are discounted by the chosen percentage. Count every unit in the cart, or only units of a single product.
- Fixed price per unit — sells the selected products and/or categories at the price in Value.
- Tiered by cart total — a table of cart-total thresholds, each with its own percentage or fixed amount; the highest threshold the cart reaches wins.
- Free item — makes up to the given number of units of one product (optionally one variant) free. The customer must have the product in the cart; the cart and product pages tell them so once they qualify.
- Shipping discount — a percentage of, or a fixed amount off, the shipping cost (capped at the cost of the chosen rate). Shown as a separate Shipping discount line on the order, email and invoice.
Discounts and tax
A discount reduces the taxable base of the order lines it applies to, so tax is charged on what the customer actually pays. A free item carries no tax; a percentage discount reduces the affected lines’ tax by the same percentage; a cart-wide fixed amount is spread across the lines in proportion to their subtotals and reduces each line’s tax accordingly. This works in both tax modes (tax-exclusive and tax-inclusive pricing) — see Tax for details. The per-line discount amounts are recorded on the order, so invoices and the sales-by-product report attribute the discount to the right products.
Where shoppers enter coupon codes
Shoppers can enter a coupon code in two places: on the cart page (behind a “Have a discount code?” link) and at checkout. Both feed the same session, so a code applied in the cart carries into checkout automatically. The cart page also shows a discount row whenever a discount applies — including automatic discounts — so a “10% off orders over $100” promotion is visible before checkout begins, in the cart summary and in the mini-cart drawer.
Location-restricted codes (an advanced-discount condition) cannot be fully validated on the cart page because no shipping address is known there yet. The cart accepts such a code and marks it “Confirmed at checkout”; it is re-evaluated against the shopper’s real address at checkout and the discount applies (or not) there. Codes whose only effect is a shipping discount get the same treatment, since the shipping cost is not known until a rate is chosen at checkout.
Applying a discount manually on an order
You can apply a one-off discount directly from the order detail page — useful for goodwill gestures, phone-order negotiations, or back-office promotions that don’t warrant a full discount rule. Open the order, click the Apply discount button in the products section, choose Percentage or Fixed, enter the value, and save. The order recalculates immediately.
Testing a coupon: create a coupon-code discount with a high usage limit, start date in the past, and a small percentage value. Open the storefront in a private window, add a product to the cart, and enter the code at checkout — confirm it applies, appears in the order total, and shows up on the order detail page and invoice.