User Manual Quickstart General Concepts Buyer Side Snippets Engraving Styles and Form Fields Flex Designs Sub Documents Scripting Workflows Editing Workflow Production Workflow Tutorial Videos Frame Features Resources Account Portal Style Reference Change Log Known Bugs & Limitations Glossary Acknowledgements Integrations Woo Commerce Lets start installing Shopify Api Reference Authorization Tokens Embedding The Editor Custom Integration Backend Api Price Display

WooCommerce Plugin

How to Install and Configure the Printess WooCommerce plugin

Please have a look at our example woocommerce shop using this plugin.

Lets start installing

Download our WooCommerce plugin: https://editor.printess.com/printess-plugin.zip

Unfortunately, this is not yet available for selection from the WordPress plugins, but we will submit it soon - after we got some feedback.

Copy the content of the zip file to the plugins folder so that the php file has the following path: wp-content/plugins/printess/printess.php), then you can activate it manually in the WordPress plugins.

Install the plugin

After activating it, a menu item “Printess” appears at the very end of the WooCommerce section. There you must make a few settings.

Plugin settings

Important are the two Printess access tokens (Shop-token and Service-token) that you can find in the editor at API Tokens in the top right account menu or on the account page, which you can reach via a link (https://account.printess.com/#account).

Printess token

Please also fill Api-Domain (by default api.printess.com) and Embed-Html (by default https://editor.printess.com/printess-editor/embed.html). You can also address specific versions of the editor e.g. by choosing editor.printess.com/v/1.0.0 and https://editor.printess.com/v/1.0.0/printess-editor/embed.html

In IDs to hide when showing the editor you must name every element id from your WooCommerce theme which needs to get hidden (otherwise it will show in front of the editor). Please make sure that nothing is left. The Printess editor needs to be fullscreen especially for mobile use.

Additional classes for customize buttons you need to name all classes of add to cart buttons which should get a customize button for Printess products.

You can set Order Approval Mode to “Manual” for now - this will not send the Printess products to the API for production immediately and you can approve it manually. Setting it to “Auto” will automatically sent jobs to the Printess API when the shop order is created.

How can you create a Printess product? Create a new “Simple Product”. In the item settings you will find a “Printess” tab. Of course also existing simple products can easily become Printess products.

Create product

In the Printess tab you can search for published Printess templates or enter them manually. Additionally its possible to configure up to 3 merge templates. Leasrn more about merge templates here.

Create Printess product

After setting up template and eventual merges update/publish as usual via “Update”.

Publish product

Done! Now it is a Printess product. Therefore the product page has changed:

Product page

The “Add to Cart” button is gone, but there is a new “Customize” button. The first thing a customer needds to do is to customise the product. The Printess editor should open like below.

Customise Product

Once configured the customer can press the add to cart button. The customised product will be added to the cart and show its configuration with a small cart image.

Product in cart

From here it can be edited again by selecting the ‘Edit’ link and add it to the cart again. In this case the new version will shown additionally in the cart.

Once the order is finished, you can see its details in the order view. As Manual release mode is set in our example shop each order element must now be approved manually, by clicking “Approve and send to production”.

Product in cart

After some time, the production result(s) will show as a link to download the pdfs.

In case a customer order needs to be changed - you can do so by selecting ‘Edit Customer Order’.

If there is any error during production, it will also appear here.

If you have any additional questions or got stuck anywhere please contact us at support@printess.com we are happy to help!