Extended conditions and bonuses of promotion

The add-on is compatible with the entire CS-Cart 4.x branch and supports the CS-Cart, CS-Cart Ultimate, Multi-Vendor, Multi-Vendor Plus and Multi-Vendor Ultimate editions. The add-on works on the server side, in the promotion forms of the administration panel and during cart calculation, so it does not depend on the storefront theme.

Some features appear only together with the standard CS-Cart add-ons:

• the Give rewards points to another user and Max. percentage of order paid by reward points (%) bonuses — with the Reward points add-on enabled; the Give rewards points in % bonus also uses it to credit the points;
• the Products supplier condition and the Discount on supplier products bonus — with the Suppliers add-on enabled.

When the corresponding add-on is disabled, its items are not shown in the condition and bonus lists.

On Multi-Vendor the cart promotions are shared by all vendors; in the issuer list of the Link issuer bonus a vendor sees only the administrators of their own company.

At the moment there is no information about the add-on being incompatible with any theme or other add-on. If a conflict occurs, please contact our support center.

After success payment, your order will be automatically marked as Paid within a few minutes. Once order changed to Paid status - add-on License activation passed success and you will received an e-mail with confirmation the receipt of payment and a second e-mail with a  download add-on link. You can also download the add-on in our License Management section of our website. To install the add-on on your website, please follow these steps:

1. Download the latest version of the add-on on our website in the "License Management" section or via the link sent by e-mail.
2. Go to Add-ons → Manage Add-ons and in the gear button, select Manual Installation.
3. Select the downloaded file and complete the installation of the add-on.

Add-on installation is completed. To go to the add-on settings page, select the installed add-on in the top menu Add-ons → CS-Commerce add-on

Everything the add-on adds lives in the promotion form: Marketing → Promotions, open a promotion or create a new one, then click Add condition on the Conditions tab and Add bonus on the Bonuses tab. The add-on items in the drop-down lists are marked with the [+] prefix.

The set of available items depends on the promotion zone chosen when the promotion is created:

• Catalog — the conditions are checked for every product separately, the bonus applies to the product; the stock and supplier conditions and the per-product reward points bonus are available here;
• Cart — the conditions are checked for the whole cart at checkout; the customer, city and cart conditions and all the other bonuses are available here.

In detail by section:

• Conditions for cart promotions — delivery city, birthdays, customer orders, product quantity, stock;
• Conditions for catalog promotions — stock by product, by category and by any product, supplier;
• Bonuses — reward points, issuer, discount on supplier products;
• The "Free shipping for part of the cart" bonus — a separate section, since the bonus has its own multi-field form.

The add-on page Add-ons → CS-Commerce addons → Extended conditions and bonuses of promotion holds no settings: it shows the installed version, available upgrades and the subscription term, plus links to the documentation and the support center. The same page opens from the add-on settings button in the Add-ons → Manage add-ons list.

After adding or changing conditions and bonuses, save the promotion. The changes take effect on save; no cache clearing is needed, but an already assembled customer cart is recalculated the next time it is opened.

The conditions below are available in promotions with the Cart zone. Every condition is set up like a standard one: a comparison operator and a value are chosen.

Delivery city

Compares the city from the shipping address the customer entered at checkout with the entered text. Operators: equal, not equal, in list, not in list — for a list, the cities are separated by commas. The comparison is by the field text, so the name must match the way customers type it.

Days before Birthday and Days after Birthday

Both conditions work with a profile field of the Date type: the field is chosen in the condition (for example, "Birthday" from the "Contact information" section), then the operator and the number of days. The add-on takes only the day and the month from the date and counts how many days are left until the nearest birthday or have passed since the last one. This way you can, for example, give a discount a week before the day (Days before Birthday less than or equal to 7) and during a week after it.

The conditions are meant for logged-in customers with the date field filled in. For a guest and for a customer without a date the add-on returns 2000 days — such a value fails any reasonable "less than or equal" check, and the promotion does not trigger.

Count of placed orders with status

Counts the customer's orders with the chosen status — for example, the number of completed orders — and compares it with the entered value. The status is chosen from the store's order statuses. The condition allows promotions for regular customers: "the third order ships free" or a discount after five completed orders.

The condition is meant for logged-in customers: guest orders in the store are not tied to a particular person, and for a guest the count does not reflect their personal history. If the promotion should not reach guests, add the standard user group condition.

Total amount of placed orders with status

Sums the totals of the customer's orders with the chosen status and compares the sum with the entered value. For a guest the condition is never met.

Qty of products in cart

The total number of product units in the cart — the sum of quantities over all items, not the number of rows. Five units of one product give the value 5.

Products in stock qty

A specific product is chosen. The condition checks whether that product is in the cart, and if it is — compares its current stock with the entered value. If the product is not in the cart, the condition is not met. This way you can, for example, keep a promotion for a product running while its stock is above a given threshold.

Quantity of goods in stock by category

A category is chosen; subcategories are included automatically. The condition finds the first product from that category in the cart and compares its stock with the entered value. Only one product is checked — the first matching one in cart order; the other products of the same category are not considered.

The conditions below are available in promotions with the Catalog zone. They are checked for every product separately, so the promotion triggers on some products and not on others.

Products in stock qty

A specific product is chosen. For that product the condition compares the stock with the entered value; for all other products the condition is not met. Suitable for a single-product promotion that should run only at a certain stock level.

Quantity of goods in stock by category

A category is chosen; subcategories are included automatically. For the products of that category the condition compares their own stock with the entered value; for the other products it is not met.

Quantity in stock

A condition without a product choice: it compares the stock of every catalog product with the entered value. With one promotion you can, for example, discount all products with more than 100 units in stock, or, the other way round, mark the last units.

Products supplier

Shown with the Suppliers add-on enabled. A supplier is chosen from the list of active ones; the operators are equal and not equal. The condition is met for the products linked to that supplier.

The stock is taken from the product's "Quantity" field at the moment of the check. For products that track stock per options (variations), the total product quantity is compared, not the quantity of a particular combination.

The add-on bonuses are added on the Bonuses tab of a promotion. Except for the per-product reward points bonus, all of them belong to the Cart zone.

Give rewards points in %

Gives the customer extra reward points for the order. The amount is set like a standard discount: as a percentage or a fixed number, of the cart subtotal; the fractional part is dropped. The points are added to the ones the customer gets by the rules of the Reward points add-on and are credited together with them when the order moves to a status that grants points.

Catalog promotions have a bonus with the same name: it counts the points from the cost of a particular product (the price multiplied by the quantity in the cart) and grants them for that product.

Link issuer

An administrator is chosen from the list. An order placed under such a promotion is recorded as issued by that administrator — the same as if they had created the order from the administration panel. This is handy for tracking orders by channel: for example, a promotion with a coupon code from a particular manager or partner. On Multi-Vendor a vendor sees only the administrators of their own company in the list.

Discount on supplier products

Shown with the Suppliers add-on enabled. A supplier and the discount amount are chosen — a percentage or a fixed one. The discount applies only to the cart items whose products are linked to that supplier; the other items are not changed. Items excluded from calculation (for example, gifts of other promotions) are skipped.

Give rewards points to another user

Shown with the Reward points add-on enabled. The user who receives the points and the amount are chosen — a percentage of the order total or a fixed one. The points go not to the customer but to the chosen user, and not immediately: when the order moves to a status with reward points granting enabled. If the order is later moved to a status without granting (cancellation, return), the same points are withdrawn. In the user's points history the operations are labelled as "Increase by promotion bonus" and "Decrease by promotion bonus" with the order number.

This is how referral and partner schemes are built: the customer places an order with a partner's coupon code, and the partner receives a percentage of the order total in points.

Max. percentage of order paid by reward points (%)

Shown with the Reward points add-on enabled. A percentage from 1 to 99 is entered. While the promotion is active, the customer cannot pay more than the given share of the order with points: if they applied more, the number of points is reduced to the allowed one, and the page shows the warning According to the promotion terms, no more than … % of the order subtotal can be paid with reward points. The number of applied points was reduced to …. If several promotions with this bonus match the cart, the lowest percentage applies.

Free shipping for part of the cart

Described in the separate section The "Free shipping for part of the cart" bonus.

The standard CS-Cart Free shipping bonus makes shipping free for the whole order. The add-on bonus works selectively: it marks the qualifying cart items as free to ship, and the shipping cost is calculated for the remaining items only. If every item qualifies, shipping is free for the whole order. The bonus is available in promotions with the Cart zone and appeared in version 1.6.0.

Bonus fields

• Categories — one or more categories; subcategories are included automatically.
• Products — individual products.
• Product feature and Feature variants — a feature with selectable values (for example, "Brand") and the variants you need. If no variants are selected, any product with that feature filled in qualifies.
• Product price from — the lower price threshold of an item.
• Shipping methods — the methods the bonus applies to. If nothing is selected, the bonus applies to the methods with the Use for free shipping option enabled; the selected methods are treated as such automatically while the promotion is active.

How a qualifying item is determined

A cart item qualifies if it belongs to at least one of the filled lists — categories, products or feature — and its price is not lower than the Product price from value. If no list is filled, every item with such a price qualifies; if the price threshold is empty too — every item in the cart. The item price in the cart is checked — including the selected options.

How shipping is calculated

The qualifying items get the free shipping flag — the same one the "Free shipping" checkbox in the product card gives. The CS-Cart core excludes such items from the package: their cost, weight and quantity do not take part in the rate calculation, and for real-time carriers only the paid items go into the request. If no paid items are left, the shipping cost is zero; for real-time carriers the add-on additionally makes sure the method does not disappear from the list because of an empty request.

On Multi-Vendor the cart is split into groups by vendor; the bonus works inside every group separately, and the shipping of the vendor whose products qualified becomes free in part.

Interaction with shipping methods

The free shipping flag of an item is respected only by the methods with the Use for free shipping option enabled (a standard method setting in Administration → Shipping & Taxes → Shipping methods). For the other methods the shipping is calculated for the full cart, as if there were no bonus. So either enable this option for the methods you need, or list them in the Shipping methods field of the bonus — then the add-on treats them as suitable during the calculation by itself.

Example

The task: free carrier shipping for the products of the "Acme" brand, the other products in the order — at the regular rate.

1. Create a promotion with the Cart zone. Conditions can be left out if the promotion applies to everyone.
2. Add the [+] Free shipping for part of the cart bonus.
3. In the Product feature field choose "Brand", in the variants — "Acme".
4. In the Shipping methods field tick the carrier and save the promotion.

The customer puts Acme products and products of other brands into the cart: the carrier rate is calculated for the other brands' products. If the cart holds Acme only — the carrier shipping is free.

If several promotions with this bonus match the cart, their selections add up: an item counts as free if it matched at least one of them, and the shipping methods are merged. Products with free shipping enabled in the product card stay free regardless of the bonus.

In order to have access to add-on upgrades, you must have an active upgrade subscription. If the subscription period has expired, you will only have access to upgrades released before the expiration date of your subscription. You can renew your upgrades subscription in the "License Management" section on our website.

The add-on supports instant upgrades via the CS-Cart Upgrade Center. The built-in CS-Cart Notification Center (bell) will notify you about new versions release of the add-on. Upgrades via Upgrades Center will allow you to switch to a newer version without losing add-on data and settings.

Before start an upgrade process, it is highly recommended to make a full backup of the site (database and files) of your store using the server or hosting methods. 

 Upgrade through the Upgrade Center

1. In the top menu, go to Administration → Upgrade Center;
2. In the gear menu, click "Refresh available upgrades"
3. Find and add-on on list of available upgrades and click the Download button and than Install button;
4. Follow all the instructions that will be shown during the upgrade process;
5. It is recommended to clear the CS-Cart templates cache after the upgrades are installed by deleting the var/cache folder on your server or adding the ctpl parameter to the address bar (example: https://domain.com/admin.php?ctpl).

Addon Reinstallation by uninstall old and install new:

Reinstalling an add-on means deleting the add-on's settings and data. Reinstallation will allow you to get a clean installation of the latest addon version. To reinstall the add-on with saving the add-on settings and data, please contact us via our Support Center to provide this service.

To completely reinstall an add-on without saving data, follow these steps:

1. Go to Add-ons → Manage add-ons and find the old installed add-on.
2. Click the delete button in the gear menu of the add-on.
3. Download the latest version of the add-on on our website in the "License Management" section.
4. Go to Add-ons → Manage add-ons and in the gear menu select Manual Installation. Select the previously downloaded file and complete the installation of the add-on.

The technical support of the add-on is already included in its price. Before contacting the support center, please make sure you are using the latest released version of the add-on. Old versions of the add-on are not supported by technical support.

To use our technical support, follow these steps:

1. On our support center site https://helpdesk.cs-commerce.com/, log in with your account;
2. Click on the "Create ticket" button;
3. Fill in all the required fields and create ticket (you will receive a confirmation email);
4. Expect a response from a specialist (a notification will be sent to your e-mail about the response) in accordance with the regulations of the technical support service.

If you have not received an answer within the time frame specified in the regulations, write us a message to the e-mail [email protected] with the subject of the ticket and we will try to resolve your issue as soon as possible.

Technical support via chat on the site, direct phone calls or e-mail letters is not provided. All help discuss goes through the support center. Carefully study the documentation for the add-on and the terms of technical support before creating a ticket. 

We recommend that you familiarize with the general restrictions:

1. Fragments of code or some files of an add-on may have a private (encoded) part. The coded part does not create problems on add-on customizations;
2. The add-on will work only on those domains that are specified in the user's license. If you try to use the solution the domains of which are not included in the license, the add-on will be automatically disabled;
3. Installing on local machines is not allowed by the licensing system. For the add-on to work on an additional domain (alias), specify this alias on the license management page. Up to three aliases are allowed per domain for testing and development purposes. You can change the main license domain yourself on the license management page.

To have possibility to add or change license domains and aliases, the upgrade subscription must be active. To change the license domain of an expired upgrades subscription, you must first renew your subscription.  

Version 1.6.0 of September 21, 2026

• Added the "Free shipping for part of the cart" promotion bonus: shipping becomes free only for the selected categories, products, feature values or products above a given price, while the shipping cost is calculated for the remaining order items; if every item qualifies, shipping is free for the whole order.
• Added compatibility with PHP 8.3.
• Fixed the cart condition "Products in stock qty": the promotion triggered even when the selected product was not in the cart.
• Updated the add-on service block: version, subscription and upgrade information in the add-on settings.

Version 1.5.3 of August 5, 2026

• Added a limit on paying with reward points through promotions: a maximum percentage of the order total can now be set.

Version 1.5.2 of June 5, 2026

• Basic stability and security updates of the add-on.
• Added compatibility with PHP 8.3.

Version 1.5.1 of July 18, 2025

• Fixed a missing language variable.

Version 1.5.0 of July 16, 2025

• Added the ability to give reward points to another user for an order.

Version 1.4.0 of May 27, 2025

• Basic security updates of the add-on.

Version 1.3.1 of March 22, 2024

• Added the "Quantity of goods in stock by category" condition for the cart.

Version 1.3.0 of March 21, 2024

• Added the "Quantity of goods in stock by category" condition.
• Added the "Quantity in stock" condition.
• Fixed some promotion condition bugs.
• Basic security updates of the add-on.

Version 1.2.0 of April 17, 2023

• Added a new bonus: "Discount on supplier products".

Version 1.1.0 of April 6, 2023

• New promotion condition: "Products supplier" (works with the Suppliers add-on).

Version 1.0.1 of August 3, 2022

• Improved appearance for CS-Cart 4.11.x and above.
• Basic security update.

Version 1.0 of May 12, 2021

• The first release of the add-on.