SG5 InsightHub

Description

SG5 InsightHub connects your WordPress or WooCommerce site to the InsightHub engine and upgrades your on-site search with AI-powered matching, typo correction, synonyms and relevance ranking — while giving you a full picture of what your visitors are actually searching for.

Search

  • Three refinement modes — Off (analytics only), Refine (the engine steps in only when native WordPress search finds nothing) and Replace (the engine ranks and returns every search result).
  • Typo correction and synonyms — a zero-result search is retried with the engine’s corrected term or synonym, with a clear “showing results for…” notice.
  • Products and content together — products, variations, posts and pages are matched and interleaved by true relevance.
  • Works with your theme — supports WooCommerce layered-nav filtering and sorting, and routes search requests through the standard results page so refinement and analytics apply consistently.

Analytics

  • Log every search with its result count, the products and content shown, and whether the engine recovered a search that would otherwise have returned nothing.
  • Optional visitor and customer attribution for search analytics, fully consent-gated (WP Consent API compatible).

WooCommerce extras (all opt-in, off by default)

  • Order tracking — push completed orders to the engine for search-to-purchase analytics.
  • Abandoned-cart capture and recovery — capture carts (with checkout consent), send recovery emails from the engine, and restore carts via a one-click link.
  • Reviews slider — show your latest product reviews anywhere with the [sg5ih_reviews] shortcode.

Chat widget

Optionally embed the InsightHub chat widget, which can answer shopper questions and look up their orders (opt-in).

Privacy

The plugin integrates with the WordPress privacy tools: personal data collected through abandoned-cart capture is included in Tools Export Personal Data and Tools Erase Personal Data, and suggested privacy-policy text is provided. Customer identity fields are only ever sent when you enable the corresponding toggle.

For analytics — search logging and abandoned-cart capture — the anonymous visitor id is only used after statistics consent when a consent plugin is active. Two features are different, because they are functional rather than analytical: form conversions, and order attribution when order tracking is on. For those the ih_vid cookie is set for every visitor of a page carrying such a form, and on the checkout page. It holds a random first-party identifier and no profile, and exists only to link something the visitor deliberately submitted — a lead, or an order — to the visit it came from. With conversion tracking switched on and set up in InsightHub, the choice made there applies instead: without cookies (nothing is stored in the browser; InsightHub recognises a returning visitor by IP address and browser identification), for the browser tab only (a session cookie that ends with it), or with a cookie set only after statistics consent and removed when consent is withdrawn.

External services

This plugin connects to the InsightHub service, a cloud service operated by SG5 Digital Solutions, to provide AI-powered search, search analytics, chat, reviews, lead capture and abandoned-cart recovery. The plugin cannot provide these features without it: the matching, ranking and AI responses are produced by the service, not in WordPress. An InsightHub account and API key are required.

All requests go to over HTTPS. Nothing is transmitted until you enter an API key and switch on the feature that sends it — every feature below is off by default.

What is sent, and when:

  • Connecting your site — your site URL, site name and administrator email address, sent once when you connect the plugin to an InsightHub account and whenever it verifies the API key.
  • Search — sent on a front-end search when Search Tracking or Search Refinement is on: the search term, the number of results, a snapshot of the matching products and content, the page number, and the visitor’s IP address. An anonymous visitor id, or a logged-in customer’s id, name and email address, are included only when the corresponding settings and visitor consent allow.
  • Content sync — sent when you save or delete a post, page or product while sync is on: its title, URL, content, and for products the price, stock, attributes and variations.
  • Orders — sent at checkout when order tracking is on: order total, currency, line items, the order id, and the customer’s name, email address, phone number, company, billing and shipping address, and IP address. When conversion tracking is on, the customer’s browser identification (user agent) is included as well, so InsightHub can link the order to the visit it came from.
  • Abandoned carts — sent when cart capture is on and the shopper has consented: cart contents and the shopper’s email address, so the service can send a recovery email. The resolve call exchanges a token from that email for the saved cart.
  • Post-purchase banner — sent when a shopper answers the banner: their answer and the related order id. When the banner is shown, the survey or form embed script is loaded from the service and a shopper who opens the survey or form submits their answers to it; a form receives the order’s email address, name and order number through its personal link.
  • Form leads — sent when a visitor submits a Bricks or Elementor form carrying the InsightHub action: the fields you mapped, which typically include the name, email address, phone number, website and message, plus the page and campaign the submission came from and the visitor’s IP address. When conversion tracking is on, the visitor’s browser identification (user agent) is included as well.
  • Campaign visits — sent on page load for pages carrying such a form, while conversion tracking is not set up: an anonymous visitor id, the page URL, the referring URL and any UTM parameters.
  • Conversion tracking — when the Conversion tracking setting is on: the plugin reads your site’s conversion settings from InsightHub (the API key only, cached for 10 minutes). If those settings count visits or link clicks, the InsightHub script is loaded on every page and sends each visit — the page URL, the referring URL and any UTM parameters — and clicks on the links you track as goals (WhatsApp, phone, email, booking, download, outbound or your own). When WhatsApp chats are linked to visits, links to your WhatsApp number add a short reference code to the message the visitor sends. How a returning visitor is recognised is chosen in InsightHub: without cookies (by IP address and browser identification), for the browser tab only (a session cookie), or with a cookie set only after statistics consent.
  • Reviews — sent when the [sg5ih_reviews] shortcode renders: your public widget id, to retrieve approved reviews for display.
  • Chat widget — when the widget is on, its script is loaded from the service and shopper messages are processed by it.
  • Booking calendar — when the Booking calendar setting is on, on pages that use the [sg5ih_booking] shortcode, the InsightHub booking block or the InsightHub booking element in Bricks or Elementor: the plugin asks for your site’s booking pages (the API key only, cached for 10 minutes), and the embed script is loaded from the service to show the booking page from book.sg5.biz. A visitor who books enters their name, email address and the details the form asks for on that page, which belongs to the service.
  • Forms — when the Forms setting is on, on pages that use the [sg5ih_form] shortcode, the InsightHub Form block or the InsightHub Form element in Bricks or Elementor: the plugin asks for your site’s published forms (the API key only, cached for 10 minutes), and the embed script is loaded from the service to show the form from insighthub-gateway.sg5host.com. A visitor who sends the form submits the details it asks for to the service, together with the address and campaign parameters of the page it sits on.

About the service, its terms and its privacy policy:

Screenshots

Blocks

This plugin provides 2 blocks.

  • InsightHub Booking
  • InsightHub Form

Installation

  1. Upload the plugin files to /wp-content/plugins/sg5-insighthub, or install through the WordPress plugins screen.
  2. Activate the plugin through the Plugins screen.
  3. Go to InsightHub in the admin menu and follow the setup wizard to connect your InsightHub account and API key.
  4. Choose your search refinement mode and enable the optional features (tracking, chat widget, order tracking, abandoned-cart capture) you want.

FAQ

Do I need an account?

Yes. The search, analytics, chat and cart-recovery features are powered by the InsightHub engine, so you need an InsightHub account and API key from SG5 Digital Solutions.

Does it work without WooCommerce?

Yes. Search refinement and analytics work on any WordPress site (posts and pages). The order, cart and reviews features activate only when WooCommerce is installed.

Is it GDPR-friendly?

Yes. All personal-data features are off by default and individually opt-in. The plugin registers with the WP Consent API and gates its analytics — search logging and cart capture — on statistics consent, and hooks abandoned-cart data into the WordPress personal-data export and erase tools. Form conversions and order attribution are functional rather than analytical: when enabled they set an anonymous first-party id so a submitted lead or a placed order can be tied to its visit. Deleting the plugin removes everything it stored on your site.

What happens if the engine is unreachable?

Search falls back to native WordPress search. Errors are logged to the PHP error log; shoppers just see standard results.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“SG5 InsightHub” is open source software. The following people have contributed to this plugin.

Contributors

Translate “SG5 InsightHub” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

2.56.0

  • New: The feedback banner on the thank-you page can open an InsightHub form instead of a survey (InsightHub app: Settings Forms). Email and name come from the order.
  • Improved: The form popup stays centered on phones, also on themes whose page is wider than the screen.

2.55.1

  • Improved: The InsightHub booking and form elements, blocks and shortcodes now only show your own InsightHub booking pages and forms.
  • Improved: With conversion tracking switched off, orders and form leads no longer include the visitor’s browser details.
  • Improved: The readme now explains conversion tracking and the data it uses.
  • Improved: General hardening and internal maintenance.

2.55.0

  • New: Show an InsightHub form on any page with the InsightHub Form block, the element in Bricks, the widget in Elementor or a shortcode, inline or as a popup button.
  • New: The Forms tab under Settings InsightHub switches InsightHub forms on. It stays off until you turn it on.
  • New: The Forms tab lists your published forms and builds the shortcode for you. Editors see a note on the page while a form is not published.

2.54.0

  • New: Elementor and Bricks list the booking calendar in its own InsightHub category.
  • New: The booking settings show the link to this site’s booking overview, a page with all its booking types to share.
  • Improved: The booking calendar is called InsightHub Booking in Elementor, Bricks and the block editor.
  • Fixed: The InsightHub Booking block is available in the block editor.
  • Fixed: The booking overview you embed on your website shows only this site’s booking types, no longer those of other sites in your InsightHub organization.

2.53.0

  • New: Bricks and Elementor forms can send a Website field to InsightHub, so the lead shows the prospect’s website. On an Elementor form saved before this version, add an extra field named website.

2.52.0

  • Changed: The Form Conversions tab is now called Conversions.
  • New: Conversion tracking on the Conversions tab, off until you switch it on. It counts visits and clicks on WhatsApp, phone, email and booking links on every page, also without the chat.
  • New: The Conversions tab shows how InsightHub recognizes your visitors, with a link to change it in InsightHub.
  • Improved: With conversion tracking on, form leads and orders find their visit even when the browser stores no visitor ID.

2.51.0

  • Changed: With order tracking on, orders now also send the customer’s company and billing and shipping address to InsightHub. Please check that your privacy policy covers this.

2.50.0

  • New: An InsightHub booking element for Bricks and widget for Elementor. Add it to a page and pick the booking type, inline or popup, the button label and the language.
  • New: Color the booking calendar and the popup button in the Bricks element or the Elementor widget, with the builder’s own colors. The shortcode can set the calendar color too.

2.49.0

  • New: The Booking calendar tab lists your booking types and builds the shortcode for you. Pick a booking type, choose inline or popup, and copy it.
  • New: If you have no booking types yet, the Booking calendar tab says so and links straight to where you create them in InsightHub.

2.48.2

  • Fixed: Sync now for pages, posts and products no longer gets stuck on “Queued”. The sync starts right away, and if it can’t start, the settings page says why.

2.48.1

  • Improved: Clearer release notes for the booking calendar added in version 2.48.0.

2.48.0

  • New: Show your InsightHub booking calendar on any page with the InsightHub booking block or a shortcode, inline or as a button that opens a popup.
  • New: The Booking calendar tab under Settings InsightHub switches the booking calendar on. It stays off until you turn it on.

2.47.0

  • Changed: If you connected your API key using the paste field, please check Search Refinement and the two checkout consent options. An earlier version could have changed them.
  • Changed: Deleting the plugin now removes all of its settings and stored data from your site. Deactivating it keeps your settings.
  • Improved: Password-protected pages and posts are no longer included in InsightHub search and chat.
  • Improved: Adding products to the cart and opening the checkout no longer wait for the connection to InsightHub.
  • Fixed: Saving your API key on its own no longer resets your other settings.
  • Fixed: Orders are now linked to the visit they came from, so campaign results include purchases.
  • Fixed: Filtered product searches now work correctly on sites with a custom database table prefix.
  • Fixed: Opening search result pages in a new tab now works as expected.

2.46.1

  • Improved: The Surveys tab now clearly states that the post-purchase banner needs order tracking, and shows a warning while order tracking is off.

2.46.0

  • Improved: The post-purchase survey now loads the standard WordPress way. Nothing changes in how the banner looks or works.

2.45.0

  • New: Exclude from the pages & posts sync setting, to leave out selected pages by ID or slug.
  • Improved: Sync now runs in the background and shows its progress, so long syncs no longer time out.
  • Improved: After each pages & posts sync, the settings page shows how long it took and which pages were slowest.

2.44.0

  • Changed: The plugin’s internal setting names changed. After updating, reconnect your API key and switch your features back on.
  • Improved: The readme now explains which data is sent to InsightHub, when and why, with links to the terms and privacy policy.
  • Improved: Search logging no longer stores extra data in your database on sites without a persistent object cache.

2.43.0

  • Improved: Extra form fields now appear as the lead’s own fields in InsightHub. Numbers stay numbers and multiple choices stay lists.
  • Improved: If InsightHub can’t accept the extra fields, the lead is still saved and the reason is shown in the activity log.
  • Fixed: Bricks radio buttons now send the chosen value instead of a list.

2.42.1

  • Fixed: Special characters in room facilities and amenities now show correctly in chat answers.

2.42.0

  • New: Rooms, tours and services from SG5 PMS now share their facilities and amenities with InsightHub, so the chat can answer capacity and amenity questions.

2.41.0

  • Improved: Product sync now includes the product type, so the chat can tell rooms, tours and services apart.

2.40.6

  • Fixed: The survey dialog now has equal spacing on both sides on phones.

2.40.5

  • Fixed: The survey dialog now stays centered on phones when the page is wider than the screen.

2.40.4

  • Fixed: The survey dialog now stays centered with every theme.

2.40.3

  • Fixed: The survey banner’s Yes and No buttons now stay side by side on phones.

2.40.2

  • Fixed: Theme styles no longer cover the survey dialog’s close button.

2.40.1

  • Improved: Internal maintenance. Nothing changes for you.

2.40.0

  • New: Choose how the survey banner appears: inline on the thank-you page, or as a pop-up dialog.
  • New: The banner uses your survey’s colors from InsightHub, with optional button and border colors of your own.
  • Improved: A refreshed banner design with a rounded border.

2.39.0

  • New: Edit the survey banner’s title, question, buttons and thank-you text on the Surveys tab.

2.38.0

  • New: A switch on the Surveys tab to turn the post-purchase survey banner on or off. It is off by default.

2.37.2

  • Improved: The Bricks and Elementor form settings moved to their own Form Conversions tab.
  • Fixed: The survey note no longer overlaps the order tracking switch. It now has its own Surveys tab.

2.37.1

  • Improved: Internal maintenance. Nothing changes for you.

2.37.0

  • New: Post-purchase survey banner on the WooCommerce thank-you page. Customers who choose Yes get the survey with their email already filled in.
  • New: The survey and how often customers are asked are set up in the InsightHub app. The banner needs order tracking to be on.

2.36.0

  • Changed: On new installs, every feature that connects to InsightHub stays off until you switch it on. Existing sites keep their current settings.
  • Improved: Search result caching is now used only on sites with a persistent object cache.
  • Improved: General hardening and internal maintenance.

2.35.4

  • Improved: A form sent twice is recognized as the same lead instead of a duplicate.
  • Improved: Leads now record the campaign they came from when the page link carries campaign details.
  • Fixed: Form submissions now appear as leads in InsightHub.

2.35.1

  • Improved: The suggested privacy policy text for abandoned-cart capture now follows your site language: English, German or Indonesian.
  • Fixed: Theme styles no longer move the close button of the cart pop-up.

2.35.0

  • Changed: Form conversions no longer wait for cookie consent, as they only link a submitted form to its visit. Search and cart tracking still ask for consent.

2.34.5

  • Fixed: Saving an Elementor page with the InsightHub action no longer causes an error.

2.34.4

  • Fixed: The Elementor lead field pickers now list the form’s fields.
  • Fixed: The last extra field in the Elementor action can now be removed.

2.34.3

  • Fixed: The InsightHub action now appears in Elementor’s Actions After Submit list.

2.34.2

  • Improved: The Bricks and Elementor switches are always shown. If the builder isn’t installed, the switch is off and explains what’s missing.

2.34.0

  • New: Elementor Pro form integration. Add the InsightHub action to a form, choose which fields to send, and each submission goes to InsightHub.

2.33.0

  • New: A Message field can now be sent along with the name, email and phone.
  • Improved: Lead details are now sent where InsightHub expects them.
  • Improved: The extra fields setting now explains what it is for.
  • Improved: A quieter activity log, with one line per form submission.

2.30.1

  • New: AI search with three refinement modes, search analytics, chat widget, reviews slider, order tracking and abandoned-cart recovery.

Every version is listed in changelog.txt.