AOO Shop

AOO Shop is the official WordPress plugin of AooCommerce (https://www.aoocommerce.com/), an online selling platform (orders, stock, chat and marketplaces in one place). AOO Shop puts your AooCommerce shop on the WordPress site you already have, so search engines and AI assistants find your products together with your articles.

Product, category, brand, collection, budget, search, delivery/FAQ and cart pages are served from AooCommerce on your own domain, inside your theme. Products, prices, stock and orders stay in AooCommerce — nothing is copied into WooCommerce and no iframe is used. Customers check out on the AooCommerce checkout page.

An AooCommerce account is required. The plugin does nothing on its own; it shows the shop of the AooCommerce account you connect it to.

Features

• SEO on your domain: title, description, canonical, Open Graph, one Product JSON-LD per page, sitemap and llms.txt (works with Rank Math, Yoast SEO or no SEO plugin)
• Cart on your domain, checkout on AooCommerce — orders arrive in AooCommerce tagged with your website
• Product cards in posts: shortcodes [aooshop_products], [aooshop_product], [aooshop_cart_icon], block editor blocks and Elementor widgets
• Browse widgets: [aooshop_collections] (with festival countdown), [aooshop_chips], [aooshop_filters], [aooshop_search] (autocomplete), PHP helpers and a read-only REST API for themes
• Shop templates per page type (all products, category, collection, budget, search) built with Elementor (free) or blocks from [aooshop_content part="header|filters|grid|footer"]
• Elementor (free) widgets in the “AOO Shop” category: Shop Part, Filters, Collections, Chips, Products, Search, Cart Icon — styled through CSS variables
• 301 redirects from old WooCommerce URLs, a menu converter and page cache with automatic purge when products change in AooCommerce
• “AOO Shop” admin menu: read-only web orders (opt-in in AooCommerce, fetched live, never stored in WordPress) and products, with links back to AooCommerce
• Connect with a 6-character code — no API key to copy

Translations

Source strings are English. A Thai translation is included. Storefront text (cart, checkout hand-off, widgets) follows the shop language of AooCommerce (Thai) — use the aooshop_frontend_locale filter to follow the site language instead.

Developers

• REST namespace aooshop/v1
• Every function, class, hook, option, shortcode, block, widget and REST name is prefixed aooshop_ / AooShop_ / aooshop-. Content saved by earlier versions (shortcodes [aoo_shop_*] / [aoo_*], blocks aoo-shop/* / aoo/*, Elementor widgets aoo-shop-* / aoo-*) is rewritten to the current names once, when the plugin first loads after the update.
• Filters: aooshop_api_base, aooshop_health, aooshop_festival_dates, aooshop_frontend_locale, aooshop_kses_allowed_html, aooshop_client_ip
• WP-CLI: wp aooshop status, wp aooshop connect <code>, wp aooshop menu-convert, wp aooshop content-convert

External services

This plugin is a connector to the AooCommerce service (https://www.aoocommerce.com/), operated by AooCommerce. It cannot work without it. Nothing is sent before the site owner connects the plugin to an AooCommerce account (pairing code or API key in AooCommerce › Settings).

All server-to-server requests go to https://app.aoocommerce.com (the AooCommerce API) with the site’s API key and a User-Agent of the form aoo-shop/<version>; <site home URL>.

• Connecting (pairing) — when the owner enters a 6-character connection code in the settings screen or runs wp aooshop connect, the code and the site address are sent to /api/storefront/embed/pair; the API key for this site comes back.
• Connection check (ping) — after connecting, when the owner clicks “Test connection”, once a day by WP-Cron, and after AooCommerce asks the site to refresh: a request to /api/storefront/embed/ping returns the shop settings (URL prefixes, price ranges, whether orders are accepted, cache purge secret). The site address is sent in the User-Agent.
• Shop pages and cards — when a visitor opens a shop page or a post with product cards and the page is not in the local cache, the plugin fetches the page HTML and SEO data from /api/storefront/embed/page, /api/storefront/embed/cards, /api/storefront/embed/sitemap, /api/storefront/embed/llms and the read-only data API /api/storefront/embed/data/* (products, filter counts, collections, search suggestions, approved product reviews). Only the requested page type, slug, filters (search words, price range, sort, page number, minimum review stars) are sent — no visitor data.
• Checkout hand-off — when a visitor clicks “Checkout”, the cart contents (product variation IDs and quantities), a coupon code if the visitor used a coupon link, the referring page and UTM campaign parameters are sent to /api/storefront/embed/cart-token. The visitor is then redirected to the AooCommerce checkout page (https://app.aoocommerce.com/store/<shop>/checkout), where they enter their delivery and payment details under AooCommerce’s terms. The cart status page asks /api/storefront/embed/cart-token/<token>/status whether that order was placed.
• Admin screens — “Orders” and “Products” in the AOO Shop menu fetch data live from /api/storefront/embed/admin/* and /api/storefront/embed/summary when a permitted user opens them (orders only if the shop enabled sharing in AooCommerce). Nothing is stored in WordPress.
• WooCommerce migration (optional, owner action) — “Import collections” and “Redirects” send WooCommerce category/product names, slugs and SKUs to /api/storefront/embed/collections/import and /api/storefront/embed/redirect-map to match them with AooCommerce products.
• Stylesheet — the storefront stylesheet storefront-embed.css is downloaded from https://app.aoocommerce.com when its version changes and stored in wp-content/uploads/aoo-shop/, so visitors load it from your own domain. If copying fails, visitors’ browsers load it from https://app.aoocommerce.com.
• Cache purge (incoming) — when products change, AooCommerce sends a signed request (HMAC with the site’s secret) to /wp-json/aooshop/v1/purge on your site. It contains only product/category/brand/collection slugs to refresh.
• Images and links seen by visitors — product images in the shop HTML are loaded by visitors’ browsers from https://app.aoocommerce.com/api/thumb (resized images), AooCommerce file storage, or the marketplace image hosts the product was imported from (Shopee, Lazada, TikTok Shop CDNs). Those hosts receive the visitor’s IP address and browser details as with any image.

AooCommerce Terms of Service: https://www.aoocommerce.com/legal/terms
AooCommerce Privacy Policy: https://www.aoocommerce.com/legal/privacy