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

---

Search plugins

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

# Nudgio Technologies

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

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

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

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

## Descripcion

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.

## Installacion

 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

## Mèta

 *  Version **1.4.0**
 *  Last updated **2 meses 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://oci.wordpress.org/plugins/tags/cross-sell/)[product recommendations](https://oci.wordpress.org/plugins/tags/product-recommendations/)
   [recommendations](https://oci.wordpress.org/plugins/tags/recommendations/)[upsell](https://oci.wordpress.org/plugins/tags/upsell/)
   [woocommerce](https://oci.wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://oci.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/)