Title: Nudgio Technologies
Author: rbtrsv
Published: <strong>April 6, 2026</strong>
Last modified: April 8, 2026

---

Search plugins

![](https://ps.w.org/nudgio-technologies/assets/icon-256x256.png?rev=3501109)

# Nudgio Technologies

 By [rbtrsv](https://profiles.wordpress.org/rbtrsv/)

[Download](https://downloads.wordpress.org/plugin/nudgio-technologies.1.4.0.zip)

 * [Details](https://sa.wordpress.org/plugins/nudgio-technologies/#description)
 * [Reviews](https://sa.wordpress.org/plugins/nudgio-technologies/#reviews)
 *  [Installation](https://sa.wordpress.org/plugins/nudgio-technologies/#installation)
 * [Development](https://sa.wordpress.org/plugins/nudgio-technologies/#developers)

 [Support](https://wordpress.org/support/plugin/nudgio-technologies/)

## Description

Nudgio Technologies connects your WooCommerce store to the Nudgio recommendation
engine to display personalized product recommendations on your storefront.

**Features:**

 * Bestseller recommendations based on real order data
 * Cross-sell recommendations (“frequently bought together”)
 * Upsell recommendations (higher-priced alternatives)
 * Similar product recommendations
 * Simple `[nudgio]` shortcode with customizable attributes
 * Gutenberg block with 35 visual settings in 8 organized groups — no shortcodes
   needed
 * Auto-detects WooCommerce product ID on product pages
 * HMAC-signed URLs — your API secret never appears in page source
 * Full visual customization: widget container, title, layout, card, image, product
   title, price, and CTA button
 * Iframe-based rendering — no CSS conflicts with your theme
 * Auto-resizing iframes — content height adjusts automatically

**Requirements:**

 * A Nudgio account with an active connection ([nudgio.tech](https://www.nudgio.tech))
 * An API key generated from your Nudgio dashboard (Connection  API Keys tab)
 * WooCommerce 7.0 or later
 * PHP 8.0 or later

**Third-Party Service:**

This plugin connects to the Nudgio recommendation engine ([nudgio.tech](https://www.nudgio.tech))
to generate and display product recommendations. When a page containing a Nudgio
shortcode or block is loaded, the plugin sends an HMAC-signed request to the Nudgio
server with the Key ID, widget configuration parameters, and product ID (if applicable).
No personal visitor data is collected or transmitted.

 * [Terms of Service](https://www.nudgio.tech/legal/terms-of-service)
 * [Privacy Policy](https://www.nudgio.tech/legal/privacy-policy)

## Blocks

This plugin provides 1 block.

 *   Nudgio Technologies Display AI-powered product recommendations from Nudgio.
   Supports bestsellers, cross-sell, upsell, and similar products with 35 visual
   settings in 8 groups.

## Installation

 1. Upload the `nudgio` folder to `/wp-content/plugins/`
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Go to Settings  Nudgio Technologies
 4. Enter your Key ID and API Secret from the Nudgio dashboard
 5. Click “Test Connection” to verify
 6. Add recommendations using the Gutenberg block (recommended) or `[nudgio]` shortcodes

## FAQ

### How do I get an API key?

 1. Sign up at [nudgio.tech](https://www.nudgio.tech)
 2. Create a WooCommerce connection
 3. Go to the connection’s “API Keys” tab
 4. Click “Generate Key” — save the secret immediately (shown once)

### How do I use the Gutenberg block?

 1. Edit any page or product  click the “+” block inserter
 2. Search for “Nudgio Technologies” (under WooCommerce or Plugins category)
 3. You can build your widget visually using the 35+ settings in the sidebar, OR paste
    a Preset Slug (auto-generated when you save a preset in the Nudgio dashboard  Widgets)
 4. Publish — the widget renders automatically

### 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.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Nudgio Technologies” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ rbtrsv ](https://profiles.wordpress.org/rbtrsv/)

[Translate “Nudgio Technologies” into your language.](https://translate.wordpress.org/projects/wp-plugins/nudgio-technologies)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/nudgio-technologies/),
check out the [SVN repository](https://plugins.svn.wordpress.org/nudgio-technologies/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/nudgio-technologies/)
by [RSS](https://plugins.trac.wordpress.org/log/nudgio-technologies/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.4.0

 * Updated documentation across all platforms to reflect Widget Presets V3 architecture
 * Gutenberg block instructions now mention both visual builder (35+ settings) and
   Preset Slug options
 * Settings page Account & Subscription section updated

#### 1.3.9

 * Removed 35 Default Widget Settings from Settings page — replaced by Global Default
   Preset slug
 * Added “Manage Widgets” link to Nudgio dashboard for creating and editing Widget
   Presets
 * Gutenberg block retains all 35 visual controls for on-the-fly editing — preset
   field on top for saved configurations
 * Shortcode defaults now hardcoded — no longer read from wp_options (power-user
   overrides still work)
 * Shortcode auto-applies Global Default Preset when no preset attribute is specified
 * Updated Shortcode Usage documentation with preset-first examples
 * Cleaned up activation defaults and uninstall cleanup

#### 1.3.8

 * Added preset TextControl to Gutenberg block sidebar — merchants can now set preset
   slug directly in the block editor
 * Fixed Gutenberg block render.php — preset attribute now correctly passed to shortcode
   handler
 * Fixed empty widget hiding in widget.js — universal JS snippet now hides widgets
   with no recommendations
 * Fixed Gutenberg edit function name for React hooks ESLint compliance
 * Aligned block.json and index.asset.php version strings

#### 1.3.7

 * Added preset attribute for widget presets — [nudgio preset=”your-slug”] loads
   complete widget config from Nudgio dashboard
 * Empty widget fix — widgets with no recommendations now hide completely instead
   of leaving blank space
 * Added preset attribute to Gutenberg block

#### 1.3.6

 * Updated WC tested up to from 9.0 to 10.6
 * Updated WP tested up to from 6.9 to 6.9.4
 * Fixed translation loading timing (moved to init hook)
 * Removed invalid contributor from readme

#### 1.3.5

 * Added Widget Container and Widget Title panels to Gutenberg block sidebar
 * Widget Container panel includes widget_padding RangeControl
 * Widget Title panel includes title, color, size, and alignment controls
 * Version bump

#### 1.3.4

 * Converted 5 size enum fields from string to integer: title_size, product_title_size,
   product_title_weight, price_size, button_size
 * Size fields now accept pixel values (e.g. title_size=24) instead of enum strings(
   sm/md/lg)
 * Font weight accepts CSS font-weight values (100-900) instead of named weights(
   normal/semibold/bold)
 * Gutenberg block uses RangeControl sliders for all size and weight fields
 * Admin settings page uses number inputs with min/max validation

#### 1.3.3

 * Converted border radius and width fields from string to integer (card_border_radius,
   card_border_width, image_radius, button_radius)
 * Settings now use number inputs with pixel values instead of CSS strings
 * Gutenberg block uses RangeControl sliders for all border/radius fields
 * Fixed stale activation defaults for widget_padding, gap, card_padding, image_aspect

#### 1.3.2

 * Allow single-column layout (widget_columns minimum lowered from 2 to 1)

#### 1.3.1

 * Renamed sync endpoints from /plugin-sync to /woocommerce-sync (requires server
   update deployed simultaneously)

#### 1.3.0

 * Added automatic WooCommerce data sync — products, orders, and order items are
   pushed to the Nudgio server via HMAC-authenticated endpoints
 * New “Sync Data” button on Settings page with last sync status display
 * WP-Cron scheduled sync every 6 hours
 * Real-time sync on product create/update and order status changes (completed, 
   processing)
 * Single product and single order sync methods for granular real-time updates

#### 1.2.3

 * Added HTML debug comments visible in View Source for troubleshooting (credentials,
   product detection, guard triggers)
 * Shows detected product_id and is_product_page status in HTML comments

#### 1.2.2

 * Fixed boolean serialization for show_price and button_full_width — sanitize_text_field(
   false) produced empty string which FastAPI rejected with 422

#### 1.2.1

 * Fixed short description exceeding 150-character limit for WordPress Plugin Directory

#### 1.2.0

 * Replaced 11-setting visual system with 35 individually configurable settings 
   in 8 groups
 * Widget Container: independent background color and padding control
 * Widget Title: separate color, size, and alignment settings
 * Layout: renamed stylewidget_style, columnswidget_columns, added gap control
 * Product Card: 7 new settings — background, border radius/width/color, shadow,
   padding, hover effect
 * Product Image: added image fit (cover/contain) and image border radius
 * Product Title: 5 new settings — color, size, weight, max lines, alignment
 * Price: separate color and size controls
 * CTA Button: 7 new settings — text, background color, text color, border radius,
   size, variant (solid/outline/ghost), full width
 * Gutenberg block rewritten with 10 editor panels and 35 sidebar controls
 * Admin settings page reorganized with reusable field helpers (color, select, text,
   number, boolean)
 * Prominent Gutenberg block instructions added to settings page
 * Uninstall cleanup updated for all new option names + legacy cleanup

#### 1.1.0

 * Added Gutenberg block with visual editor controls
 * Added responsive columns setting (2-6)
 * Added size setting (compact, default, spacious)
 * Added widget_title, cta_text, show_price, image_aspect shortcode attributes
 * Updated shortcode to pass all visual parameters through HMAC-signed URLs

#### 1.0.0

 * Initial release
 * Shortcode with HMAC-signed iframe URLs
 * Admin settings page with WP Settings API
 * Test Connection functionality
 * Auto-detection of WooCommerce product ID
 * Encrypted API secret storage
 * Auto-resizing iframes via postMessage

## Meta

 *  Version **1.4.0**
 *  Last updated **2 months ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.1 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 8.0 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/nudgio-technologies/)
 * Tags
 * [cross-sell](https://sa.wordpress.org/plugins/tags/cross-sell/)[product recommendations](https://sa.wordpress.org/plugins/tags/product-recommendations/)
   [recommendations](https://sa.wordpress.org/plugins/tags/recommendations/)[upsell](https://sa.wordpress.org/plugins/tags/upsell/)
   [woocommerce](https://sa.wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://sa.wordpress.org/plugins/nudgio-technologies/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/nudgio-technologies/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/nudgio-technologies/reviews/)

## Contributors

 *   [ rbtrsv ](https://profiles.wordpress.org/rbtrsv/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/nudgio-technologies/)