Product customization Index
##Overview of the LineDetail Field
This field is a PAM field created to define the parameters of the option that will be presented to the shopper in a product page on the web store. This comma separated field allows you to present a text, number, drop down menu, radio button or a date picker to the shopper from which they can customize their purchase.
##Rules Governing the LineDetail Field
- The field is a comma separated field where each value will correspond to an option presented to the shopper;
- The number of fields must match the number of field in the LineCost and LineTitle fields;
- Further rules are option specific and set out below in Options Available:
##Options Available
###Text Input
LineDetail should be a series of numbers separated by commas delineating the number of characters that can be input into a text box.
Sample PAM entry
LineDetail: 20,30,20
This will create (in conjunction with LineTitle and LineCost) 3 fields able to take 20 characters in the first and last lines and 30 characters in the middle line.
###Menu Input
Sometimes you need to give a shopper a selection from a drop down menu. In this instance you need to substitute the line length for an m followed by the values you want included in the drop down menu.
It is important to start your menu with the word none if you want the shopper to have the option to not use this field. The webstore will not charge the line cost if none is the selected option.
Sample PAM entry
LineDetail: 20,30,mGarona-Times_New_Roman-Web_Dings
This will display 2 text columns and a drop down menu with the name of three fonts in it.
###Radio buttons
If you want to offer a shopper a choice between options that are mutually incompatible, radio buttons are what you need. It works by adding the value ‘r’ followed by the name/value of the radio buttons you want displayed. We would suggest always making the first button ‘None’ so that shoppers can opt out of the selection and not get charged. For pricing, the webstore will check if the None button is selected and not charge customers if this button is the selected button.
Sample PAM entry
LineDetail: 20,20,rNone-Red-Blue-Green
This will display three fields, the first two text fields with 20 characters in them followed by a set of four radio buttons called None, Red, Blue and Green.
###Numeric drop down menu input
If you want a shopper to enter a numeric value use this input. It allows you to programmatically specify the contents of a drop down menu.
Sample PAM entry
LineDetail: nLOWER_VALUE-HIGHER_VALUE-STEP
LOWER_VALUE is the lowest acceptable number;
HIGHER_VALUE the highest acceptable number;
STEP is the the interval (generally 1).
So if you wanted someone to be able to select any number between 0 and 99 you would enter s0-99-1.
The web store will add the word none to the start of the drop down. If the none is selected then the web store won’t charge the user for this field.
###Date Picker
Sometimes you need a date from a shopper. By substituting a line length with the value ‘d’ you can have the webstore display a small calendar allowing the shopper to select a date. This is passed down to the store as a string in the same way as a text field would be.
Further Notes on date picker
These inputs rely on HTML5. This is present in all modern browsers (Chrome). However, in older browsers you might find some inconsistencies with the date picker and it might be displayed as a text input box instead. In this instance a shopper will have to type in a date rather than select it from a calendar.