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 Overview 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.
Background image
Logo (long and wide logos work best)
Theme css
button color
button hover color
IMPORTANT: At this time fonts are not customizable for Identity and all fonts use Helvetica and Arial if the browser doesn’t support Helvetica.
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.
.png?version=1&modificationDate=1607613839314&cacheVersion=1&api=v2&width=272&height=544)
Setting | Description | Specs |
|---|---|---|
| Web-based URL of logo - this setting determines determines what logo displays in the email | |
| This setting determines what footer text displays in the email | Typically used for address, phone number and/or contact email. |
| This setting determines what resort name displays in the email | (i.e. Peak Resort) |
| 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. |
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. |
Common Troubleshooting Questions
Question: Are my fonts supported in identity?
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 |
|---|---|---|
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 |