INSTALLATION GUIDE

First, you must install the PrintXpand module in the “PrestaShop Backoffice”.

MODULE INSTALLATION

Follow the below steps to install the Brush You Ideas into PrestaOffice and required details to integrated with the Product Designer Tool:


Step-1

Login to PrestaShop Backoffice. navigate to Modules -> Module Catalog under the Improve tab to install a “PrintXpand” module. By clicking on it, the “Module Catalog” page will display.

Step-2
Now, by clicking on Install a Module button, you can upload the zip file of “PrintXpand”. It will take a few seconds to upload and process.

Step-3
Once it is done, you will get the success message. By clicking on the Configure option, you can navigate to Configuration of PrintXpand or Navigate to Modules -> Module Manager to configure the PrintXpand Tool.
In the Module Manager page, select the Other option in the “Category” search, you will get the PrintXpand module. By clicking on the Configure button, the configuration page will appear.

Step-4
Here you need to insert the URL of “product designer tool” and API related details as per the API integration and configuration from the Designer tool backend.

Step-5

Insert & configure the Product Designer Tool customization options:

– Button Label: Insert the button ‘text label’ for the product designing. By clicking on that button customer will be redirected to the “Product Designer” Page for that product.

– Want a design button on the list page? : Select “Yes” to display the “Design” button on the product listing page to the products else “No”.

– Remove add to cart button design products: To hide the “Add to cart” button from the design products select “Yes” else “No”.

PrintXpand MODULES CONFIGURATION IN PRESTASHOP

After configuring PrintXpand in PrestaShop, you can manage and sync the resources like Categories, Products, Orders, Customers from Backend Configuration of the PrestaShop. Here is how:

Product Configuration & Sync

To manage and sync the products, navigate to Catalog -> Products.

You will see the product list with the details. Here you can find the Sync Status and PrintXpand Action column. You can sync the product into the PrintXpand-Product Designer Tool backend by clicking on the sync icon.

You can sync more than one product by clicking on Sync All button and the selected records will be synced.

Add a new product:

Here, enter the required details like Title, Description, Images, Pricing, Quantity, etc. If the product has Variants (like Colors, Size, Brands, etc.), select the “Product with Combination” option on the Basic Settings page.
By selecting it, the “Combination” tab will enable. Here you can select the size, color, etc. and after inserting all the details click on “Generate it”. Once all the details are added and configured, you can add the products to the store. If required, you can edit as well afterward.

Note
First, complete all the Product Configuration by inserting all the required details and then Save the product. After saving it, navigate to the “Basic Settings” tab to enable the Brush Your Idea. You must add the product without selecting the Enable PrintXpand option.

To enable PrintXpand for the product:

Scroll down on the “Basic Settings” tab of the product and you will find the PrintXpand option. For syncing the products into the Product Designer Tool (Magento side), you must enable it by checking the checkbox.

Other Modules Synchronization

Categories

To manage the Category, navigate to Catalog -> Categories. You can manage the Category by add/edit/delete and sync into the product designer tool manually.

Orders

To manage the Orders, navigate to Orders -> Orders. By clicking on it, you will get the list of the Orders with the details.
As the customer place an order, the order which contains the design will be synchronized in the Designer Tool backend.
Note: Only those product orders will be synced that contain the design.

Customers

When the user Signs up on PrestaShop, you can check his/her details on PrestaShop by navigating to the Customers.
As a new user will sign up, the details will be synchronized in the Designer Tool backend.

Note:
– There is a functionality of mass sync. To use it, select the multiple records and click on the Sync All button. After it, all selected records will be synced, and the status will be changed.
– Category, Orders, and Customer records will take approx. 5 mins to sync into the Product Designer tool while the product will take approx. 10mins.

DESIGNER TOOL BACKEND CONFIGURATION

Backend configuration and set up for the Product Designer Tool (Magneto side configuration).

Product Configuration for Product Designer Activation

To enable ‘PrintXpand’ for a product, navigate to Shopify Dashboard, Apps -> PrintXpand→ Products. You will get the list of the products.

When you have added a new product, you must ‘Sync’ the product by clicking on the Sync Now button for the first time. This will also enable the Product Designer tool. You do not need to enable it manually.

You can ‘Enable’ the Product Designer for the product from the ‘Actions’ dropdown.
To disable it, you can select ‘Disable’ the Product Designer for any product from the Actions dropdown list.

Here you can also Search, Filter, Sort Product List, and check product details by clicking on a product name.

Notes:
~ Product details will get updated only if they are synchronized already. (Images will not be updated/changed, except the specified fields)

~ The designer tool only supports the simple and configurable/variate/variable product.

~ The Discount you insert will not display or calculate individually on the designer tool page, it will directly calculate in the Cart page only.

Configure Default Design (Set Image Sides & Design Area)

Once the ‘Product Designer’ is enabled for the product from ‘Shopify’, you must set ‘image sides’ and ‘design area’ of the product. For that, navigate to your ‘Designer Tool backend’.

Go to: Catalogue -> Products and navigate to the detail page of the product for which you have enabled the PrintXpand-designer tool.

Now, you can set ‘image sides’ by clicking on the image and after saving the product, you can set the design area in the image manually.

There is another way to configure the product in just one click. On the product detail page, there is a green button on top named Configure Default Design. By clicking on this button, the image side and the default design area will be added to the center in the first image of the product. Other attributes like Base, Small, Thumbnail can be added automatically.

Click “OK” button and then “Save” the product. Once completed you will get a success message.

Select Image Sides

By clicking on Product Image, the ‘Image Detail’ pop up window will appear on the screen. Add ‘Alt Text’ and to display this image as the default image on Thumbnail, Product View and any other area, select the option of Role: Base, Small, Thumbnail, Swatch accordingly.
Select the “Image side” for the product image from ‘Image Side’ dropdown list.

After adding all the details, don’t forget to save it. You will not be able to create a design area for the product until you save it.

Create Design Area

After saving, click on the “Brush” icon and “Create Design Area” window will pop up on your screen. To add a design area, use the mouse cursor and resize the selection box on the product image to set the design area for that particular product image side. (e.g. Front Side)

After creating a design area, click on “Save Design Area” button.

You can delete a design area by clicking on the “Delete” button from the right side.

Masking Category And Masking File

You can create, upload, delete or assign masking categories and masking files from here only.

You can add a Masking file by choosing a masking category and masking image that must be SVG file from Select Existing Masking.

To select any pre-uploaded masking file, select its masking category from the Masking Category dropdown. The names displayed in the Masking dropdown will be as per the name assigned while creating them.

You can also create any category by just providing the name and save to create a new masking category at Create New Masking.

Similarly, you can create a new masking file by selecting Upload new masking files and assigning a category to it. It will provide options to save any masking file to use anytime.

Note: If you have any doubts regarding the SVG file and how to mask the image, you can contact us. Our support team will guide you on how to mask the image.

Enable Product Designer

To enable the Product Designer for a Product, scroll down to “Product Designer” option and set ‘Yes’ for ‘Enable Product Designer’ option.

Default Associated Product

When you have added a Configured Product, you should have also uploaded images as per the different attributes and variations.

To display the ‘default product’ on the Front End, you must select a ‘Default Associated Product’ from the Product → Product Designer option.

As you click on it, you will get the dropdown list to set a default product to display on the Front End.

Designer Tool API Configuration for PrestaShop

Once the modules and their relevant data have been synchronized into the designer tool, you can manage the following configurations from the designer tool backend.

Go to: Stores → Configuration → Product Designer API Configuration

General

You must insert the following details:

Source System Base URL: Insert your Source System Base URL.
i.e. https://domain.com/
Customer Login URL: Insert URL Source System Login.
i.e. https://domain.com/account/login/
Customer Logout URL: Insert URL Source System Logout.
i.e. https://domain.com/account/logout/
Customer Authenticate URL: Insert source system URL for “customer authenticate” to check customer login sessions.
i.e.https://domain.com/account/checklogin
Add To Cart URL: Insert source system URL for “Add To Cart”.
i.e. https://domain.com/save/cart/
Save Design URL: Insert Source system URL for Save/Update Design/Image.
i.e. https://domain.com/account/saveDesignerUrl/
Locale: Select your language for your store view.
Base Currency: Select default currency to display on your website for the designer tool.

Third-Party System Information

Insert the following details of the Third-Party System Information:

Domain URL: Insert URL for your App.
API Key: Insert the API key of the source system.

Header Configurations

You can manage the following header details of the Shopify user page:

Favicon Image: To specify the favicon image of the product designer page.
Logo Image: To specify the logo image for the product designer page.
Logo Image Alt: To specify the text for the logo image.

TAX ENHANCEMENTS FOR PRESTASHOP BACKOFFICE

On your PrestaShop Product designer Store, you can display the Product prices including tax or excluding tax as per your need. You can set configure that under the ‘Tax Options’ from the PrestaShop BackOffice.

Frontend View

After setting up from the backend in Tax options, your customer will get the Product price including or excluding tax in your Store.

How Tax will Appear on Product Designer Page?

The tax rate will travel from the Product page of your PrestaShop to the designer tool page. So, when your customer clicks on the Product from your Store to design it, the tax also appears on the designer page.

If the customer changes any attributes of the product from the designer tool page, the tax will not be displayed on the designer page, but when they add that product in the cart, the tax will be calculated in the cart total.

PrestaShop Tax Settings

To set up the inclusion/exclusion of tax to be displayed with the Product price, Log in to PrestaShop Backoffice and navigate to Shop Parameters -> Customer Settings -> Groups under the Configure tab.

You can set the Tax including/excluding Product price to be displayed in the Store, Group-wise: Visitor, Guest, or Customer.

Click on the Edit option of that group for which you want to set the Tax options. By clicking on the ‘Edit’ option, you will be navigated to the page of the setup options.

You will find the Price display method option which you can choose to select the Product price with Tax included or excluded in the store. Select the option which you want to display.

INTRODUCTION TO FRONTEND

Product Option

If you have added the ‘Configurable Product’, the Product Option with the icon will appear on the right side of the product designing canvas. From here, you can select the attributes like Brand, Color, Size, etc.

Designer Tool

From here, your customers can design their product using the Tool.

They can set the position of the object by using the Alignment option.

They can set the order of the objects when more than one objects are on Product design area using the Layer option. They can also flip the object Vertically & Horizontally.

The image cropping option is also given to crop the area of an image.

They can edit the product design with the Tools like Select all- deselect all objects, duplicate object, Best Fit, etc.

Design Explorer

From here you can manage the Tabs like Upload, Plain Text, Clip Art, Background, Name Number, Templates, etc. You have all the rights to manage the Tabs. After the Back End configuration, your customer can access the Designer option.

Tabs and Sub Tabs: Let your customers access the Tabs and Sub Tabs as per the Back End configurations.

All Products: You can showcase the customizable Product list & Product Categories.

PrintXpand-PRESTASHOP

PrestaShop- Front End View

Once all the product configurations are made for product designer activation, users will be able to ‘View’ and ‘Design’ the products from the store.

To design the product, the user can click on the ‘DESIGN IT’ button from the Product List Page or Product Detail Page on the Shopify front end page.

By clicking on it, the user will be redirected to the PrintXpand-Product Designer Tool page from where they can design products as per the requirement.

PrestaShop – Add To Cart

Once your customers have designed products from the ‘Product Designer Tool’ page, they can add product(s) to cart.

Now, from the cart page, your customer will be able to view two products i.e. Main Product and Custom Designed Product (which will work as an ‘Add on’ Product).

Note: If the Designing Price is not applicable or somehow 0, then the customer will only find the Main Product with a designed image along with the selected attributes.

MANAGE IMAGE SIDES

You have all the right to customize the number of sides of any product or restrict them to only one side as per your printing compatibility and cost considerations. From the Back End, you can make these changes and they will reflect in the Front End.

To add and manage the sides of the images of Product, go to:

Product Designer → Manage Image Sides

By clicking on it, you will get the list of inserted image sides with the details like ID, Image Side, Status, Action.

To add a new image side, click on the “Add Image Side” button. By clicking on it you will be redirected to the “Add Image Side” page.

Enter the following details:
Image Side: Enter the name of the Image side. (e.g Front, Back)
Status: Select the current status for Image Side.

After inserting the details, click on the “Save Image Side” button and you will be redirected again to the list of Images sides.

You can ‘Edit’ any Image side by clicking on the ‘Edit’ option. After editing press the Save ‘Image Side’ button.

If you want to ‘Delete’ any Image Side, select it and click on ‘Delete’ from the ‘Actions’ dropdown. By clicking on it, a confirmation message will appear. Press ‘OK’ to delete the selected image side.

MANAGE DESIGN TEMPLATES

Displaying the products with an eye-catching design will attract the customers when they visit your store. Use pre-loaded templates and display them on your store to get your customers started. The customers will get an idea as to how the customized product will look like. It will help them conceptualize their designs for own product.

Back End Configuration

Manage Template Categories

To manage design templates categories, navigate to
Product Designer -> Manage Design Templates Categories.

Now you can view a complete list of Template Categories along with their details like ID, Title, whether it is a root category or not and on which stores it is displayed.

To add a new Design Template Category, click on the ‘Add Design Templates Category’ button. On clicking it, you will be redirected to the “Add Design Templates Category” page.

Now, enter the following details of the Template Category:

Category Title: Enter the relevant title of design template category.
Is Root Category: If you are inserting a ‘Parent Category’, tick mark on this checkbox. But, if you are inserting a child Category, then select its parent category from the “Category” dropdown.
Store Views: Select the stores in which the design templates category will be displayed.
Status: Choose the current status of the template category. (Enable/Disable)

Thereafter, click on the “Save Design Template Category” button to save the details and it will appear on the “Design Template Category” list.
You can ‘edit’ any Design Template category by clicking on the “Edit” option from ‘Action’ column.

To ‘Delete’ any Template Category, select it and click on “Delete” option from the “Actions” dropdown. As you click on the ‘Delete’ option, a confirmation message will appear. By clicking on the “OK” button, the selected Template Category will be deleted.

Select Template Category

To set the design template categories which will be displayed in the “Template Tab” option on the Front End, select the categories from the ‘Design Templates Category’ dropdown list (Back End Configuration).

Make Design & Assign Category

You can create templates for Simple & Configurable products by navigating to Catalog → Products. From the Product list, click on “Make Design” option from the ‘Select’ option under the ‘Action’ tab.

Note: The Make Design option will appear only if you have enabled “Product Designer” option, set the Images Sides and Designing Areas.

By clicking on ‘Make Design’, you will be redirected to the designing page of the product.

Here, you can create a design template by designing a product using the “Designer explorer tab” (left side) and designer tool (right side) on the tool.
Once you are satisfied with the template, save the Design by clicking on ‘Save’ icon.

By clicking on it, a popup window named “Save Template” will open where you can add/edit a ‘Template Name’ and select the option “Set as Preloaded Template for this product” if you want to set as Preloaded Template. Choose a ‘Category’ in which you want to display this template from the drop-down list.
Note: You can also select multiple categories by pressing ‘Ctrl’ key while selecting options.

This design template will appear in the list of the “Manage Design Templates” in “product Designer” module at the backend.

You can also assign or remove the templates from the sub-tab “Design Templates” in “Manage Design Template Category” module of “Product Designer” at the backend.

Admin can also enable or disable the design template anytime.

Go to the `Manage Design Template` listing page and select design templates you want to enable or disable in the bulk. Select Enable/disable from Action dropdown at the top of the list.

You can also enable/disable the design template while you save any new design template.

Manage Design Templates

To manage design templates, navigate to
Product Designer → Manage Design Templates

You can view a complete list of Design Templates along with their details like Template ID, Product ID, Title, its Category, Image and Action to Edit.
As you click on the “Edit” option, you will be redirected to the designer page of the product.

Here, you can edit and change the design by using the Designer explorer (left side) and designer tool (right side).

Manage Default Design Template

You can set the design template for any product. In a configurable product, you can set the design template for all the child products. The parent product will carry the latest updated child’s design template. And the child products without any design templates will follow the parent product template.

Preloaded Template

To set a “Preloaded Template” which would be displayed on the Front End for the specific product, select the template from the Preloaded Template dropdown list. It will contain the list of templates which are designed for a particular product.

After selecting the default template, click on the ‘Save’ button to save all the configurations.

Frontend View

Once the design templates are managed and configured from the Back End, your customers can load the Default Templates by clicking on the ‘Templates’ tab in the Product Designer Page. They can view the Design Templates as per the assigned Design Template categories to the product.

The customers can also search the templates by name from the ‘Search by Name’ text field.

 

If the customers load the designer template product, they will get the Template Data tabs with the “Text Data” and “Image Data” of the selected designer product.

 

From the “Text Data”, the customers can add/edit the text captions, and from the “Image Data”, the customers can add/replace the images.

DESIGNER TOOL TABS CUSTOMIZATION

You have all the rights to select Main Tabs & Sub Tabs as per your business requirement.

Backend Configuration

For general tab layout configurations, go to Stores → Configurations → Layout

From here, you can select the “Main Tabs” by multiple selections.
Suppose, if you have selected any 5 tabs, the remaining 2 tabs will be eligible for subtabs.

Manage Tabs

After configuration of the Tabs, you can Manage the Tabs from Product Designer → Manage Tabs. By clicking on it, you will get a list of all the Main Tabs.

From here, you can change the Custom Label (Name of the Tabs) which will be displayed on the “Designer Explorer” tab (left side) on the Front End. Click on the “Save Tab” button to save the changes.

Front End View

After all the Back End configurations, the customers can view the ‘Main Tabs’ and the ‘Sub tabs’ as you have configured.

The “Designer Explorer Tool” (left side) will have all the Main Tabs and the Sub tabs can be seen by clicking on the Main Tabs.

MANAGE TEXT AND FONT EFFECTS

Our PrintXpand Designer Tool provides unique text features for your customers to insert their favorite slogans, dialogues and one-liners on their choice of product (e.g. t-shirts, mugs, cards, etc.). Your customers can add attractive text like multi-colored text, text-shadow, and other designer text styles.

Backend Configuration

Manage Fonts

First, you must Manage the fonts which will be shown for the Text formatting during product designing to your customers.

Go to: Product Designer → Manage Fonts

As you click on “Manage Fonts”, you will get the list of already inserted Fonts along with details like Id, Title, Thumbnail Image (if available), Store View, Status & Actions.

You can edit any font just by clicking on “Edit” from the Action Column.
If you want to ‘Delete’ any Font, select the Font and click on the ‘Delete’ option from ‘Actions’ dropdown list.
A confirmation pop-up will appear after you click on the ‘Delete’ option. Select “Ok” to perform the delete action.

Similarly, you can change the font status to Enable / Disable from ‘Actions’ dropdown list.

Text Configurations

You must set the general Text Configurations from the System Configuration.

Go to: Store → Configuration → Text option

The general Text Configurations are shown as below:
Default Font Type: Select a default Font for the Text from this dropdown list. The text will appear in the default Font Type during Product designing in the front end.

Default Font Size: Select a default Font Size for the Text from this dropdown list. The text will appear in the default Font Size during Product designing in the front end.

Enable Text-Object Limit: If you select Yes, you can set a limit of the Text Object for your customers so they cannot cross the limit on the single design area.
Text object Limit: To add a limit for the Text Object, enter the value of text limit in this field.
Error Message: Enter the message which will be displayed if the customer exceeds the limits of the Text Object.

Frontend View

Text Design for a Product

After setting the Back End Configuration (Product Designer → Manage Fonts ) and General Text Configurations (Stores → Configuration → Text), the customers can start designing the product by adding a text element.

Now, click on the ‘Text’ tab in Designing Explorer. The customers can enter the Text which they want to show on their product. The customers can insert the Text until the text limit has exceeded. The customers will get an Alert message on exceeding the configured Text limit.

After inserting the Text, the Designer tool will be enabled on the right side. From here, the customers can customize the Font Size, Style, Color, and text alignment.

Apply the Text Effects

Font Style, Color & Size: The Font Style, Color & Size will appear as per the Text Configurations which has been set as the default from the Back End.

Customers can select their favorite ‘Font Style’ and pick a color from the ‘color selection’ option. They can increase the ‘Font Size’ by dragging the text size slider to right & left to decrease.

Customers can also ‘edit’ the text in Bold, Italic and Underline.

Customers can adjust the Text alignments to Left, Center, Right and Justify.

Stroke: To add the outline text effect of a particular color on the text.

Drop Shadow: To adjust the text-shadow effects horizontally (X-offset) & vertically (Y-offset) on the text.

Skew: To give horizontal or vertical italicized effects to the Text in the product design.

Object Position: To change X-Y coordinates for positioning (Horizontal-Vertical) in the product design.

MANAGE NAME AND NUMBER

This feature of the Premium pack allows the customers to add their favorite Name & Number on the product using our PrintXpand Product Designer Tool.

Back End Configuration

The Name/Number option will be enabled only for the ‘Configurable Products’. After the product configurations, you will get an option as ‘Enable name/Number’ in the Product Designer option from the Product page.

If you want to provide Name/Number option to the customers, select ‘Yes’ for “Enable Name/Number” toggle button.

Front End View

After the Back End configuration, the Name/Number will appear on the “Designer Explorer” (left side).
Now, the customers are able to add the Name/Number on their choice of product.

Customers can add multiple rows by clicking on +Add More buttons beside ‘Name’ and ‘Numbers’ options. Customers can add up to 25 rows of Name & Number.

They can also select the sides for Name & Numbers which are managed from the Back End.

When ordering in bulk, On the front end, the customers will only be able to preview one Name/number design. The rest of the designs will be available on the backend with the original order and they need to be generated from the Back End by the admin itself.

MANAGE IMAGE EFFECTS AND FILTERS

Your customers can apply filters on images while designing the product by using our Image filters feature.

Backend Configuration

The designer tool comes with effects like blur, brightness, contrast, hue, Noise, Pixelate, and Saturation. Also, there are filters available like Black and white, brownie, emboss, grayscale, invert, and sepia, and more based on the tool’s package you purchase. Users can apply any of the filters and edit it using effects to get the desired output.

The list of effects and filters is already provided. You have the rights to Enable/Disable them as per your convenience.

To edit and manage the Image effects, go to Product Designer → Manage Image effects and filters

Here, you can view the list of Image effects with the details like ID, Name of Image effects default Status and Actions.

To ‘Edit’ any of the image effects from the list, click on the “Edit” option. By clicking on it, you will be redirected to the Edit Image effects page.

Effect Image: To update the image for it, click on ‘Choose File’ button and select the file to be uploaded.
Status: Choose the current status of it. (Enable/Disable)

After editing, click on ‘Save’ button to save the changes.

Note: Image effects are part of the Premium package.

Front End View

Image Filters

Once image effects have been configured and managed from the Back End, your customers can view the Image Filters in the Designer Tool (right side).

When the customers will upload an image from the “Upload Image” option or Clipart (PNG, JPG) and add to the canvas, the Image Effects tool will be displayed in the designer tool (right side).

Note: These Image Filters will apply only if the file format of an image is JPEG & PNG. But, if the file format is SVG, the customers can only change the internal colors of that image.

MANAGE PRINTABLE COLORS

You can add and manage the Colors from Back End configuration. The customers can select only those colors which you have enabled.

Backend Configuration

Printable Color Management

You can provide the Printable Colors to the customers as per the compatibility of your printer or availability of printable colors.

To manage the Printable Colors, go to Product Designer → Manage Printable Colors.

By clicking on “Manage Printable Colors”, you will get the list of already inserted printable colors with the details like printable color ID, Color Name, Color, Store View, Status and Action to Edit.

To add a new Printable Color, click on the Add Printable Color button. By clicking on the “Add Printable Color” button, you will be navigated to the “Add Printable Color” page.

Now, add the following details:

Name: Enter the printable color name.
Store Views: Select the stores on which the color will be accessible.
Code: Enter the color code of particular printable color (hex color code) or select the color through color picker pointer.
Status: Choose the default status of the printable color. (Enable/Disable)

After inserting all the details, click on “Save Printable Color” and then a Color will be saved.

Now, the color can be seen on the list. You can edit any color just by clicking on “Edit” from the Action Column.

If you want to ‘Delete’ any Color, select the Color and click on the ‘Delete’ option from ‘Actions’ dropdown list. A confirmation pop-up will appear after you click on the ‘Delete’ option. Select “Ok” to perform the delete action.

Similarly, you can change the printable color status to Enable / Disable from ‘Actions’ dropdown list.

To set the default Color
You can set the default color. So when the customers insert any ‘Text’ or ‘Name/Number, the object will appear in that default color. (screenshot)

To set the default color for preset, go to Stores → Configuration → Color Picker
Here, select Yes to ‘Default Color for Color Picker’ option.

Front End View

After setting the Back End Configuration and default color selection, the customers can access the color and select from the Designer Tool.

The customers will get the list of colors in the ‘Preset’ tab which is added in ‘Manage Printable Colors’ from the Back End.
While adding any Text Object, the customers will get the default color which is selected from the Back End.

BACKGROUND PATTERNS

Customers can apply background patterns from this section. Customers can use any of the patterns set by admin or use any image as a custom pattern. To set custom design pattern go to Product Designer → Mange Clipart Categories and mark the category as a pattern in the setting.

There are two ways customers can use this feature:

Existing patterns:
You can offer a library of patterns to your users. Users can select any of them and use them in the image as a pattern. You can upload patterns from backend in the pattern category.

Custom Background Pattern:
Customers can select any of the image files and make it as a background pattern. To use an image as a pattern, select the image on the canvas and click on the `make a pattern` button in the `Tool section` in the `Designer section` on the right side.

You can apply various operations on the pattern as:

Pattern Type:
~Repeat Pattern:
To repeat the pattern on the canvas.
~No Repeat:
To use a single image as a pattern.
~Repeat X Pattern:
To repeat the pattern horizontally.
~Repeat Y Pattern:
To repeat the pattern vertically.

Pattern Size:
To set the zooming effect on the pattern.

Pattern Offset:
To move the pattern horizontally and vertically.

Pattern Angle:
To rotate the image to a certain angle.

Pattern Padding:
To control padding in between images of the pattern. You can also reset or delete the pattern from here

CLIPART

Your customers can spice up their product designs with attractive and stylish Cliparts!
Our PrintXpand designer tool provides Clipart Gallery for your customers that contains pre-loaded unique designs which they can add to their products.

Backend Configuration

Manage Clipart Categories

You can manage and categorize the Clipart images. It is easy to set the parent and the child categories for the Cliparts.

To add and manage the Clipart and its Category, go to Product Designer → Mange Clipart Categories

As you click on Manage Clipart Categories, you will get the list of already added clipart categories. You can manage and edit them as per your requirement.

By clicking on “Add Clipart Category”, you will be redirected to the “Add Clipart Category” page where you can add a new Clipart Category and Clipart Images.

Now, select the parent/subcategory and enter the details as shown below:

Title: Enter the relevant name of a Clipart.
Assign as Root Category: Tick this option if it is a ‘parent category’.
Category: If you are adding clipart for ‘subcategory’, select its ‘parent category’ from the dropdown list.
Store Views: Select the stores in which the Clipart will be displayed.
Status: Choose the current status of Clipart. (Enable/Disable)
Add Clipart Images: Browse and upload the images to be added in the Clipart category.
JPG, JPEG, PNG and SVG formats can only be supported.
Label & Tags: Enter Clipart’s ‘Label & Tags‘ to ease out of the search.
Position: Enter the No. of position in which you would like to display the Clipart image at the Front End.
Exclude: Enable this option if you don’t want to display the clipart in the front end instead of permanently deleting.
Remove: Customer can permanently remove clipart image using this option.

After inserting all the details, click on the “Save Clipart Category” button and it will be added in the “Manage Clipart Categories” list. Later, you can edit as per your need.

To ‘Delete’ any Clipart Category, select it and click on “Delete” option from the “Actions” dropdown. As you click on the ‘Delete’ option, a confirmation message will appear. By clicking on the “OK” button, the selected clipart category will be deleted.

Clipart Configuration

To set the general Clipart Configurations from the Back End, go to Stores → Configurations → Clipart
From here, you can set the default configuration to display in the Front End.

The general Clipart Configurations are shown as below:

Enable Clipart Limit: Select ‘Yes’ to set maximum clipart allowed in a single design area.
Set Default Clipart Category: Select a default Clipart Category which will be displayed when the customers click on the Clipart option.
Clipart Limit: Enter the value of Clipart limit so the customers cannot exceed the limit on the single design area.
Error Message Clipart: Enter the relevant Error Message which will be displayed when the customers exceed the limit.

Front End View

View Added Cliparts

Click on Clipart tab from the ‘Designer Explorer’ (left side). The customer will see the Cliparts in the grid view and explore the clipart provided as configured from the backend. They can search and filter the clipart.

Now, the customers can add their favorite Clipart image and they can apply the Image Effects from the ‘Designer Tools’ tab (right side). They can set the alignment of the clipart, Front/Back positions by Layer, rotate and flip horizontal & vertical.

Note: The customers can crop the Clipart Images but the cropping will not be applied on SVG format images.

CUSTOM IMAGE UPLOAD

Using our PrintXpand Designer Tool, your customers can upload their favorite and treasured images from their device to give the personalized touch in designing their product.

Back End Configuration

For custom image upload configurations, go to Stores → Configuration → Custom Image Upload.

Add custom image upload details as follows:

Show Instruction: Select ‘Yes’ to show instructions while uploading a custom image.
Instruction Text: Enter the instructions to be displayed while uploading the custom image.
Enable Image Limit: Select ‘Yes’ to set a limit for uploading a custom image. This avoids the overlapping of more images in the product design area.
Image Limit: Enter the limit for uploading maximum images.
Error Message: Enter the error message to be displayed if the number of images exceeds the limit of custom images.
Minimum Size of Image: Enter the minimum size of an image in MegaByte (MB).
Maximum Size of Image: Enter the maximum size of an image in MegaByte (MB).
User’s Confirmation Before Uploading Image: Select ‘Yes’ to ask for the customer’s confirmation.
Text for User Confirmation: Enter the relevant confirmation message which will be displayed above the Upload Image button.

Frontend View

Upload Images

After setting up and managing the ‘Custom Image Upload’ from the Back End Configuration, the customers can upload images for their product design.

The customers can upload images by navigating to “Upload” tab from the designer explorer (left side).

If you have enabled “User’s confirmation before uploading image” option from the back end, then the customers will have to check the confirmation checkbox and then only they can upload any image from the system’s folder.

The customers can also get the uploaded images by click on “Get Your saved Images”.

Note: Customers should be logged in to their accounts to get the previously uploaded images.

After uploading the images, they can perform various activities from the ‘Designer Tools’ tab (right side) like applying image effects, set the alignment of the clipart, Front/Back positions by Layer, rotate and flip horizontal & vertical.

Crop Feature

The ‘crop’ option is given on the Designer tool (right side) under the ‘Tool’ option. The customers can ‘crop’ uploaded Images which are in JPEG & PNG formats but the SVG format images will not support for cropping.

To ‘Delete’ any of the uploaded images, customers can click on ‘Delete’ icon which would appear on dragging mouse cursor on a particular image.

PRINTING CONFIGURATIONS

Our PrintXpand Designer tool provides you a freehand to ‘Manage Printable Colors’ and different ‘Printing Methods’. You can Enable/Disable some printing options for your customers as per your convenience and printer compatibility.

Back End Configuration

Manage Printing Methods

To add and manage multiple methods of printing, go to Product Designer → Mange Printing Methods

As you click on “Manage Printing Methods”, you will get the list of Printing Methods along with details like ID, Printing Methods Name, Printing Description, Methods Type, Store View, Printing Methods Execution, and Actions.

You can add a new ‘Printing Method’ by clicking on the “Add Printing Method” button. It will navigate you to ‘Add Printing Method’ page

Now, add the following details:

Name: Enter the relevant name of the printing method.
Description: Enter the description of the printing method with some additional details.
Minimum Printing Quantity: Specify a minimum quantity for using the particular printing method.
Store Views: Select the stores on which the printing methods will be accessible.
Printing Method Execution: Select the printing method by which the printing method will be managed. It has two possible options: “By Area Range” and “By Color Quantity”
Status: Choose the current status for this printing method. (Enable/Disable)

After inserting all the details related to printing methods, click on “Save Printing Methods”.

Now, the new printing method can be seen on the list.

If you want to ‘Delete’ any printing method, select it and click on the ‘Delete’ option from ‘Actions’ dropdown list. A confirmation pop-up will appear after you click on the ‘Delete’ option. Select “Ok” to perform the delete action. (screenshot)

You can edit any of them just by clicking on “Edit” from the Action Column. By clicking on the “Edit” option, ‘Edit Printing Method’ page will open.

If, by Area Range was selected for the Printing Method Execution. You can see the By Area Size sub-option in the ‘Printing Method Information’. By clicking on it, you will be navigated to the “By Area Size” page which is actually “Manage Area Size” option in which you can select the Print Price from the list.

Similarly, if you have selected By Color Quantity as ‘Printing Method Execution’, you will get the ‘By Color Quantity’ sub-option in the ‘Printing Method Information’. In this, you can select the Print Price as per the Quantity of the color used in Product Designing.

Printing Cost

There is always variation found in the Printing cost of any product design. It depends on the ‘Printing Method Execution’ set for a particular printing method. If By Color Quantity is selected, then the Printing cost of the product will be based on the Number of colors added in product design. Whereas if By Area Range is selected, the Printing Cost count will be as per the Range of Area cover in the Product Design.

In PrintXpand designer tool you can manage the Printing cost:
By Color Counter
By Area Range

By Color Counter

To manage the cost of colors based on Quantity (Counter) that will be used in the printing of the product design, go to Product Designer → Manage Color Counter.

By clicking on it, a complete list of color counts along with their respective cost can be seen.

To add Color Counter, click on the “Add Color Counter” button. As you click on it, you will be redirected to the “Add Color Counter” page.

Now, enter the following Color Counter details:
Color Count: Enter the ‘number of colors’ that can be used during printing.
Cost: Enter the ‘cost’ of using a particular color count during printing.

Click on “Save Color Counter” button after inserting all the details.

Later, we can Edit any Color Counter by clicking on ‘Edit’ option from the ‘Action’ column and we can also delete Color Counter by clicking on ‘Delete’ from the ‘Actions’ dropdown.

By Area Size

To manage the cost of printing based on its area size that will be used in the printing of the product design, go to Product Designer → Manage Area Size.

Click on the “Add Area Size” button to add or define a new area size. By clicking on it, you will be redirected to the “Add Area Size” page.

Now, enter the following details related to Area Size:
Area Size Title: Enter the relevant ‘title’ of area size.
Area Size Start: Enter the area size from where it begins or starts. It must be in px.
Area Size End: Enter the area size where it ends. It must be in px.
Area Size Cost: Enter the ‘cost’ of the defined area size.

Enable Printing Method

Now, after adding ‘Printing Methods’, the added methods will be displayed in the ‘Printing Method’ list in the ‘Product Designer’ option of any Product.

For that, navigate to Catalog → Products → Product Designer option.

In the “Product Designer” option, you will get the Printing Methods. Select multiple methods as per your printing compatibility. The methods which you will select that will be displayed in the Product Designer page to the Customers.

Front End View

After all the configurations like Printable Colors and Printing Methods, now the customers can design their products by selecting from the available colors and the printing option. The price of the products will be charged as per printing configurations.

Note: The Printing method will be asked when the customers are adding their designed product in the Cart.

DRAG AND DROP IMAGES

To easily upload images and clipart, there is a drag and drop functionality available.

Users can directly drag and drop an image from their system to design canvas or in the upload image section.

Users can also use it to upload any image from the designer section onto the product canvas.

CUSTOM PRODUCT IMAGE DOWNLOAD

Back end Configuration

To set the ‘Custom Product Image Download’ configuration, go to Stores → Configuration → Custom Product Image Upload.

The Custom Product Image Download configurations are shown as below:

Download Customized Product Image: Select ‘Yes’ to enable the ‘Download’ option for the product designer page.

Frontend View

After the configurations, your customers can easily download designed product images. They can do so by clicking on the ‘Download’ icon. The download icon will also be provided in the preview pop-up as well.

OBJECT MANAGEMENT

In the PrintXpand product designing tool, the customers can easily align the individual objects on the canvas and manage the sides with interactive Tool. They can also rotate and flip the elements with the tool.

Customers can manage the alignments and the sides in the product designer page using mentioned below tools.

Layer Management
Object Alignment

Layer Management

Using the PrintXpand product designing tool, the customer can View/Hide any object, Lock and Delete the objects. It is possible to manage the order of the objects with the ‘Back’ and ‘Front’ options with regards to other elements.

By clicking on “Layer” icon, it will expand and display all the options of layer management for individual design objects. These options include View/Hide, Back/Front, Lock and Delete.

View / Hide:
The customers can View & Hide any object by clicking on View/Hide icon. In the layer management panel, the view icon of the hidden object can be seen in Red.

Back / Front:
By clicking on the Front/back icons, the customers can manage the Forward/Backward positions of the object as per their need.

Lock:
Click on the lock icon, to lock an object. This will prevent the editing of that object. so that any change of other objects will not affect. The lock icon of the locked object will mark in Red.

Delete:
To delete any of the object layers, click on the ‘Delete’ icon beside that particular object.

Layer in Designer Tool

Your customers can also manage Forward/Backward object positions from the Right side in Layer section. Your customers can manage positions when the objects are more than two. In Right side there are four options are given:

Bring Forward: To forward an object. i.e. 3rd position to 2nd position. (This option is also available in the layer management panel)
Send to Back: To send an object in last position i.e. 1st position to last position.
Bring Backward: To backward an object. i.e. 1st position to 2nd position. (This option is also available in the layer management panel)
Send to Front: To send an object in front in 1st position. i.e. Last position to 1st position.

Note: ‘Send to Back’ and ‘Send to Front’ options are enabled based on the selected object in the product design area.

Object Alignment

The customers can manage the alignment of objects in product design. The following options are given to manage the alignments:

Align Left: Click on this icon to align the object towards left in the canvas.
Align Horizontal Center: Click on this icon to align the object in the center horizontally in the canvas.
Align Right: Click on this icon to align the object towards the right in the canvas.
Align Top: Click on this icon to align the object towards the top in the canvas.
Align Vertical Center: Click on this icon to align the object in the center vertically in the canvas.
Align Bottom: Click on this icon to align the object towards the bottom in the canvas.

THEME CONFIGURATION

Product Designer Settings

Configure the theme of your store as you want.

Designer Tool Theme Type: Select the theme type that will be applied for the background. You have two options:
Light: If you select the Light theme, the background will be displayed in white.
Dark: If you select the Dark theme, the background will be displayed in dark color and the “Dark Theme Logo” option will be enabled to upload a website logo in the Dark Theme.
Designer Tool Primary Color: Pick a primary color for the designer tool elements.
Dark Theme Logo: Add a logo that will display only for the Dark theme.
Delete Image: You can delete a previously uploaded logo.

Front End View

You can differentiate the Dark & Light Theme from the screenshots. If you have selected the Dark Theme, the ‘logo’ will appear as per Backend configuration.

PRODUCT DESIGN PREVIEW

Once the customers have finished designing their product, they can see how their printed products will look like through a “full-screen preview”.

Front End View

In the Product designer preview, the customers can check a preview of complete product design before placing an order. To view design in “full-screen preview”, click on ‘Preview’ icon.

After clicking a product preview icon, a preview window will pop-up on the screen displaying product with the design.

MANAGE PRINTING FILES

Back End Configuration

Once your customers have designed their products and placed the order, you can view their product designs from the Back End.

Go to: Sales → Orders

By clicking on Orders, you will get the list of the orders placed by your customers. Click on “View” from the Action Column.

Now, navigate to the ‘Items Ordered’ section and click on View Design. By clicking on it, you will be redirected to a new tab where you can view the Product design and images with all the sides added by the customers.

You can download as per your requirement:
Download PDF: To download a particular Image in PDF
Download Image: To download a particular Image
Download Order: To download all the images
Generate SVG: To generate SVG format images.

Note: “Generate SVG” option can be enabled from the store configurations.

DPI BASED OUTPUT

Get your choice of output files by setting DPI values from the backend. DPI is helpful for high-resolution output files.

To set DPI value, go to Stores → Configurations → DPI Configuration

From here, you can select the DPI value of your choice.

CUSTOM OUTPUT

Set custom dimensions of the output files which are ready for printing. You can enter the values for height and width output files in pixels.

To set values, go to the Product Page → Product Designer option and Set your preferred height and width in Custom output width, and Custom output height attributes.

SOCIAL MEDIA SHARING

Sharing our creative ideas on social media is always exciting. Our PrintXpand designer tool lets your customer share their own design on social media directly through the product designing tool.

Front End View

After designing the product, the customers can share their own designs on the Social Media platform like Facebook, Twitter & Pinterest by clicking on the ‘Share’ icon. They can also share via Email.

By clicking on the ‘Share’ icon, select the social media platform. You will be redirected to the respective login credential page. After proper authentication, your amazing designs will be a part of your social media profiles.

DETAILED LIVE PRICING

With Live price generation, customers get the complete bifurcation of design customization price on the tool itself while designing.

By clicking on the information icon next to product price at the bottom right of the tool, the user can find a total final price with product quantity, customization cost, and design object (text, image, clipart, etc.) cost.

DYNAMIC MESSAGES

Back End Configuration

You can label the designing button and add Warning messages for Designing Area by navigating to Stores→ Configuration → Dynamics Messages.

Design it Label: From here, you can Label (name) the button that will be shown on the front end for designing.
Print Area Warning: Add a warning message when any object design is being out of the design area.
Low Resolution: Add a warning message when the customers upload a low-resolution image.

Frontend View

As shown in the screenshot, the customers will get the “Personalize It” button for designing the product. Also, note that your customers will get the designing button only if you have enabled the Product Designer. (Catalogue → Product)

If any object is being out of the product designing area, your customer will get a Warning message as per your Back End configuration (Product Designer Settings).

If your customers upload a low-resolution image on product designing area, they will get a Warning message as per your Back End configuration (Product Designer Settings).

ALL PRODUCTS

Back End Configuration

You can enable the “Products” section on the designer tool page for giving the option to change. You can show the tooltip for the Product section & option.
Go to Stores → Configuration → All Products

Enable All Product Sections: Select Yes to enable the “All Products” Section on the designer tool page. If you have selected Yes, you can add tooltip for “All Products” section and “Product options”.
First Tooltip: Add a tooltip description for “All Products” Section.
Second Tooltip: Add a tooltip description for “Product Options”. (If a Product is Configurable)

Front End View

As per the Back End configuration, your customers can see the “All Products” section on the designer tool page. From here they can easily change the product.

As customers click on “All Products” section, they will see the First Tooltip. If a product is configurable, by selecting a Product from “All Products” section, they will see the Second Tooltip.

SOCIAL MEDIA UPLOAD

The customers can upload some memorable images from the Social Media platforms like Facebook & Instagram. For this the ‘Upload’ feature of PrintXpand tool allows your customer to upload the images from social media.

Back End Configuration

To set social media configuration from the Back End, go to Stores → Configuration → Social Media Upload. The Social Media Image Upload configurations are shown below:

Instagram Client Id: Add your Instagram client Id.
Instagram Client Secret Key: Add your Instagram Client Secret key.
Facebook App Id: Add your Facebook application Id.

Frontend View

After the configurations from the back end, the customers can upload the images from their Social Media, go to the “Upload” tab from the designer explorer.

The customers will get the ‘Facebook’ & ‘Instagram’ icons and then by clicking on any social media icon, the customer can upload the images in product designing.

CMYK & RGB Color Picker

Everyone will love if they are allowed to pick their favorite color from the Custom Color for product designing! Yes, your customers can pick any color using the “Color Picker” feature in the PrintXpand designer tool.

Back End Configuration

Enable Custom Color Picker

To configure ‘Custom Color Picker’ feature and to ‘Set Default Color’ appearance, go to Stores → Configuration → Color Picker

Default Color for Color Picker: Set default color that will be directly applied to the specific content when the customer adds that content into the designing area.
Enable Custom Color Picker: Select ‘Yes’ to enable the Custom Color Picker component in the Front End. So, the customers can choose their desired color from the color picker.

Enable CMYK

To enable the ‘CMYK’, go to Stores → Configuration → CMYK.

Enable CMYK to display the ‘CMYK input boxes’ in the color picker that displays the value of the selected color in that box.
Note: If you have selected ‘No’ to this option, the RGB Color picker will be appeared in the Color Picker Tool.

Front End View

After the Backend configuration, your customers can pick their desired color from the “Custom” tab.

Your customers can see the CMYK boxes at the bottom of the ‘Custom’ tab if you have enabled the CMYK. Customers can choose the color by inserting the CMYK values if they already know.

Note: If you have disabled the CMYK, the RGB Color picker will appear under the ‘Custom Color’ tab.

LOCK FEATURE

Ultimate Lock feature

The ultimate lock icon will be displayed only if the design template feature is there.

While creating the design template, admin can lock specific object from the backend and the customers will be restricted from editing that object. Admin will get a new lock icon, to lock any object to design, next to the crop icon in the Designer tool (right side).

For text object, customer can only change the text of the object. Customer will not able to change color/font-size/font-family, etc of the text object.

For image object, customer can only change the image. Customer will not be able to apply any effects.

USER GUIDE

With this feature, you can help your customers utilize all the main tabs and designing features properly. These will work as tips and guide your customers throughout the designing process.

Back End Configuration

First, you must enable the User Guide option from the Stores → Configuration → PrintXpand → Product Designer Settings → General. From here, you can enable the “User Guide” by selecting Yes.

Now, you can add the interactive User Guide keeping the Main Tabs in mind.
For that go to Product Designer → Manage Tabs.

Here, you will get the list of all the Main Tabs.

By clicking on the ‘Edit’ option under the ‘Action’ tab, you will be redirected to the Tab Detail Page.

Now, under the User Guide heading, you can add respective text in “Left Panel Tooltip” & “Right Panel Tooltip”.

Front End View

After Back End configurations, the customers will get the User Guide by clicking on any Tab which is located on the “How do you want to start “page. You will get this page by clicking on the ‘User Guide (Help)’ icon above the Designer Tool.

If you have added a short message in the ‘Left Panel Tooltip’ from the Back End, your customers will get the User Guide message on the left side.

If you have added a short message in the ‘Right Panel Tooltip’ from the Back End, your customers will get the User Guide message on the right side.

MANAGE PHOTO CALENDAR

The PrintXpand designer tool provides a feature that lets your customers create a personalized “Photo Calendar”. They can design the photo calendar by uploading images, text, clipart, background, etc. as per the configurations from the Back End.

Back End Configuration

For the Product Template configuration, go to Product Designer → Manage Product Template.

By clicking on it, you will be redirected to the Manage Product Template page. Here you will get the list of Product Templates for the Calendar.

To add a new Product Template, click on the ‘Add Product Template’ button. By clicking on it, you will be redirected to the ‘Add Product Template’ page.

Enter the following details:
Template Name: Enter the relevant Template Name.
Product Type: Select Calendar as the product type from the dropdown list.
Store Views: Select the stores in which the product template will be displayed.
Product Template Images: You need to upload images to create a template for the Calendar.

You can upload images for the photo calendar as per months.
After uploading, you have to select their respective months & years.
You can also set any uploaded image as the cover or back image. These options are available in the ‘Select Month’ dropdown list.
After uploading the images and selecting months & years, you need to upload their individual masking images, too.
You can delete the entire row by ticking ‘Remove’ box.

After inserting all the details and uploading all the images with month & year-wise, click on ‘Save Product Template’.

Note: In the masking images, the number of Path Tags should be equal to Number of design area of the images.

Now, after creating a product template, the next step is to create a simple product from:

Catalog → Product → Add Product

Here, you need to insert required details like Product Name, Price, Quantity, Weight, etc.

Now, scroll down to the ‘Product Designer’ option. Here you need to Enable Product Designer option and then by scrolling down, select Calendar in ‘Product Type’ option. You need to save all the details and then go to the “Images & Video” option to upload the images that you want to display on the stores.

While adding images and selecting sides, make sure you select an appropriate product template for the Calender from the dropdown list. This option will only appear if you’ve selected ‘Photo Calendar’ as the product type.

Note: The product designing and Masking area will be defined as per the template.

Now, Save the Product.

Front End View

After all the configurations, the Photo Calendar will be displayed on the stores. The customers can click on the photo calendar and then select the photo calendar template to get started with the personalization. After selecting the template, they will be redirected to the product designer page.

By clicking on it, your customers will be redirected to the product designing page with the Calendar template.

The customers can upload images in bulk. Images/clipart will take place as per the available design areas in all the templates. In the Upload and clipart tab, the customers will be shown Total Pending Images number. After uploading all the images and by clicking on the ‘Apply images’ button, all the images will be uploaded on the template as per the month.

Under the product image, the customers will be able to see the dropdown option to select the starting month of the calendar they are personalizing.

Note: Design Templates of normal products are not available for Calendar Type Products. Additionally, the admin needs to add all months images of at least one year.

HOT FOLDER

HotFolder is a cross-platform desktop application. You can download the Product design Images and details of placed orders through PrintXpand Designer tool. It is easy to create special folders on your system as per the destination folder of your choice. Once you configure the app it automatically fetches the new Product design Images from the e-store.

Prerequisites

It is important to enable PrintXpand tool to your e-store so that, customers can design the products as per the requirements.

To download and synchronize the product images with HotFolder, it is important that to make product designs with the PrintXpand Designer Tool only.

To synchronize or run HotFolder application in your e-store, you must have an internet connection with higher bandwidth.

Authentication Module

You can login to your HotFolder account by filling the required information.

To Login to your account, provide following information:

Store URL: Enter the URL of your e-store (e.g. https://www.PrintXpand.com).
Username: Enter the Username of your Store Admin Panel.
Password: Enter the Password of your Store Admin Panel.

Configuration Module

Once you have successfully authenticated/logged into your account, you will be navigated to the `HotFolder Configuration Module`.

From here you can manage following fields:

Store Order By: Choose the option by which you want to set the file structure in your system after you download the files from the e-store. You can store orders in two ways:
~Date Wise: To store the orders as per their Order Dates.
~Order Wise: To store the orders as per their Order Number.

File Types: Choose the type of file in which you want to download the order configuration files. It has the following options: csv | txt | xls | xml

Data Retrieval Interval: Choose the time interval to fetch and interval check of the new orders from the store. It has the following options: 15 Minutes | 30 Minutes | 45 Minutes | 1 Hour | 1 Day

Order Status: Choose the Order Status for which you want to download order files from the e-store. It will contain all the existing order statuses from the e-store.
Note: By default, you would have ‘Pending’ order status selected.

Destination Folder: Choose the folder / specific location in which you want to download all files from the e-store.

Click on ‘Save and Proceed’ button to save the changes and proceed further. By clicking, it will start the file downloading process as per the configurations. And you will be navigated on `Record Listing Page`.

By navigating back to `HotFolder Configuration Module`, you will find a `My Files` button to access the `Record Listing Page` again.

Record Listing

Once you fetch the files from the Store Backend, you can view a complete list of available files in the table as per the previous configurations. The table will contain the following order details:

Order Number: The unique number assigned to the order.
Order Date: The date on which the order was created.
File Name: The name of the file by which it will be downloaded.
Destination Path: The destination path on which the order record file will be saved.
Type: The type of file in which the order configurations file is downloaded.

Status: The download status of order file. There will be three types of status:
~Pending – To download pending files.
~Downloaded – To downloaded files.
~Failed – To download failed files.

Action: The actions column will consist of the following points:
~N / A: It is for the orders files which you are yet to download and have under ‘Pending’ status.
~Retry: It is for the order files which failed the downloads and have ‘Failed’ status.
~View: It is for the order files which are downloaded and have ‘Downloaded’ status.

To clear some of the records from Records Listing page, select the records and click on ‘Clear Log’ button. It will clear the log records without affecting the downloaded files.

For `Failed` records, you can apply `Retry` action on each record to download again. You can also select all the records you want to download and apply `Retry All`.

The timer at the top indicates the remaining time for the next call to the server. It checks and downloads new orders from the store.
You can use the button next to the timer to manually check and fetch new orders at any time.

To navigate back to the Configuration Module, click on ‘Configuration’ button from the Records Listing Page.

Filter Records

To filter the records, navigate to the ‘Filters’ section above the records table. You can filter records in the following ways:

Status: Select the status value by which you want to filter the record from the ‘Status’ dropdown list. After selecting the status value, click on the ‘Search’ button to apply the filter.

Start Date and End Date: Choose the start date and end date for the time interval for which you want to filter the records. You can choose the initial date from ‘Start Date’ and the last date of the time interval from ‘End Date’. Thereafter, click on the ‘Search’ button to apply the filter.

Reset: Click on ‘Reset’ button to reset the applied filter criteria.

To logout from the HotFolder app, click on the ‘Log Out’ button. By doing so, it will clear all the records and saved configurations from the HotFolder. Downloaded files will not be deleted from the destination folder.