Nudgio Technologies

Sign up at nudgio.tech
Create a WooCommerce connection
Go to the connection's "API Keys" tab
Click "Generate Key" — save the secret immediately (shown once)

Edit any page or product → click the "+" block inserter
Search for "Nudgio Technologies" (under WooCommerce category)
Select the block → configure 35 visual settings in the sidebar, organized in 8 groups
Publish — the widget renders automatically with your settings

Is my API secret secure?
Yes. The API secret is encrypted before storage in WordPress. It never appears in your page source — only the Key ID, timestamp, nonce, and HMAC signature are included in widget URLs.
What shortcode attributes are available?
Algorithm / Data:
* type — bestsellers, cross-sell, upsell, similar (default: bestsellers)
* count — number of products to show (default: 4)
* product_id — specific product ID (auto-detected on product pages)
* lookback_days — order data lookback period (default: 30)
* method — bestseller method: volume, value, balanced (default: volume)
* min_price_increase_percent — upsell price threshold (default: 10)

Widget Container:
* widget_bg_color — hex color for widget background (default: #FFFFFF)
* widget_padding — padding in pixels (default: 16)

Widget Title:
* widget_title — custom widget heading (leave empty for auto-default)
* title_color — hex color for title (default: #111827)
* title_size — font-size in pixels (default: 24)
* title_alignment — left, center (default: left)

Layout:
* widget_style — grid, carousel (default: grid)
* widget_columns — max columns at full width, 1-6 (default: 4)
* gap — gap between cards in pixels (default: 16)
* card_min_width — minimum card width in pixels (default: 200)
* card_max_width — maximum card width in pixels, 0 = no limit (default: 0)

Product Card:
* card_bg_color — hex color for card background (default: #FFFFFF)
* card_border_radius — border radius in pixels (default: 8)
* card_border_width — border width in pixels (default: 0)
* card_border_color — hex color for card border (default: #E5E7EB)
* card_shadow — none, sm, md, lg (default: md)
* card_padding — card content padding in pixels (default: 16)
* card_hover — none, lift, shadow, glow (default: lift)

Product Image:
* image_aspect_w — image aspect ratio width, 1-20 (default: 1)
* image_aspect_h — image aspect ratio height, 1-20 (default: 1)
* image_fit — cover, contain (default: cover)
* image_radius — image border radius in pixels (default: 8)

Product Title:
* product_title_color — hex color for product title (default: #1F2937)
* product_title_size — font-size in pixels (default: 14)
* product_title_weight — CSS font-weight 100-900 (default: 600)
* product_title_lines — max lines before truncation, 1-3 (default: 2)
* product_title_alignment — left, center (default: left)

Price:
* show_price — show product price: true/false (default: true)
* price_color — hex color for price (default: #111827)
* price_size — font-size in pixels (default: 18)

CTA Button:
* button_text — button text, e.g. View, Shop Now (default: View)
* button_bg_color — hex color for button background (default: #3B82F6)
* button_text_color — hex color for button text (default: #FFFFFF)
* button_radius — button border radius in pixels (default: 6)
* button_size — font-size in pixels (default: 14)
* button_variant — solid, outline, ghost (default: solid)
* button_full_width — stretch button to full width: true/false (default: false)
Do cross-sell/upsell/similar work on non-product pages?
These types require a product context. On non-product pages, the shortcode outputs nothing unless you specify a product_id attribute explicitly.