First Order Discount for WooCommerce

No. There is no code to share. The discount is applied by the plugin when the customer is eligible, and nothing is applied when they are not, whatever they type.

By their account if they are logged in, and by their email address if they are not. A customer counts as new when no earlier paid order is found for either. The check is made in the cart and again at the moment the order is placed, so changing the email address at checkout does not get round it.

Paid, on-hold, completed and refunded orders count. Unpaid orders count only if you tick the box for it, and failed and cancelled orders never do. A subscription renewal never makes someone count as having ordered, and an order created by hand in the admin is never given the discount but does count.

Not with the same account, and not by changing the capitals, adding a plus-tag or adding dots in a Gmail address. A customer who simply uses a completely different mailbox and a different account looks like a new customer, as with any offer that does not ask for more identification. You can also switch on matching by billing address and by phone number.

Your earlier orders are read in the background, and until that has finished every check looks at your orders directly, so nobody who ordered before is treated as new. The Tools screen can rebuild the record from your orders at any time.

Yes, and with the classic ones. On the block checkout a customer who turns out not to be new is told in plain words, and the total is refreshed without the discount, so nothing is charged that they did not agree to.

You choose: use whichever is worth more to the customer, allow both, or use the welcome discount only. The default is whichever is worth more.

Not by default. Items that are already on sale are left out of the discount, and a box lets you include them. A minimum cart total is worked out on the same items the discount is.

Each tier is a cart total and the discount for a cart that reaches it. A cart gets the best tier it has reached, and never less than the amount you set above. The total is the part of the cart the discount covers, so with a product limit set it is counted on those products only.

After. The discount is worked out first and then held to the cap, so a customer with a big cart gets the cap and no more.

Your choice: only the cheapest delivery rate, or every rate. Collection rates such as local pickup are never counted as the cheapest delivery.

Nothing. It is added to the cart at no charge, the customer cannot remove it or change its quantity, and it goes if they stop qualifying. It is never part of what the discount is worked out on. It is not added if the product is out of stock.

It can, which is why both are off until you switch them on. Two people who share an address and a phone number but use different email addresses are treated as one customer. Mark as new customer on the Tools screen is the way out for a customer who was caught by mistake. Only a scrambled code is kept, never the address or the number itself.

A customer whose email address is on a listed domain is not given the discount. The list starts short and is yours to edit, and it is off until you switch it on. A listed domain also covers the names under it.

A guest is not logged in, so that limit does not apply to them. Use the customer roles setting to refuse guests outright.

Yes. On the Tools screen, enter their email address to see whether they would get the discount, and use Mark as new customer to let them through. It changes only this plugin's record, not their orders.

It keeps only scrambled codes made with a secret key stored on your site, never the addresses themselves. It is kept when you deactivate or delete the plugin, so the discount cannot be given twice if you reinstall. You can erase a customer through the personal data tools in WordPress.

No. A customer is looked up by an indexed column, and while your older orders are still being read in, a search of the orders themselves fills the gap.

Yes. Orders are only read and written through WooCommerce, so either storage works.

Nothing about your orders or customers ever leaves your site. The licence check and the update check contact PluginCity, and send the licence key, the site address and the plugin version. Nothing else is sent.

Download the ZIP from your PluginCity account, then go to Plugins, Add New, Upload Plugin, choose the ZIP and click Install Now. If an earlier copy of the plugin is already installed, choose Replace current with uploaded: every setting you have made is kept. It needs WordPress 6.7 or later, WooCommerce 10.0 or later with WooCommerce active, and PHP 8.1 or later. There is nothing else to install alongside it.

Paste your licence key under WooCommerce, First Order Discount, Licence. Updates then arrive on your Plugins screen like any other, and the key keeps the scope, cap, tiers, free shipping, free gift, role, date and matching settings editable. A new install has 14 days before that starts to matter.

Nothing is deleted. The bigger discounts for bigger carts, free shipping and the free gift switch off. Every limit that makes the discount smaller or rarer keeps applying, so a lapse can never widen who gets the discount or raise what it is worth. Renewing brings it all back as you left it.

The plugin steps aside and shows a notice. It does not fatally error, and your settings are waiting when WooCommerce comes back.