Identity Theming and Content Customization

Overview

The following theme and email settings are configurable in Identity and must be set. These cannot be controlled through and Admin interface and must be done by the Aspenware Dev Ops team, contact your Aspenware representative to update these settings. Email logo and footer client settings, stored in the DB under ClientProperties:

To learn more about Identity overall, read the Identity Overviewarchived first!

Theming for Identity

When using identity your client folder will include a background image and your logo image. Horizontal logo images are recommended when using the identity application. In addition to language strings, below are the components that resorts may configure upon implementing identity. All other UI features are default to the application.

NOTE: In a multi-store environment, the following can be customized per storefront.

  1. Background

    1. Background Image

    2. Background Overlay (for text readability)

  2. Logo (long and wide logos work best)

    1. Logo URL

    2. Logo Sizes for Mobile, Tablet and Desktop

  3. Primary Color (Buttons, Mobile Header Bar)

  4. Button Details

    1. Button Color

    2. Button Radius (rounding)

    3. Button Hover Color

    4. Button Font Weight (Bold, Normal, etc)

    5. Button Font Size

    6. Button Letter Spacing

  5. Font Details

    1. Heading Font Color

    2. Body Font Color

    3. Link Font Color

    4. Link Hover Font Color

    5. A single custom font can be supported for those who use CSS to import their custom fonts. Font customizations will apply to the Identity application, but the email font will be standardized as Helvetica for all customers. Supply the font URL to your Aspenware Representative, similar to the example below:

IMPORTANT: At this time fonts are not customizable for those who use Javascript to import their custom fonts. When custom fonts are not available, Identity will use Helvetica and Arial if the browser doesn’t support Helvetica.

Also note that only a single font is supported for identity, so if headers and body copy require different font libraries, this is not supported today.

Multiple store-fronts and Identity

Aspenware Commerce can be configured to have multiple store-fronts operating from a single backend admin instance, where product configuration for the shop is done. Each storefront can have its own look and feel, language strings, custom domain, settings, products, and more. Similarly, Identity can be configured to work with multiple storefronts. A single instance of Identity can also be configured to work with multiple completely separate Aspenware Commerce stores, so that if you are logged in to one store you are logged into others, however, there are some limitations around what can be customized across store-fronts or unique shops for Identity.

If using the same identity across multiple storefronts and/or stores, the custom URL across the single instance of identity must remain constant. For example, Boyne Resorts uses a single Identity across all of its 7 resorts, so http://shop.bigskyresort.com redirects to http://id.boyneresorts.com but guests coming to this page from the Big Sky shop or Arrival see a Big Sky branded experience and language strings that correspond to Big Sky.

Other limitations include language strings, if two stores are operating out of a single Aspenware Commerce Instance, i.e. they share an admin backend, then they can have unique branding, but the language strings must remain the same across the stores. If two stores use the same Identity but have separate Aspenware Commerce admin instances, they can have unique brands AND language strings. For example, Boyne Mountain and Boyne Highlands, sister resorts in Michigan also use the same Identity as the other Boyne Resorts (http://id.boyneresorts.com ), however, these two storefronts share a single Aspenware Commerce Admin, so the Identity language strings for these two store-fronts are shared. In the image below, the items in yellow are shared across the store front’s views of identity, and the items in blue are unique.

 

Email Template Customization

Both Identity password emails and verification code emails have standard email templates for forgot password emails and account verification emails. Email templates can be customized to include the resorts logo, links to the resort website, resort address in the email footer, and the resort name.


 

Setting

Description

Specs

Setting

Description

Specs

ResortLogoUrls

Web-based URL of logo - this setting determines determines what logo displays in the email

 

ResortEmailFooters

This setting determines what footer text displays in the email

Typically used for address, phone number and/or contact email.

ResortNames

This setting determines what resort name displays in the email

(i.e. Peak Resort)

ResortUrls

This setting determines where the user is taken if they click the logo in the email

(i.e. aspenware.com)



Updating Messaging in Identity

Most language strings within Identity are configurable. These language strings are updated using a JSON file and will be defined during the implementation process of Identity. Most language strings can retain default values, however the following language strings are recommended for customization. View a full list of language strings.

Login Page Configurable Language Strings

Description

String Resource

Current Value

Placement

Login page

account.login.description

Please sign in or create an account.

Displays beneath page title, is a collapsed and invisible if no text is entered.

Login page

account.login.loginoptions

Email, Username, or Pass ID

Displays above line where user types in username, email, or pass ID

Login page

account.login.validation.invalid

Email, Username, or Pass ID is invalid.

Displays beneath username entry field when continue button is selected but no characters entered in username field

Login page

account.login.validation.callservices

We’ve encountered a problem logging you in. Please contact customer service at ###-###-####.

Displays beneath username entry field when email profile matches up with multiple authIDs

Login page

account.login.callservices.noemailprofile

We’ve encountered a problem logging you in. Please contact customer service at ###-###-####. Error: Account has no email profile.

Displays beneath username entry field when user has a username that is not an email and has no email profile.
Error: var message = string.Empty;            if(account.Status == "UserAccountExistsWithNoEmail")            {                message = "Missing email profile.";            }else if(account.Status

Login page

account.create.informationmissing

We’ve encountered a problem logging you in. Please contact customer service at ###-###-####. Error: customer information is missing.

Displays beneath username entry field when user is missing a date of birth.

Reset Password Page

Description

String Resource

Current Value

Placement

Login → Reset Password Page

account.forgotpassword.description

To reset your password, please enter your email or username and select continue."

Displays beneath title, if no description is entered area is collapsed.

Login → Reset Password Page

account.forgotpassword.username

Email or username

Displays beneath description above entry field.

Login → Reset Password Page

account.forgotpassword.validation.success

Success! An email and link for resetting your password has been sent to this address.

Displays beneath email.username field after password reset email is sent.

Login → Reset Password Page

account.forgotpassword.validation.invalid

Invalid email address, please try again.

Displays beneath email.username field if invalid entry.

Create Account Page

Description

String Resource

Current Value

Placement

Create Account page

account.create.createaccount

Create an Account

Top of create account page

Create Account page

account.create.description

Already have an account?

Displays beneath page title. Text area is collapsed if no text is entered.

Create Account page

account.create.accountexists.signin

Sign in [URL]

active url after “Already have an account” text

Claim Account

Description

String Resource

Current Value

Placement

Claim Account → Select Account page

account.claim.selectaccount

Select Account

Title displays at top page

Claim Account → Select Account page

account.claim.description

We found two or more accounts that match information you entered. Please select an account to continue.

Description displays beneath title. If no text is entered, this text box will collapse.

Claim Account → Select Account page

account.claim.select

Select Account

Displays beneath description and above selection dropdown.

Claim Account → Verify Account page

account.claim.verify.description

We found a matching account. Please select a delivery method for your verification code.

Description displays beneath title. If no text is entered, this text box will collapse.

Claim Account → Verify Account page

account.claim.select

Select Account

Displays beneath description and above selection dropdown.

Force Password Reset (Only if setting PasswordExpirationEnabled is true)

Description

String Resource

Current Value

Login → Force Reset Password

account.passwordexpired.passwordexpired

Password Expired

Login → Force Reset Password

account.passwordexpired.description

Your current account password has expired. To reset your password, please enter your email or username and select continue.

Login → Force Reset Password

account.passwordexpired.username

Email or username

Login → Force Reset Password

account.passwordexpired.validation.success

Success! An email and link for resetting your password has been sent to this address.

Login → Force Reset Password

account.passwordexpired.validation.invalid

Invalid email address, please try again.

 

Terms and Conditions

  • Identity can be configured to allow guests to review and execute Terms and Conditions as a part of the account creation or sign-in process. In order to complete this configuration, please collect the following below and then send an email to service@aspenware.com. In the email, request that your Identity server be configured for use with Loyalty. Include all required copy and links, organized by T&C 1, T&C 2, etc. Be sure to include your preference for the default setting (checked or unchecked for each T&C setting.)

     

  • Terms & Conditions 1 (T&C 1)- Agreement Copy:

    • Example: I consent to the Terms of the Rewards Program.

  • Terms and Conditions 1 - Copy for Link and link for modality

HINT: The following HTML elements are supported in checkbox labels:

<b> <strong> <i> <em> <a> <span> <p>

href and the target attributes on an <a> tag. This means that <a href=”google.com” target=”_blank”>Google</a> will render as a working link.

Additionally, <b>, <strong>, <i>, and <em> can be used to format labels with bold or italics if desired. <p> and <span> can be used to break up the content or force line breaks.

Any tags or attributes not listed above will not render. They will be stripped out of the HTML before the content is rendered to the page. This is to ensure that nobody is inserting <script> tags or other elements that could lead to security risks or broken layouts.


 

Common Troubleshooting Questions

  1. Question: Are my fonts supported in identity?

    1. Answer: Custom fonts are currently not supported as an identity theme option. This may be supported in the future. The default font is a standard san-serif font.

Checklist

Use this checklist when customizing Identity theme to ensure all steps are completed.

Task

Optional/Required

Status

Task

Optional/Required

Status

Send background image, logo and button color(s) to Aspenware representative

Required

 

Send email logo, footer content, and URLto link to in email to Aspenware representative

Required

 

Send any language customizations to Aspenware representative

Optional