Product Customisations

To add or edit a Product Customisation, follow the steps described in the sections that follow.

1. Go to Products > Product Customisations in the IRP Admin left navigation menu.
2. To add a new Product Customisation, click the Add New Product Customisation button at the top of the page.
3. To edit an existing Product Customisation, click the Edit button at the right side of the Product Customisation that you want to edit.
4. Enter or edit the following details:

   Setting	Description
   Product Customisation Details
   Customisation ID	The unique IRP identifier for this Product Customisation. This is automatically generated when adding a Product Customisation.
   Active	Active Product Customisations will be applied to Models where the Brand and Category restrictions have been met. Inactive Product Customisations will not apply at all on the front end of the site. Note that a Product Customisation cannot be made active until you have added Product Views and Printing Methods.
   Name	This name is used only in IRP Admin so that this Product Customisation can be quickly referenced and identified on the ProductCustomisations.aspx page.
   Priority	Priority is used if multiple Product Customisations apply to the same Model. Lower values correspond to higher priorities, making them more likely to display, for example 0 has a higher Priority than 1 so will display before any Customisations with a priority of 1 or greater.
   Display Preview	If you check this box, any Custom Elements that the Customer adds will display on the preview image, overlaid on a base image. If a fairly accurate preview is not possible then you should not check this box so that no preview displays but the personalised elements can still be recorded. If you leave this box unchecked, the options will be listed separately in the boxes and will not be shown on the preview options - but the model images will continue to be shown.
   Description	This optional description can be used to detail what the Product Customisation is for and what it allows for other Admin Users.
   Advanced Details
   Max Text Elements	The maximum number of Text Elements that a customer can add to the customisation. Note that the Max Text Elements value is set against the full customisation which limits the maximum number of text elements that can be added across all product views. To limit the number of text elements for a specific product view, you need to enable the Allow Custom Text setting (on the 'Product Views' tab) and enter a value for the Text Element Limit setting for the area within it. For example, if you would like to configure product views such as the 'front' and 'back' of an item which are each limited to one piece of text, you need to set Text Element Limit to 1 for the area in each of these views. If there is a Max Text Elements value of 2 and no Text Element Limit per view, a customer can add both of these elements to either the 'front' or the 'back' rather than one text element each.
   Text Element Surcharge	This surcharge will be applied for each Text Element that the customer adds.
   Max Image Elements	The maximum number of Image Elements that a customer can add to the customisation.
   Image Element Surcharge	This surcharge will be applied for each Image Element that the customer adds.
   Allow Text Colour Selection	If unchecked, all Text Fonts will be black by default and the customer will not have the option of changing this colour. If checked, a universal colour palette or specific colours can be defined under the Text Element Options tab.
   Allow Text Font Selection	If unchecked, this will prevent the customer from being able to choose a font from a dropdown list and the default font will be Arial. If checked, specific fonts can be defined under the Text Element Options tab. Note that all fonts must be supported in CSS in order to display correctly on the front end of the site.
   Allow Element Rotation	This allows customers to rotate Text or Images that they add if the Display Preview setting is enabled. Rotation does not work in IE8 or earlier.

5. When inserting a Product Customisation, click the Insert Product Customisation button to save the details. You should then see the following message at the top of the page:
   
   And new tabs will appear: Category Restrictions, Brand Restrictions, Model Restrictions, Text Element Options, Printing Methods and Product Views.
6. On the Category Restrictions and Brand Restrictions tabs, you can apply the customisation to the customisable category that you have created previously and/or any specific Brand/s. To do this, highlight the Non-Selected Categories/Brands that you want to apply the customisation to and click the Add >>> button. This will add these Categories/Brands to the Select Categories/Select Brands lists. You can revert this by highlighting the Selected Categories/Brands that you want to remove, and clicking the <<< Remove button.
   
7. When you have entered or edited the necessary details on the tabs, click the Update Product Customisation button.
8. On the Model Restrictions tab you can apply the customisation to a specific model or models. To do this, click your mouse cursor in the search bar and then select the model or models from the drop-down list that you want to apply the customisation to and click the Add Models button. You will then see the model or models you have added in the grid on the page and from here you can also delete models that you have previously selected:
   
9. When you have entered or edited the necessary details, click the Update Product Customisation button. With the main Product Customisation Information set, you can now move on to adding Product Views, Text Element Options and Printing Methods.

Product Views are the areas in which images or text can be added to the product. Examples of Product Views include Front, Back, Left Pocket, and so forth. Each view must have one or more Defined Areas that a Customer can add images and/or text to. This tab also allows you to add the base image for this product as well as define the areas to which custom content can be added.

To add a Product View, follow these steps:

1. Click the Product Views tab.
2. To add a new Product View, click the Add New Product View button at the left side of the page.
3. To edit an existing Product View, click the Edit button at the right side of the Product View that you want to edit.
4. Enter or edit the following details:

   Setting	Description
   Product View ID	The unique IRP identifier for this Product View. This is automatically generated when adding a Product View.
   Product Customisation	The Product Customisation this Product View will, or does, apply to. This is automatically set to the customisation for which you are adding the Product View.
   Product View Base Image	(Adding Product Views only.) The Base Image is what the customer will see when they are customising the Product. Custom Text and Image elements will appear on top of this image. Images can be uploaded by clicking the Choose File button, navigating to the required Image on your machine and selecting it. Base Images must be in JPEG format and should not exceed 440px.
   View Name	This translatable Name value will appear as the tab Text for this View on the front end. Click the Translate button to change the language you are editing.
   Display Order	Each view will display in its own tab on the front end, so the display order determines which view to display first. Lower values will appear before higher values, with a value of 0 appearing first.
   Surcharge	This GBP surcharge will be applied when the customer personalises this View, i.e. adds a Text/Image element to the View. This surcharge can be set per amount of units. For example, if a surcharge of 5 and 12 units are specified, the 5 surcharge will be applied to every 12 units to be printed. If 24 units are ordered the total surcharge value will be 10. In cases where fewer units than the units value are ordered, the surcharge will be applied once. For example, if a surcharge of 5 and 12 units are specified, and a customer orders 8 units, the 5 surcharge will still be applied.
   Min Custom Image Height (px)	This sets the minimum Image Height. Images smaller than this will not be uploaded.
   Max Custom Image Height (px)	This sets the maximum Image Height. Images larger than this will not be uploaded.
   Min Custom Image Width (px)	This sets the minimum Image Width. Images smaller than this will not be uploaded.
   Max Custom Image Width (px)	This sets the maximum Image Width. Images larger than this will not be uploaded.

5. When inserting a Product View, click the Insert View button. A new section called Product View Areas will open which will allow you to specify the areas that can be customised on the product:
   
6. You must define the Areas in which customers will be able to place Images/Text. To define or draw an Area, drag the mouse over the base image to select an area that the customer will be able add Images or Text to. The X and Y, Height and Width values of the area will be displayed below. If you plan on adding more than one Area in the same View, ensure that they do not overlap.
   
7. When you have defined the area, enter or edit the following details:

   Setting	Description
   Start X	The starting X coordinate for this area - this is populated automatically according to the area you have selected with your cursor.
   Start Y	The starting Y coordinate for this area - this is populated automatically according to the area you have selected with your cursor.
   Width (px)	The width of this area in pixels - this is populated automatically according to the area you have selected with your cursor.
   Height (px)	The height of this area in pixels - this is populated automatically according to the area you have selected with your cursor.
   Area Name	This translation will appear in a dropdown list on the front end of the site when the customer selects the area to which they want to add their text or images. Click the Translate button to change the language you are editing.
   Mutually Exclusive Text & Images	If enabled, either Text or Images can be added to the Area, but not both in the same Area.
   Allow Custom Images	If enabled, Images will be accepted in the Area. If disabled, Images cannot be added to the Area. A customisable area must allow custom images, text or both. If you check this box then the following settings will also appear: Fixed Image Area: If checked, any images that a customer adds will be automatically centred in this area and shall not be moveable or resizeable. Note that this applies only if a preview is displayed for this customisation. Image Element Limit (optional): This value will limit the number of images that a user can add to this area.
   Allow Custom Text	If enabled, Text will be accepted in the Area. If disabled, Text cannot be added to the Area. A customisable area must allow custom images, text or both. If you check this box then the following settings will also appear: Fixed Text Area: If checked, any text that a customer adds will be automatically centred in this area and shall not be moveable or resizeable and font sizes will not be selectable (the font size will be changed automatically based on the number of characters entered). The number of lines of text to add and the number of allowed characters per line must be specified if this is selected. Note that this applies only if a preview is displayed for this customisation. Is Text Numeric Only: If checked, any text that a customer adds will be limited to numeric characters 0-9. Text Element Limit (optional): This will limit the number of text elements that can be added to this area to the given value (which is optional). Max Number Of Characters (optional): This is the maximum number of characters to allow per element in the input text area which the customer will add their text to. Character Surcharge: This surcharge will be applied to each character of each personalised text element that the customer adds to this area.

8. When you have added the necessary View details, click the Add Area button.
9. When you have added the required Product Views, click the Update View button to save them all.
10. Once configured you will see the Product Views listed in a grid:
    
    Here is an example of how previously-configured Product Views look when you are back on the ProductCustomisationEdit.aspx page:
    
11. To define more Areas or make changes to an existing area from the ProductCustomisationEdit.aspx page, click either the Has Areas link or the Edit button at the right side of the Product View you want to define an Area for. From here you can edit any of the details that you have previously entered for the Product View as well as add Areas.

You can specify the available Text Fonts, Font Sizes and text Colours for the Customisation here. All of these Text Elements are optional.

Text Fonts

Add the fonts that will be available to customers when they add custom text elements. Font names should correspond to CSS fonts. To add a text font, follow these steps:

1. Click the Text Element Options tab.
2. In the Text Fonts section, enter the following details:

   Setting	Description
   Font Name	This name must be a CSS supported font-family in order to display for the customer. Non-CSS fonts can still be added for reference when printing, but will not be visually represented. Fonts which have been added for other customisations will appear as you start to type. Note that if you are adding a New Font, leave the Existing Font setting blank as these two settings are mutually exclusive.
   Display Name	The name that will be displayed to the customer for this font. Note that you can easily translate this into any language in your system by clicking the Translate button beside the setting.
   Existing Font	Choose from a list of previously added Fonts. This allows you to add the same font with different Case settings. Note that if you are adding a New Font, leave the Font Name setting blank as these two settings are mutually exclusive.
   Allow Upper Case	If Upper Case is enabled and Lower Case is not, all Text will display in Upper Case only. Both Options should be selected to allow Upper and Lower case Text.
   Allow Lower Case	If Lower Case is enabled and Upper Case is not, all Text will display in Lower Case only. Both Options should be selected to allow Upper and Lower case Text.

3. When you have entered the necessary details, click the Add New Font button.

Font Sizes

Add the font sizes (in pixels) that will be available to customers when they add custom text elements. If no font sizes are specified the default Sizes (8-32) will display for customers. To add a font size, follow these steps:

1. Click on the Text Element Options tab.
2. In the Font Sizes section, enter the following details:

   Setting	Description
   Font Size (px)	This will be a selectable Font Size in pixels.
   Surcharge	This surcharge will be added to the total cost of the customised product for each Text Element at this size.

3. When you have entered the necessary details, click the Add New Font Size button.

Text Colours

Add the text colours that will be available to customers when they add custom text elements. If no specific colours are added and the customisation allows text colour selection, customers will be able to select colours from a full colour palette. To add a Font Colour, follow these steps:

1. Click the Text Element Options Tab.
2. In the Text Colours section, enter the following details:

   Setting	Description
   Hex Value	The hexadecimal value of the colour. This can be entered manually or selected from the expandable colour palette to the right.
   Colour Name	This optional colour name can be used to describe the font colour to other IRP Admin users. It can also prove useful when reviewing purchased customised products which require printing.
   Surcharge	If provided the surcharge will be added if one or more text elements uses the given colour.

3. When you have entered the necessary details, click the Add Text Colour button.

You can remove text element options by clicking the Remove button beside the text element option that you want to remove.

Printing methods describe how the customisation will be produced for the customer. They allow you to restrict the ability to add text or images for a given printing method if they are not possible to print. You can add various charges for printing methods including a setup charge and charges per unit.

To add a Printing Method, follow these steps:

1. Click the Printing Methods tab.
2. To add a new printing method, click the Add New Printing Method button at the left side of the page.
3. To edit an existing printing method, click the Edit button at the right side of the printing method that you want to edit.
4. Enter or edit the following details:

   Setting	Description
   Printing Method ID	The unique IRP identifier for this printing method. This is automatically generated when adding a printing method.
   Active	This determines whether or not the printing method will be selectable on the front end.
   Product Customisation	The product customisation this printing method will or does apply to. This is automatically set to the customisation for which you are adding the printing method.
   Method Name	This translatable name value will appear in the printing method dropdown list on the front end of the site when a customer is personalising a product.
   Method Description	The description is optional, however it can be used to fully explain what is allowed for this printing method. Any given value will display as a tooltip for the customer when they hover their mouse over the given printing method in the dropdown list.
   Setup Charge	This will be the additional cost charged to the customer for printing using this printing method.
   Allow Custom Images	If enabled, images will be accepted in the customisation when this printing method is selected. If disabled, Images cannot be added to the customisation.
   Allow Custom Text	If enabled, text will be accepted in the customisation when this printing method is selected. If disabled, text cannot be added to the customisation.
   Apply Surcharges Per View	If checked any defined unit surcharges, defined in the Printing Method Charges section, will apply to each view that the customer personalises. Therefore if a customer personalises two views, the applicable unit surcharge value will be doubled.

5. When inserting a Printing Method, click the Insert Printing Method button. A new section called Printing Method Charges will open which will allow you to enter the following charge details if necessary:

   Setting	Description
   Max Printable Units	This charge will only apply to stock options that have up to this many units.
   Surcharge	This is the surcharge value that will be applied for this printing method when up to the above number of units are ordered.
   Per Unit(s)	If this value is 6 then the surcharge will be applied for every 6 units ordered. If fewer than 6 units are ordered the charge for 6 will apply.

   You can add as many printing method charges as required by entering values for the three fields and clicking the Add Charge button.
   You can remove charges by clicking the Remove button beside the charge that you want to remove.
6. When you have entered the necessary details, click the Update Printing Method button.

Once you have added the product customisation, when you create a product with the customisable category type, it will be displayed with the base images added in the customisation control on the front end, as shown below: