OpenCart Community

Current Version: v2023-12-04 (release notes)

OpenCart Versions: 1.5.2.x - 4.0.2.x

To Purchase: Visit Clear Thinking or opencart.com



Restrict the payment methods available to your customers! You can set each payment method to be displayed based on a wide variety of criteria, including the shipping method and rate they select.

• Upload and go — no core file modifications are necessary. The extension utilizes vQmod for OpenCart 1.5.x, ocMod for OpenCart 2.x/3.0, and Event hooks for OpenCart 4.0
• Enjoy peace of mind: all settings are 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 to edit in a spreadsheet application.
• Take advantage of the built-in extension updater. All that's required is to enter your current license key and click "Update".
• Restrict payment methods 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
  - Location Criteria: city, country, distance, geo zone, location comparison, postcode, zone
  - Order Criteria: currency, customer group, language, shipping cost, shipping method, shipping rate, store
  - Product Criteria: category, manufacturer, product, or build your own group
• Build rule sets to apply multiple rules to a restriction at once. Re-use the same rule set to quickly create the restrictions you need.
• Group products, categories, and manufacturers together however you want to create Product Groups. These groups can then be used to determine when payment methods are enabled or disabled.
• Use the included Testing Mode to determine why payment methods are not appearing as expected on the front-end, helping to debug complex rule interactions.

Updated to v151.2

Release Notes:
- Added ability to restrict payment methods by store
- Combined Order Criteria restrictions into a single scrollbox
- Fixed bug with interactions between multiple restrictions
- Fixed bug with products that have no categories and/or manufacturers set
- Fixed typo in edits.txt file
- Updated instructions.txt

Updated to v151.3

Release Notes:
- Fixed bug with category and manufacturer names that contain apostrophes

Updated to v151.4

Release Notes:
- Added "Total" cart criteria, which utilizes the value of the total at the point of the "Shipping" Order Total
- Changed store comparison from the URL to the store_id
- Updated instructions.txt

Updated to v151.5

Release Notes:
- Changed "Total" cart criteria to utilize the value of the total after the "Shipping" Order Total is calculated
- Updated instructions.txt

Updated to v152.1

Release Notes:
- NOTE: Updating from previous versions will require you to redo some settings
- Added ability to restrict methods by geo zone
- Added ability to compare cart criteria values against the entire cart, or
just applicable items in the category/manufacturer/product lists
- Added edit to disable loading session payment methods in 1.5.0.x - 1.5.1.x
- Fixed "unserialize" error when extension data is too large
- Fixed bug with volume calculations not including product quantities
- Fixed bug with length class in 1.5.0.x
- Improved storage size of product data
- Improved location and complexity of core file edits
- Updated to include compatibility with 1.5.2.x
- Updated to skip missing file errors in vQmod 2.1.6+
- Updated instructions.txt
- Updated license.txt

Updated to v153.1

Release Notes:
- NOTE: Updating from previous versions will require you to redo some settings
- Added NOT comparison type, for enabling a method when the cart contains at least one product not in the list. (Unlike NONE, this comparison can contain products in the category / manufacturer / product lists, as well.)
- Added pop-up dialog for adding products to Product criteria, making it easier to add them when at the bottom of the page
- Added Select All / Unselect All links for each Order Criteria section
- Added ability to restrict methods based on postcode
- Added ability to base order total comparisons on the taxed sub-total
- Added ability to have the value for order total comparisons converted using currency rates, or used as that amount in each currency
- Added ability to copy restrictions when creating new ones
- Fixed bug with interactions between multiple restrictions
- Updated admin panel interface
- Updated help text and added examples
- Updated instructions.txt
- Updated license.txt
- Verified compatibility with 1.5.3.x

Updated to v153.2

Release Notes:
- Added ability to create multiple postcode blocks for postcode restrictions
- Added ability to auto-convert values from a non-default currency
- Added "Show Examples" button with examples of how to set up restrictions
- Added ability to restrict methods based on item length, width, and height
- Fixed bug with always restricting for stores that have no shipping methods
- Fixed bug with checkboxes showing as checked when all of a set are unchecked
- Updated admin panel interface
- Updated instructions.txt
- Updated edits.txt (if you've performed the manual modification, you'll need to redo the modification)

Updated to v153.3

Release Notes:
- Added ability to set single postcodes for the "Postcodes" Cart Criteria
- Fixed "undefined index" errors for address fields

Updated to v154.1

Release Notes:
- Updated instructions.txt with a note about fixing max_input_vars issues
- Verified compatibility with 1.5.4.x

Updated to v155.1

Release Notes:
- Added: vQmod compatibility for Bingo's One-Page Checkout extension
- Added: "Internal Notes" field, to keep track of restrictions
- Added: ability to base total comparisons on the pre-discounted sub-total
- Added: ability to select the format for the postcode criteria
- Fixed: all category names are displayed in italics in 1.5.5.x
- Fixed: deleted products result in an error if already assigned
- Improved: code for postcode comparisons
- Updated: edits.txt
- Updated: instructions.txt
- Verified: compatibility with 1.5.5.x

Updated to v155.2

Release Notes:
- Fixed: bug with shipping method checks
- Fixed: date selectors don't work for the new rate when copying rates

Updated to v200.1

Release Notes:
- Added: compatibility with OpenCart 2.0.0.x
- Removed: compatibility with OpenCart 1.4.8 - 1.5.1.x
- NOTE: This version is a complete redesign, to utilize a new "rules" system. The functionality is essentially the same, so updating is not required at this point. If you do decide to update from a previous version, this version will overwrite your previous one, so you'll need to set up all your restrictions again.

Updated to v201.1

Release Notes:
- Added: compatibility with OpenCart 2.0.1.x
- Fixed: "Undefined property: stdClass::$error_message" error for distances
- Fixed: "Undefined index: postcode" and "city" error messages
- Fixed: "Location Comparison" rules not working properly
- Fixed: "Total Value" settings not working properly in all cases
- Updated: initial page loading speed is greatly improved (up to 4x faster)
- Updated: small MijoShop compatibility fix

Updated to v202.1

Release Notes:
- Added: the full category path is now shown in auto-complete fields
- Confirmed: compatibility with OpenCart 2.0.2.x
- Fixed: extension Status setting doesn't work properly
- Fixed: "Undefined index: shipping" error message
- Fixed: "Undefined index: member" error message
- Fixed: "City" rules not working when spaces are entered after commas
- Fixed: issues with "none of the" comparisons in some rare circumstances
- Fixed: "Array to string converstion" error for payment/shipping method rules
- Fixed: "Invalid argument supplied for foreach()" error for Product Groups
- Fixed: restrictions do not work when only gift vouchers are in the cart
- Fixed: the "Shipping Cost" option for "Total Value" rule was missing
- Updated: auto-complete fields are now not attached until they are clicked, which should increase page loading speed even further

Updated to v202.2

Release Notes:
- Fixed: auto-complete fields not working correctly
- Fixed: "Backup Settings" not working correctly
- Updated: minor visual fixes

Updated to v203.1

Release Notes:
- Added: auto-saving can now be turned on or off, directly in the admin panel
- Added: Distance Units setting, to more easily switch between miles and km
- Confirmed: compatibility with OpenCart 2.0.3.x
- Fixed: Restore Settings doesn't work with files using Windows line endings
- Fixed: multiple "Shipping Rate" rules aren't combined using OR logic
- Fixed: deleted restrictions sometimes still affect the restriction process
- Fixed: Distance rules have issues with addresses using HTML-encoded letters
- Updated: Sort Order fields now allow for 2 alphanumeric characters
- Updated: moved edit slightly to avoid other mods interfering
- Updated: multiple "Product Group" rules are now combined using AND logic

Updated to v210.1

Release Notes:
- Added: compatibility with OpenCart 2.1.0.x
- Added: ability to use driving distances for "Distance" rules
- Added: support for the OpenCart 2.0 geocode in System > Settings
- Fixed: partially deleted restrictions can still affect the settings
- Fixed: Rule Sets did not display in the admin according to Sort Order
- Fixed: bug when mixing Product Group rules with other product criteria

Updated to v210.2

Release Notes:
- Added: "Country" and "Zone" rules, for quicker setup without using geo zones
- Added: help text clarifying that multiple Date/Time rules use AND logic
- Fixed: "Array to string conversion" error for automatic backup generation
- Fixed: admin panel getting caught in an infinite loop when a category was assigned itself as a parent in Catalog > Categories
- Fixed: bugs with "Past Orders" rules when no database data was present
- Fixed: extension not working when editing orders in some OpenCart versions
- Removed: "Sort Order" fields from Product Groups and Rule Sets -- they are now sorted by the "Name" field
- Updated: as per user request, Testing Mode messages are now in their own tab in the extension, instead of in the general Error Log
- Updated: instructions.txt file to include directions for updating

Updated to v220.1

Release Notes:
- Added: compatibility with OpenCart 2.2.0.x
- Added: ability to specify UK postcodes using just the 1 or 2-letter prefix
- Fixed: "Undefined variable: text_geo_ip_tools_location" error
- Fixed: "is is" typo in a few Testing Mode messages