General settings

In this page of the documentation, we will analyze the options included in the tab General of the plugin settings. Go to YITH Plugins > Product Add-ons > General to start.

General

General-settings-part-1

“Show add-ons” option allows to choose the position where to show add-ons within product detail page: before or after “add to cart” button.

“Add to cart” button label: customize the text of the cart button if you want to.

Show product price in “cart” page: check this option if you want to show the product base price in the cart.

Always show the price table: check this option if you want to show the price table on the product page, even if the add-ons price is equal to zero.

Add-ons

For each add-on created, the plugin allows combining label, description and image. According to the settings, in plugin settings dashboard (in the highlighted options in the image) information will be shown or not in product detail page.

If you want to show only the add-ons without the regular price of each product in the “Cart” page, disable the “Show product price on cart page” option.

Enable the option Show add-ons collapsed if you want to collapse the add-on options when the page is loaded. Users will find an arrow icon to open the add-on details.

collapsed

Options

Options - User view.
  • “Show option images”: show the image related to the option included in the add-on
  • Date format: this option will let you choose the date format in the add-on options.

Tooltip

Tooltips are used to show the description related to the option. To disable the use of tooltips or to change their layout, use the options you find in the “Tooltip” section of the plugin settings dashboard.

tooltip
Tooltip - User view.

Upload

“Upload” section refers to add-ons of “file” typology.

 uploading options
file upload

All files uploaded by users will be saved in the path you have specified in “Uploading folder name”, within “uploads” folder.
To be accepted, the file must have one of the formats specified in “Uploading file types” and its size must be less than the value specified in “Uploading File size” option.

How to create a new options group

Firstly, it essential to create an options group including all the add-ons we want to insert in one or more products of the shop.

Go to “Products -> Product Add-Ons” and click on “Add New”.

New options group

Assign a name to the group and choose to which products you want to associate it.

The plugin allows to create three “typologies” of options group:

  • “global”: options are inserted to all the products of the shop
  • “by category”: the options group is applied to the products related to one or more specified categories
  • “by product”: the options group is used only on the selected product. For further information about how to create an options group from the product editing page, we suggest reading this page of the documentation.

Configure options group

Before inserting all the options of the group, configure the following parameters:

  • “Priority”: the priority is used to give an order to show the options group in product page (in value ascending order)
  • “Visibility”: the option allows to choose to hide the options group, to show it to all users or only to the admnistrator of the shop.

By way of example we have decided to create an options group that will be shown only on “Ring” product.

Duplicate groups

If you need to create a group with similar add-ons, consider the possibility of duplicating a group.

From the page where all groups are listed, click on the duplicate icon as shown in the following image:

Duplicate group

An exact copy of the group will be created, including all the items in it. Start editing the ones that need to be changed and leave the others unchanged. This button will let you save a lot of time!

Create a new add-on

The next step is creating and configuring the add-ons you want to insert in the group you have just created. Make sure you saved the group settings and click on the “Manage Add-Ons” button on the top of the page.Manage Add-OnsNow choose the type of add-on that you want to insert from the following ones:

  • checkbox
  • color
  • date
  • labels
  • multiple labels
  • number
  • select
  • radio button
  • text
  • textarea
  • upload

Types of add-on

Optionally, you can combine to the add-on “labels”,“description” and “image”.

add-on new

To enable/disable the display of add-on details, go to “General” section of the plugin settings dashboard.

add ons general

By setting the add-on as “required”, users cannot add the product to cart if they do not use the options related to the add-on.
When a “checkbox” type add-on is set as “required”, all its options must be selected by the user in order to add the product to the cart.

Set Dependencies

The view of the add-on can depend on two kinds of dependencies:

dependencies

  • Variation requirements: the add-on can only be selected if a specific product variation has been selected and specified in the “Variations Requirement” entry.
  • Options requirements: the add-on is only shown when the option specified in the requirements entry is selected by the user. If the user does not respect the requirement you have set, the add-on is not shown.

Sold individually

If you enable the “Sold Individually” option, the add-on price won’t change even if the quantity of the selected product increases.

sold individually

The first X options free

You can decide that the first x options a customer chooses are for free. Example:

For the add-on “Pizza ingredients” with 4 options (sauce, peas, cheese, chips),
the customer can add 2 ingredients for free and the others are + € 0,50
In this case you would set an add-on price of € 0,50 and “First X options free” = 2.

options free

Duplicate add-on

If you need to create an add-on with similar options, consider the possibility of duplicating an add-on.

From the page where all add-ons are listed, click on the duplicate icon as shown in the following image:

Duplicate Add-on

An exact copy of the add-on will be created, including all the options in it. Start editing the ones that need to be changed and leave the others unchanged. This button will let you save a lot of time!

Add options

The third and last step of the configuration of a new add-on is related to the option addition associated to it.

Please note: in order to show the add-on, you must insert at least one option.

With the ‘drag and drop’ option you can sort the list of options.

ring options

Specify for each of them the following values:

  • Option label: the text to identify this option on the frontend
  • Description: enter here details about this option (valid for all types of add-ons except for Select)
  • Placeholder: the placeholder text shown if no text has been entered by the user yet. Use this to help your users have more information about how to use the option (valid only for Date, Number, Text and Textarea types of add-ons)
  • Tooltip: type the text that will be shown as a tooltip (valid for all types of add-ons except for Select)
  • Price: the price associated with the option can be calculated in 4 different ways depending on the related add-on type
    • fixed price (valid for all add-on types)
    • percentage price: based only on the basic price of the product (valid for all the add-on types)
    • multiplied by the length of the string: the option base price is multiplied by the length of the text string the user inserted in the option (valid only for Text and Textarea add-on types)
    • multiplied by the option value: the option base price is multiplied by the value the user inserted in the option (valid only for Number type add-ons)
  • “Min/Max”: these values can be configured if the add-on is of “number” typology
  • “checked”: if the add-on is of “checkbox” typology, it can be used to set a single product as “checked”
  • “Hide label”: hide label and only show input field

To enable/disable the display of add-on option details, go to “General” section of the plugin settings dashboard.

Global options - Options

This is how our add-on is shown on the frontend.

Add-on example

Duplicate options

If you need to create an option similar to an existing one, consider the possibility of duplicating the option.

From the page where all options are listed, click on the duplicate icon as shown in the following image:

Duplicate option

An exact copy of the option will be created, including its details. Start editing the parts that need to be changed and leave the others unchanged. This button will let you save a lot of time!

Duplicated option

Calculate quantity by values

Did you insert a number type add-on in the product? Only in this case you can set the product quantity as the sum of the option values for the number type add-on. How to do it? Enable the Calculate quantity by values amount entry for the number type add-on as shown in the following image.

Enable Calculate quantity by values amount option

In this way, the product quantity to add to the cart will be given by the values amount the user inserted in the number type fields.

Product quantity

Replace the product image

For each add-on you have created, you can enable the product image “replace” feature in case the user selects the add-on.

Enable Replace The Product Image option

To allow this action, it is essential to apply the following conditions:

  • the “Replace the product image” option must be enabled on the add-on
  • you must associate an image with the add-on or with its single options

Set image for add-on

When the user will select the add-on, the system will dynamically replace the highlighted product image with the one associated with the option or with the add-on.

If you have problems switching images with your theme, you can try to enable the “Alternative ‘Replace Image’” option to use an alternative method.

alternative replace image

Single product options

The plugin adds the dedicated “Product Add-Ons” section in each product editing page through which you can manage the view of the add-ons for the related product.

If you want to edit one of the options groups created with general rules, click on the “Manage all groups” button.

New options group

If you want to disable the global add-ons on the product, you must enable the “Disable globals” option.

Disable globals

Add-on creation

Insert the group name and click on the “Add group” button to create an options group associated only with the selected product.

Add group

Now you can follow all the directions that you find in this page of the documentation.

Creation of attributes

YITH WooCommerce Product Add-Ons allows you to create custom attributes for your product variations.
In this page, we will configure attributes together step by step, so that the way to do that will be as clear as possible.

Click on Products > Attributes and you’ll see a page like this.

Edit attribute

To create a new attribute, you have to fill the following fields:

  • Name: name of the attribute displayed in front end
  • Slug: slug of the attribute (maximum lenght: 28 characters)
  • Enable Archives: enable this if you want this attribute to have product archives in your store.
  • Type: attribute type. Beside standard WooCommerce types, the plugin adds attribute types: Colorpicker, Image and Label.
  • Default sort order: order to sort attribute terms
  • Description: attribute description

In the example we are going to show you, we have chosen “colors” attribute

New attribute

Configuration of terms

Once you have created an attribute, you have to add variations of it. Click on the button shown to enter the first variation.

Configure terms

To add a new color, specify the following required options:

Add new term

  • Name: color name (shown in frontend)
  • Slug: slug for attribute variation
  • Description: description associated to the attribute variation, shown in front end
  • Colorpicker: choose the colour you want to assign to the current attribute variation using a colorpicker
  • Tooltip: tooltip associated to the attribute variation and shown in product page

In our example, we have entered the following colors:

  • black
  • blue
  • grey
  • orange
  • purple

Terms configurated

You can create new product variations directly from product detail page.
Open a product and, after adding an attribute, click on Add New to add a new variation.

Create new term

In our example, the attribute type is “colorpicker” and, therefore, in the modal window that opens we will have to add colours for the new variation.

Attribute variation

Add attributes to the product

To associate the attribute “Colors” to the product, do exactly as you would do for any other attribute belonging to WooCommerce types.
Add the new attribute and values in the section Attributes in product page.

Attribute section

Once you have configured product settings through the created color attribute, we will see something like this in product detail page.

Product detail page