...
| Table of Contents |
|---|
When Should I Use This Feature?
An attributed add-on is an add-on that has an attribute assigned to it with attribute values. This allows multiple SKUs, unique attribute value names, and different pricing to be assigned to add-on variants. When an attributed add-on is assigned properly to a core product, the linked attribute value that is selected on the PDP will trigger the matching attributed add-on value to display. If added to cart the add-on will then be sold as a separate SKU from the core product.
A use case example might be if you have a ski rental core product with a helmet add on. Then, that add on could be either a 1-day helmet rental or a 2-day helmet rental, each with it’s own SKU and pricing.
...
Setup Guide
Following the steps below to configure attributed add ons.
Prerequisite Tasks
...
1. POS Tasks
RTP
The product must be a fully configured product in the POS system and able to be sold in ONE|Resort.
General tab
Product is active
The appropriate security level is set at or below the Aspenware User security level.
Sales Locations
Appropriate Sales Location for Aspenware is assigned
Components
Required Component(s) for the product have been added.
Sales Channels
The appropriate Sales Channel for Aspenware has been added.
Pricing
Pricing date ranges and/or pricing seasons are valid.
Rules
Optionally add any rules the product may require, ie Customer Required, PUB/Skiosk, Min/Max age, etc.
Siriusware
The Item must be a fully configured product in the POS system and should be able to be sold on Sales.
Salespoint Type
Item is available to be sold from Web Sales
Restrictions
Available Sales Dates has the Item priced for the current season
Items
Item is added to the Item Tree being used by the Online Salespoint
Add-on Item is set up as either:
A standalone DCI (example: a rental add-on to a ticket)
Required modifier Item added to main DCI (example: accept or decline insurance)
2. Commerce Tasks
Create a core product. The product should be fully configured, published, and accessible in the store.
Add an attribute to the core product and mark it as a Linked attribute. This attribute must match the attribute added to the add-on product. Changing selections for this attribute on the PDP will trigger which add-on is displayed.
...
Create a hidden category for add-ons if one does not already exist.
| Info |
|---|
NOTE: For steps to create a core product see Configuration: Product Shell. |
Detailed Setup Guide
...
Create an Add-On Product
Add Attribute(s) to the Add-On Product
Generate Attribute Combinations
Create an Attribute to House the Add-On Connection to the Core Product
Associate the Add-On Product to the Core Product
| Info |
|---|
NOTE: It is recommended to save often by clicking Save and Continue Edit in the top menu bar. This will ensure your work is saved in the event you accidentally close or navigate away from the page. |
HINT: Image examples below can be clicked to enlarge for easier viewing.
1. Create an Add-On Product
To create an add-on product, follow the steps to create a product shell.
| Info |
|---|
NOTE: Steps to configure images, short and long descriptions, and email descriptions can be skipped when configuring an add-on product shell as these will not be visible to the guest when booking through the core product. |
Assign the add-on product to a hidden category (likely titled “Add-ons” or “Hidden”).
...
| Note |
|---|
IMPORTANT: Add-ons have additional limitations to be aware of:
|
2. Add Attribute(s) to the Add-On Product
Go to Catalog > Products, find the desired add-on product, and click Edit to open the Edit product details page.
Scroll down to the Product attributes section. (Click the + if collapsed.)
Click Add a new attribute to open the Edit product attributes page.
...
Select the attribute from the Attribute drop-down list.
Temporarily check Is Required for purposes of generating the attribute combination table. This will later need to be removed.
Keep Control type as Drop-down list. No other control types are supported.
Set Enable linked attribute to 'True.'
| Note |
|---|
IMPORTANT: This attribute must match the linked attribute attribute added to the core product. |
Click Save.
...
If the attribute added has predefined values configured within the Catalog > Attributes > Product Attributes section, these will be generated when the attribute is added to the product. These can be removed and changed.
If you would like to edit or delete predefined values, click Edit or Delete next to the value you wish to change. Either edit predefined values or add new values.
If you would like to add a new attribute value to the attribute, click Add a new value.
When adding a new value, specify the value Name.
Save and repeat for all attributes on the product.
| Note |
|---|
IMPORTANT: Each attribute value Name must match the associated core product’s attribute value’s Name exactly. If you change the name of the attribute values on the core product you must also change the attribute values here otherwise all attributes will appear on the PDP. |
3. Generate Attribute Combinations
...
To generate the attribute combinations, scroll to the Attribute combinations tab under the Product attribute section on the Edit product details page.
...
If all of your required attributes are set up (e.g. Age and Number of Days), then you can generate attribute combinations.
...
Click Generate all possible combinations.
...
A message box will appear asking you if you are sure you want to generate all possible combinations. If you are certain that none of your attributes with add ons are added, click Yes.
...
Click Edit next to each attribute combination.
Enter the correct RTP|One PHC or Siriusware DCI in the SKU field.
Update the Overridden price field. Add-on products cannot be dynamically priced, so the price must be defined here.
Leave all other fields alone. They are not used.
Save and repeat this step for each row in the attribute combination table. This this is where the add-on product SKUs and prices are defined.
| Note |
|---|
IMPORTANT: Don’t forget to uncheck Is Required on all of the attributes added to the Add-on product after the attribute combination table is generated. Add-ons that have required attributes will not be able to be booked. |
...
4. Create an Attribute to House the Add-On Connection to the Core Product
To create an attribute, following the steps in section 1 of the attached configuration guide: Configuration: Product Attributes
No predefined values should be added to the attribute on the attribute editor screen.
...
4. Associate the Add-On Product to the Core Product
Go to Catalog > Products, find the desired CORE product, and click Edit to open the Edit product details page.
Scroll down to the Product attributes section. (Click the + if collapsed.)
Click Add a new attribute to open the Edit product attributes page and select the attribute from the Attribute drop-down list.
...
Select the attribute recently created to house the add-ons.
Set the remaining fields based on your preference for display and functionality on the PDP then click Save and Continue Edit.
The Text prompt field enables additional information to be given to the user interface about how and where an attribute is displayed. [Add On] is typically added to these products so that the add on selection appears in a separate “Upgrade Your Experience” box.
Control type is typically configured as Checkboxes
Expand the Values section and click the Add a new value button.
...
In the modal complete the following:
The Attribute value type must be set to“Associated to product”
Associated product: Click the Associate a product button in the modal.
Search for the add-on product by Name.
Click to Select the desired add-on product
Within the initial modal, the selected add-on product’s name should now be visible and an orange textbox should be visible. Check Associate product attribute combinations, which appears next to the orange box.
HINT: When there is an orange textbox present this means the add-on selected has attributes assigned to it. If the textbox is blue then the attributed add-on was not configured properly for this configuration.
Next, complete the following information for that attribute value:
Customer enters quantity: This field is not used, leave unchecked.
Product quantity: This field is not used, leave unchecked.
Name: Enter the name of the attribute. This will be seen by the guest on the PDP and by default any text you input here will be followed by a dash “-” then the name of the attribute values on the add-on product. You can edit the name later.
Is pre-selected: Can check or uncheck.
Display order: Leave as 0.
Picture: Select an icon image or leave as “No picture”.
Click the Save button.
...
| Info |
|---|
NOTE: You can change the name, image, etc. that guests will see for each add-on on the PDP by clicking Edit next to the value of the desired add-on after the above steps are completed. For example, clicking Edit in the screenshot below will bring up the screen to edit this. |
...
The add-ons are now added to the product and can be seen on the PDP when the matching attribute is selected.
...
The Commerce Site Navigation allows for theme customization. This guide will review how to set up that new theming. The configurable elements outlined below will need to be completed by an Aspenware Developer. Please consider the customization options outlined to ensure navigation is branded to integrate well with your resort’s visual theme and voice. Reach out to your Aspenware Service Agent (support@aspenware.com) to communicate your selections.
Detailed Setup Guide
Determine Text for Customizable Content
Submit Logo Files for Navigation
Determine Colors for Navigation Bars
1. Determine Text for Customizable Content
The customizable elements are described below. Refer to the customizable content diagram of the default content.
The customizable text includes:
Shop: Side navigation, defaulted to ‘Shop’
Main Site: Side navigation, defaulted to ‘Main Site’, limited to 16 characters. Note that this is coded to inherit the same URL as the main logo link.
My Account Button Label: Defaulted to ‘My Account’
My Account Button Subtext: Default leaves the subtext blank
...
2. Submit Logo Files for Navigation
Determine the logos that you would like to use for the following navigation options:
Details | Recommended Image Sizes for Best Image Quality | Examples (Click to expand) |
|---|---|---|
The logo that appears in the navigation in the navigation bar | 50-100px tall |  |
(Optional) A mini logo that appears in the side navigation (drawer) next to Shop and Main site links | MUST be a 150px by 150px square with a max file size of 150kb |  |
3. Determine Colors for Navigation Bars
There are many opportunities within the integrated shop navigation header to determine color and font choices.
Navigation bar background colors
Details | Examples (Click to expand) |
|---|---|
Navigation bar background color | .jpg?version=1&modificationDate=1684878100918&cacheVersion=1&api=v2&width=204) |
Navigation bar font colors
Details | Examples (Click to expand) |
|---|---|
Top Navigation font color | .jpg?version=1&modificationDate=1684878100937&cacheVersion=1&api=v2) |
Side navigation bar font colors
Details | Examples (Click to expand) |
|---|---|
Side navigation top area background color (We recommend matching the color of the navigation bar background color.) | .jpg?version=1&modificationDate=1684878100955&cacheVersion=1&api=v2) |
Side navigation top area font color (We recommend matching the color of the top navigation text when the background is colored.) | .jpg?version=1&modificationDate=1684878100974&cacheVersion=1&api=v2) |
| Info |
|---|
NOTE: Font and text size will be inherited from the overall theme fonts. |
...