Setup Checklist
This section is a comprehensive and high level summary of all tasks and prerequisites required for this feature to function properly. This section is purposed for use after an administrator is familiar with configuring this feature as an “audit” checklist. For detailed set-up instructions, jump down to “Prerequisite Tasks” and “Detailed Setup Guide” and then follow up with this checklist to ensure all steps are completed.
EZLinks Tasks | |
Contact EZLinks and complete required setup. REQUIRED
| PREREQUISITES |
Infrastructure Tasks | |
1. Provide Aspenware Azure information (reccomended to use secure upload and not send via email) REQUIRED
2. AW rep tasks: REQUIRED
| PREREQUISITES |
Aspenware Commerce Tasks | |
1. Set up “Golf” Category REQUIRED 2. Create Golf Attributes REQUIRED 3. Enable store to route to Golf REQUIRED 4. Set the Default Sponsor ID REQUIRED 5. Map Customer Role(s) to the corresponding EZLinks Sponsor ID(s) REQUIRED 6. Add Language Strings REQUIRED 7. Add Widgets REQUIRED | PREREQUISITES |
1. Create Golf Course Product REQUIRED 2. Assign the line of business to the product REQUIRED 3. Set the course display order OPTIONAL 4. Add Course Notes OPTIONAL 5. Add Discounts OPTIONAL 6. Collect credit card during checkout for $0 orders OPTIONAL | DETAILED SETUP |
Prerequisite Tasks
This section describes all requirements that must be completed before you can begin setting up this feature. Once these tasks are complete continue to the next section.
EZLinks Tasks
Contact EZLinks and complete the required setup.
Purchase an EZLinks subscription.
Setup a web reservation channel.
Provide AW with SponsorID(s).
NOTE: Each channel represents a set of golf tee time inventory. Meaning, there may be different pricing, booking policies, etc. For Aspenware to handle online reservations for “Public Golfers” and “Resort Members”, in this example there will be 2 SponsorIDs.
Infrastructure Tasks
1. Provide Aspenware Azure information (recommended to use secure upload and not send via email)
Application (Client) ID
Directory (Tenent) ID
Client Secret for the Aspenware DevOps app registration
Navigate to Azure Active Directory/App Registrations and click on Owned applications
Go into the dev-ops App Registration and provide the IDs to AW. Recommended to use a secure upload and not send via email.
From there you can go into Certificates and Secrets and create a new key secret and set it to never expire. A new one won't overwrite the others. Provide this key to AW. Recommended to use a secure upload and not send via email.
2. Aspenware rep tasks:
NOTE: See Monday Board for specifics to complete tasks.
Provide EZLinks with technical requests
Request connection info from EZlinks
Install Plugins (Golf, Routing, Roles, Discounts, Discount Requirements)
Point AWC test to EZLinks Test and AWC Live to EZLinks Live
Ensure “Unity.Discount” Configuration > Widgets is enabled
Ensure “Cache product prices” is unchecked Configuration > Settings > Catalog Settings
Add Category Template System > Templates > Category Templates
Name: Golf
View path: CategoryTemplate.GolfProducts
Display order: 2
Add Product Template System > Template > Product Templates
Name: Golf product
View path: ProductTemplate.Golf
Display order: 11
Ignored product type IDs (advanced): [leave blank]
Aspenware Commerce Tasks
1. Set up “Golf” Category
Go to Catalog > Categories > Add New and set up a category titled “Golf” like you would a normal category with the exception you must also toggle on the “Advanced” view and set the Category template to “Golf”.
WARNING: Golf configuration does not support subcategories.
2. Create Golf Attributes
Go to Catalog > Attributes > Product attributes and add the following attributes:
NOTE: Do not create any attribute values for these.
Course Id
Entitlement Id
Fee Id
Fee Name
Fee Options
Reservation Date
Reservation Time
Reservation Holes
Reservation Price
Slot Nbr
Slot Name
Slot ID
3. Enable store to route to Golf
If “Golf” is not already present go to Aspenware Commerce > Routing > Manage Lines of Business and add “Golf” while leaving Ski as the default.
4. Set the Default Sponsor ID
Aspenware references EZLinks' Sponsor IDs in order to retrieve the correct tee times and pricing for specific customers. Since rates can vary for “club members” and “public players”, Aspenware requires a “Default Sponsor ID” which should be mapped to the public player sponsorID for 18 holes and 9 holes if applicable. This ensures a guest without a special Role is priced at the public rate.
Go to Aspenware Commerce > Golf Configuration and enter the Sponsor IDs and click Map
NOTE: If there is an issue adding the Sponsor IDs on this screen, these values can be added in Settings golfsettings.18holedefault and golfsettings.9holedefault
5. Map Customer Role(s) to the corresponding EZLinks Sponsor ID(s)
Aspenware references EZLinks' Sponsor IDs in order to retrieve the correct tee times and pricing for specific customers. Since rates can vary for “club members” and “public players”. Furthermore Customer Roles can be used to limit which products are visible to guests or requiring the guest to enter a credit card in checkout or not for Golf products.
NOTE: First customer roles must be set up which can be done by following the guide here:
Go to Aspenware Commerce > Role Configuration and complete the following:
Roles: Select the role from the drop-down
External Role ID: Input the POS’s Role ID
Sales Channel ID: Input the EZLInks SponsorID
Membership Type ID: Input the EZLinks Membership Type ID
Then click Map and repeat this process for all roles.
NOTE: If you have existing roles or need to update your role IDs for any reason, reach out to Aspenware support and we can update this on your behalf.
6. Add language strings
The most up-to-date language strings can be found here: Language Strings Library and the following are related to golf:
Language String | Default Value |
|---|---|
Messages.Order.DueAtCourse | Due at Course: |
golf.catalog.viewteetimes | View Tee Times |
golf.checkin.slotmissingcustomer | Missing Customer Info: Slot customer is missing |
7. Add Widgets
The most up-to-date widgets and process to add can be found here: https://aspenware.atlassian.net/wiki/spaces/AE/pages/1102807053/Configuration+and+Library+HTML+Widgets#1.-Find-the-Desired-HTML-Widget and the following are related to golf:
HTML Widget Name | Use | Code | Config Options | Widget Zones | Location | Example(s) Click to expand |
|---|---|---|---|---|---|---|
Golf Reservation Message | Because Tee-Times are $0 down products, this explains why a credit card is being collected for carts with tee-times | <div class="payment-message" style="padding: 1.6rem; background: #e8edf0; margin: 0 1.2rem; line-height: 1.5;" v-if="requiresCreditCard">A credit card is being collected to reserve your tee time. {{ personalization.TotalPriceDisplay }} is due online. {{ personalization.TotalCustomerEnteredPriceValue | currency }} will be due at the course.</div>
| Can edit some phrasing | checkout_payment_method_bottom |  | Checkout - Payment Page |
Golf Confirmation Page Message | Reiterate the amount due at course and highlight terms and conditions before guest completes booking | <div class="payment-message" style="padding: 1.6rem; background: #e8edf0; margin: 0 1.2rem; line-height: 1.5;" v-if="requiresCreditCard"><strong>{{ personalization.TotalCustomerEnteredPriceValue | currency }} DUE AT COURSE<br /><br />
Cancellation/No Show Policy:</strong><br />All guests are responsible for their reserved tee times. No payment will be collected to reserve a tee time; in the event of a no show, the credit card associated with the tee time reservation will be charged as follows:
Tee time cancelled more than 48 hours before tee time, no fee charged. Tee time canceled 24 - 48 hours before tee time, 50% of greens fee will be charged. Tee time canceled less than 24 hours before tee time will be charged 100% of greens fees.
This cancellation policy and associated penalties is applicable to all non-Full Golf Member players.</div>
| Must edit cancellation policy to match own policy | checkout_confirm_bottom |  | Checkout - Order Confirm Page |
Golf Tee Times Check-in Help | If online check-in enabled for golf, this widget zone gives instructions for how to use online tee time check in on the Tee Time Check in page | <div id="“maincontent”"> <h2>How to Check In For Your Round</h2> <hr class="“bluelinerule”" /> <div class="“introdescription" intro-body=""> <div class="”" introdesctext=""> <p><i>Online check-in is only available on day of play from midnight up to your tee time.</i></p> <h3>How to Check In For Your Round:</h3> <ol> <li>Choose your course, enter your confirmation number and your last name. If you clicked on the <i>Check In</i> link in your email, these fields will be pre-populated.</li> <li>Choose one or more slots to check in and pay in a single transaction, click Next.</li> <li>You may choose to check out as a guest or login with your account. If you are a BoyneRewards member, please log in to receive your points.</li> <li>Playing with friends on your reservation? Simply forward your confirmation email with the link to them or copy the link above and they can check in their slot and pay online too.</li> <li>Show up and enjoy your round of golf!</li> </ol></div> </div> </div> | Text | checkin_teetimes_bottom | Tee Time Check-In Page |
Detailed Setup Guide
This section describes all required steps to set up the feature after prerequisite tasks have been completed.
1. Create Golf Course Product
Go to Catalog > Products > Add New and set up a product according to standard product shell configuration [see: Configuration: Product Shell] with the following differences:
Product Info Tab
Product Name: Enter the name of the product. Optionally, a dash “-” can be used to add an additional line of larger text below the course name on the category page and the PDP.
Short & Long Description: Enter your short description.
NOTE: HTML is not supported and adding a | will not create a long description. Depending on the user’s browser ~200-400 characters are supported on the category page. If the character limit is greater than what is supported on the user’s browser the excess characters will be cut off with “…” until the product is clicked then the remainder of the text will display on the PDP.
SKU: Input the EZLinks course ID
Categories: Add the product to the “Golf” category
NOTE: If utilizing AW’s golf check-in feature, the check-in category should also be added.
Product Template: Change product template to “Golf product”
Price tab
Price: Set to $0.
NOTE: The price displayed to guests is pulled from EZLinks.
Customer enters price: Check this box
Minimum amount: Leave as 0.00
Maximum amount: Leave as 1000.00
Tax exempt: Check this box
NOTE: Tax is not used as golf products are $0 products.
Inventory tab
Inventory method: Don’t track inventory
Minimum cart qty: 1
Maximum cart qty: 4
Allowed quantites: 1,2,3,4
Pictures tab
Follow the standard upload process with key differences that only a single image needs to be uploaded and the recommended specs are 1770x541 for optimal display.
Product attributes tab
In order to properly display the data populated from EZLinks on the PDP, add the golf attributes exactly as displayed below:
WARNING: If anything does not match exactly as above including capitalization, display order, etc then the product will not perform as expected.
2. Assign the line of business to the product
Go to Aspenware Commers > Routing then select the course from the Product drop-down, select Golf from the Line of Business drop-down, and click Assign.
3. Set the Course display order
Courses can be configured to display dynamically based on course availability or desired order. If the setup is based upon availability and multiple courses have availability, then the Courses will display in the order in which they were created.
Go to Catalog > Categories > select the “Golf” category > Scroll down to Products and click edit on the desired golf course.
To display courses dynamically based on availability set all display orders to 1.
To display courses in a specified order set the values in numerical order.
4. Add Golf details to order confirmation emails
Go to Content Management > Message Templates > and click Edit next to the OrderPlaced.CustomerNotification template.
Click Tools > “< > Source Code” and add the tag %Order.CallToAction% > click Save and Continue Edit
NOTE: This template shares messaging sent for orders containing ski products. If a guest purchases both a ski and golf product in one transaction, the location in the template that you add this tag will determine if ski products are displayed before or after golf products.
5. Enable Online Check-in/Customer Pre-Pay [Optional]
Resorts can optionally allow guests to check-in and prepay for their course ahead of their tee-times.
First add the URL for checkin to golf order confirmation emails.
Go to Configuration > Settings > All Settings and search for “GolfSettings.CustomerCheckin.EmailCheckinButtonBaseUrl”. Add this setting if not present and ensure the setting’s value is set to your store’s URL ending with “/checkinteetimes” example:
6. Add Course Notes [Optional]
Course notes can be added to provide guests more information about their purchase.
If not already setup Go to Catalog > Attributes > Specification attributes > Add New and create a specification attribute named “Course Note”. Click Add a new option and add “Course Note” then click Save.
NOTE: This is case-sensitive.
Then go to Catalog > Products > and select your golf course. Scroll down to Specification attributes and click Add attribute. Add the specification attribute “Course Note” and click Save.
Attribute type: Custome text
Attribute: Course Note
Value: {enter the text you want guests to see}
Show on product page: checked
Display order: 0
7. Add Discounts [Optional]
Discount codes can be used on golf products and often utilize start/end dates. They must meet the following setup requirements from the discount guide here: Configuration: Discounts.
8. Collect credit card during checkout for $0 orders [Optional]
If you are using a payment provider that supports storing the credit card in the POS from Aspenware, you can collect the credit card during the checkout process even if the order total is $0.
WARNING: Only Auth.net has been tested and verified for this. Tokenization through Payeezy and future payment providers may also work but will need to be tested and confirmed.
If the “Requires CC in checkout” classification does not exist add it. Go to Aspenware Commerce > Product Classifications > Add Classification and add a new classification for collecting the credit card and click Add.
Then assign this classification to the Category (assigning directly to the product is not required)
Like this page? Click the like button below. Don't like this page and/or want to give feedback about this page, leave a comment below and Aspenware will address to improve this article.