Quick start

Step-by-step setup of the first-order discount on a MiniShop3 site.

Requirements

Manage → Elements → Plugins (in MODX 3: Elements → Plugins)
Find the ms3FirstTimeBuyerDiscount plugin
Enable it and attach it to the msOnGetCartCost event (should be selected by default)
Save

MiniShop3 will call this plugin when calculating cart cost.

Manage → Settings (in MODX 3: Settings → System settings)
Filter by area ms3firsttimebuyerdiscount or search for ftb_
Set:
- ftb_enabled — on (yes)
- ftb_discount_type — percent or fixed
- ftb_discount_value — e.g. 10 (10%) or 500 (500 fixed)

In MiniShop3 ensure ms3_status_for_stat contains the IDs of “paid” order statuses (usually 2,3 by default). This defines who is a first-time buyer.
Log in as a user with no paid orders in those statuses (or checkout as guest with a new email/phone)
Add a product to the cart — the cart block should show the total with the discount applied
A user with at least one order in ms3_status_for_stat does not get the discount

To show a “First-order discount” block, add to the checkout page template:

modxfenom

modx

[[!ms3ftbDiscountBanner]]

fenom

{$modx->runSnippet('ms3ftbDiscountBanner', [])}

The plugin loads the component CSS/JS on the page. For guests, the banner is refined after they enter email/phone via the eligibility endpoint.

Result: the discount is applied automatically during cart calculation; you don’t have to change templates — only the final total changes.