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
Go to Catalog, click Product Bundles Pro and setup accordingly.
General Settings
General settings will be applied to bundles list (on frontend or backend) or used in some common cases (for example, if certain options are not defined in modules).
- Filters - Selected filters will be displayed above bundles list. To hide Filter section, simply uncheck all items.
- Columns - Selected columns will be displayed in bundles list. At least one column must be selected!
- Display Mode - There\'re 3 modes available: Latest, Bestsellers and Random. The behavior of each mode is the same as in corresponding product modules.
- Shuffle Bundles - Bundles will be shuffled each time the page with bundles list is loaded.
- Show Bundle Description - Display bundle\'s description in the bundles list. Description will be cut to the Product Description Limit value.
- Show Rating - Display average product rating in bundles list. Bundle rating is a sum its product ratings divided by number of products.
- List Description - Custom test to display above the bundles list (similar to product category description).
- List Style - Display bundles in the list as grid (horizontal layout) or list (vertical layout). Works and looks similar to product category page.
Bundle Options
- Discount - Bundle discount in percent or fixed value (for example, $100 or 10%).
- Discount Multiplier - When bundle is added to cart multiple times, discount will be limited to the given number even if it is less than bundle quantity.
- Logged Only - Bundle will be available to logged customers only.
- Date Start - Date, when bundle becomes available.
- Date End - Date, when bundle becomes unavailable.
- Customer Groups - Bundle will be available to selected customer groups only.
- Geo Zones - Bundle will be available to selected geo zones only.
- Stores - Bundle will be available to selected stores only.
Other bundle options are the same as corresponding product options. Enter desired title and description, define meta data, add images, enable and your bundle is ready.
Order Total
Go to Extension -> Order Total, install Product Bundles Pro and setup accordingly. It is needed to calculate and display a discount for bundles according to given parameters:
- Combine Discounts - If customer adds multiple bundles to cart, combined discount will value be displayed in order totals list instead of multiple values.
- Hide Total - This order total will be hidden and its value added to selected order total.
- Total to Add - If Hide Total is enabled, this order total\'s value will be added to selected order total.
- Add Info to Total - Will add information, that selected order total also includes discount for bundle.
- Inactive With - Discount will not be applied, if one of the selected payment, shipping or order totals is active.
NOTE: When Combine Discounts option is enabled, Bestsellers mode will not work in modules!
Modules
If you plan to use modules go to Extension -> Modules and install Product Bundles Pro (Multiple bundles) or Product Bundles Pro (Single bundle) module and setup accordingly. Then go to Design -> Layouts section and add previously installed and enabled module to any page you like.
Product Bundles Pro (Multiple bundles) displays the list of bundles according to given parameters. There\'re several options, which change the module behavior:
- Bundles - Only selected bundles will be displayed in the module (works similar to Featured module). If empty, all bundles will be available for querying.
- Bundles Limit - How many bundles to display in the module.
- Display Mode - There\'re 3 modes available: Latest, Bestsellers and Random. The behavior of each mode is the same as in corresponding product modules.
- Shuffle Bundles - Bundles will be shuffled each time the page is loaded.
- Show Description - Display bundle\'s description in the module. Description will be cut to the Product Description Limit value.
- Show Rating - Display average product rating in the module. Bundle rating is a sum its product ratings divided by number of products.
- Show Total - Total number of available bundles will be displayed in module title.
Product Bundles Pro (Multiple bundles) displays a single bundle according to given parameters. There\'re several options, which change the module behavior:
- Bundle - Selected bundle will be displayed in the module. If empty, module will only work on product page and display a single bundle with current product.
- Display Mode - Works only when bundle is not selected. Will display latest, best selling or random bundle with the current product.
- Show Description - Display bundle\'s description in the module.
- Description Limit - Description will be cut to the given number of characters. If empty, description will be cut to the Product Description Limit value.
- List Style - Display bundle products as grid (horizontal layout) or list (vertical layout).
