Insert excerpt | ||||||
---|---|---|---|---|---|---|
|
...
Insert excerpt | ||||||
---|---|---|---|---|---|---|
|
EZLinks Tasks | |||||||||||||||||||||||||||||||||||||||||||||||||
Contact EZLinks and complete required setup.
|
| ||||||||||||||||||||||||||||||||||||||||||||||||
Infrastructure Tasks | |||||||||||||||||||||||||||||||||||||||||||||||||
1. Provide Aspenware Azure information (reccomended to use secure upload and not send via email)
2. AW rep tasks:
|
| ||||||||||||||||||||||||||||||||||||||||||||||||
Aspenware Commerce Tasks | |||||||||||||||||||||||||||||||||||||||||||||||||
1. Set up “Golf” Category
2. Create Golf Attributes
3. Enable store to route to Golf
4. Set the Default Sponsor ID
5. Map Customer Role(s) to the corresponding EZLinks Sponsor ID(s)
6. Add Language Strings
7. Add Widgets
|
| ||||||||||||||||||||||||||||||||||||||||||||||||
1. Create Golf Course Product
2. Assign the line of business to the product
3. Set the course display order
6. Add Course Notes
7. Add Discounts
8. Enable Online Checkin
9. Disable Online Checkin Out of Season
|
|
Prerequisite Tasks
Insert excerpt | ||||||
---|---|---|---|---|---|---|
|
...
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 uses this value to make calls when we don’t know a user’s password and have to do something with their EZL account. A salt is added to the hashing process to force their uniqueness, increase their complexity without increasing user requirements, and to mitigate password related attacks.
These should be placed under the EzLinksSettings:
"EzLinksSaltValue": "4$p3N$4Lt",
...
1. Set up “Golf” Category
Go to Catalog > Categories > Add New and set up a category titled “Tee Times.”
Set up this category according to the Category Configuration Guide, however, you must also toggle on the “Advanced” view and set the Category template to “Golf”.
...
2. Create Golf Attributes
Go to Catalog > Attributes > Product attributes and create the following attributes:
...
If “Golf” is not already present go to Aspenware Commerce > Routing > Manage Lines of Business and add “Golf” while leaving Ski as the default.
...
Aspenware references EZLinks' 18 holes, 9 holes, and membership 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
...
Info |
---|
NOTE: First customer roles must be set up which can be done by following the guide here: |
First, go to Customers > Customer Roles and select Add New.
Name the customer role in accordance with the membership General Program Profile in RTP|One and the Membership SponsorID name in EZLinks.
Ensure Active is checked and DO NOT UPDATE ANY OTHER FIELDS.
Select Save and repeat this process for all roles.
Note |
---|
IMPORTANT: If you define a “purchased with product” on a customer role configuration in Aspenware Commerce it can break your site. Roles can be granted via purchased products in RTP|One but NOT using this feature. |
Next, go to Aspenware Commerce > Role Configuration and complete the following:
Roles: Select the role from the drop-down that was just created in the step above.
External Role ID: Input the General Program Profile ID from RTP|One in the External Role ID field.
Sales Channel ID: Input the EZLInks SponsorID from EZLinks in the Sales Channel ID field.
Membership Type ID: Input the EZLinks Membership Type ID in the Membership Type ID field.
Click Map and repeat this process for all roles.
...
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 |
Golf.CheckIn.NoReservation.Title | No Reservation Found |
Golf.CheckIn.NoReservation.Message | Online check-in is only available on the date of play. Check your reservation details and try again. |
Golf.CheckIn.TooLate.Title | You are a bit too late to check in |
Golf.CheckIn.TooLate.Message | Online check in is only available on the date of play. You are searching for a reservation for ${DateOfPlay}. Come back on that date to check in. Thanks for choosing BOYNE Golf! |
Golf.CheckIn.TooEarly.Title | You are a bit too early to check in |
Golf.CheckIn.TooEarly.Message | You are a bit too early to check in. “Online check-in is only available on the date of play. You are searching for a reservation for <Date of Play>; please come back on that date to check in. Thanks for choosing BOYNE Golf! |
Golf.CheckIn.Button.Search | Search |
Golf.CheckIn.Button.SearchNew | New |
Golf.CheckIn.Button.Next | Next |
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 |
| 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 |
| 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 |
| Text | checkin_teetimes_bottom AND body_start_html_tag_after | Tee Time Check-In Page when ACTIVE | |||
Online Check-in Unavailable | Turn this on ONLY when online check-in is not available, for example before the golf course is open for the season |
| Text | checkin_teetimes_bottom AND body_start_html_tag_after | Tee Time Check-In Page when INACTIVE |
Detailed Setup Guide
Insert excerpt | ||||||
---|---|---|---|---|---|---|
|
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:
...
In order to properly display the data populated from EZLinks on the PDP, add the golf attributes exactly as displayed below:
...
Note |
---|
WARNINGIMPORTANT: If anything does not match exactly as above including capitalization, display order, etc then the product will not perform as expected. |
To hide extra attributes that should not show in cart card e.g. slot id etc. Navigate to Configuration > Settings > All settings.
Find “catalogsettings.hiddenattributes” and in the value section, enter the exact attribute names that you would like not shown in the cart separated by a comma.
Select Update.
2. Assign the line of business to the product
Go to Aspenware Commers > Routing then select each 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.
...
If not already set up 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.
Info |
---|
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
...
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.
Note |
---|
WARNINGIMPORTANT: Only Auth.net has been tested and verified for this. Tokenization through Payeezy and future other 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)
...
For every golf installation that is using customer pre-pay, a single tee time check-in product must be created. This product only needs to be set up once but must be present to power the check-in functionality.
From Catalog>Products, clickAdd New to create a new product.
From here, switch to the “Advanced” tab, providing access to all required fields
Change ‘Product Template’ to Golf product
Update the following fields:
Product name - Enter “Tee Time”
Short description - Leave blank
SKU - Enter “checkin”
Published - Check to publish the product. If the product is published and belongs to a published category, it will be accessible publicly.
Price - Set to $0. The price when a customer checks out is $0. The price displayed to show what will be charged at the time of guest check-in comes from EZLinks.
Customer enters price - Check this
Minimum amount - Enter 0
Maximum amount - Enter 1000
Tax exempt - Check this
Tax Category - If this appears, set to None. This field will not appear if Tax exempt is checked.
Maximum cart qty - Must be set to 1. Minimum cart qty. should stay default of 1
Categories - Do not add to any categories
Click Save and Continue Edit
Next, go to the Product attributes tab.
In order to properly display the data populated from EZLinks on the PDP, add the golf attributes exactly as displayed below:
...
Note |
---|
WARNINGIMPORTANT: If anything does not match exactly as above including capitalization, display order, default values, etc. then the product will not perform as expected. |
Record the product ID from the “Tee Time” product so you can use the id in the settings required in the step below.
Create Categories for each Golf Shop
Navigate to Catalog > Categories
If Golf Shop Categories are not yet created
Select Add New > Enter Golf Shop Name e.g. Alpine Golf Shop
Select Display > Under Category Template > Select“Golf”
Select Products > Add a new product
Add each course that belongs within the Golf Shop
Record the Category ID so that you can create it as a hidden category in the next step.
Add the required settings for check-in
Go to Configuration > Settings > All Settings and search for the following settings:
“golfsettings.checkin.teetimeproductid” add the id for the Tee Time product created in the step above.
“catalogsettings.hiddencategories” add the id for the category created for the Golf Shop in the step above
“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:
...
Add Golf check-in link 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% after %Order.Product(s)% in the HTML
Then, click Save and Continue Edit
Info |
---|
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. |
...
Turn off/on $0 check-in
Go to Configuration > Settings > All Settings and search for “GolfSettings.CustomerCheckin.AllowZeroDollarCheckin”. Add this setting if not present and set to “True” or “False”.
True - $0 orders will be allowed to check-in. (Set to true if you want to allow members to check-in online)
False - $0 orders will be prevented from being allowed to check-in. (Set to false if only guests who have paid for tee times should be allowed to check-in online)
8. Disable Online Check-In when out of Season (Optional)
...
Navigate to Nop Templates > Plugins > Html Widgets > Manage Html Widgets
Find and Edit “Online Check-In Unavailable”
Select Visible to DISABLE customer prepay.
...
NOTE: Some resorts that use Golf functionality of an Aspenware Commerce check-in experience embedded in LS Retail. For documentation on On-site check-in capabilities, please refer to legacy documentation.
...
...