Add Style Groups

1. Click Edit Styles in the Black menu.
   Note! There is already one Style Group, named Style, which you may use for adding default styles. This group may not be deleted and it is not necessary that you use it. However, if you have many Product Styles, and many products that will be using several, but not all of the Styles, adding them all here first may save you some time when creating your Style Groups, as you may simply "copy" styles from this default group into any other group. We will first cover adding Style Groups below.
2. Click the "Click Here To Add/Edit Style Groups" link at the top of the page. If you wish to Edit a Style Group, click the Style Group ID.
3. Before adding the first Style Group, there is a certain set of rules regarding the way you must ID them.
   1. All "Single Style" Style Groups MUST be set with an ID higher than all of your "Multiple Style" Style Groups. We recommend setting the first "Single Style" Style Group ID to a value greater than the number of "Multiple Style" Style Groups you will ever conceivably have.
   2. Any "Single Style" Style Group with an ID of 50000 or greater will appear as a Text Input field to the user, per the example in the overview.
   3. Any "Single Style" Style Group with an ID of less than 50000 will appear as a Yes/No choice as per the example in the overview.
   4. Again, all "Single Style" Style Groups must have an ID greater than all "Multiple Style" Style Groups within a product.
   5. Style Groups will appear in the product view by order of the ID you give them. You should therefore ID your Style Groups by skipping numbers where possible; 5, 10, 15, or 10, 20, 30, etc. This will allow you to add Style Groups later and have them appear where you like.
4. Input Fields:
   • Style Group: Customers will see this field in their shopping cart and e-mail invoice when ordering a style. You may name Style Groups the same. Example for a style group named "Finish" with a Finish of Mahogany selected for a Computer Desk placed in the cart:
     Computer Desk
     Finish: Mahogany
   • Alternate Name: If this field is populated, it appears in the Add Product and Edit Product screens and in the list of Style Groups in the Edit Styles section of administration. Otherwise, the value from the field above will display. This is for administration purposes only in case you do have several style groups with the same name.
   • Menu Text/Input Text Length:
     1. For "Multiple Style" Style Groups, this will appear in the Select Menu to the customer. We automatically add the word "Select", so if you enter the word Finish in this field, the user will see "Select Finsh" in the Select Menu in the product view, and if they choose Mahogany as the finish when ordering, will see Finish: Mahogany in their "basket" under the item.
     2. For Styles asking for customer input ("Single Style" Style Groups with an ID of 50000 or above), you may create a text input field by entering a number of 255 or less. If you enter a number greater than 255, a textarea field will be created allowing a (basically) unlimited number of characters.
     3. For Yes/No Style Groups ("Single Style" Style Groups with an ID below 50000), you may enter "1" (without the quotes). Otherwise you may enter "0" or anything else and it will be ignored. If 1 is entered, and the customer chooses Yes to "Add Optional Gift Wrapping for $5.00?", it will appear in his cart as...
        Gift Wrapping: Yes
        Entering anything other than 1 in this field will show the style name, causing it to show in the cart as...
        Gift Wrapping: Optional Gift Wrapping
        This example assumes a Style Group of "Gift Wrapping" with the single style within the group named "Optional Gift Wrapping".
   • Link Text: Allows you to have a link to images of the Styles in this Style Group. If you enter anything here, like "Click Here To See Finishes", there will be a link above the select menu in the product view that says "Click Here To See Finishes". This will then open a Popup Window. Where to place the images, the naming conventions, etc. is covered in the Add Styles section.
   • Style Mandatory (Yes/No): Selecing Yes will force the customer to make a selection.
   • Use Style Code as Part Number: When an item is ordered, you may use a combination of the Style Code[s] selected, along with the Product ID and a delimiter, to build the part number "on-the-fly". The Part Number that appears to the customer and which gets written to the invoice will be built from the Style Codes selected and will be built in the order the Style Groups are numbered. Example:

     You have an item "Widget" (Product ID W) with 2 style groups, Color (ID 10) and Size (ID 20). Your Color group contains Red, Blue and Green. Your Size group contains Large and Small. If the customer chooses a Red (Style Code RD), Large (Style Code LG) widget, the Part Number ordered would be W-RD-LG. This will allow you to synchronize multiple inventory items at your business or warehouse with a single product in the shopping cart. If you wanted size to come before color (W-LG-RD) you would need to renumber the Color Group and Size Group IDs. The final output may be altered by changing the 2 settings below in Application.cfm.

     1. <cfset attributes.styletopartreplace = "0"> - If this is set to "1" the original Product ID is replaced rather than appended. So the Part Number in the example order would become RD-LG.
     2. <cfset attributes.styletopartdelim = "-"> - This may be changed or removed. If changed to an underscore, this would make the ordered Part number W_RD_LG or RD_LG depending upon attributes.styletopartreplace. If removed, this would make the ordered Part number WRDLG or RDLG depending upon attributes.styletopartreplace.

     You may also add additional Style Groups to the same item with this feature set to No. For example if the Large, Red Widget ordered gets Holes punched in it before delivery, and the customer has a choice of Square Holes or Round Holes, you may add the Hole Type style group with this set to No. The style code of the Hole selected would not affect your inventory so would not be used to build the Part Number.

     Be sure to see Product Grouping for expanded functionality for this feature.

   • Price As (Actual/Percent): Prices may be set to calculate as the actual dollar amount set on a Style, or as a percentage of the base item. If set as Percent, and you enter "10" as the Price under a Style, choosing that Style will increase the price of the item 10% more than the item price + size surcharge. The price of any Styles chosen from other Style Groups will not be used to calculate the price. If set as Actual, and you enter "10" as the Price under a Style, choosing that Style will increase the price of the item $10.00.
5. Click the "Add Style Group" button and the Group is created.

Now that you've created a Style Group, see "Add Styles To Groups".