README

Thank you for using the "Printess Designer module for Magento2" (Digitalprint_PrintessDesigner).

This package contains everything you need to connect Printess with your Magento commerce shop to get the most advanced editor for print automation and mass customization.

Developed and tested on Magento 2.4 only. Feel free to send us an issue if they are any problems with the extension.

1. Documentation

• Contribute on Github
• Releases
• Printess Knowledge Base

2. How to install Printess Designer Extension

Install via composer (recommend)

Run the following command in Magento 2 root folder:

composer require digitalprint/magento-2-printess-designer
php bin/magento setup:upgrade

3. User Guide

This module integrates the Printess Editor into Magento2. If the module is activated and a product is configured accordingly, the buy button is automatically replaced with the design button. When clicked, the preconfigured designer opens to edit the product. Finished configured products can be put directly into the shopping cart via the designer. The relevant configuration is saved and transmitted through the normal magento checkout.

After the purchase, the store owner can simply download the generated PDF from printess via the sales overview.

3.1 General Configuration

Log into the Magento administration panel, go to Stores > Configuration > Printess > Designer

Choose Yes to enable the extension.

3.1.2 API-Token

You will find your Shop- and Service-Token in your printess account in the account menu to the right of the top menu bar.

• Shop Token: The shop token allows loading of templates and snippets, upload images and saving / loading the current layout.
• Service Token: The service token has access to the production api and can render PDFs or PNGs.

3.1.3 Colors

Choose color. This will change the color of primary elements like links, buttons, etc ...

3.1.4 Output

• Origin: Identifier for orders from this magento scope.
• Optimize Images: Global setting. Enable images optimization during the rendering of print files.
• DPI: Global fallback. Each product can have individual print resolution settings.

3.2 Product Configuration

Each product must be configured individually for the editor. This can be done for the respective product in the catalog under the item "Printess". The following fields can be configured.

• Template-Name: the name of the template assigned in Printess.
• Document-Name: optional, if not supplied primary or first document is used.
• Form Fields (JSON): read "mapping the form fields" for detailed informations.
• DPI: optional: optional, overwrite global print resolution settings

3.3 Mapping the form fields

Since there is no direct link from a Printess template to a Magento product, a mapping is necessary which is created via this JSON field.

Example:

[{"printess_ff_name": "DOCUMENT_SIZE", "pim_attr_name": "poster_din_format", "value": "42x59.4"}]

The attribute printess_ff_name contains the configurable property which is configured in printess. In this example it's "DOCUMENT_SIZE". In Magento a configurable product must be created. The attribute values must be the same as in Printess.

4. Download print files

After a customer has completed an order with Printess products you will find the download link to the pdf file under "Items Ordered" listed at the order details.

Admin > Sales > Orders > #ID > Items Ordered