IDEA89 — AI Shopping Assistant for Magento 2

Turn your Magento storefront into a conversion machine. IDEA89 adds an AI-powered shopping assistant that answers product questions, recommends what to buy, and surfaces promotions — in your brand voice.

5-minute install. No theme changes. No dev work.

What it does

How it works

1. Install the module via Composer
2. Enter your API key from the IDEA89 dashboard
3. The widget appears on your storefront immediately
4. Products sync automatically — the assistant is ready to sell

Your catalogue is indexed with AI embeddings for semantic search. When a shopper asks a question, the assistant searches your products, checks stock, and responds with relevant recommendations — complete with product cards, prices, and add-to-cart buttons.

Requirements

• Magento 2.4.6 or later (Open Source, Adobe Commerce, or Adobe Commerce Cloud)
• PHP 8.1, 8.2, 8.3, 8.4, or 8.5 — practically, whichever your Magento install
  supports:

  Magento	PHP range
  2.4.6	8.1, 8.2
  2.4.7	8.1, 8.2, 8.3
  2.4.8	8.2, 8.3, 8.4
  2.4.9	8.4, 8.5 (8.3 upgrade-only)

• An IDEA89 account — start your free trial

Installation

composer require idea89/magento2-assistant
bin/magento module:enable Idea89_Assistant
bin/magento setup:upgrade
bin/magento cache:flush

That's it. No layout XML changes, no theme overrides, no frontend build step.

Configuration

Navigate to Stores > Configuration > IDEA89 > AI Shopping Assistant in Magento Admin.

General

Widget Appearance

Content Sync

Choose what gets synced to IDEA89:

• Products — names, descriptions, prices, images, attributes, variants, stock, reviews
• Categories — so the assistant knows your catalogue structure
• CMS Pages — About Us, FAQs, policies — the assistant can answer "what's your return policy?"
• Store Info — store name and context description

Store Locator (Pro plan and above)

Settings live under Stores → Configuration → IDEA89 → Store Locator. Twelve fields covering page behaviour and content:

The page also lives as a CMS widget — drop IDEA89 Store Locator into any CMS page or static block from the widget picker.

Locations themselves are managed in the IDEA89 dashboard → Locator. The chat assistant uses them automatically when a shopper asks "where is your nearest store?"

Order Tracking (every plan)

Settings live under Stores → Configuration → IDEA89 → Order Tracking. Five fields:

All fields support per-store-view scope. Online-only retailer? Set Enable Order Tracking = No on that store-view and the card never surfaces.

See docs/order-tracking-guide.md for the full guide — privacy model, supported carriers, troubleshooting, and the order-card JSON shape.

Advanced

How syncing works

All syncs are idempotent — sending the same product twice is safe and expected.

The widget

The assistant appears as a floating chat widget on your storefront. It includes:

• Conversational AI that understands your products
• Product cards with images, prices, ratings, and add-to-cart buttons
• Promotional banners for active cart price rules
• Quick-reply chips for common questions
• Mobile-responsive design
• Dark/light theme support
• No impact on your Magento theme or page speed (loaded asynchronously)

The widget is served from the IDEA89 CDN — no static content is added to your Magento deployment.

Pricing

Save 10% with annual billing. All plans include the full feature set.

Start your free trial — no credit card required.

Uninstalling

bin/magento module:disable Idea89_Assistant
bin/magento setup:upgrade
composer remove idea89/magento2-assistant
bin/magento cache:flush

No database tables are created in your Magento instance. All data is stored on the IDEA89 platform.

Support

• Documentation: idea89.com
• Email: [email protected]
• Dashboard: app.idea89.com

License

This module is licensed under the Open Software License 3.0 (OSL-3.0).

Copyright 2026 4K Technologies Ltd.

Built by 4K Technologies in the UK.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[1.1.5] - 2026-06-07

Added

• sale_price and is_on_sale in catalog sync payload, computed from
  Magento's special_price / special_from_date / special_to_date.
  Enables the IDEA89 on_sale shopper intent (e.g. "anything on sale?").

[1.1.4] - 2026-06-07

Added

• Category names in catalog sync. ProductSerializer now sends a
  category_names: string[] field alongside the existing category_path
  (which still carries the raw Magento category IDs joined by " > ").
  The API stores lowercase trimmed names in its category_slugs column
  and uses them for per-row category filtering — needed for queries like
  "cheapest in living" to actually narrow to the right category. Without
  this field the API's category filter is a silent no-op on Magento data
  because the legacy split_part(category_path, '/', 2) derivation
  expects slash-delimited names, not >-delimited IDs. Cached per
  process to avoid repeat lookups across the sync batch.

[1.1.3] - 2026-05-30

Added

• PHP 8.5 support. Adobe Commerce 2.4.9 (GA 2026-05-15) officially
  supports PHP 8.5 — composer.json require.php widened to
  ~8.1.0||~8.2.0||~8.3.0||~8.4.0||~8.5.0. Module code uses only
  standard PHP 8.1+ syntax (typed properties, attributes, readonly,
  declare(strict_types=1)) and was confirmed compatible against the
  PHP 8.5 deprecation / removal list. The full Magento → PHP matrix is
  now: 2.4.6 → 8.1/8.2; 2.4.7 → 8.1/8.2/8.3; 2.4.8 → 8.2/8.3/8.4;
  2.4.9 → 8.4/8.5 (8.3 upgrade-only). README and MARKETPLACE.md updated.

Changed

• README PHP badge 8.1–8.4 → 8.1–8.5.

[1.1.2] - 2026-05-30

Added

• Always-visible IDEA89 brand strip above the General group in Stores >
  Configuration > IDEA89 > AI Shopping Assistant. Renders via a Fieldset
  override (Block\Adminhtml\System\Config\AboutFieldset) so there is no
  collapsible header, no group label, and no static-content-deploy step
  needed. Includes inline lightbulb SVG, tagline, version pill (auto-read
  from PackageInfo), and trust links to Documentation, Website, Support,
  and the merchant dashboard.
• Pulsing emerald glow + click-through on the lightbulb (opens
  https://idea89.com in a new tab). CSS-only animation, hover scales to
  1.08x and speeds up the pulse.

Changed

• composer.json author email [email protected] -> [email protected]
  so all merchant contact funnels through one inbox (matches SECURITY.md).
• composer.json author name 4K Technologies -> 4K Technologies Ltd,
  added role: Developer per Adobe Commerce Marketplace EQP guidance.
• composer.json require.php widened to PHP 8.1 | 8.2 | 8.3 | 8.4. Module
  code is forward-compatible across the whole range; the practical limit
  is whichever PHP version the host Magento install supports.
• composer.json require.magento/* moved off * to specific minor
  pins matching the 2.4.6 / 2.4.7 release vectors (EQP red-flags *).
• README PHP badge 8.2+ -> 8.1-8.4; Requirements section now maps
  Magento version to its PHP range.

Added (submission readiness)

• MARKETPLACE.md — internal submission brief covering the portal field
  map, EQP compliance status, MEQP pre-submission commands, and the
  outstanding human-action checklist.
• Copyright header on all 36 PHP files (4K Technologies Ltd, OSL-3.0).

Removed

• Stale screenshot drift from working tree via repo-root *.png
.gitignore rule (not user-visible, but cleans the dev experience).

[1.0.0] - 2026-05-21

Added

• AI shopping assistant widget (floating chat, mobile-responsive)
• Full product catalogue sync with variants, attributes, and stock
• Real-time sync via observers (product save, stock update, price rule save)
• Nightly full catalogue re-sync cron
• Minute-by-minute queue drain cron
• Promotion sync (active cart price rules)
• CMS page and category content sync
• Admin configuration panel (Stores > Configuration > IDEA89)
• Test Connection button in admin
• Sync Now button in admin
• Configurable widget position (bottom-left / bottom-right)
• Configurable brand colour
• Configurable assistant name and store context
• API URL override for self-hosted deployments
• CSP whitelist for IDEA89 API domain
• Encrypted API key storage