Guia de instalação

Install the Printofor plugin

Set up the WooCommerce-native gang sheet builder in your store in seven steps. You only need to do the connection steps once.

  1. Check the requirements

    Confirm your environment before you begin.

    • WordPress 6.2 or newer.
    • WooCommerce installed and active (the plugin will not activate without it).
    • PHP 8 or newer.
    Note. If WooCommerce is missing, activation stops with a clear error and the plugin stays inactive. Install WooCommerce first.

  2. Install and activate the plugin

    Add the Printofor Gang Sheet Builder plugin and activate it.

    • Go to Plugins > Add New and upload the Printofor plugin zip, then click Install.
    • Click Activate. A top-level Printofor admin menu appears with Overview, Settings, and Legal.

  3. Connect the builder and engine

    Open WooCommerce > Settings > Printofor and fill in the connection fields. These are set once at deploy time and should not need to change afterward.

    • Builder Service URL - base URL of the deployed builder, for example https://builder.printofor.com.
    • Engine API Base URL - base URL of the engine used for price validation and export. Must not include a trailing slash.
    • API Secret - this shop's secret for engine authentication, the value provisioned for this shop. It is not the engine master secret.
    • Shop ID - the tenant identifier for this shop. It is auto-generated on first save; do not change it unless instructed.
    Local development. Leave the Builder Service URL and API Secret blank to run without authentication while developing locally.

  4. Create and enable a gang sheet product

    On any WooCommerce product, open the Printofor tab in the Product data panel.

    • Tick Enable Printofor builder. The builder then replaces the standard add-to-cart area on that product.
    • Choose the Product path mode: Build (open the builder), Upload (customer uploads a ready file), or Both.
    • Set Roll width presets (inches), a comma-separated list such as 22,24. Leave blank to use the default of 22.
    • Optionally set a Default sheet length to pre-fill the builder; leave blank to let nesting determine the length.

  5. Optional: conversion tools, Canva, and SMTP

    Still under WooCommerce > Settings > Printofor, enable the extras that fit your shop.

    • Cutoff countdown - a live same-day production countdown on product pages, with your cutoff time and an after-cutoff message.
    • Loyalty earn display - show points or credits earned, at a rate you set.
    • Social proof - star rating, review count, and up to six trust badges near the buy action.
    • Lead capture popup - an email capture popup that reveals an existing WooCommerce coupon code.
    • Canva import - add an Import from Canva button (the engine needs the Canva credentials set as environment variables).
    • SMTP - route transactional email through your own SMTP host instead of the site default.

  6. Place a test order and generate print files

    Run one order end to end to confirm the full flow.

    • Open your enabled product, design a sheet in the builder, and add it to the cart.
    • Complete checkout as a customer would. The layout is stored with the order.
    • Open the order and run the Generate print files (Printofor) order action. Each sheet exports a print PNG and a white underbase, linked from the order items panel.
    Export needs the engine URL. If the action reports it is not configured, set the Engine API Base URL in step 3 before retrying.

  7. Accept the license and go live

    Before using the builder in production, open the Printofor > Legal menu and accept the Shop License Agreement. The acceptance date is recorded. Your store is now ready to take real gang sheet orders.