After you have finished with the purchasing process, we’ll send you an email containing all the links you need to download this extension.
(Please turn off Merge-JS before installing the module. Only Turn on Merge-JS again when finishing the installation.)
NOTE: If you use Hyva theme, please install the original extension via Composer.
I. Install a new module
1. Install the Custom Option Core module
When installing a new Dependent Custom Options module, it is required to install the Custom Option Core module. Only with the Custom Option Core module installed, then the DependentCustom Options extension can work well.
Please follow these steps:
Step 1:
Download the Core Module
Step 2:
Create a directory:
[Magento root folder]/app/code/Bss/CustomOptionCore
Step 3:
Unzip the source code of the extension to the directory created in step 2.
Step 4:
Go to Magento 2 root directory and run the following commands:
- php bin/magento setup:upgrade
- php bin/magento setup:di:compile
- php bin/magento setup:static-content:deploy
- php bin/magento cache:clean
2. Installing the Magento 2 Dependent Custom Options extension
2.1. Install via App/Code
Step 1:
Unzip the file.
Step 2:
Create another directory called app/code/Bss/DependentCustomOption/. DependentCustomOption is the module’s internal identifier. You can find it in the “composer.json” file in the extension ZIP file you downloaded, look at the node “psr-4”.
This is what you call the directory, and then you put the contents of the extension ZIP file in there.
Step 3:
Upload the directory app/code/Bss/DependentCustomOption/ into the root directory of your Magento installation. The root directory of Magento is the directory that contains the directories “app”, “bin”, “lib” and more. All directories should match the existing directory structure.
Step 4:
Go to Magento 2 root directory.
Run: php bin/magentosetup:upgrade.
Step5:
Run: php bin/magentosetup:static-content:deploy.
Step 6:
Run: php bin/magento setup:di:compile
Step 7:
Clear all Caches.
2.2. Install via Composer
Besides installing Magento 2 extensions via App/Code, installing via Composer is another very common and simple way used by a lot of Magento users.
Follow the guide here.
II. Upgrade the extension to the new version
If you are already using Dependent Custom Options extension, and what to upgrade to a newer version (from 1.0.9), please follow the instructions below:
Step 1:
Download the new extension version (including the Custom Options Core module).
Step 2:
Delete the previous code in the directory:
[Magento root folder]app/code/Bss/DependentCustomOption/
Step 3:
Unzip the source code of the new extension version to the directory.
Step 4:
Go to Magento 2 root directory and run the following commands:
- php bin/magento setup:upgrade
- php bin/magento setup:di:compile
- php bin/magento setup:static-content:deploy
- php bin/magento cache:clean
III. Install/Uninstall/Disable the Hyva Theme Compatibility package
The following instruction is used for the Hyva theme compatibility package ONLY.
1. To install the Hyva compatibility package:
Step 1: Install the extension by the above Composer (If you have already installed the module, then skip this step)
Step 2: Install the Hyva compatibility package:
a. Install via composer, run commands:
- composer require hyva-themes/magento2-bsscommerce-dependent-custom-option
- php bin/magento s:up
b. Enable module, run command:
- php bin/magento setup:upgrade
2. To disable the Hyva compatibility package, run command:
- php bin/magento module:disable Hyva_BssDependentCustomOption
3. To uninstall the Hyva compatibility package, run command:
- composer remove hyva-themes/magento2-bsscommerce-dependent-custom-option
*NOTE :
When installing module, you need to run the following commands to receive css:
- bin/magento hyva:config:generate
Adding the file including tailwind css: "src": "vendor\/hyva-themes\/magento2-bsscommerce-dependent-custom-option\/src" to file app/etc/hyva-themes.json
- cd /path/vendor/hyva-themes/magento2-default-theme/web/tailwind/
(This path is for theme Hyva default in your site)
- cd /path/to/project/app/design/frontend/VendorName/ModuleName/web/tailwind/
(This path is for custom theme in your site)
- npm run build-prod
After purchasing this module, just add our Skype account at support.bsscommerce, BSS Support Team will help you to install this extension immediately. Further assistance is available via Email and Skype.
In case you have followed all the above steps but the extension still doesn’t work properly, you can delete the file or change the module’s filename to keep your website function as normal. Then please contact us via sales@bsscommerce.com or Skype: support.bsscommerce, our supporters will assist you in resolving any issues within 24 hours.