WooCommerce Companion Plugin

Quick2Print v1 uses WooCommerce REST API credentials for product creation and the official Printful WooCommerce plugin for the store-side Printful connection. A separate custom Quick2Print Companion plugin is also available in the repo for WordPress-side health checks, product snapshots, draft creation, and repair rescan checks.

Plugin Roles

• The official Printful Integration for WooCommerce plugin is required for WooCommerce products to appear in Printful as synced products.
• The custom Quick2Print Companion plugin lives at plugins/quick2print-companion/quick2print-companion.php and exposes the quick2print/v1 REST API namespace for staging validation and bridge diagnostics.
• Quick2Print app publishing currently uses WooCommerce REST and Printful API credentials directly, so the custom plugin should be tested as a separate contract until it is wired into the app workflow or retired.

When It Is Required

Quick2Print uses the official Printful Integration for WooCommerce plugin as the supported production bridge. We create WooCommerce products first, then wait for the connected Printful store to discover them as synchronised products.

Quick2Print lets a brand test template setup before production synchronisation is configured. We do not mark production publishing ready until WooCommerce credentials, Printful credentials and the WooCommerce plugin connection are healthy.

The custom Quick2Print Companion plugin is experimental, optional, and not part of required onboarding. Use it only for isolated bridge-endpoint experiments when a deployment has explicitly adopted those endpoints.

Install The Official Printful Plugin

1. In WordPress, open Plugins and install Printful Integration for WooCommerce.
2. Activate the plugin for the WooCommerce store used by the connected store.
3. Open the Printful plugin area in WordPress and connect it to the correct Printful store.
4. Confirm the store appears in the Printful dashboard before running Quick2Print production actions.

The planning reference currently tracks version 2.2.12, which requires WordPress 5.3+ and PHP 5.6+. The connected store should also run a supported WooCommerce version with REST API access enabled.

Configure WooCommerce

Confirm WooCommerce uses supported REST URLs and pretty permalinks. Quick2Print writes through the WooCommerce REST API, so provider settings still need the store URL, consumer key, and consumer secret from Connect WooCommerce.

Use a REST API key with read/write access so Quick2Print can read categories and tags, create products and variations, update product data, and sync generated mockups back to WooCommerce.

Configure The Custom Quick2Print Companion

1. Install and activate plugins/quick2print-companion/quick2print-companion.php in WordPress.
2. Open WooCommerce -> Quick2Print.
3. Save a strong API token.
4. Use the same token as the x-q2p-token header when manually testing the custom companion REST endpoints.

The custom plugin exposes:

• GET /wp-json/quick2print/v1/health
• GET /wp-json/quick2print/v1/products/{id}/snapshot
• POST /wp-json/quick2print/v1/products/draft
• POST /wp-json/quick2print/v1/repair/rescan

Configure Printful

Quick2Print expects the WooCommerce store and Printful store to match the same connected store. We also require the Printful private token described in Connect Printful.

Quick2Print keeps each brand's WooCommerce credentials, Printful credentials and plugin status scoped to the intended storefront. We recommend checking the active brand before changing a connection.

Readiness Checks

Before running production workflow actions, verify:

• WooCommerce REST API credentials are saved in Quick2Print.
• The Printful private token is saved in Quick2Print.
• The Printful WooCommerce plugin is active and connected in WordPress.
• The custom Quick2Print Companion health endpoint passes when that bridge is part of the test scope.
• A test WooCommerce product can sync into Printful.
• Quick2Print publishes WooCommerce products live by default; we let workspace admins switch the brand to draft creation in brand settings when review is required.

If products do not appear in Printful after WooCommerce creation, use Troubleshoot sync and check the plugin connection before retrying Printful discovery.