- Download the extension from your FreeWP Dashboard.
- Go to Plugins > Add New > Upload and select the ZIP file you just downloaded.
- Click Install Now, and then Activate.
FreeWP Woocommerce Product Add-Ons
Installation
Setup and Configuration
FreeWP WooCommerce Product Add-Ons enables you to add customizable options to either multiple products in bulk or specific individual products within your catalog:
- For bulk customization, you can create global add-ons, which can optionally be restricted to certain product categories.
- For individual products, you can set up per-product add-ons. Additionally, you have the flexibility to exclude global add-ons from being applied to any specific product.
Global Add-Ons
To create global add-ons, navigate to Products > Add-Ons and click on Create your first add-on.
Global add-ons are arranged into groups, each of which includes the following settings:
- Name: A unique identifier for each global add-ons group, not visible to customers.
- Product Categories: By default, global add-ons apply to all products in your store. This option allows you to restrict specific add-on groups to selected product categories.
- Display Order: This number determines the position of the add-ons group on product pages. Groups with a lower display order appear higher on the product page. Individual product add-ons are displayed at order 10 by default.
To add a new field to a group, simply select the desired add-on type from the Add field dropdown menu.
Per-Product Add-Ons
To create add-ons for specific products:
- Locate and edit the desired product in your store.
- Navigate to the Product data > Add-ons tab.
- Choose an add-on type from the Add field dropdown menu.
Alternatively, you can import existing add-ons from another product.
If you want to prevent a product from inheriting global add-ons, simply uncheck the Use Global Add-Ons? option.
Add-On Types
The extension supports the following types of add-on fields:
- Multiple Choice: Displays a list of options as dropdowns, images, or radio buttons. Users can select one option per add-on.
- When using radio buttons, a default “None” option is automatically included.
- Checkboxes: Provides a list of checkboxes, allowing users to select multiple options.
- Short Text: Displays a text field for users to input text. You can restrict the input to specific formats, such as any text, letters only, numbers only, alphanumeric characters, or email addresses.
- Long Text: Offers a larger text field for multi-line input. You can also set a character limit.
- File Upload: Includes a button that allows users to upload files.
- Customer-Defined Price: Displays a field where users can enter a custom numerical value, which is added to the product price.
- Quantity: Provides a field for users to specify a custom quantity.
- Heading: Adds a heading to organize add-ons into sections.
- Date Picker: Displays a calendar for customers to choose a specific date.
Multiple Choice
The Multiple Choice add-on provides customers with a list of options to choose from.
- Title: Displays the add-on’s title above the options. You can format the title as a label, a heading, or hide it entirely.
- Display as: Options can be shown as a dropdown menu, a group of radio buttons, or a set of images.
- Add Description: Enabling this option allows you to include additional details about the add-on. The description appears below the title and supports HTML formatting.
- Require Selection: This option ensures customers must configure the add-on before they can add the product to their cart.
Use the Add Option button to create individual choices. For each option, you can specify a label and, optionally, a price. Pricing options include:
- A flat fee.
- A dynamic price based on product quantity.
- A percentage of the total product price.
Checkboxes
The Checkboxes add-on presents a list of additional options as checkboxes, ideal for offering product upgrades or extra services, like gift wrapping. Customers can select multiple checkboxes.
- Title: Displays the add-on title above the checkboxes. The title can be formatted as a label, a heading, or hidden altogether.
- Add Description: Enables you to include extra details about the add-on. The description appears below the title and supports HTML for additional customization.
- Require Selection: This option makes it mandatory for customers to configure the add-on before adding the product to their cart.
To create checkbox fields, use the Add Option button. For each checkbox, you can provide a label and optionally set a price. Pricing options include:
- A flat fee.
- A dynamic price based on the product quantity.
- A percentage of the total product price.
Short Text
The Short Text add-on provides a small text field for customers to input information. This add-on is perfect for collecting personal details, such as a name or email address, or for product customization, like adding an engraving or printed text.
- Title: Displays the add-on’s title above the text field. You can format the title as a label, a heading, or hide it completely.
- Restriction: By default, customers can enter any text. This option allows you to restrict input to Only Letters, Only Numbers, Letters and Numbers, or Email Addresses Only.
- Add Description: Enables additional information to be displayed below the title. The description supports HTML for enhanced formatting.
- Add Placeholder: Allows you to display a placeholder text in the field as a guide for customers.
- Require Input: Ensures customers must fill out this field before adding the product to their cart.
- Limit Character Length: Lets you specify the maximum number of characters that customers can enter.
- Adjust Price: Allows you to add an additional cost for the add-on. The price can be:
- A flat fee.
- Calculated dynamically based on product quantity.
- A percentage of the product’s total price.
Long Text
The Long Text add-on provides a large text field where customers can input longer messages, making it ideal for gift notes, special instructions, or custom requests.
- Title: Displays the title of the add-on above the text field. You can format it as a label, a heading, or hide it entirely.
- Add Description: Allows you to include additional details below the title. The description supports HTML for enhanced customization.
- Add Placeholder: Enables you to add placeholder text within the field to guide customers.
- Require Input: Ensures that customers must fill in this field before adding the product to their cart.
- Limit Character Length: Lets you specify a maximum number of characters that customers can enter into the field.
- Adjust Price: Allows for an extra cost to be associated with the add-on. The pricing can be:
- A flat fee.
- Dynamically calculated based on the product quantity.
- A percentage of the total product price.
File Upload
The File Upload add-on provides a button that allows customers to upload their own images, making it perfect for designing custom products like t-shirts, mugs, or business cards.
- Title: Displays the add-on’s title above the upload button. You can format the title as a label, a heading, or hide it altogether.
- Add Description: Allows you to include additional details about the add-on. The description is displayed below the title and supports HTML for customization.
- Require Upload: Ensures customers must upload a file before adding the product to their cart.
- Adjust Price: Lets you add an extra cost for the add-on. The pricing options include:
- A flat fee.
- Dynamic pricing based on product quantity.
- A percentage of the total product price.
Uploaded files are displayed below the line item when editing an order. They are also included in the order confirmation emails sent to the site administrator and the customer. Files are saved in the following location:
wp-content/uploads/product_addons_uploads/{customer-id-md5-hash}/filename.ext
Customer-Defined Price
The Customer-Defined Price add-on allows shoppers to specify the amount they wish to pay, which is then added to the total product price. This feature is ideal for accepting donations or letting customers include a tip with their order.
- Title: Displays the add-on title above the text field. You can format it as a label, a heading, or hide it completely.
- Add Description: Enables you to provide additional information about the add-on. The description is displayed below the title and supports HTML for enhanced customization.
- Require Input: Ensures that customers must enter a value before adding the product to their cart.
- Limit Price: Allows you to define a price range, setting minimum and maximum values for the amount customers can enter.
Quantity
The Quantity add-on provides a field where customers can specify a custom quantity for their order.
- Title: Displays the title of the add-on above the quantity field. The title can be formatted as a label, a heading, or hidden entirely.
- Add Description: Allows you to include additional details about the add-on. The description appears below the title and supports HTML for customization.
- Require Input: Ensures customers must specify a quantity before adding the product to their cart.
- Limit Quantity: Enables you to define a range, setting minimum and maximum quantities that customers can input.
- Adjust Price: Lets you add an extra cost associated with the add-on. Pricing options include:
- A flat fee.
- Dynamic calculation based on the entered quantity.
- A percentage of the product’s total price.
Heading
The Heading add-on adds a section heading to the product page, making it useful for organizing and grouping add-ons into distinct sections.
- Add Description: Allows you to include additional details about the heading. The description is displayed below the title and supports HTML for enhanced customization.
Date Picker
The Date Picker add-on displays a calendar that allows customers to select a specific date.
- Title: Displays the add-on title above the date picker field. The title can be formatted as a label, a heading, or hidden entirely.
- Add Description: Enables you to provide additional details about the add-on. The description is displayed below the title and supports HTML for enhanced customization.
- Require Selection: Ensures customers must select a date before adding the product to their cart.
- Adjust Price: Allows you to add an extra cost associated with the add-on. Pricing options include:
- A flat fee.
- Dynamic calculation based on product quantity.
- A percentage of the product’s total price.
Add-On Pricing Options
Add-ons can be either free or paid, with paid add-ons increasing the total product price based on the pricing model selected.
Paid add-ons offer the following pricing options:
- Flat Fee: The price is applied only once, regardless of the quantity ordered.
- Quantity-Based: The price is multiplied by the total quantity of the product ordered.
- Percentage-Based: The price is calculated as a percentage of the product’s total price.
Importing and Exporting Add-Ons
You can easily transfer add-ons between products or global add-on groups using the Import and Export buttons in the add-ons configuration screen.
Importing/Exporting Per-Product Add-Ons
Navigate to the Product Data > Add-ons tab to manage per-product add-ons.
Importing/Exporting Global Add-Ons
Access the Products > Add-ons tab to handle global add-ons.
Exporting Add-Ons
- Click the Export button.
- A success message will confirm that the add-ons data has been copied to your clipboard.
Importing Add-Ons
- Click the Import button.
- Paste the copied add-on data into the popup field that appears.
- Click OK. A success message will confirm the successful import, and the new add-ons will be added to the product or global add-ons group.
- Click Update to save your changes.