🛒 PrestaShop integration

How to integrate the PrintWearAI configurator on a PrestaShop 1.7+ store: theme snippet, automatic add-to-cart via the cart controller, and product mapping.

How it works

1. embed.js injects the 3D configurator as an iframe on your product pages.
2. When the customer clicks add-to-cart inside the configurator, the widget emits an add_to_cart event to your page.
3. The built-in PwaiEmbed.handlers.prestashop() handler posts the item to the PrestaShop cart via the AJAX cart controller (controller=cart).

Step 1 — Install the snippet in your theme

Add the snippet to your product template (child theme templates/catalog/product.tpl, or a "custom HTML" module). Passing the product reference via data-sku is the most reliable way to tell the widget which product the page shows:

<div id="pwai-configurator" data-sku="{$product.reference}"></div>

<script src="https://printwearai.com/embed.js"
        data-key="fk_YOUR_KEY"
        defer></script>
<script>
  document.addEventListener('DOMContentLoaded', function () {
    PwaiEmbed.handlers.prestashop();   // automatic PrestaShop cart
  });
</script>

• data-key is your public embed key (fk_…), found in your workspace → Integration. It is required — the widget only reads data-key.
• There is no PrestaShop-specific auto-detection: the widget falls back on generic strategies — window.PWAI_PRODUCT, a <meta name="pwai:sku"> tag, data-sku / data-product-id on the container, or JSON-LD Product markup if your theme outputs it. The data-sku attribute above covers all standard themes.
• Useful optional attributes: data-height (default 700), data-locale (fr/en/es/de/it), data-product (force a catalog slug), data-autodetect="false", data-no-consent="true".

Step 2 — Map your products (no automatic import)

Unlike Shopify and WooCommerce, there is no automatic product import for PrestaShop — a sync brings back 0 products. Map products manually instead:

1. Tenant workspace → Products → edit your 3D product → External catalog link.
2. Set SKU / reference to the PrestaShop product reference (must be identical on both sides — this is what data-sku / /api/resolve matches).
3. Set External product id to the PrestaShop id_product — this is what the cart handler posts as id_product.

Automatic add-to-cart

PwaiEmbed.handlers.prestashop(options) registers a handler that, for each add_to_cart event:

1. Reads m.product.external_product_id. If it is missing it logs a warning and does nothing — the product must be mapped.
2. Reads the CSRF token from input[name=static_token] on your page (rendered by standard PrestaShop themes) and appends it as token if present.
3. Sends POST /index.php (with cookies) with these form fields:

4. Redirects to /panier (disable with { redirect: false } — see pitfalls below if your cart lives at another URL).

Prefer full control (e.g. product combinations, custom cart URL, storing the thumbnail)? Register your own callback instead of the built-in handler:

PwaiEmbed.onAddToCart(function (m) {
  // m.config_id, m.quantity, m.sizes,
  // m.product.external_product_id, m.customization.thumbnail …
});

FAQ & common pitfalls

• Nothing shows, console says data-key missing — you wrote data-embed-key; the widget only reads data-key.
• Redirected to /panier but my cart is at another URL — the built-in redirect targets /panier. Call PwaiEmbed.handlers.prestashop({ redirect: false }) and redirect yourself, or use PwaiEmbed.onAddToCart(fn).
• Console warning "id_product Presta manquant" — the 3D product has no external_product_id. Set the PrestaShop id_product in Products → External catalog link.
• Cart controller rejects the request — the handler could not find input[name=static_token] on the page. Make sure your theme renders it (standard themes do), or add the item yourself via PwaiEmbed.onAddToCart(fn).
• customization[flare_config_id] is not stored on the order — PrestaShop only persists customization fields declared on the product. Add a text customization field to the product (or a small module) if you need the config id on the order line; the id is always available in your PrintWearAI workspace → Orders regardless.
• Add-to-cart opens the PrintWearAI hosted cart instead of the PrestaShop cart — the event is only sent to your page when the 3D product carries an external_product_id. Map the product.
• Add-to-cart does nothing and logs "add_to_cart sans handler" — you forgot to call PwaiEmbed.handlers.prestashop() (or PwaiEmbed.onAddToCart(fn)).
• Combinations (declinaisons) — the handler posts id_product only, without id_product_attribute. For combination-level control, use PwaiEmbed.onAddToCart(fn).
• Upgrade notice instead of the widget — the embedded widget requires a Pro plan or higher.

See also: Embed widget · Webhooks · Custom site (API)