WooCommerce Integration

Installation Guide

Install our official WordPress plugin for the easiest setup — automatic product detection, admin settings panel, category exclusions, and shortcode support.

Download Plugin

gunupdate-woocommerce.zip — v1.0.0

Download .zip

1 Install Plugin

Go to WordPress Admin → Plugins → Add New → Upload Plugin. Select the downloaded gunupdate-woocommerce.zip and click Install Now. Then click Activate.

2 Configure Settings

Go to WooCommerce → GunUpdate Widget. Enter your API key, choose widget mode, position, and theme. Click Save Settings.

3 Test Connection

Click the Test API Connection button on the settings page. If successful, visit any product page to see the widget.

Shortcode

If you set position to "Manual", use the shortcode in your product templates:

[gunupdate]
[gunupdate mode="builder"]
[gunupdate mode="configurator"]

Category Exclusion

In the settings panel, check categories where the widget should NOT appear (e.g., "Apparel", "Gift Cards"). The widget will only show on product pages in unchecked categories.

Custom Styling

Add custom CSS in the settings panel to match your theme:

#gunupdate-widget {
    margin-top: 20px;
    border-radius: 12px;
}
#gunupdate-widget .gu-btn-primary {
    background: #your-brand-color;
}

Widget Modes

compatibility

"Does this fit my gun?" — customer uploads photo or selects model, gets yes/no answer + compatible products from your store.

builder

Interactive gun builder — clickable hotspot zones on a gun silhouette. Customers explore accessory categories visually.

configurator

Full experience — build + compatibility check + smart recommendations. Best for stores with 50+ gun accessories.

Data Attributes Reference

Attribute	Required	Description
data-store	Yes	Your API key
data-product-id	Yes	Product ID on your platform
data-product-name	No	Product name for better matching
data-product-sku	No	SKU for precise matching
data-mode	No	compatibility \| builder \| configurator
data-theme	No	light \| dark \| auto
data-platform	No	Platform identifier for analytics
data-lang	No	Language code (default: en)