Printcart Canvas Print

Description

Printcart Canvas Print adds a Customize with PC Canvas button to the
WooCommerce add-to-cart form of the products you enable. The button opens the
Printcart-hosted designer in a full-screen overlay. There the customer picks a
size, an edge style and a depth, designs the canvas, and sees an edge-wrap
preview rendered by Printcart before adding it to the cart.

The plugin is the WooCommerce side of the Printcart service. The designer, the
preview renderer, the print-quality check, the pricing and the order hand-off
all run on Printcart, so a Printcart account is required. “External services”
below lists exactly what is sent and when.

What “3D preview” means here

Printcart returns a flat preview image of the wrapped canvas, a lit and
angled mockup. It is not an interactive or rotatable 3D model.

Features

• A “Customize with PC Canvas” button in the WooCommerce add-to-cart form, for
  classic templates and the add-to-cart form block. It is shown only on
  products that are enabled and linked to a Printcart product and side. Other
  products get no PC Canvas markup at all.
• A full-screen overlay hosting the Printcart designer, with an origin-checked
  message bridge. The launch configuration is fetched only after the customer
  clicks.
• Five edge styles: image wrap, mirror, blur, blurred mirror and solid colour.
• Edge style, depth and size come from your own Printcart printing option,
  including its conditional fields, and are saved on the WooCommerce order.
• Cart prices are calculated by Printcart on the server and held as a
  single-use reservation. A price sent by the browser is never trusted.
• Print-quality (DPI) checking of the customer’s image for the chosen size,
  with a DPI Profiles screen to set the minimum quality and what happens below
  it.
• Paid canvas orders are sent to Printcart in the background. You can turn
  this off on PC Canvas > Connection.
• A PC Canvas admin menu: Dashboard, Products, Product Setup, Printing Options,
  Canvas Templates, DPI Profiles, Orders, Artwork, Connection and Diagnostics.
  Every screen works with JavaScript turned off.
• Product Setup owns the canvas geometry and shows one readiness verdict, with
  the next action, for each product.

Requirements

• WooCommerce, installed and active.
• A Printcart account, with its Store SID and Secret (used by your server) and
  its Unauth Token (used to load the designer), entered on PC Canvas >
  Connection.
• A paid Printcart plan for previews and order sync. On Printcart’s free plan
  Printcart refuses the preview render and the order sync with “Upgrade your
  account”. Print-quality checks and previews spend tokens from the store
  owner’s Printcart wallet; see “External services”.

PC Designer

PC Canvas does not need PCDesigner – Web 2 Print Solution or any other
designer plugin. If PC Designer is also active, PC Canvas reads only whether it
is switched on for a canvas product, so that it can keep PC Designer’s “Start
Design” button and editor redirect out of the way on that product and warn you.
It never changes PC Designer’s settings or data.

External services

This plugin connects your WooCommerce store to Printcart, a third-party
print-production service. It cannot work without it: the designer, preview,
print-quality check, pricing and order hand-off run on Printcart. Nothing is
sent to Printcart until you enter your Printcart credentials on PC Canvas >
Connection and link a product to Printcart.

The plugin never sends your customers’ names, email addresses, phone numbers,
billing addresses or shipping addresses to Printcart. Like any server-to-server
request, each call also carries your server’s IP address and the standard
WordPress user agent, which includes your site address and WordPress version.

1. Printcart API: https://api.printcart.com/v1

Called by your server, never by the browser. It is the only host that receives
your SID and Secret. The address can be changed with the “API base URL” field
on the Connection screen.

In wp-admin, when you act.

• Connection test: reads your store details and plan (GET /stores/store-details, GET /account/wordpress-plan) and checks the Unauth Token (GET /products).
• Product setup: looks up the Printcart product for a WooCommerce product by its WooCommerce product ID, reads products, sides, side geometry, 3D settings and production readiness, and reads your printing options (/printing-options/resolve, /printing-options/{id}/wordpress). No customer data.
• When you ask for it: creates a Printcart product from the WooCommerce product name (POST /products), writes side sizes (PUT /sides/{id}) and saves the 3D profile (edge style and depth).
• Test preview: uploads a test image and renders it, as below, at the same token cost.
• Support export: the same read-only checks plus GET /integration/woocommerce/sync-health. The export is shown to you to copy; it is not sent anywhere.

In the background. When a product’s saved copy of its printing-option
fields is older than 15 minutes, WP-Cron reloads it
(GET /printing-options/{id}/wordpress) in its own request. No customer data.

When a customer asks for a preview (the designer asks automatically when the
customer changes an option the preview depends on):

• POST /images: a PNG snapshot of the design (up to 10 MB) and its file name, so Printcart can host it.
• POST /3d/edge-preview: the Printcart product and side IDs, the hosted image address, the edge style and colour, the output size, and the customer’s size and depth.
• Metered: 1 token per render Printcart performs, from the store owner’s wallet, billed to you. A render Printcart serves from its cache is free, but a repeat of the same design is not guaranteed to be served from cache. Refused on Printcart’s free plan. Any visitor who opens the designer on an enabled product can trigger renders.

When a customer’s image is checked for print quality (on upload, on a size
change and before add to cart):

• POST /customizer/preflight/dpi: the Printcart product and side IDs, the canvas size in pixels and inches, and each placed image’s pixel dimensions (up to 100 images). No image and no image address are sent.
• Metered: 2 tokens per request from the store owner’s wallet, billed to you. If the wallet is empty the customer keeps the local estimate and the designer stops asking for that session.

When a customer confirms a design and adds it to the cart:

• POST /printing-options/{id}/calculate: the quantity, canvas size and unit, and the customer’s option choices, so Printcart can price the line.

Automatic order sync, on by default. When an order that contains a designed
canvas line is paid (WooCommerce status processing or completed), the order is
sent in the background with POST /integration/woocommerce/orders, never
during checkout. Bank-transfer and cheque orders wait until you mark them
paid. A failed send is retried twice.

• Order: order ID and number, status, currency, total, subtotal, shipping total, tax total and creation date.
• Each canvas line: line ID, WooCommerce product and variation IDs, product name, quantity, the design file and preview addresses, and the canvas details (Printcart product, side and profile IDs, size, geometry, edge style, colour, depth, layout and panel count).
• Not sent: customer name, email, phone, billing or shipping address, customer ID, payment details, order key and customer note.
• Turn it off: untick “Send paid orders to Printcart automatically” on PC Canvas > Connection. Retry sync on PC Canvas > Orders still sends a line by hand.

Terms of Service: https://solution.printcart.com/tos/licenses-and-terms
Privacy Policy: https://printcart.com/privacy-policy

2. Printcart designer: https://customizer.printcart.com

When a customer clicks “Customize with PC Canvas”, their browser loads the
Printcart designer in an iframe. Its address carries your shop address, your
store’s Unauth Token, the Printcart product and side IDs, the WooCommerce
product and variation IDs, and a short description of the canvas. From then
on the designer is Printcart’s application: it loads its own files from
Printcart, and the photos the customer uploads and the design they make go to
Printcart. The address can be changed with the PC3D_APP_URL constant.

The Unauth Token is readable by any visitor to an enabled product page, by
design. It cannot change your products’ canvas geometry, but it is not a
read-only key: Printcart accepts it for some write requests, such as saving
design templates. It can appear in browser history, server logs and Referer
headers. You can rotate it from your Printcart account.

Terms of Service: https://solution.printcart.com/tos/licenses-and-terms
Privacy Policy: https://printcart.com/privacy-policy

3. Printcart file hosting

Uploaded design images and rendered previews are stored by Printcart and
served from the address Printcart returns for them. The customer’s browser and
your wp-admin load those images from there.

Terms of Service: https://solution.printcart.com/tos/licenses-and-terms
Privacy Policy: https://printcart.com/privacy-policy

API reference: https://docs.printcart.com/rest-api-reference/