OpenCart Community

Current Version: v2025-2-18 (release notes)

OpenCart Versions: 2.0.1.x - 4.1.0.x

Requirements: vQmod is required for OpenCart 4 versions.

To Purchase: Visit Clear Thinking or opencart.com



Automatically add products to the cart, based on a variety of triggers! This extension uses an intuitive "rules" system to easily determine when products should be automatically added, and lets you add products with options. You can restrict your triggers based on cart criteria, date/time criteria, order criteria, and product criteria.

• Upload and go — no core file modifications are necessary. The extension utilizes ocMod for OpenCart 2.x/3.0 and vQmod for OpenCart 4.
• Take advantage of the built-in extension updater. All that's required is to enter your current license key and click "Update".
• Choose whether auto-added products are free, turning them into free gift products, or whether they should have their normal price. You can also choose whether auto-added products can be removed from the cart, and if they are automatically removed when the rules are not met.
• Set any valid options to be added with the auto-added product.
• Select whether auto-added products are added just once, or whether they will be added in the same quantity as the triggering products.
• Enjoy peace of mind: all settings can be automatically saved to the database when changed, and are backed up to a backup file every time the admin panel is loaded. Settings can also be manually backed up, and then downloaded to restore from later, or edited in a spreadsheet application.
• Create auto-add triggers quickly and easily using the clean admin interface and intuitive rules system. Available rule types include:
  - Cart/Item Criteria: length, width, height, L+W+H, price, quantity, stock, total, volume, weight
  - Date/Time Criteria: day of the week, date, time
  - Discount Criteria: coupon, gift voucher, ignore specials, reward points
  - Order Criteria: currency, custom field, customer, customer group, language, past orders, payment method, shipping cost, shipping method, shipping rate, store
  - Product Criteria: attribute, attribute group, category, manufacturer, option, product, user-created product group, or any other product data
• Build rule sets to apply multiple rules to a single trigger at once. Re-use the same rule set for different triggers to quickly create the ones you need.
• Group products, categories, manufacturers, options, and attributes together however you want to create Product Groups. These groups can then be used to determine when products should be auto-added, and whether some, all, or none of the products in the group are required.
• Use the included Testing Mode to determine why things are not working as expected on the front-end, helping to debug complex rule interactions.

Updated to v303.2

Release Notes:
- Added: "L + W + H" rule, to calculate the sum of all dimensions of a product
- Added: "Price" rule, to compare individual product prices (ignoring the quantity of the item in the cart)
- Added: ability to negate "Customer Data" rules by adding the ! character to the beginning of the entered value
- Added: "Filters" rule, and Filters be added to "Product Group" rules now
- Added: "Recurring Profile" rule to limit a trigger to products in the cart that have a particular recurring profile applied (or not applied) to them
- Added: ability to append some text to the name of auto-added free products

- Fixed: "Customer Data" rules weren't working properly
- Fixed: "Reward Points applied to cart" rules weren't checking for 0 points
- Fixed: "Past Orders: Days" rules had an issue with ranges that started at 0
- Fixed: for total comparisons in different currencies, the main store's default currency wasn't being utilized correctly
- Fixed: making products free and auto-removing them wasn't always working on OpenCart 2.0 versions

- Updated: Product Criteria rules now have a more clear Testing Mode message
- Updated: products that do not qualify for "Product Group" rules will now be taken out of the calculated total when there is a "Total Value = Total" rule
- Updated: "Custom Field" rules now support ranges
- Updated: added a hook to when the cart page and checkout page load, to fix any issues with simultaneous connections making a trigger occur twice
- Updated: added a hook to when the confirm page loads, to fix "Payment Method" rules not working

Updated to v303.3

Release Notes:
- NOTE: The "Setting Override" rule for "config_address" has been replaced with a dedicated "Origin" rule, used to set the origin address for distance calculations. You will need to update your configuration to use this new rule after updating. To avoid losing the addresses you've input, make sure you use the Backup Settings button before updating. If you want help converting your rules over, please contact Clear Thinking.

- Added: ability to set a time within a "Date" rule, to have the cutoff point be on a specific date + time (e.g. 2021-02-26 15:00)
- Added: "Quantity of Product" rule, to require a certain quantity of a specific product in the cart, without affecting other calculations
- Added: "Quantity of Group" rule, to require a certain quantity of a specific product group, without affecting other calculations
- Added: "Category" comparison for "Past Orders" rules
- Added: "Date" comparison for "Past Orders" rules

- Fixed: "Stock" rules were not factoring in option stock levels
- Fixed: rules with "of every item" comparisons were not ignoring products deemed ineligible by "Product Group" rules
- Fixed: "Product Group" rules using "not" or "none of the" comparisons could count non-qualifying products if other "Product Group" rules were present
- Fixed: products with recurring profiles were ignored if multiples of the same product (but with different profiles) were in the cart
- Fixed: "Undefined index: entry_auto_remove_products" error
- Fixed: bug introduced in the last version related to the new "Filter" rules, for OpenCart versions older than 1.5.5
- Fixed: issues when using 0 for "Past Orders: Days" rules
- Fixed: issues with "Past Orders" rules for "Coupon Used" and "Coupon Unused"
- Fixed: issues with "Ignore Specials" rules for products with Discounts
- Fixed: issues with "Custom Field" rules when the value was left blank

- Updated: Cart/Item Criteria rules involving length, width, or height now use the product base value instead of the total value based on quantity
- Updated: "Option" rules no longer support multiple comma-delimited values, so that option values with commas in them work properly
- Updated: account-based "Custom Field" values now work for guest customers

Updated to v2023-5-31

Release Notes:
- NOTE: Starting with this release, version numbers will now be based on the date the new version is released.

- NOTE: This version changes "Rule Sets" to allow you to require ALL rules from the set or ANY rule from the set. If you use Rule Sets at all, make sure you click "Save" after updating to save the new version of the setting.

- Added: compatibility with OpenCart 4.0.0.x - 4.0.2.x (vQmod required)
- Added: new "Check For Updates" button with one-click update functionality
- Added: "is" and "is not" comparisons for "Date" rules
- Added: ability to search for products in the auto-complete field by Model
- Added: new "Sub-Total of Only Options" choice for "Total Value" rules, which will look only at qualifying options for total-based comparisons
- Added: "Only Specials" rule to apply triggers to only products in the cart with Special or Discount prices

- Fixed: "Automatic conversion of false to array" error in PHP 8.1
- Fixed: copying rows when using auto-saving would not copy every setting
- Fixed: bug with the change to Cart/Item Criteria rules involving dimensions
- Fixed: auto-removal bug related to the cart library's remove() function
- Fixed: "empty needle" error when leaving "Shipping Rate" rules blank
- Fixed: hyphenated values could evaluate incorrectly in "Customer Data" rules
- Fixed: lowercase/uppercase bugs with certain "Customer Data" rules
- Fixed: "Undefined index" and "array_intersect" errors related to the "Ignore Specials" rule
- Fixed: occasional page loading delay caused by using "Coupon discount" rules

- Updated: better guest detection for certain OpenCart versions
- Updated: instructions.txt file with directions on a potential fix for Journal-related issues

Updated to v2023-12-04

Release Notes:
- Added: ability to enable/disable the settings being cached on the front-end
- Added: "Product Count" comparison for "Past Orders" rules

- Fixed: billing address detection was not always correct in OpenCart 4.0.2.x
- Fixed: "Undefined index: Choose rule type" error when saving a blank rule
- Fixed: issues caused on the front-end related to the extension caching its settings when OpenCart was set to use a non-file caching system

- Removed: an unnecessary function added in the previous update

- Updated: the Testing Mode log size check now happens on the front-end rather the admin panel, to more reliably stop log files from growing over 50 MB
- Updated: multiple triggers that add the same product will now add the sum of all trigger quantities

Updated to v2024-11-20

Release Notes:
- Fixed: occasional issue when vouchers are in the cart
- Fixed: calculation bug when dimension rules were used with "of entire cart"
- Fixed: warnings when a registered customer does not have an address saved
- Fixed: bug related to using ! negation in "Customer Data" rules
- Fixed: potential calculation issue when using a "Total Value = Total" rule
- Fixed: issue when checkout doesn't set shipping methods correctly in OpenCart 4.0.0.x and 4.0.1.x versions

- Updated: saved rules are now sorted by type
- Updated: improved compatibility with the OpenCart 4.0 order editor for customer-based rules

Updated to v2025-2-18

Release Notes:
- Added: compatibility with OpenCart 4.1.0.x
- Added: ability to prevent adding items that are out of stock

- Fixed: more lowercase/uppercase bugs with certain "Customer Data" rules
- Fixed: occasional bug related to "Rule Sets" with "ANY" logic

- Updated: the free PayPal Checkout extension's "Pay Later" option that does not work like a normal payment method will now be detected properly