Smart Offers — Complete documentation
Configure and run Smart Offers on PrestaShop 1.7.8, 8 and 9: buy X get Y, bundle gifts, mix and match and bulk packs, applied automatically and safely in the cart.
Smart Offers lets you run the four most common bundled promotions on PrestaShop: buy X get Y of the same product, a gift for products bought together, mix and match among a selection and bulk packs. The module adds the reward items to the cart, applies the discount and shows the offer on the product page and in the cart, on PrestaShop 1.7.8, 8 and 9.
Compatibility
| Item | Supported |
|---|---|
| PrestaShop | 1.7.8, 8.0 to 8.2, 9.0 and later (single ZIP) |
| PHP | 7.2 and later (the PHP version required by your PrestaShop applies) |
| Themes | Classic, Hummingbird and their child themes |
| Multistore, multi-currency, combinations | Yes |
| Languages | English, French, Spanish, German, Italian, Polish, Dutch, Portuguese |
Installation and update
- In the back office, open Modules → Module Manager and click Upload a module.
- Drop the
dfoffers-3.0.0.zipfile. - The module appears under Catalog → Discounts → Smart Offers, next to the cart rules.
Updating from 2.x: upload the new ZIP over the old one. Your offers, products, translations and shops are kept. The upgrade script adds the new options, moves the menu entry, and secures the cart rules already created by 2.x (no credit voucher can be generated anymore).
The dashboard
The Offers page shows the running offers, the valid orders that used an offer over the last 30 days, their revenue and the discount granted. Each offer shows its rule in plain words, its status (running, scheduled, ended, disabled), its dates, its orders and its discount. You can search, filter by status, enable or disable with one click, duplicate, delete, and apply bulk actions.

The four offer types
- Buy X, get Y of the same product: the classic 1+1 or 2+1. Each product of the list gets its own offer; leave “any combination” to count all its variants together.
- Buy products together, get a gift: all the trigger products must be in the cart, the reward products are then free or discounted.
- Mix and match among a selection: the customer picks N items among products or combinations, the cheapest ones are free or discounted (3 for 2 on all mugs, for example).
- Bulk pack: for every lot of X units of one product, the customer gets Y units of another product.
Creating an offer
Click New offer, or pick one of the four models when no offer exists yet. The editor has five steps and, on the right, a live preview of the product page banner and a summary of the rule in plain words.
- Offer type: one of the four cards. Only the relevant fields are shown.
- Products and quantities: add the products with the search window, by name, reference or ID. For a product with combinations, add it for any combination or pick one or several specific combinations.
- Reward: free (100%) or a percentage (50 for “the second at half price”), automatic add to the cart or not, repetition on every complete lot, maximum per cart.
- Display: name, badge text and additional text in each language, colour of the offer. The text colour of the badge is chosen automatically to stay readable.
- Availability: status, start and end dates, priority, customer groups and shops.


When the reward items are not added automatically, the customer adds them and the discount applies as soon as they are in the cart; the cart then reminds them of the reward waiting.

The product page banner
On every product concerned, a banner explains the offer with the products to buy and the reward, the regular price crossed out next to the free or discounted items, the end date of the offer, and an “Applied in your cart” state once the customer qualifies. It adapts to narrow columns and to mobile.




The cart
Under the cart lines, the customer sees the offers applied with the amount saved and the items received. A badge (“1 free”, “1 at -50%”) marks the lines that contain discounted units, in the cart and in the checkout summary. The block refreshes after every quantity change, on Classic and Hummingbird.

You are almost there lists what is missing to unlock an offer (“Add 1 × T-shirt”), and A reward is waiting for you reminds the customer to add a reward that is not added automatically.

If the customer removes a gift, it is not forced back: the offer is set aside and an Add it back button is shown. For a “buy X get Y” on the same product, the units removed are the free ones first, so the customer never loses a unit they paid for.

Settings
- Banner position: below the add-to-cart button (recommended), right below the price, below the images, in the reassurance block or full width below the description.
- Compact banner, prices in the banner and end date.
- Cart: show what is missing to unlock an offer, badge on the cart lines.
- Debug log: writes each cart computation to Advanced parameters → Logs; leave it off in production.
- Maintenance: number of cart rules created by the module and clean-up of those of abandoned carts.

How the engine works
- On every cart change (and when the cart or checkout page loads), the module reads the cart and separates the units the customer pays for from the units it added itself.
- Offers are evaluated by priority (1 first). A unit used by one offer is not used again by another, so the same item is never discounted twice.
- For each offer that applies, the missing reward items are added (if you chose so) and one cart rule per discounted product is created or refreshed (code
DFOFFER_…). - Offers that no longer apply are removed: added units taken back, cart rules deleted.
Security and taxes
- Everything is computed on the server from the cart and your offers; nothing sent by the browser is used in a price.
- Each cart rule is restricted to the discounted product: it can never exceed what the customer has of that product in the cart, and the tax rate of that product applies to the discount, also on the invoice.
- Rules never generate a credit voucher, are not listed in “My vouchers”, and a code copied from another cart is removed before payment.
- A reward out of stock or disabled is not discounted. An order already placed is never modified.
- Back office actions follow the employee permissions of the tab (view, add, edit, delete).
Cart rules of carts abandoned for 30 days are removed automatically once a day when you open the module; rules used by an order are always kept for your accounting.
Help and troubleshooting
The Help tab of the module explains how it works and answers the most common questions.
- The banner does not show: check that the offer is enabled, within its dates, open to the customer group and the shop, and that the product is active. Then try another banner position: some themes do not call every hook.
- A voucher of yours is refused with an offer: a voucher set as “not combinable with other cart rules” may refuse the combination; adapt it in Catalog → Discounts.
- The badge is missing on cart lines: your theme needs
{hook h='displayProductPriceBlock' product=$product type="unit_price"}or{hook h='displayCartExtraProductActions' product=$product}in its cart line template.

Technical details
- Hooks: displayProductAdditionalInfo (or the position chosen), displayProductPriceBlock, displayAfterProductThumbs, displayReassurance, displayFooterProduct, displayShoppingCartFooter, displayCartExtraProductActions, actionCartSave, actionFrontControllerSetMedia, actionObjectProductDeleteAfter, actionObjectCombinationDeleteAfter.
- Tables: ps_dfoffers_offer, _offer_lang, _trigger, _reward, _shop, _cart_auto, _rule, _cart_declined.
- Templates that can be overridden in your theme:
views/templates/hook/product-banner.tpl,cart-offer.tpl,cart-line-gift.tpl. CSS classes use thedfoffers-prefix. - No override, no cron task, no external service. Uninstalling deletes the offers and the unused cart rules; rules used by orders are kept.