Shapiko 3D Configurator for WooCommerce

Description

Shapiko builds 3D product configurators with exact pricing for build-to-order products: railings, gates, fences and more. A buyer enters sizes and picks options, and sees the product in 3D with the price, the parts list and drawings. The configurator checks the rules (spacing, maximum spans, what fits with what), so only valid configurations get a price.

This plugin connects your Shapiko configurator to your WooCommerce store:

• On product pages. Give a product a Shapiko configurator slug, and the configurator appears under the product summary.
• Anywhere else. Use the “Shapiko 3D configurator” block or the [shapiko_configurator] shortcode on any page or post.
• Exact parts in the cart. The configurator’s “Add to cart” button adds the exact products and variations, with their quantities, to your WooCommerce cart. It adds all of them or none.
• Your prices. The cart charges your WooCommerce prices. Shapiko checks, when it builds the configurator, that its prices match your products.
• The configuration goes with the order. Each cart line shows “Configuration: “. The order keeps the quote number on its lines, and the first line also gets the configuration details (sizes and options), so you know what to build.
• Works with your cart. Classic cart and checkout, and the Cart and Checkout blocks. HPOS compatible.

A Shapiko configurator is a paid service. Shapiko builds it from your products and price list; you review it before it goes live. See shapiko.com.

How the cart works

1. The configurator runs in a frame from https://shapiko.com.
2. When the buyer clicks “Add to cart”, the configurator sends the list of products and quantities to your page, inside the buyer’s browser.
3. The plugin accepts that message only from https://shapiko.com, and only from the plugin’s own frame. It checks every line (whole product IDs, quantities from 1 to 9999, at most 100 lines).
4. It adds the lines through your store’s own WooCommerce Store API. If any line fails (for example, out of stock), or the store would change a quantity (minimum or pack sizes), it takes the lines it just added out again and shows the reason in the configurator.
5. Then it goes to the cart page, or stays on the page and shows a notice, as you choose in the settings.

Before the configurator is live

Buyers see the configurator only once it is live, and only on the domains it is live for. Anywhere else the block folds away, so buyers see nothing. Logged-in editors see one line explaining why (not live yet, a domain that is not listed, or an unknown slug).

External services

This plugin shows the Shapiko configurator service, which runs on https://shapiko.com. It is needed: the configurator itself (the 3D view, the pricing and the parts list) is the service.

• What is loaded, and when: on every page that shows a configurator, the buyer’s browser loads the configurator page https://shapiko.com/p/<slug>/v/latest/ in a frame. The frame loads when it scrolls into view.
• What is sent: the configurator slug, your site’s address (scheme and domain, so the configurator can talk to your page), and the button label you set. As with any web page, the buyer’s browser also sends its IP address and user agent to shapiko.com. The configurator page loads the three.js 3D library from cdn.jsdelivr.net.
• What is not sent: the plugin sends no cart, order or customer data to Shapiko. The items are added through your own store’s API, in the buyer’s browser. Nothing is sent when no configurator is shown.

Shapiko’s terms of service: https://shapiko.com/terms/ and privacy policy: https://shapiko.com/privacy/. jsDelivr’s privacy policy: https://www.jsdelivr.com/terms/privacy-policy-jsdelivr-net

Privacy

The plugin stores no personal data of its own. It adds two things to your WooCommerce data:

• a cart item field with the configuration’s quote number (for example, “SMP-1K2J3H”), saved on the order lines as “Configuration”;
• the configuration details (the sizes and options the buyer chose), kept in the buyer’s WooCommerce session until checkout and then saved on the first order line of that configuration as “Configuration details”.

Both come from the buyer’s browser, like a product option. They are part of the order, and WooCommerce’s own export and erasure tools cover them. Uninstalling the plugin deletes its settings and the products’ “Shapiko configurator slug” field; orders keep their lines.

Suggested text for your privacy policy: “Our product configurator is provided by Shapiko (shapiko.com). When you open a page with the configurator, your browser loads it from shapiko.com, which receives your IP address and browser details. The configuration you choose is added to your cart and order on this site.”