Description
AI eShop Optimizer – AI Chat & Content Recommendations Plugin
Welcome to AI eShop Optimizer, the premier AI-driven solution for intelligent customer engagement powered by the latest AI models from Anthropic and OpenAI.
Works with or without WooCommerce – Perfect for:
– E-commerce sites with WooCommerce for product recommendations
– Corporate and content sites for intelligent chat assistance
– Merchant information sites that need AI-powered customer support
The plugin provides advanced AI chat capabilities with semantic search powered by state-of-the-art embedding engines. For WooCommerce sites, it also enables product recommendations through our graph-database powered service at https://eshop-optimizer.com.
Our advanced AI tools uncover latent patterns and consumer preferences, empowering you with strategic upsell and cross-sell propositions.
The plugin also enables you to import with one click our recommendations – or any product recommendations in a csv file that conforms to our format – and to also monitor their performance using google UTM tags (which you may also use to monitor your own recommendations performace).
Features
AI Product Recommendations
- Harness the power of a semantic graph database for unmatched product pairing suggestions.
- Dive deep into your sales data to extract bespoke upsell and cross-sell opportunities.
- Beta-test participants reported a remarkable 57%+ annual surge in sales.
- Privacy-centric: Opt out of sharing product and category names and product prices with limited impact to the quality of the recommendations.
- Effortlessly back up and export current Upsells and Cross-sells.
- Leverage Google GA4 insights to gauge the success of your recommended pairings.
Products for the Same Needs
- Automatically recommend products that fulfill the same customer needs
- Uses your product’s need attributes (pa_need taxonomy) to find matching products
- Ranks suggestions by pre-computed sales performance from the product catalogue
- Intelligently excludes existing upsells and cross-sells to avoid duplicates
- Stores up to 6 optimized suggestions per product for fast retrieval
- Displays prominently on product pages (appears first, before other recommendations)
- Multi-tier caching for optimal performance (Object Cache + Database)
- Generate suggestions as part of Operational Efficiency workflow
Insights Chat — Claude-powered (NEW in 5.0)
- Ask your shop questions in plain language from inside the WordPress admin
- Powered by the AI Chat Anthropic key you already have — no separate subscription
- 33 purpose-built Claude data abilities resolved automatically via the WordPress Abilities API
- 11 categorized accordion groups of suggestion chips — Customers, Brand portfolio, Recommendation rails, Attribution & archives, Product needs audit, Star ratings, Content & blog, Cross-skill, Store analytics, Promotions / launches / sales, Newsletters & campaigns
- Cross-cuts orders, products, attribution, recommendations, ratings, blog engagement, and customer profiles
- Stays inside WooCommerce — no third-party BI subscription, no data export
Joint Session × Attribution Analytics (NEW in 5.0)
- Bridge between the Session Tracker (engagement) and the Attribution Engine (conversion) — both keyed off the same aieo_session_id cookie
- Blog-post attribution — clicks from blog posts to products now attribute correctly with the originating post_id
- Engagement-bucket buy-probability — empirical P(cart-add) per (scroll-quartile × time-quartile × mouse-activity) bucket per product
- Abandoned-cart triage, cart-removal analysis, rating × conversion correlation, need × conversion correlation
- Pre-aggregated daily rollup tables keep chat answers in single-digit milliseconds regardless of history depth
Insights Remote DB Streaming (NEW in 5.0, Pro)
- Stream raw analytics events to your own operator-owned MariaDB / MySQL for unbounded BI access
- Reuses the existing ERP connection registry — same encrypted credentials, same audit trail
- Configurable export frequency (15 min / hourly / daily) with per-table lag dashboard
- Local-purge failsafe — hot rows are not deleted until the remote confirms receipt
- Net stable local database footprint ~1.1 GB year-over-year
Star Ratings SEO Schema (NEW in 5.0)
- AggregateRating JSON-LD automatically bridged into AIOSEO, Yoast, and RankMath via their schema filters
- Fallback head-injected JSON-LD when no SEO plugin is detected
- Per-feature enable/disable toggle on the Star Ratings admin page
- Surface customer ratings to Google Rich Results without manually configuring each SEO plugin
Custom Slots + Tolstoy + Recommendations Ordering (NEW in 5.1)
- Drag-and-drop “Recommendations Ordering” card on the e-shop Manager dashboard reorders every recommendation rail (Up-sells / Cross-sells / Related / Recently Viewed / Products for the same needs) and any operator-defined Custom Slot, with a per-row Show toggle to hide rails without removing them
- Custom Slots host arbitrary content alongside the built-in reco rails — two kinds per slot:
- Tolstoy: paste a widget id + account UUID; AIEO assembles the
<tolstoy-widget>tag and defer-loads the gotolstoy.com CDN script once per page - HTML / code: rich-text WYSIWYG (TinyMCE) with a Code tab, accepts any HTML, embed scripts, image tags, or WooCommerce shortcodes (e.g.
[products limit="6" orderby="popularity"])
- Tolstoy: paste a widget id + account UUID; AIEO assembles the
- Per-slot title with show/hide toggle — renders with the same heading + underline styling as the built-in “Recently Viewed Products” / “Related Products” titles
- Cross-tab Tolstoy attribution — clicks from a Tolstoy carousel that lead to a cart-add are recorded as
source='tolstoy'in wp_aieo_addcart_events withsource_meta = {slot_id, tolstoy_widget_id, clicked_url}so reports can pivot on widget, carousel, or source product - Works on BOTH FSE block themes (via the
.ff-recommendations-clusterflex container + inline CSSorder:rules) AND classic themes (via dynamic re-prioritisation of WooCommercewoocommerce_after_single_product_summaryaction hooks)
IAPI (Interactivity API) — WC Cart / Checkout block parity (NEW in 5.1)
- Full integration with the modern WooCommerce block-based cart and checkout (driven by WordPress @wordpress/interactivity)
- Side-cart, Swatches multi-select, Sticky Add-to-Cart, Wishlist, Star Ratings, Free-Shipping Display, Recommendations attribution all work on both surfaces — block-cart/block-checkout AND legacy shortcode-cart/shortcode-checkout
- AIEO_DMM_Swatches_Runtime supports dual-mode enqueue (
@aieo/swatches-iapimodule when IAPI is on, jQuery bundle otherwise) with a single DOM contract - WC Store API (
wc/store/cart) endpoints recognised by the side-cart, attribution log, and waitlist subscribe flows so block-checkout actions are captured the same as classic checkout - AIEO Custom Slots, Free-Shipping Display, and Trust Badges register their bridge-block render paths inside
woocommerce_blocks_loadedso they’re available in block-themed cart/checkout templates via the Site Editor
Floating Mini-Cart + Free-Shipping Bar (NEW in 5.0)
- Two-column floating mini-cart styled after the Rey theme — left column recommends “You might like”, right column shows Shopping Bag / Recently Viewed
- Free-shipping progress bar right under the tab header
- 500 ms debounced quantity AJAX — qty changes feel instant, no full cart recalculation on the server
- Session-level HTML cache (30 s TTL); WC fragments integration keeps every other widget in sync
- Sticky Add-to-Cart bar for product pages
Pricing Engine + Conversion Boosters (NEW in 5.0)
- Per-role price overrides via CSV upload, with batch validation
- Brand-level % discounts with start/end-date windows
- Loyalty class definitions + per-user assignments
- Stacking recipe: Role Pricing Brand Discount Loyalty Class — each customer sees the strongest applicable price
- Brand-based free-gift offers (cart subtotal threshold per brand)
- Configurable exit-intent modal with checkout-specific variant
Marketplace Connectors & Shipping (NEW in 5.0)
- Marketplace Order Importer — Skroutz / e-shop / Amazon orders flow into WooCommerce as native orders so attribution, stock, customer profiles, and fulfillment stay unified
- Per-vendor rotatable webhook tokens + configurable SKU lookup strategy
- Streaming marketplace feed generator (XML / CSV) for 35k-product catalogues
- Greek + Cypriot Shipment Tracking providers (replaces the WC plugin’s US/UK/Canada/Germany defaults)
- Smart Shipping Label — postcode-less carts see “Carrier (Από €X.XX)” minimum rate so customers know shipping isn’t free without seeing a misleading default
Customer Intelligence + Web Push (NEW in 5.0)
- wp_aieo_customer_intelligence keyed by eponymous_id — omnichannel customer view (eshop + in-store) is the single source of truth
- Behavioural segments — Top customers, Lost cohort, Lookalikes, Abandoned-cart, reactivation
- Triggered web-push flows — welcome, reactivation, price-drop, back-in-stock — with full dispatch log + click attribution
- Customer Survey Intelligence — Gravity Forms ingest + 7 high-signal metrics (NPS class, satisfaction, priorities, discovery channel, gift preferences, personal profile) + composite VoC score
- “Notify me when back in stock” Waitlist with automatic stock-watcher emails
- Wishlist analytics — most-wishlisted products, surfaces, and pages driving adds
AI-Powered Chat (FREE)
- Support for latest AI models from Anthropic Claude and OpenAI:
- Claude Opus 4.1, Claude Sonnet 4.5, Claude Haiku 4.5
- GPT-5, GPT-4, GPT-o1, GPT-3.5
- Advanced embedding engines for semantic product search:
- Voyage AI: voyage-3.5-large, voyage-3.5-lite, voyage-3-lite, voyage-finance-2
- OpenAI: text-embedding-3-large, text-embedding-3-small, text-embedding-ada-002
- Customizable chat templates for different use cases
- Smart product search and recommendations powered by AI embeddings
- Product catalog integration with semantic similarity matching
- Context-aware responses using customer behavior data
- Customizable chat appearance with multiple themes (Rounded/Square)
- Dynamic color customization for branding
- Session management and chat history tracking
- Floating chat widget with adjustable positioning
- Mobile-responsive design
Advanced Session Analytics
- Custom Class-Based Event Tracking – Track clicks on any element using custom CSS selectors
- Click Event Throttling – Prevent database flooding while maintaining accurate click counts
- Cookie Consent Bypass Mode – Toggle GDPR compliance for immediate tracking or compliance-first approach
- Product Image Click Tracking – Special tracking for product images with debounce to prevent duplicate events
- Anti-Double-Counting – Custom rules take precedence over standard tracking
- Automatic Cache Busting – Version strings with variable lengths for aggressive cache invalidation
- Multi-Layer Cache Compatible – Works with Nginx, Varnish, REDIS, WP Rocket, Cloudflare
How to Use
-
Export and Back-Up Current Pairings
Safely export existing upsells and cross-sells, which doubles as a reliable back-up. The Pro version also takes your current selections into account, potentially enhancing the AI’s output. -
Accelerated Order Export (Enabled HPOS Required)
Swiftly export up to 100,000 order items. The Pro version lifts the cap on orders, including comprehensive details like Order ID, Product ID, sequence, and more.
Exclude product titles and prices at will.
Maintain customer anonymity by withholding CustomerIDs, albeit with a slight compromise on recommendation precision.
Opt for a seasonal sales analysis, focusing on trends pertinent to the current time of year.
Refine Your Data with Our AI Engine
Register at eshop-optimizer.com and submit your data. Within moments, receive refined upsell and cross-sell strategies for your leading products. Full catalog analysis available with the Pro version.
eshop-optimizer.com respects your privacy and adheres to strick privacy guidelines. Our company’s, Oxford Metadata Ltd, privacy provisions has been approved by both Google and Facebook. For further details please visit: https://eshop-optimizer.com/compliance -
Import Tailored Upsell and Cross-sell Strategies
Implement the AI-crafted upsell and cross-sell suggestions via an easy-to-upload CSV file. -
Witness Enhanced Sales
Marvel at the accuracy of our AI-driven recommendations and observe how they can boost your sales figures. We’re so confident in our service that we offer free initial analyses – we believe you’ll be eager for more and enthusiastic to spread the word!
Experience the relevance of our recommendations and discover how AI can improve your store’s sales. We offer free analyses, and we are confident that you’ll want more and share our plugin with your friends!
For any queries or support, contact us at support@eshop-optimizer.com.
Website: (https://eshop-optimizer.com)
Blocks
This plugin provides 3 blocks.
- AIEO Brand Slider Lazy-hydrated brand carousel. Modes: top, new_brand, new_product, favourites (per-user affinity), manual. Server-renders the first N cards as a noscript fallback; client hydrates into a vanilla scroll-snap carousel with arrow nav.
- AIEO Brand Rails Stacked curated brand rails (Featured / New / Your Favourites / Top). Each rail has its own count and slides-per-view, configurable in the inspector.
- AIEO Brand A-Z Index Server-rendered A-Z brand directory. Every letter A–Z (plus '#' for non-Latin brands) is always present; empty letters render disabled. Sticky letter bar + per-letter brand grid with product counts. Reads exclusively from wp_aieo_core_brand_vitals.
Installation
Extract the contents of this plugin zip file into your wp-content/plugins/ directory locally.
Upload the extracted folder to your website.
Navigate to wp-admin/plugins.php on your dashboard.
Find ‘AI eShop Optimizer’ and activate the plugin.
Alternatively, install directly through WordPress:
Go to the ‘Plugins’ menu in WordPress.
Click ‘Add New’ and search for ‘AI eShop Optimizer.’
Install and activate directly from your dashboard.
Reviews
Contributors & Developers
“AI eShop Optimizer” is open source software. The following people have contributed to this plugin.
Contributors“AI eShop Optimizer” has been translated into 1 locale. Thank you to the translators for their contributions.
Translate “AI eShop Optimizer” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
7.1 – 2026-06-06
First-party measurement & consent — server-side Facebook Pixel/CAPI + GA4, checkout active/idle timing, and a lightweight Consent/GDPR cookie banner (three buttons, cookie scanner, button theming, two layouts) — plus Custom Tabs and drag-and-drop Product Tab Ordering
- Pixels & Conversions (server-side measurement). AIEO can now own the Facebook (Meta) Pixel and Google Analytics 4 end to end — a thin browser pixel and server-side Conversions API / GA4 Measurement Protocol, deduplicated on a shared event id, sent after the order is saved (zero checkout latency). Each platform is selectable (AIEO owns it, or stay out of the way for a tool you already run), with master off-switches so you can keep PixelYourSite. Facebook credentials can be read from PixelYourSite if present.
- Consent / GDPR — first-party CMP. A lightweight, first-party cookie-consent banner (no external CMP, no IAB TCF bloat) on its own page: a rich-text message, three actions (Accept all / Decline / Customize) with a per-category preferences panel (necessary / functional / analytics / marketing), per-button colour theming (background / text / border + hover, with an equal-prominence guard so Decline can’t be hidden), two layouts (bottom bar or a centre glass pop-up), a floating “Cookie settings” button so visitors can change or withdraw consent, and a policy-version field that re-asks everyone after a policy change. It drives Google Consent Mode v2 and gates AIEO analytics plus the Facebook / GA4 senders. A built-in cookie scanner classifies the cookies and third-party services your storefront sets (Google Fonts, GA4, the Meta pixel, YouTube, …) against a curated database — populated automatically as visitors browse (no server crawl, names only, never values) — with an inventory you can re-classify.
- Checkout timing. Active vs idle time is now measured for each successful checkout and aggregated per product, so offer timing (exit-intent, etc.) can be set from real deliberation data rather than a fixed delay; coupon-completed orders are tagged and excludable from the baseline.
- Custom Tabs (Product Display). Up to five extra product tabs you can switch on and rename at will (e.g. “Application”, “Ingredients”) — each holds its own rich text per product and the tab simply disappears when a product has no content for it. A one-click migration assistant imports existing content from the legacy Pods “usage” / “specification” fields (auto-enabling and labelling the first two tabs), and the legacy theme tabs are removed automatically so nothing shows twice.
- Product Tab Ordering. A new drag-and-drop card on the Product Display dashboard (between the info-column layout and the recommendations order) sets the order of the WooCommerce tabs (Description / Additional information / Reviews) together with your Custom Tabs, in one sequence; tabs a product doesn’t have are skipped while the order holds for the rest, on both block (FSE) and classic themes.
7.0 – 2026-06-05
Product-page layout builder (block + classic themes), a reusable product/variation picker, and a master Button Styles control — plus side-cart mobile-bar styling (glass, per-icon, bubble), padding/min-max/glass for the master buttons, wishlist & brand in the layout builder, and sticky admin navigation
- Side-cart mobile bottom bar. Theme-independent colours (bar background + height, icon, cart-count number + circle), a glass effect (transparent + backdrop blur), per-option “selected” colours for Navigator / Search / AI Chat / Cart, an optional cart-only floating bubble (like the desktop cart), and a fix for the lone-cart badge alignment. The whole side-cart surface also moved to a shared class so the runtime can render it without the admin plugin.
- Product Needs — Pills. New tag-style “pills” display alongside the list, with full pill styling (size, radius, padding, gap, colours, border).
- Master Button Styles — padding, sizing, glass. Per-group Top/Right/Bottom/Left text padding, min/max width + height, an opt-in glass effect, and full Secondary hover (border + hover background / text / border).
- Layout builder — Wishlist + Brand. “Add to Wishlist” is now placeable (Beside image / Beside the product title / Under image), and Brand Display gained the “Beside the product title” option; the builder wins over the per-module Brand position.
-
Admin polish. Fixed the toolbar icon stacking; reordered the AI Optimizer submenu (Data Prep e-shop Manager AI Chat Interactivity (IAPI) Rec Cache) and removed the Session Schema Migrator from the menu; the top bar + e-shop Manager sub-tab navigation are now sticky.
-
Product-page layout builder. One drag-and-drop “Display Order” list (Storefront Display Single Product Page) now sets the vertical order of the whole product info column — the core elements (title, rating, short description, sale / free-shipping messages, price, add-to-cart) and the info modules (meta, categories, brand, payment logos, trust badges, waitlist, gifts, complementary, product needs, role-pricing login) — with a per-module “Beside image / Under image” choice. The same order is applied on both block (FSE) themes and classic themes (Botiga / FemmeFatale), so the page looks the same either way. Core blocks that ignore styling and the Brand Display placement now follow the list too.
- Categories line restored. The clickable “ΚΑΤΗΓΟΡΙΕΣ” comma-list is back as its own positionable module, styled to match the SKU/Barcode rows; the role-pricing login message is positionable too; and Product Categories now sits next to Product Meta in the menu.
- Reusable product / variation picker. A modal browser — pick simple products, whole variable products, or specific variations — replaces the free-text ID/SKU boxes on Product discounts, Free gifts and Free shipping (included and excluded lists), the Product Exchanger and the marketplace feed exporter. Existing selections migrate automatically.
- Master Button Styles (Tools). One place sets the default background, text, border and radius (plus hover) for every AIEO storefront button, with separate Primary, Secondary and Archive masters; per-button colour pickers (Waitlist, Complementary, Sticky Add-to-Cart, Side-Cart) inherit the master and override only when set. The side-cart, save/share-cart, coupon-apply and multi-select buttons now follow the master, and a bug that blanked the admin colour-picker swatches is fixed.
- Admin discoverability. The Ctrl / ⌘-K navigator indexes the layout card and the Saved & Abandoned Carts report; the AI Insights chat gained an abandoned-carts playbook and feature-location pointers.
- Auto-restock. The e-shop’s own sales (a distinct ERP invoice type) are excluded from physical-store demand so they can’t trigger false restocks; out-of-stock cancellations now surface in the Stock Recovery Failures KPI.
6.5 – 2026-06-03
Stock Recovery basket-turnover halo + per-branch pickers, Missing Hot Sellers published-benefit accounting, and ERP de-duplication
- Stock Recovery basket-turnover halo: a new column plus a “Basket turnover protected” KPI show the total value of the whole in-store orders each out-of-stock product appears in (not just its own line) — the real basket revenue you defend by keeping the product available, captured at restock and summed across all restocks.
- Per-branch pickers + money-first sort: every Stock Recovery row lists units sold per physical store within the chosen window (so pickers know which branch holds the stock), and the queue is sorted by in-store turnover by default.
- Missing Hot Sellers per-branch column showing which stores sell each not-yet-published SKU.
- Missing Hot Sellers “Published from this list” accounting: once you publish a product from the list, its real online sales since publishing are tracked and summarised (products published, online units/turnover, vs the in-store demand it had) — quantifying the payoff of acting on the list.
- ERP de-duplication: the store-orders feed re-appends every order on each sync, inflating in-store turnover/unit figures; detection now keeps only the latest import-day per order (preserving genuine multi-unit purchases), so the numbers are accurate.
- Recency window can now be set up to 365 days (was 180).
6.4 – 2026-06-02
Missing Hot Sellers, variation descriptions on swatches, and clean activation on a fresh database
- Missing Hot Sellers now lets you control what counts as a “gap” so the totals reflect real opportunities. An Include filter chooses which statuses appear — by default drafts to complete and products not in the eshop at all, while Private (one-time/reciprocal offers you deliberately took offline) and Pending are excluded. The headline count, in-store turnover and estimated recoverable figure all follow the filter.
- New exclude-by-pattern field: list name or SKU substrings (e.g. recurring offers, coupons, gift vouchers, catch-all accounting SKUs like “ΔΙΑΦΟΡΑ ΕΙΔΗ”) and any matching product is dropped from the list and the totals — for current and future imports.
- The per-row Dismiss still removes a single SKU permanently; dismissed items now appear in a manage list with a Restore link, so exclusions are no longer one-way. All filtering happens at read-time (no re-detection needed).
- Product swatches now surface each variation’s own description. The per-variation description (e.g. “No100 Fair”) is combined with its attribute into a “description – attribute” caption (e.g. “No100 Fair – Ανοιχτόχρωμο”) shown when you hover an image swatch, under the product title on selection, and — alongside the attribute — in the cart, checkout, order details and emails. The swatch caption is read instantly from the preloaded swatch cache, so it costs nothing at render time; a “Variation name under product title” toggle was added to the Product Swatches settings, and the cart/order label is filterable (
aieo_dmm_swatch_cart_desc_label). - Removed the PHP warnings emitted on first activation against a fresh database —
Undefined array key "index_type" / "index_name" / "index_columns" / "column_name"fromwp-admin/includes/upgrade.php, followed byCannot modify header information - headers already sent(the warning output broke the post-activation redirect). WordPress’sdbDelta()parsesCREATE TABLEline by line and mis-reads blank lines (as empty indexes) and--SQL comments (as columns) once PHP 8 surfaces undefined-array-key warnings. A newaieo_dbdelta()wrapper strips blank/comment lines before table creation, so our documented schema SQL stays readable while dbDelta receives one field/index per line. Affected the Customer Surveys and Push customer-intelligence schemas; observed on a fresh MySQL 8.4 install.
6.3 – 2026-06-02
Paid-traffic attribution (Facebook + TikTok + Google), offer-targeting correctness, catalogue-query hardening
- Attribution: full paid-social support. The session attribution now captures the raw click id (fbclid / ttclid / gclid / gbraid / msclkid / …) for Conversions-API & offline-conversion uploads, plus the campaign -> ad set / ad group -> ad hierarchy (Meta
ad_id/adset_id/campaign_id, TikTok and Googleadgroup_id), so paid campaigns can be analysed down to the ad. TikTok and Google iOS (gbraid/wbraid) clicks are now classified correctly, and Instagram link shares stay “social” (not mis-tagged as paid). - Product discounts / Free gifts / Free shipping — targeting correctness:
- Exclusions now work as a cart-level veto: when the cart contains any excluded brand / category / need / product, the discount, gift or free-shipping rule no longer applies (as the UI states).
- The “Specific products” whitelist is now enforced — an offer that requires one of those products only applies when the cart actually contains one.
- Per-product discounts now honour the exclusion lists, and cart-conditional discounts (minimum subtotal / specific-products) no longer apply unconditionally.
- Fixed a double-discount that could apply the percentage twice on cart lines when “apply discount to the main product price” was enabled.
- Free-gift awards now respect exclusions and the specific-products whitelist.
- Fixed brand-only discounts being mis-attributed across every line in the offer ROI reports.
- Duplicate-promo detection now considers every condition (exclusions, thresholds, scopes, specific-products) so distinct promos are no longer dropped as “duplicates”; gift offers are now de-duplicated on save to prevent accidental gift stacking.
- Performance: product targeting lookups are memoised within a request (fewer repeated taxonomy reads during cart and shipping calculation).
- Hardening: the gift “sample” hiding on shop / search pages no longer issues an expensive postmeta self-join on every archive query (it could pin the database for minutes on large catalogues) — sample products are now excluded via a cached id list.
- Stock Recovery: in-store demand is now shown for both the recency window (which drives the suggested restock quantity) and all-time since the product went out of stock, clearly labelled on the headline totals and each row — so the figures match the suggestion.
- New: Multi-Attribute Variations tool (Catalog Sync Stock Management) — lists variable products that use more than one attribute for variations (e.g. colour × size). Allowed by default (a master switch lets you turn on a save-guard that blocks them in catalogues where it’s a mistake).
6.2 – 2026-06-01
Flat-vitals data sourcing, schedulable predictor, recovery insights
- SKU and barcode (GTIN) indices are now precomputed into the core product vitals table on every build — rolled up per parent in the variation-combine step — and a
parent_idindex was added. SKU/barcode lookups now read a single flat vitals row instead of joining the legacy Pods table. - Sales / out-of-stock predictor: the staged (batched) build now also runs on the scheduled path, so the predictor can be put on a schedule (WP-Cron / system cron) without the parent-grain pass stalling — previously only the manual “Run now” used batches.
- Stock Recovery: new headline card totalling the in-store sales of products the eshop currently has out of stock, alongside the predictor’s pessimistic / average / optimistic recovery-value estimates.
- Missing Hot Sellers: new card totalling the in-store sales currently missing online (products, units, turnover).
- Stock Recovery confidence thresholds each get a plain-language hover tooltip explaining the setting and how to tune it.
- Performance: bulk COGS apply now suppresses heavy per-save reindex hooks (search / filtering / feeds / embeddings) for the duration of the run, so large catalogues update in a fraction of the time.
- Fixed: the full bundled translation could be shadowed by an incomplete wp.org language pack (e.g. a 10-string Greek pack), leaving most of the admin UI in English. The plugin now forces its bundled translation to take precedence over an incomplete global language pack.
6.1 – 2026-05-31
- Physical-Demand Recovery: detects products the ERP marks out-of-stock that the physical stores still sell, and can auto-restock them (manager confidence thresholds) — with recovered-sales (units + €) and success/failure tracking.
- Missing Hot Sellers: ranked list of SKUs selling in-store but not live in the eshop (draft imports needing images/description/categories/brand, or absent), with direct edit links.
- Catalog Sync reorganised into a two-column panel (Stock Management / Sync & Feeds).
- Sales/out-of-stock predictor now runs from the UI in batches (no timeout); grain/anchor controls realigned.
- All Insights reports (wpDataTables) re-pointed to the AIEO schema; two new Insights-chat skills for the data above.
- Fixed a harmless “Duplicate column name ‘entry_source’” notice on deactivate/reactivate.
6.0 – 2026-05-29
Block-checkout COD gating suite, BoxNow Partner API, payment-method reactivity
- NEW: Cash-on-Delivery can be disabled per destination country. A multiselect in the COD card (Free Shipping tab) hides COD for the chosen billing countries, driven by the checkout country switcher — flip to Cyprus and COD disappears live; Greece keeps it. Works on both classic and block (Store API) checkout via a runtime delegate plus a
canMakePaymentblock callback that updates reactively on every country/shipping change, no reload - NEW: COD can be disabled per shipping method / courier (e.g. tick “Box Now” to forbid COD whenever Box Now is selected). Table-rate rate IDs are normalised (the
_rule_{id}suffix stripped) before matching so every carrier resolves correctly - NEW: per-courier COD fee override with a
{cod_fee}placeholder in the gateway description that resolves to the courier-specific amount. Decimal entry accepts both.and, - Performance: the entire gating layer only registers its filters / block JS when a country, courier, or fee override is actually configured — stores on plain default COD pay no runtime cost
- NEW: Payment Gating (cheque-on-pickup) now works on block checkout and lives under the COD card on the Free Shipping tab (its standalone tab is removed). Runtime delegate added so the Store API path honours it
- NEW: BoxNow Partner API driver — full integration (manual v7.2). OAuth2 client_credentials auth, create voucher, label PDF, cancel, and locker listing; the order-edit Print action now appears for BoxNow vouchers. Verified create label cancel on production. Credentials live in
courier_boxnowsettings;build_voucher_payload()now passesorder_idso the driver can read the customer’s chosen locker - NEW: Skroutz / Shopflix feeds emit
color+additional_imagefor the “Μόδα” (fashion) category, sourced from core product vitals. Skroutz wraps colour in CDATA and emits<color/>when empty so the field is present on every product - Fixed: checkout landing message now spans the content width (carries the theme
alignwideclass) so it lines up with the checkout/cart rows below - Fixed: chat model selection now saves newly released models (e.g. Claude Opus 4.8) — the Save handler validates against the model registry instead of a hardcoded whitelist that silently reverted the choice
- Fixed:
array_map()fatal on the chat-model save path, plus four more(array) sanitize_text_field($_POST[...])array-swallowing anti-patterns (embedding manager, ratings, TRS zone admin, DMM social login) - Removed: the deprecated legacy shipment-tracking module (AIEO Fulfillment tracking supersedes it; orphaned option cleaned up)
5.10 – 2026-05-28
Shopflix voucher endpoint fix + admin list-table per-page caps
- Fixed: Shopflix voucher PDFs were coming back with the wrong layout/rotation. The print endpoint expects
/shipments/{trackingNumber}/print, not/shipments/{orderId}/print— Shopflix support confirmed 2026-05-28. We now capturetrackingNumberfrom the create response (with a/orders/{id}fallback for already-existing shipments) and call print correctly. Vouchers now respect the merchant-portal-selected label format - NEW: admin list-table per-page caps. Tools tab “Admin list-table per-page caps” card sets a hard ceiling on Screen Options for the All Orders + All Products lists (defaults 200/200). Operators below the cap keep their personal value untouched; only those above (e.g. shop managers running at 500–600) get clamped on the next render. Settings are administrator-only — shop managers see the card but it’s overlaid with a frosted “Administrator only” lock. Cap=0 disables enforcement for that screen
5.9 – 2026-05-28
AS async runner restored, admin-bar menu, Shopflix error decoder, re-ship of ACS driver
- Critical fix: ensures the ACS Courier driver fixes actually ship. The 5.8 wp.org package was built from a snapshot that predated the ACS driver rewrite, so sites updating from 5.8 didn’t get the 10 fixes documented in the 5.8 changelog. 5.9 re-bundles them properly. If you’re on 5.8 and your ACS vouchers were still mis-printing (Weight: 5,00, COD: 602,00), update to 5.9
- NEW: Action Scheduler async runner re-enabled. Pending actions now drain continuously instead of waiting for the 5-minute system-cron window. AS’s own background AJAX runner is allowed to fire on every page load; regular page rendering stays unaffected (concurrent_batches=0 on web). One prod site went from 150 overdue actions to 81 in under a minute after the fix
- NEW: admin-bar menu. The “AI Optimizer” icon appears in the WordPress admin toolbar with dropdown shortcuts to Data Prep, e-shop Manager, and AI Chat. Saves the operator a sidebar-scroll on every screen
- Fixed: Shopflix accept errors are now human-readable. The Shopflix API returns errors under
error.message+error.code, but our parser was readingerror.errorMessageand falling back to “HTTP 400”. Now surfaces the actual message (“Cannot Accept Order (10303)” etc.) so operators know whether to retry, contact Shopflix support, or skip the order
5.8 – 2026-05-24 to 2026-05-26
Three-day stretch — COD surcharge fix, Skroutz webhook repair, ACS Courier driver rewrite, AS dedup hardening, fulfillment polish
- Fixed: COD payment method was hidden at checkout when the cart used a non-whitelisted shipping slug. AIEO now force-restores the configured COD gateway, pre-empting WC’s “Enable for shipping methods” whitelist and any third-party filter (Box Now, COD-Plus). Runtime + admin both updated
- Fixed: COD fee now overwrites a same-label legacy fee instead of skipping via idempotency. Operator-set €X is authoritative
- Marketplace Order Importer — Skroutz webhook integration repaired end-to-end: parser accepts both wrapped
{event_type, order:{…}}and flat{event_type, id, code, …}payload shapes; falls back toorder.codewhen Skroutz omits the numericid; uses Skroutz’s current line-item field names (product_name/unit_price/total_price); Mapper survives orphaned product references via try/catch + free-form line-item fallback - NEW:
REGISTEREDstate added to the MOI Accept/Reject button allowlist so Shopflix orders in their initial state actually show the action buttons - ACS Courier driver — ten fixes audited against the official ACS Rest API docs: response envelope preserved (so
ACSExecution_HasError+ per-rowError_Messagereach the UI); response traversal corrected toACSOutputResponce.ACSValueOutput; address split into street + number; Greek phone landline/cell split with+30stripping;Charge_Typedefaults to2, auto-switches to4when COD;Acs_Delivery_Productsauto-appendsCODwhencod_amount > 0; print uses the correctACS_Print_Voucheralias and decodes the base64 PDF; cancel uses the correctACS_Delete_Voucheralias;Weight+Cod_Ammountnow sent as JSON numbers (was being parsed by ACS with Greek locale, multiplying decimals by 10 on the printed label) - NEW: Recompute queue — atomic dedup at the AS schedule layer. New
pre_as_schedule_*filters with MySQLGET_LOCKshort-circuitas_schedule_*calls when a pending/in-progress action exists. Closes the dedup-bypass that let parallel recurring chains accumulate (one prod site had 225 pending ticks for a single hook before the fix) - Fixed: Session Tracker
trackAddToCartnow guards$button.*access and falls back to page context when callers fireadded_to_cartwithout the 4th$buttonarg. Fixes the spinner-stuck symptom on the swatches bulk-add path - NEW: Fulfillment vouchers —
postal_codecolumn stored at voucher creation. Migration is idempotent and runs on plugin upgrade - Fixed: Stock import now strips the UTF-8 BOM, transcodes Windows-1253 / ISO-8859-7 UTF-8, and synthesises a header row when the first line is data. Greek-locale Excel exports import without manual conversion
- NEW: Price export — Stock column + Vitals fast-path. Reading from the vitals cache turns a 90-minute export on a 25k-SKU catalogue into about 2 minutes; Live path unchanged
- Marketplace feeds — field parity with the wpwoof reference + universal
?cf-no-cache=1cache-bust on every emitted URL. Fixes the long-standingg:pricebug that was emitting the sale price instead of the regular price - NEW: Geniki monthly invoice CSV reconciliation card on Fulfillment Reports. Matches invoice rows to voucher rows; surfaces orphans either direction. Pattern is carrier-agnostic; Geniki is the first integrated
- Bulk fulfillment actions are now memory-protected. Lifts the practical limit from ~40 orders to 200–500+ depending on the carrier API
- Critical fix: WC 10.9 compat migration was looping forever. Replaced the broken “_product_image_gallery missing” gate with explicit
_aieo_variation_migratedmarkers (one prod site ran the loop 153,219 times across 2.5 days). New operator UI in DMM Variations gallery exposes the migration state - Fixed: Variation image storage now uses a two-hop join via
_product_image_gallery(WC 10.9 canonical)_thumbnail_idparent featured. Fixes the “variation image renders as the 40×40 swatch chip” regression - Fixed: Star ratings mobile non-FSE alignment + caption wrap. Defeats Botiga’s universal
button { min-width: ... }rule that pushed empty stars onto a second row
5.7 – 2026-05-24
Day-after follow-up to 5.6 — runtime-only brand blocks, engagement-gated Web Push, plus three small admin polish items
Web Push — engagement-gated banner (Chrome quiet-UI mitigation)
* NEW: the opt-in banner no longer mounts on a flat setTimeout(SHOW_DELAY_MS). It now waits for AIEO Session Tracker to dispatch an aieo:engagement CustomEvent on document at one of these milestones: pageviews-2, pageviews-3, scroll-25, scroll-50, scroll-75, add-to-cart, time-30s. The “Show delay (ms)” admin setting becomes a minimum-wait floor (banner never appears before that even if scroll fires at 2s)
* NEW: hard-cap fallback at 90s — visitors who never hit a milestone but also don’t bounce still see the banner eventually
* Graceful degradation: when AIEO Session Tracker is absent (operator disabled it OR runtime-only install without the admin asset), falls back to the original flat-timeout behavior so no install regresses
* Why this matters: Chrome’s quieter notification permission UI auto-denies prompts on domains with low acceptance rates. Asking bounce visitors on first-page-load poisons the reputation — every silent auto-denial counts as a “Block” signal. By only prompting engaged visitors, the acceptance rate per prompt climbs and Chrome’s quiet UI fires less aggressively over time
* Engagement signal source: AIEO_SESSION_TRACKER.pageViewsInSession (new public property, sessionStorage-backed, incremented eagerly even for bounce visitors so counts are accurate). New aieo:engagement CustomEvent is also dispatched from inside trackAddToCart and trackScrollDepth so other consumers can hook in too — no new tracker, just extends what’s already there
Brand blocks now runtime-resolvable — admin plugin no longer required for storefront pages that render aieo/brand-*
* NEW: AIEO_Runtime_Brand_Blocks delegate in the runtime plugin registers the six brand-related server-rendered blocks (aieo/brand-azindex, brand-slider, brand-rails, brand-related, brand-archive-hero, brand-story) at init priority 29 so they’re available even when the admin plugin isn’t in the request’s plugin whitelist. block.json + render.php files stay in the admin plugin’s directory (single source of truth); AIEO_Core_Brand_Vitals autoloads via the mu-plugins autoloader regardless of admin being active
* AIEO_Blocks_Loader::register_blocks() now consults WP_Block_Type_Registry::is_registered() before each register_block_type() call — when both plugins are active the runtime registration at init@29 wins, and admin’s loop at init@30 silently skips already-registered blocks (no more _doing_it_wrong notices from duplicate registration)
* Shared style handle aieo-article-cards (needed by brand-related) is also registered by the runtime delegate so brand-related renders correctly in runtime-only mode
* Use case: pages with brand sliders / brand A-Z directory / related-brands rails on category, blog, and landing pages no longer require the full admin plugin on every request — same render output, ~40 ms saved per page on cold-cache fetches
Fix — Session Tracker JS 404 + MIME-type refusal on every front-end page
* Fixed: aieo-session-tracker.js returned HTTP 404 with text/html body because the class was moved to the runtime plugin (Phase 1.5) but the JS asset was left behind in the admin plugin. plugin_dir_url(__FILE__) . '../assets/js/aieo-session-tracker.js' from the runtime class resolved to runtime/assets/js/aieo-session-tracker.js — which didn’t exist. Browsers logged “Refused to execute script from … because its MIME type (‘text/html’) is not executable” on every page load. The asset now ships alongside both plugin copies of the class so the runtime-first autoloader path finds its own asset
Critical fix — Web Push: opt-in pipeline broken by deferred JS + Service-Worker 404 + silent localStorage throws
* Fixed: AIEO_DMM_Web_Push now registers rocket_delay_js_exclusions on activation so WP Rocket’s “Delay JavaScript execution” feature stops treating aieo-push-optin, aieoPush, aieo-push-sw and aieo-magic-link-modal as deferred-until-interaction scripts. Without this, the opt-in banner JS only ran after a mouse-move / scroll / click that lands inside the page — bots, remote-desktop sessions, and visitors who follow a deep link straight to a product page never triggered it, so the subscribe POST never fired. Now Just Works on every install with no operator config
* Fixed: aieo-push-optin.js silently died on Edge’s Tracking Prevention (and Safari ITP) when localStorage.getItem() threw — the unguarded call killed the entire IIFE before the banner could even render. Now wrapped in try/catch; blocked storage is treated as “no cooldown set” so the banner still appears
* NEW: silent re-subscribe path — when Notification.permission === 'granted' from a prior visit but no wp_aieo_push_subscriptions row exists (e.g. the earlier SW-404 bug killed the original POST), the JS now silently registers the SW, calls pushManager.subscribe() and POSTs the result on page load. No banner re-prompt, no operator action — historical “granted but never recorded” users heal themselves on next visit
* Improved: postSubscription() now checks response.ok and throws on non-2xx so the outer try/catch records the failure instead of fire-and-forget. CFG.debug-gated console output for the operator who wants to dig in
* See docs/WEB_PUSH_INSTALL.md §4 for the Nginx location = /aieo-push-sw.js block — the third leg of this trio (404 SW URL was the upstream root cause on the FF prod incident 2026-05-23)
Data Prep Schedule — product_attributes stage added so brand blocks self-populate without the manual rebuild
* NEW: hourly data-prep cron now runs a product_attributes stage between category_hierarchy and product_vitals. This stage calls the AIEO_InsertCoreProductAttributes stored procedure with the operator’s configured brand / vendor / size / color attribute taxonomies — resolving parent brand_id from wp_term_relationships. The existing propagate_brand stage then copies parent variations as before
* Why it matters: brand blocks (aieo/brand-azindex, brand-slider, brand-rails, brand-related, brand-archive-hero, brand-story) used to render empty on sites where the operator hadn’t ticked “Please recreate the product core attributes and principal categories” in the Operational Efficiency Settings UI. That checkbox is now correctly scoped as a manual intervention only — the hourly schedule covers the day-to-day case
* Defensive: the new stage uses information_schema.ROUTINES to verify the SP exists before CALLing it — older installs without the SP get a clean no-op instead of breaking the whole tick
Google Reviews — single-location auto-fallback + clearer empty states
* NEW: when the aieo/google-reviews block (or [aieo_google_reviews] shortcode) is in “Single location” mode but no slug is set AND the page can’t auto-resolve a location from context, the block now falls back to the operator’s only configured location if exactly one exists. Most SMB stores have a single physical shop — they no longer need to pick a slug for every block instance, the block just works
* Improved: the empty-state message now shows the actual number of locations configured and steers the operator to the right next step. “No Google Reviews locations configured yet — add one under…” (when 0 exist) vs “You have N locations configured — pick one via the block’s sidebar, or switch to All-locations / Cards grid mode” (when 2+ exist). Replaces the old cryptic “Set a location slug, or place this block on a page bound to a location row”
* The admin Settings tab now carries a full “How to display the reviews on the storefront” help card explaining the FSE block, the three shortcodes, all 11 attributes, and a do_shortcode() PHP-template snippet — so operators on classic themes / page builders find the docs without leaving the admin
Google Reviews — shortcodes for non-FSE themes + runtime-only exposure
* NEW: [aieo_google_reviews] shortcode — wraps the same render path the aieo/google-reviews block uses, so classic themes / widget areas / page-builder …
























