Configuration
The following changes have been made to the E-Commerce pages in support of the new Family Pass Package functionality:
• An ItemShowFamilyPass.aspx page based on ItemShow.aspx has been created to handle the components of the pass package
• The user is redirected to the new ItemShowFamilyPass.aspx page if the item selected is a Package Item
• The file PackageConfiguration.xml has been added to define Package Items and the components of the Family Pass Package. This xml file must be in the site root in order to be read and applied.
• The control file PackageItemShow.ascx has been added to the UserControls folder to help in handling the selection of first and second level modifiers on the new ItemShowFamilyPass.aspx page
Package Items and their components are defined and their behavior configured using the PackageConfiguration.xml file. Information about the main family pass package item is entered into the <PackageItem> section of the xml file.
Example:
<PackageItem>
<MinQty>2</MinQty>
<MaxQty>999</MaxQty>
<QuantityRestrictionExcludes>PASSES|ADDONS|INSURANCE</QuantityRestrictionExcludes>
<PackageTitle>Family Pass Package</PackageTitle>
<PackageDescription>The Family Pass Package allows you to bundle your
family's season passes into one great Package. Choose up to 2 Adults. You may add as many
Youth/Child passes as you like, and the 5th and subsequent passes will be free (with a $25 service
Fee). Add your family members below:</PackageDescription>
<DCI>PASSES|FAMPASPKGS|FAMILYPASS</DCI>
</PackageItem>
The <MinQty> and <MaxQty> tags are used to define the minimum and maximum number of modifiers that the main family pass package item can have. The <QuantityRestrictionExcludes> tag indicates which, if any, modifiers are not included when determining if the quantity restrictions have been met or not. Set the <PackageTitle> and <PackageDescription> tags to text that you want to display on the new ItemShowFamilyPass.aspx page to describe the family pass package. And finally enter the DCI of the main family pass package item into the <DCI> tags as shown above.
The next section of the PackageConfiguration.xml file is used to configure the modifiers for the main pass package item and how they behave. You can add as many <PackageItemGroup> sections as you need to define the groups of modifiers that you have in your package. The tags define things in a similar manner as they do in the section above.
Example:
<PackageItemGroups>
<PackageItemGroup>
<MinQty>1</MinQty>
<MaxQty>2</MaxQty>
<PackageGroupName>Adult Passes/Senior
Passes</PackageGroupName>
<PackageGroupDesc>Please select Adult/Senior family members (Minimum of 1 / Maximum of 2) by clicking the links below. Then select add-ons using the
checkboxes.</PackageGroupDesc>
<DCIs>
<string>PASSES|FAMPASPKGS|ADULT</string>
<string>PASSES|FAMPASPKGS|SENIOR</string>
</DCIs>
<PackageItemGroups />
</PackageItemGroup>
<PackageItemGroup>
<MinQty>1</MinQty>
<MaxQty>999</MaxQty>
<PackageGroupName>Youth Passes/Child
Passes</PackageGroupName>
<PackageGroupDesc>Select Youth/Child family members (Minimum of 1 / Maximum unlimited) by clicking the links below. Then select add-ons using the
checkboxes.</PackageGroupDesc>
<DCIs>
<string>PASSES|FAMPASPKGS|YOUTH</string>
<string>PASSES|FAMPASPKGS|CHILD</string>
</DCIs>
<PackageItemGroups />
</PackageItemGroup>
<PackageItemGroup>
<MinQty>0</MinQty>
<MaxQty>1</MaxQty>
<PackageGroupName>Insurance</PackageGroupName>
<PackageGroupDesc>Select this if you want to add insurance to your
pass package.</PackageGroupDesc>
<DCIs>
<string>PASSES|ADDONS|INSURANCE</string>
</DCIs>
<PackageItemGroups />
</PackageItemGroup>
</PackageItemGroups>
Modifiers
Functionality was added to the E-Commerce pages to show modifier prices in the cart. The prices are displayed as follows: Modifier Description (+ price) (modifier1 (+ $24.50)) on the description row for each first and second level modifier. The functionality is enabled by setting Site Admin Panel > Item Settings > ShowModPrice value = 1 in the site config file - set the value to 0 to disable.