Documentation
Feedback
Guides
VTEX IO Apps

VTEX IO Apps
My Account - StoreV2 version
My Authentication
Official extension
Version: 1.9.0
Latest version: 1.9.0

{"base64":"  ","img":{"width":110,"height":20,"type":"svg","mime":"image/svg+xml","wUnits":"px","hUnits":"px","url":"https://img.shields.io/badge/all_contributors-0-orange.svg?style=flat-square"}}

Description

This VTEX IO app extends the MyAccount app to add authentication-related menu options (Authentication tab). It is installed by default in every VTEX account. Just like MyAccount, this can be used in either IO or Portal stores.

{"base64":"  ","img":{"width":1251,"height":624,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":48311,"url":"https://user-images.githubusercontent.com/22064061/112358629-47ff2100-8caf-11eb-8f89-80bdb48d2e68.png"}}

Table of Contents

Usage

Visibility

By default, the Authentication tab is not visible in the left-side menu of the MyAccount UI.

To make it visible, go into

https://{{accountName}}.myvtex.com/admin/apps/

and search for My Account among the installed apps. Then click Settings.

{"base64":"  ","img":{"width":299,"height":182,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":9457,"url":"https://user-images.githubusercontent.com/22064061/112537384-5de31380-8d8d-11eb-80a5-902d1e0922db.png"}}

Set Authentication option to :white_check_mark: Visible, then click Save.

{"base64":"  ","img":{"width":152,"height":72,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":2819,"url":"https://user-images.githubusercontent.com/22064061/112537098-0b095c00-8d8d-11eb-915a-3dd7e8da86da.png"}}

:loudspeaker: Disclaimer: in a close future, the Authentication tab visibility will become always true.

:information_source: Before making this tab visible, you should customize it to match your store visual identity

Customization

IO Stores

In order to apply CSS customizations to the app, follow the instructions given in the recipe on Using CSS Handles for store customization (you don't have to worry about block or blockClass).

A list of all CSS Handles is in this section.

You can see the Authentication UI being customized in:

https://{{workspaceName}}--{{accountName}}.myvtex.com/account#/authentication

Portal Stores

In order to customize the app, create a .css file with your own rules. Your class selectors should reference the UI's pre-existing classes.

A list of all CSS Handles is in this section.

:loudspeaker: Avoid using element or position-based selectors, as the customization may break in the face of the smallest UI changes.

To upload your .css file, go to the VTEX CMS (/admin/a) and open the CMS/Files Manager/.css file. Click Add and you'll be able to upload it. This file is accessible from VTEX CMS storage.

Lastly, you should link that .css file to the Account Page HTML Head by editing the "Account" CMS template.

You can see the Authentication UI being customized in:

https://{{accountName}}.vtexcommercestable.com.br/_secure/account#/authentication

(if you want to use IO workspaces, just add the query string "?workspace={{workspaceName}}")

CSS Handles List

:information_source: If you're in a Portal Store, append the prefix vtex_my-authentication_ to each handle for your CSS class selectors.

CSS Handles
box_container
box_header
box_headerSeparator
box_content
box_footer
errorAlert_container
warnAlert_container
authenticationScreen_container
authenticationScreen_passBox
newPassInput_container
passValidation_container
passValidation_title
passValidation_content
passValidation_minLengthNumber
passValidation_minLength
passValidation_number
passValidation_lowerUpper
passValidation_lower
passValidation_upper
passValidation_iconSuccess
passValidation_iconFailure
savePassButton_container
skeletonEditPassword_content
skeletonEditPassword_button
currPassInput_container
createPassword_text
codeInput_container
resendCodeButton_container
maskedPassword_title
maskedPassword_content
loginSessionsBox_title
loginSessionsBox_content
skeletonLoginSessions_content
skeletonLoginSessions_button
loginSessionsScreen_container
loginSessions_skeleton
loginSessions_error
loginSessions_list
loginSessions_box
skeletonLoginSessionsScreen_title
skeletonLoginSessionsScreen_text1
skeletonLoginSessionsScreen_text2
loginSession_currSession
loginSession_currSessionIcon
loginSession_currSessionText
loginSession_device
loginSession_lastAccess
loginSession_originDetails
loginSession_fullAddress
loginSession_firstAccess
See also
VTEX App Store
VTEX IO Apps