Smart Add-Ons
Smart Add-Ons documentation
Smart Add-Ons documentation for installation and setup: download the plugin, activate your license, and create your first add-on group — no server configuration required.
- WordPress 6.4+
- PHP 8.1+
- WooCommerce 8.0+
No server configuration needed. Smart Add-Ons connects to Dhyan Cloud automatically after license activation. You do not need to edit wp-config.php — install, activate your key, and start building.
1
Purchase & download
- Checkout on dhyansoftware.com/shop.
- Open My Account → Downloads and download
smart-addons-upsell-engine-v1.0.0.zip.
2
Install the plugin
- Go to Plugins → Add New → Upload Plugin.
- Choose the ZIP, click Install Now, then Activate.
- WooCommerce must already be installed and active.
3
Activate license
- Open Smart Add-Ons → License in wp-admin.
- Paste your key (
ADDF-XXXX-XXXX-XXXX-XXXX) and click Activate License.
4
Create your first add-on group
- Go to Smart Add-Ons → Add-On Groups → Add Group.
- Add fields, set pricing and rules, then assign the group to products.
- Preview the product page on the storefront.
First add-on group — field checklist
- Add fields — text, textarea, checkbox, radio, dropdown, image select, file upload, date picker, or custom price
- Set pricing (fixed, percentage, or formula), conditional rules, and validation as needed
- Assign to products, categories, or globally; optionally exclude global groups per product
- Save and view the product page on the storefront (classic or block theme)
Guides
Popular Smart Add-Ons guides
Jump to the most-used setup and configuration articles.
Key features
- Conditional logic — show or hide fields and groups based on other selections
- Group visibility — restrict by user role or date schedule; accordion layout on storefront
- Import / export — JSON backup and reusable group templates for faster setup
- File uploads & Blocks checkout — secure customer uploads with admin download from orders; works with Cart & Checkout blocks
Developers
Extend Smart Add-Ons
PHP hooks & filters, a documented REST API, and custom field types — extend without forking the plugin.
Developer customization
Smart Add-Ons exposes WordPress filters and actions so agencies and developers can extend behavior without forking the plugin. Add these in a custom plugin or your child theme’s functions.php.
Available hooks
| Hook | Type | Arguments | Purpose |
|---|---|---|---|
saue_addon_groups_for_product | filter | $groups, $product_id | Modify which add-on groups load for a product (storefront, cart, REST). |
saue_register_field_types | action | $registry | Register custom field types on the FieldTypeRegistry. |
saue_addon_group_saved | action | $group_id | Runs after a group is saved and its cache is invalidated. |
saue_addon_field_deleted | action | $field_id | Runs when an add-on field is deleted from the builder. |
saue_integrations_loaded | action | — | Fires after optional integration modules (Subscriptions, Bookings, WPML) register. |
saue_subscriptions_addon_groups | filter | $groups, $product_id | Adjust add-on groups on WooCommerce Subscriptions renewal orders. Requires WooCommerce Subscriptions. |
saue_bookings_before_product_addons | action | $product_id | Inject booking context before add-ons render on bookable products. Requires WooCommerce Bookings. |
saue_before_render_product_addons | action | $product_id | Run custom logic immediately before the React add-on UI mounts. |
saue_translate_string | filter | $value, $context, $name | Translate group, field, and option labels (WPML bridge included). |
saue_locate_template | filter | $path, $template | Override PHP template paths (for example order upload list). |
saue_addon_field_html | filter | $html, $field, $product_id | Inject supplemental PHP HTML before the React add-on UI per field. |
Example — hide a group for wholesale customers
add_filter( 'saue_addon_groups_for_product', function ( $groups, $product_id ) {
if ( ! current_user_can( 'wholesale_customer' ) ) {
return $groups;
}
return array_values( array_filter(
$groups,
static fn ( $group ) => ( $group['slug'] ?? '' ) !== 'retail-only-upsell'
) );
}, 10, 2 );Storefront UI is React-based; most layout and styling is controlled from Smart Add-Ons → Appearance in wp-admin. Full references: Hooks & Filters and REST API (saue/v1/*).
Troubleshooting
| Issue | Fix |
|---|---|
| Activation failed | Confirm your site can reach the internet and that the key matches your product (ADDF- prefix). Re-enter the key and try again. |
| Wrong checkout price | Clear cart cache and update the plugin to the latest version from My Account → Downloads. |
| Price preview error | Hard refresh the product page; confirm your license is active under Smart Add-Ons → License. |
Still stuck? Email support@dhyansoftware.com with your license key and site URL — or open a ticket from the support page.