V1.3


The below is a step-by-step guide to updating your products and application configuration to work with Version 2, so that products can be created in the Reseller app. 


Workflow Helper Functions


There are a number of features available in the Products (App) screens that can be used when upgrading. These should be considered when following the steps below.


View Types

Click on the option at the top of the screen ('Click to create a view type for each aspect') to automatically generate View Type records for all Aspects set to the product.  Note that any view types that currently exist may be duplicated in this process and may need deleting.


View Groups

Click on the option at the top of the screen ('Click to create view groups for a specific attribute') to automatically generate View Group records for all values for the attribute you select.  Note that any view groups that currently exist may be duplicated in this process and may need deleting.


Views

Use the Duplicate functionality on the popup menu of a View to create a copy which can then be modified.


Print Areas

Use the Duplicate functionality on the popup menu of a Print Area to create a copy which can then be modified.


App Functions

Click on the option at the top of the screen ('Click to create all functions for all view types') to automatically generate App Function records for all defined view types.  Note that if the product is set as 'Personalisable' on the Details tab, then the Personalisable app functions (Image Area, Text Area, Colour Area) will also be generated.   Any app functions that currently exist may be duplicated in this process and may need deleting. 


Related Configuration

There are a number of configurable items used in App V2 that should be configured alongside the products.  It is recommended that these are configured before the products so they can be linked to them where applicable.


Font and Colour Groups

When creating Personalised products, resellers create and select font and colour groups, depending on the allowed functionality of the product configuration in the consumer configurator:

  • A Text Area function allows the consumer to add text to their product, and requires a font group for configuration.  It may also have a colour group to allow the consumer to set the text colour from a preset list, or a free-form entry to allow selection of any colour.
  • A Colour Area function allows the consumer to set a background colour to the print area, and may have a colour group to allow the consumer to set the background colour from a preset list, or a free-form entry to allow selection of any colour.

These groups are defined in the workflow under the Fonts and Colours screens in the Product Administration menu, and are then made available to the reseller when building the shop product. 



Groups come in two types, System and Reseller.  System groups are groups defined in the workflow.  These act as templates for resellers, and can't be used directly in product configuration.  Reseller groups are created by resellers, and are either generated from scratch, or are based on a System generated group.  Reseller groups are then used to configure a product.


Resellers can select groups when defining layers as shown below, and can create Reseller groups by clicking the adjacent Manage buttons.


This displays a manage groups dialog, where the reseller can create groups either from scratch, or based on a System group.



Once a font or colour group is defined by a reseller, it will be available in the app when adding text or colour area layers.  Resellers can define a group once and then use it for several products.


For example: the configuration process for a Font Group might be as follows:


  • The workflow admin would create a System Font Group on the Fonts screen
  • A product with a text app function would be configured in the admin as in the next sections to be AppV2 ready
  • A reseller would create a shop product with a text area layer, and in the configuration would copy the template font group to create their own Reseller font group.  They may modify it (e.g. add new fonts), and then set it as the group to use with that text layer.
  • The consumer would see the fonts defined in the reseller-defined group when using the configurator.


Fonts and colours then appear in the configurator for the consumer to select based on the selected group:


 


Shipping Method Alias

Shipping Method Aliases are used to provide consumers with a choice of shipping methods when they make a manual order through the app, and are configurable in the workflow by the Network Owner.  These are configured in the Shipping Method Alias screen in the Shipping Admin menu.



If a shipping method alias should be present in the App, edit the alias and set the 'Available in ECommerce App' check as selected.

Upgrade Examples

The following sections detail the process of upgrading an existing App V1 product to be usable in V2.  Each example assumes that the product to upgrade is already in a valid state for use with V1 of the app.


Example 1: Mug 

The examples below all relate to the configuration of a Print on Demand mug product.

 

Workflow

The workflow is largely the same structure as with Version 1, with a few changes mostly around the Products (App) screen.


Product

Display the Products (App) screen and for each of your products, go to the following screens:


  • Details -> Rendering - Select the Variant rendering type.

  • Views [v2] -> View Groups - Define a default View Group.

  • Views [v2] -> View Types - Define a default View Type.

  • Views [v2] -> Views - Define a default View, using the group and type above.   

    • Accept the default values for the other options on the Details tab.

    • In the Images tab, add Example, Background, Mask and Guide images, all equal in dimensions.

  • Click Save to save changes so far.  Go back to the product edit screen.

  • Mock-ups - For each Mock-up, set the View Group.

  • Variants - For each Variant, set the View Group

  • Print Areas - Add a Default Print Area, and attach it to the View above.

    • Set the size details for the Print Area in the Sizing tab.

  • App [v2] - Create App Functions with the View Type defined above, and Print on Demand as the product type.  Create at least 1 Image function, with default values.

  • Details -> Details - Select the App V2 Ready checkbox to make this product selectable in the App.

  • Click the Save button to save the changes.

App

The App should now be able to display the updated product.  Go to My Products, and click on New Print on Demand Product.  Locate the updated product and click to create one.


The Product details should appear, and if the product is correctly configured, the ‘Start Designing’ button should be present at the bottom right corner.  If not, please review the configuration above and try again.


Example 2: T-Shirt

The examples below all relate to the configuration of a Print on Demand t-shirt product. 

Workflow

The workflow is largely the same structure as with Version 1, with a few changes mostly around the Products (App) screen.

User Configuration

  • The user configuration should not require modification for use with Version 2.

Product

Display the Products (App) screen and for each of your products, go to the following screens.  Note that you may need to periodically click Save to save the changes before progressing:


  • Details -> Aspects - Ensure that the correct T-Shirt aspect is selected, with Front and Back aspect options.

  • Details -> Rendering - Select the View Group rendering type

  • Views -> View Groups - Define a View Group for each T-shirt colour.

  • Views -> View Types - Define 2 View Types - Front and Back - and select the appropriate aspect for each.

  • Views -> Views - Define a view for each combination of view group and view type.  For example, if you have 5 colours, you would have 10 views.   

    • Accept the default values for the other options on the Details tab.

    • In the Images tab, add Example, Background, Mask and Guide images, all equal in dimensions.

    • Set the Front views to be the default in their groups.

    • Use the mouse to ensure that the Front view is always before the Back view in the views list.  This is so that the front view appears in the App by default.

  • Click Save to save changes so far.  Go back to the product edit screen.

  • Mock-ups - For each Mock-up, set the View Group for the same colour.

  • Variants - For each Variant, set the appropriate View Group 

  • Print Areas - Add a Print Area for each of the View Groups defined above, setting the printable area to the guide image size.

  • App - Create App Functions for both Back and Front view types defined above, and Print on Demand as the product type.  Create at least 1 Image function, with default values.

  • Details -> Details - Select the App V2 Ready checkbox to make this product selectable in the App.

  • Click the Save button to save the changes.

App

The App should now be able to display the updated product.  Go to My Products, and click on New Print on Demand Product.  Locate the updated product and click to create one.


The Product details should appear, and if the product is correctly configured, the ‘Start Designing’ button should be present at the bottom right corner.  If not, please review the configuration above and try again.


Configurator

The in-app configurator should be available to test a Personalised product from the main details screen of each product.  This can be used to test how the product will appear in the shop.  Click the Consumer Configurator button on the product details screen and if necessary, select the product variant to configure.