CyberStore Ecommerce 2023 Documentation
Forgot Password Email
In This Topic

The Forgot Password Email is sent when a Shopper uses the Forgot My Password page to reset their pasword. A verfiication code is sent to the email of record for the account which must then be confirmed on the site to enable a password reset.

Default Configuration

The information below documents the default configuration for the email. To cusomize the email configuration, use the Setup > Email Manager maintenance screen in the CyberStore Management Console

Default Header

Field Value
LinkName ForgotMyPassword
From orders@theoutdoorscompany.com
To {Auto-populated}
Subject

Your [webaddress] Account Password

CC {Blank}
BCC

{Blank}

Description Sends verification code for forget password reset.

Default Body

The following HTML code is used by default as the email body for this message.

Email HTML
Copy Code
<p>
    A password reset request was received for [email@domain.com] from [webaddress].
</p>

<p>
    If you initiated this request please visit the <strong>
        <a href="[changepasswordurl]">Password Retrieval Request Page</a>
    </strong>
    to confirm the request using the verification code below.

    <blockquote><strong>Verification Code: [verificationcode]</strong></blockquote>
</p>

<p>
    Please note that the code above will expire 30 minutes from the time the request was made.
</p>
<p>
    This email was sent automatically by the [webaddress] Forgot Password Function. <br>
    If you did not request this email, we recommend you change your account password at
    <br>
    <i>[my account URL].</i>
</p>
This is an automated message, please do not reply.
<hr>
​[global]

Replacement Tags

Replacement Tags provide the means to do a text merge of values relevant to the action preceeding the email and include dynamic data in the email being sent.

Global Tags

The following are tags globally avaialble for all emails.

Tag Description
[CustomerDefaultEmail] The email address of record for the Customer
[DefaultEmail] The default address as configured for the Site
[FromAddress] The from address configured for the email
[SendDate] The date the email was sent
[SendTime] The time the email was sent
[ToAddress]  The to address configured for the email

Email Specific Tags

The following are the tags specific to the Forgot Password Email.

Tag Description
[ChangePasswordURL] The web address of the change password page for the Site
[Email@domain.com] The email address of the active Account
[Global] The Global Message configured for the Site
[My Account URL] The address of the My Account page for the Site
[VerificationCode] The verfication code for the request
[WebAddress] The web address configured for the Site

Important Note:

There is no replacement tag available for the value of the password. This is by design and follows best practices.

Customer Replacement Tags

In adddition to the email specific replacement tags in the table above, the following are tags available to this email template.

Tag Description
[CustomerNumber] The Customer Number
[CustomerClass] The name of the Customer Class
[CustomerName] The Customer Name
[CustomerPhone] The phone number of record of the Customer
[CustomerFax] The fax number of record of the Customer
[CustomerContact] The contact of record of the Customer

On-File (B2B) Behavior:

When the email is being sent in the context of an On File (B2B) account and customer then all tags are available and will replace with the data from the Customer record.

B2C Behavior:

When the email is being sent in the context of an account that is not On File (B2C, anonymous or logged-in) then only the [CustomerClass] tag is available and any of the other tags will replace with blank values.

Replacement Function Tags

The following table provides the list of available Tag Functions that can be used within the all system emails.

Function tags are written within the HTML body and must be contained within opening and closeing double brackets - "[[" and "]]", for example:

[[@IFERROR(@FORMATDATE(@ADDDAYS(@LATER([PurchaseDate], [LastServiceDate]), 366), "MMMM d, yyyy"), "a date in the near future")]]

In the example above, a function is indicated by the use of double square brackets, and the @ sign is a character that indicates a function is being performed, and in this example a function can contain a function and order of operations is from the inside out). The parameters can be replacement tags by the use of square bracket syntax, though actual values could be submitted by not using brackets around the parameters.

If a function cannot evaluate a result, has invalid parameters, or a calculation error occurs, then an blank string is returned.

General Functions

Function Description
@VOID() Do nothing. (Most cases use this as a fallback/system function)

Date Functions

Function Description
@LATER(date1, date2,..., daten) Compare the two or more date/time values and determine which occurs after the other, and return that later value.
@EARLIER(date1, date2, ..., daten) Compare two or more date/time values and determine which occurs before the other, and return that earlier value.
@DATEDIFF(date1, date2) Returns the difference between two dates, including years, months, days like 1 year, 4 months, 3 days
@DATEDIFFDAYS(date1, date2) Returns the difference between two dates, in days.
@ADDDAYS(date, numDays) Using a date value, add a number of days to it and return it. A negative number subtracts that number of days from the date and returns a previous date.
@ADDMONTHS(date, numMonths) Using a date value, add a number of months to it and return it. A negative number subtracts that number of months from the date and returns a previous date.
@ADDYEARS(date, numYears) Using a date value, add a number of years to it and return it. A negative number subtracts that number of years from the date and returns a previous date.
@FORMATDATE(date, "formatString") Formats the date using the specified string. Available format strings can be found at https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings

 Math Functions

Function Description
@SUM(number1, number2,... numbern) Add together two or more numeric values (integer or real) and return the calculated total
@SUBTRACT(number1, number2,... numbern) Calculate the diffierence between two or more numbers. The calculation is performed form left to right.
@MULTIPLY(number1, number2,... number n) Multiply two or more numbers to evaluate the product.
@DIVIDE(number1, number2) Calculate the quotient of two numbers by dividing the first parameter by the second.
@AVERAGE(number1, number2,... numbern) Calculate the average of two or more numbers by deriving the sum of all the numbers and divide by the total quantity of numbers.
@MOD(number1, number2) Calculate the remainder (or modulo or modulus) when dividing two numbers. The first parameter is divided by the second and the result is the remainder, or 0 if no remainder.
@FORMATNUMBER(number, "formatString") Formats a number in the specifed format. Available formats as listed at https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-numeric-format-strings 

 Logical Functions

Function Description
@IFERROR(@FUNCTION, then) Returns a value you specify if a @FUNCTION evaluates to an error; otherwise, returns the result of the FUNCTION