Magento 2 Product Improvement Extensions

  1. Home
  2. Docs
  3. Magento 2 Product Improvement Extensions
  4. Magento 2 Custom Options Package
  5. User guide

User guide

 

1. Overview

Magento 2 Custom Option Combo is a comprehensive solution to help you knock out the limitations of custom options by default. It includes these extensions below:

  • Custom option template
  • Custom option image
  • Dependent custom option
  • Custom option absolute price and quantity (coming soon)

2. How Does It Work?

To enable features of B2B Package in your Magento 2 website, please go to

Stores → Configuration → BSS COMMERCE

2.1. Custom option template

Choose Custom Option Template under BSS COMMERCE tab

2.1.1. Custom Options Template Grid

Magento-2--custom-template-extension

  • In ID column: choose the ID of the template
  • In Title column: choose the title of the custom option template
  • In Is Active column: the status of the template. “Yes” means that the custom option is enabled in the frontend and “No” means that it is disabled.
  • In Description column: description of the template
  • In Create At column: specific date and time that the custom options template was created.
  • In Update At column: specific date and time of the last edition.
  • In Action column: choose Edit to go to the custom options template edit page, or choose Delete to delete the template

Note: the above information isn’t displayed in the frontend.

2.1.2. Create Custom Option Template

Please click on Add New Template button to create new custom options template.

Magento-2-custom-option-template

2.1.2.1. Custom Option Template Information

In  Template Information tab, you can edit the general information for the template.

  • In Title, edit a title for the template.
  • In Is Active, choose Yes to enable the template in the frontend, or No to disable it.
  • In Description, edit the description for the template that is being created.

In Assign Template for Products by:

  • Products Grid: assign the custom option template to products by grid. There will be an additional tab named “Select Products” displaying a product grid for you to set up.

  • Products: assign the custom option template to products by IDs. There will be an input field for you to enter multiple product IDs, separated by commas (,).

  • Skus: assign the custom option template to products by SKUs. There will be an input field for you to enter product SKUs, separated by commas (,).

After assigning custom option template, the custom options are immediately inserted to the Customizable Options tab in each product edit page in the backend and they will be displayed in the frontend.

2.1.2.2. Create Custom Options

To edit custom options of a template, please open Custom Option tab in Custom Option Template Edit page.

In this tab, you can create unlimited custom options by all input types. This section is the same as the Customizable Options tab in product edit page.

After setting, you need to save to complete. There are 5 buttons for you to press:

  • Save: save all settings and then you will be redirected to the custom option template grid
  • Duplicate: duplicate the custom option template. The duplicate template is removed the selected products of the original one.
  • Save and Continue: save the template and continue staying in the edit page.
  • Delete: delete the template
  • Back: back to the template grid.

Note:

When the custom option template is deleted or set from Yes to No in Is Active field, the custom options assigned to the product using that template is removed.

After the custom option template is assigned to the product,

  • If there are new options added to the template, then those new options are also added to the product.
  • If the admin edits any option of the template, the relevant option of the product is also updated.
  • If the admin deletes any option of the template, the relevant option of the product is also removed.

Custom Options assigned to the product using the template will be associated to that template. In other words, whenever the template is updated, the options of the assigned products will change accordingly.

Magento 2 Custom Option Template extension allows that one product can be assigned to multiple templates.

As above, for the time being, the module supports assigning the template to products by Product IDs, Product SKUs, and selecting products in grid of the Template Edit Page. It means the template can not be assigned to product on Product Edit Page.

When the custom option template is duplicated, assigned products will not be duplicated in the new template.2.1.3.  Manage Admin User Roles

Please go to System ⇒ Permissions ⇒ User Roles to restrict other admin accounts accessing the custom options template management.

2.2. Custom option image

2.2.1. General Configs

  • In Enabled, choose Yes to enable the extension, or No to disable it.

Note: The module works with simple product, configurable product, bundle product (without dynamic pricing), downloadable and virtual product.

It only supports adding images for products that can have custom options by Magento default so the extension does not work with the grouped product. In case of bundle product, it only supports uploading images for the custom options created by admin, not the bundle items.

2.2.2. Frontend View Settings

  1. In Drop-down Option View, choose one of the following options.
  • Show image when selected: Image is only displayed when the custom option is selected.

For example:

  • Show all images: All images are displayed in each custom option. If a customer selects an option, its image will be highlighted.
  1. In Multiple Select Option View, choose one of the following options:
  • Show image when selected: Image is only displayed when the custom option is selected.
  • Show all images: All images are displayed in each custom option. If a customer selects an option, its image will be highlighted.

For example:

2.2.3 Image Size Settings

  • In Drop-down Option Image Height, set image height for drop-down option type.
  • In Drop-down Option Image Width, set image width for drop-down option type.
  • In Radio Buttons Option Image Height, set image height for radio buttons option type.
  • In Radio Buttons Option Image Width, set image width for radio buttons option type.
  • In Checkbox Option Image Height, set image height for checkbox option type.
  • In Checkbox Option Image Width, set image width for checkbox option type.
  • In Multiple Select Option Image Height, set image height for multiple select option type.
  • In Multiple Select Option Image Width, set image width for multiple select option type.

2.2.4. Upload Image for Custom Options

Go to Products ⇒ Catalog ⇒ Choose one product ⇒ Find Customizable Options

  • Click upload icon to upload image from local. Save configuration after finishing.
  • To remove the uploaded image, hover on the chosen image and click the delete icon.
  • To recover the deleted image, hover on the chosen image and click the retrieve icon.

Note: Don’t delete the custom option before saving configuration or the images uploaded for options won’t be saved.

2.3. Dependent custom options

2.3.1. General Configuration

Please go to Store ⇒ Configuration BSSCommerce ⇒ Dependent Custom Option

In Enabled: choose Yes to enable the module, or No to disable it.

*Note: When you enable/disable the module, you need to check again and set up required configs of options. It is a must to enter values for Required Options only when editing Required Options on the frontend is possible (not to be hidden or disabled).

In Children Option Values Display:

  • Be Enabled Only If the Parent Option Value is Selected: choose this option to set the children options are hidden and they will be enabled only when their parent option is picked.
  • Always be Displayed but Customers Can’t Pick If the Parent Option Value isn’t Selected: choose this option to set the children options always be shown but the checkboxes aren’t enabled until the parent option is selected.

In Children Options’ Values Depend on Multiple Parent Values: this configuration is applied when the child options depend on multiple parent options.

  • Be Enabled If At Least One Parent Value is Selected: the child options will be enabled if at least one parent option is chosen.
  • Be Enabled Only If All Parent Values are Selected: the child options will be enabled only when all parent options are chosen.

Note: The display of child options is dependent on the setting in Children Option Values Display config.

After setting, please press Save Config button and flush cache to start using the module.

2.3.2. Set Dependent Custom Options

Note:

  • The maximum number of input variables allowed in a form is set to 1000. Since our module will create two inputs per value option, the number of inputs in the saved product form may exceed this amount.
  • Please make sure that you have changed the max-input-vars of your server to a proper value. If one product has more than 50 value options, you should set the max-input-vars to 1500, for example.

Now, let’s get started setting up dependent custom options.

You need to go Customization Options section of the product edit page.

Each custom option and option value is added a unique ID number. The custom option IDs will be used to set up dependent custom options.

When there are multiple pages of custom options, you must open and view all pages so our module can save and validate all options ID.

  • In Dependent Options’ IDs: enter the custom option IDs and custom option value IDs to set them to be dependent on this option value.

Besides directly entering the option ID, You can click on the icon next to Dependent Options’ IDs field to multiple select the available option IDs to be dependent on this option value.

Note:

  • The custom options depended on other options are called children options and the option values added dependent custom options are called parent options
  • Only the custom option values in Select input types (Drop-down, Checkbox, Radio Buttons, and Multiple Select) can be the parent options.
  • All custom options and option values in any input type can be the child options.
  • The parent options and child options must be in the same product.
  • You can’t add the child option IDs that do not exist.
  • A children option can be dependent on multiple parent options.

After setting, please press Save button.

2.3.3. Frontend Display

Here we have a product includes custom options and they are set as the following:

  • Options of Size “M” and “L” are dependent on Color “Black”
  • Options of Size “L” and “XL” are dependent on Color “White”

And you set up the configuration as:

  • Children Option Values Display: Always be Displayed but Customers Can’t Pick If the Parent Option Value isn’t Selected.
  • Children Options’ Values Depend on Multiple Parent Values: Be Enabled If At Least One Parent Value is Selected.

Then, you will get the output in the frontend product page like this:

2.4. Custom option with absolute price and quantity

2.4.1. General Configs

Please go to Store ⇒ Configuration ⇒ BSSCommerce ⇒ Custom Option Absolute Price and Qty

  • In Enabled, choose Yes to enable the module, or No to disable it.
  • Tooltip Config: The tooltip that notifies customers about custom options with absolute pricing is enabled when users hover over the absolute price option. This extension allows you to customize the tooltip.
  • In Enable Tooltip: choose Yes to enable the tooltip, or No to disable it.
  • In Message in Tooltip Box: edit a message to be shown on the tooltip.
  • After completely setting, please press Save Config button to save your customization.

2.4.2. Apply Absolute Price to Custom Options

Please go to the edit page of a product then press the Customizable Options tab to create custom options for the product.

This module adds a new option “Absolute” to Price Type selection. Choose “Absolute” to set absolute pricing for the option you want.

2.4.3. Quantity Select Box for Custom Options

Check the “Qty” box to enable the Quantity Selection Box for custom options.

Here is how the absolute price and quantity of custom options are displayed in the frontend:

 

 

Was this article helpful to you? Yes No

How can we help?