Phase 2 — Installation & Setup
Install the plugin, connect test credentials, and configure storefront settings.
Install Harmony’s Plugin
You’ll receive woocommerce-harmony.zip via email.
Option A — Dashboard Upload
- Plugins → Add New → Upload Plugin.
- Select the ZIP file and click Install Now.
- Activate the plugin once installed.
Option B — SFTP Upload
- Unzip locally to
woocommerce-harmony. - Upload to
/wp-content/plugins/. - Activate in WordPress.
Troubleshooting: upload_max_filesize limit
Add the following to .htaccess:
php_value upload_max_filesize 64M php_value post_max_size 64M php_value memory_limit 256M
Or add to wp-config.php:
@ini_set( 'upload_max_filesize', '64M' ); @ini_set( 'post_max_size', '64M' ); @ini_set( 'memory_limit', '256M' );
Verify Activation
Once active, the Harmony tab appears under WooCommerce → Settings.
Connect Test Credentials
- WooCommerce → Settings → Harmony → API.
- Enter Username + Password.
- Save changes, then click Test Connection.
Create Insurance Information Page
- Pages → Add New → “Insurance Information”.
- Paste the legal disclosure text provided by Harmony.
- Publish and select it in Harmony → Display tab.
Add this page to your website footer for compliance visibility.
Assign Insurance to Products
Method A — Categories (Recommended)
- Products → Categories → Edit a category.
- Enable Harmony Insurance toggle.
- Select Insurance Type + Condition.
Method B — Individual Products
- Products → All Products → Edit.
- Open Harmony tab in Product Data.
- Override insurance configuration as needed.
Configure the Insurance Modal
The Insurance Modal is the popup that lets customers review coverage and add insurance to cart. Match it to your brand by adjusting colors and radius.
- WooCommerce → Settings → Harmony → Styling.
- Set primary color, border radius, and offer styling.
- Preview by opening a product with insurance enabled.
Customer View
This is what shoppers see before adding insurance to their cart.
Next: Phase 3