Skip to content
WooCommerce & WordPress Plugin Docs

Getting started

Requirements

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

Setup

Section titled “Setup”
  1. Upload the plugin to /wp-content/plugins/aldono, 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, Textarea, Number, Date, Checkbox, Select or Radio. For Text and Textarea you can also set Min chars and Max chars.
  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 or Radio type, fill the choices 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 or radio 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 or radio 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.

The input is checked too: a number must be numeric, a date must be a real date, a select or radio must post one of its own choices, and text or textarea must respect its character limits. See Field types.

Free and PRO boundary

Section titled “Free and PRO boundary”

The free edition covers seven field types (text, textarea, number, date, checkbox, select and radio), free or priced, with validation and cart/order display. Aldono Pro adds conditional logic, file uploads, quantity pricing, select swatches and per-option inventory. See Aldono Pro.

Next steps

Section titled “Next steps”

Need help?

Section titled “Need help?”