Zum Inhalt springen
WooCommerce & WordPress Plugin Docs

Getting started

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

Requirements

Section titled “Requirements”
  • WordPress 6.5 or newer.
  • WooCommerce active. Add-Ons does nothing without it (Requires Plugins: woocommerce).
  • PHP 8.1 or newer.

Setup

Section titled “Setup”
  1. Upload the plugin to /wp-content/plugins/addons, or install it via Plugins → Add New.
  2. Activate it. WooCommerce must be active.
  3. The feature is on by default. To confirm, open WooCommerce → Add-Ons and check that Enable add-ons is ticked.

The WooCommerce → Add-Ons screen is store-wide display only, it does not hold any product’s fields. You define those on each product.

Adding options to a product

Section titled “Adding options to a product”
  1. Edit a product and open the Add-Ons tab in the Product data panel. The tab shows on simple and variable products.
  2. Click Add option. Each row is one field on the product page.
  3. Set the Label (for example Gift wrap or Engraving text).
  4. Choose the Type: Text, Checkbox or Select.
  5. Add a Price to charge for the option, or leave it blank for a free option. Negative prices are not allowed, a delta is always a surcharge.
  6. Tick Required if the product cannot be added to the cart until the field is filled.
  7. For a Select type, fill the options box, one choice per line as Label | price, for example Standard | 0 and Premium | 9.99. Omit the price for a free choice. A select with no choices is skipped on the front end.
  8. Update the product.

How the price adjusts

Section titled “How the price adjusts”

When a shopper picks a paid option, its price is added to that product’s cart line total automatically, recalculated on WooCommerce’s woocommerce_before_calculate_totals. For a select field, each choice can carry its own price, and the chosen option’s price wins over the field’s base price. The selections are stored on the cart line and copied onto the order as line-item meta.

Validation

Section titled “Validation”

Required fields are checked when the product is added to the cart, through WooCommerce’s woocommerce_add_to_cart_validation. If a required field is empty, the product is not added and the shopper sees a notice naming the field, Please complete the “Engraving text” option before adding to cart.

Free and PRO boundary

Section titled “Free and PRO boundary”

The free edition covers text, checkbox and select fields, free or priced, with required-field validation and cart/order display. Add-Ons Pro adds conditional logic and file uploads. See Add-Ons Pro.

Next steps

Section titled “Next steps”

Need help?

Section titled “Need help?”