Documentation
Installation instructions
You can install extension using Extension Installer or manually. In the latter case unpack and upload all folders from "upload" directory to the root of your store. If there's install.xml file in the package, rename it to extension_name.ocmod.xml, replacing "extension_name" with extension's name (or any other name), and upload it to "system" folder. When upgrading from previous version simply rewrite all existing files. Refresh modifications cache from Extensions -> Modifications page (not needed if install.xml file is not included in the package).
Note for OpenCart 3 users
If you see "The directory is not allowed to be written to" error message, download OpenCart 3.0 Extension Installer Fix from this page and install it. Then install the main extension.
Note for OpenCart 2.0.X users
Sometimes OCMod inserts modification in multiple files, which are separated by "|" character in XML-file. On earlier OpenCart 2 versions a comma was used instead. To quickly fix this, open XML file (usually, install.xml) and replace all occurrences of "|" character with "," for "path" attribute in every applicable <file> element. Search for "<file path=" to quickly find and highlight all elements.
If after installation you have "Permission denied" issue when accessing Modules, Shipping, Payments, Order Totals (or any other) section of Extensions menu, remove "module", "shipping", "payment", "total" (or any other) folder from "admin/controller/extension" directory. Same for "admin/language/en-gb/extension" directory. For example ("module" should be removed from both paths):
admin/controller/extension/module
admin/language/en-gb/extension/module
Permissions
In some cases it is required to manually set permissions for installed extension. To do this go to System -> User Groups, find your group and select access/modify permissions for desired extension. You can find extension in permissions list by folder/filename pair (for example, marketing/acoupon).
Extension Setup
How to use
To set ban rules go to Sales -> Customers -> Ban System and click Add Rule button. Choose a field from dropdown list, set the condition (EQUALS or LIKE) and enter desired value. If you want to add another field, click Add Field button, choose AND/OR operator and repeat operations above. You can set as much fields and rules as you want, but be careful and don't miss their logic.
Example: Ban user with email johndoe@mail.com, name John, lastname Doe, on Baker street or something like that.
email EQUALS johndoe@mail.com AND firstname EQUALS John AND lastname EQUALS Doe AND address LIKE baker
WARNING! Be careful with the rules, do NOT overuse them. Ban System is very powerful yet serious tool.
Types of ban
There're two types of ban: default and smart. Default ban simply disallows any operation, which matches given criteria, and displays error message.
Smart ban is more intelligent and follows different rules for different operations:
- On login - Customer or affiliate is marked as unapproved or disabled and corresponding error message is displayed.
- On register - Account is created, but marked as unapproved or disabled. Visitor gets "Account created, but requires approval" email.
- On account edit - Same as on login.
- On checkout - Order is marked with status set in extension settings. Any online payment is not possible, user is redirected to checkout/success page.