Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
Pass Checker
Pass Checker
nopaneltrue

Table of Contents

Setup Checklist

Insert excerpt
AE:Set-up Checklist
AE:Set-up Checklist
nopaneltrue

2. Create Golf Attributes

EZLinks POS Tasks

Contact EZLinks and complete required setup.

Status
colourRed
titleRequired

  • Purchase an EZLinks subscription.

    Status
    colourRedBlue
    titleRequired

  • Setup a web reservation channel.

    Status
    colourRed
    titleRequired

  • Provide AW with SponsorID(s).

    Status
    colourRed
    titleRequired

  • Complete misc. EZLinks tasks.

    Status
    colourRed
    titleRequired

  • optional

Status
colourYellow
titlePrerequisites

Infrastructure Tasks

1. Provide Aspenware Azure information (reccomended to use secure upload and not send via email)

Status
Status
colourRed
titleRequired

  • Application (Client) ID

  • Directory (Tenent) ID

  • Client Secret for the Aspenware DevOps app registration

2. AW rep tasks:

Status
colourRed
titleRequired

  • 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

  • Add Product Template System > Template > Product Templates

colourYellow
titlePrerequisiteS

Aspenware Commerce Tasks

1. Set up “Golf” Category

Status
colourRed
titleRequired
Status
colourRed
titleRequired

3. Enable store to route to Golf

Status
colourRed
titleRequired

4. Set the Default Sponsor ID

Status
Status
colourRed
titleRequired

5. Map Customer Role(s) to the corresponding EZLinks Sponsor ID(s)

Status
colourRed
titleRequired

6. Add Language Strings

Status
colourRed
titleRequired

7. Add Widgets

Status
colourRed
titleRequired

colourYellow
titlePrerequisiteS

1. Create Golf Course Product

Status
colourRed
titleRequired

2. Assign the line of business to the product

Status
colourRed
titleRequired

3. Set the course display order

Status
colourBlue
titleoptional

4. Add Golf details to order confirmation emails

Status
colourRed
titleRequired
5. Enable Online Check-in/Customer Pre-Pay
Status
colourBlue
titleoptional

6. Add Course Notes

Status
colourBlue
titleoptional

7. Add Discounts

Status
colourBlue
titleoptional

8. Collect credit card during checkout for $0 orders

Status
colourBlue
titleoptional

Status
colourGreen
titleDetailed setup

Prerequisite Tasks

Insert excerpt
AE:Prerequisites Tasks Excerpt
AE:Prerequisites Tasks Excerpt
nopaneltrue

...

POS Tasks

Contact EZLinks and complete the required setup.

  • Purchase an EZLinks subscription.

  • Setup a web reservation channel.

  • Provide AW with SponsorID(s).

...

C.

  • P

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:

Info

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]

P

  • A

2. A

Aspenware Commerce Tasks

1. Set up “Golf” CategoryS

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”.

...

Note

WARNING: Golf configuration does not support subcategories.

2. Create Golf Attributes

Go to Catalog > Attributes > Product attributes and add the following attributes:

Info

NOTE: Do not create any attribute values for these.

  1. Course Id

  2. Entitlement Id

  3. Fee Id

  4. Fee Name

  5. Fee Options

  6. Reservation Date 

  7. Reservation Time

  8. Reservation Holes

  9. Reservation Price

  10. Slot Nbr

  11. Slot Name

  12. 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

...

Info

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.

Info

NOTE: First customer roles must be set up which can be done by following the guide here:

Configuration: Customer Role Assignment

...

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.

...

Info

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

...

Code Block
<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

...

Code Block
<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

...

Code Block
<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

...

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.

Info

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

Info

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.

Info

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

Info

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:

...

Note

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

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.

...

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.

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.

False - $0 orders will be prevented from being allowed to check in.

Add the URL for checkin.

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:

...

Add/update the required language strings from: Language Strings Library that are labeled with “Golf - Checkin page”

...

Add the “Golf Tee Times Check-in Help” widget from Configuration and Library: HTML Widgets

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.

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

...

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.

Note

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)

...

Ca

2. C

Go to

3. E


Insert excerpt
AE:Like this Page Excerpt
AE:Like this Page Excerpt
nopaneltrue