{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This page describes how to customize the emails to remind users to change their passwords before they expire","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Abiquo will customize emails using template and properties files with the following priority:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Localized files, with a language code extension, such as ","type":"text"},{"text":"passwordNotificationTemplate_en_US.mustache","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"passwordNotification_en_US.properties","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Main files with no language code extension, such as ","type":"text"},{"text":"passwordNotificationTemplate.mustache","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"passwordNotification.properties","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"System defaults. We use the contents of the system default files in the examples below","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"To customize the emails to remind users to change their Abiquo passwords:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log in to the Abiquo API Server as an administrator","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"config","type":"text","marks":[{"type":"code"}]},{"text":" folder, if there is no ","type":"text"},{"text":"mail","type":"text","marks":[{"type":"code"}]},{"text":" folder, create a ","type":"text"},{"text":"mail","type":"text","marks":[{"type":"code"}]},{"text":" folder and set the owner as the ","type":"text"},{"text":"tomcat","type":"text","marks":[{"type":"code"}]},{"text":" user","type":"text"}]},{"type":"codeBlock","content":[{"text":"/opt/abiquo/config/mail","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"mail","type":"text","marks":[{"type":"code"}]},{"text":" folder, create the custom files as required. You can create localized files and main files. ","type":"text"},{"type":"hardBreak"},{"text":"The content of the default files is shown here. ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Email file: ","type":"text"},{"type":"hardBreak"},{"text":"for example, as a localized file for US English, ","type":"text"},{"text":"passwordNotificationTemplate_en_US.mustache","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"

Dear {{username}},

Your password will expire in {{days}} days. Please change your password as soon as possible.\n

Thank you,

The Abiquo Team

","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Properties file: ","type":"text"},{"type":"hardBreak"},{"text":"for example, as a localized file for US English, ","type":"text"},{"text":"passwordNotification_en_US.properties","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"subject=Password Expiration Notification","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-warning","text":":warning:","shortName":":warning:"}},{"text":" If you change the ","type":"text"},{"text":"subject","type":"text","marks":[{"type":"code"}]},{"text":" property, you must restart the Tomcat server to apply your changes","type":"text"}]},{"type":"paragraph"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally, add custom variables and content.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the email body, to add a custom variable, use double curly braces (also called double mustaches). For example","type":"text"}]},{"type":"codeBlock","content":[{"text":"

Please call your system Administrator on {{helpline}}

","type":"text"}]},{"type":"paragraph","content":[{"text":"Then in your properties file, set a value for your custom variable","type":"text"}]},{"type":"codeBlock","content":[{"text":"helpline=555 12345","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To create a template property that will return unescaped HTML enter the triple mustache of ","type":"text"},{"text":"{{{","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"}}}","type":"text","marks":[{"type":"code"}]},{"text":" around the property name. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"

To change your password, go to your account at {{{login}}}

","type":"text"}]},{"type":"paragraph","content":[{"text":"Then set a variable in your property files","type":"text"}]}]},{"type":"listItem","content":[{"type":"codeBlock","content":[{"text":"login=Abiquo cloud","type":"text"}]},{"type":"paragraph"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If your users have a different locale, such as when they use a language other than English, use the ","type":"text"},{"text":"language code for the user locale","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For example, for ","type":"text"},{"text":"Spanish - Spain","type":"text","marks":[{"type":"code"}]},{"text":" change ","type":"text"},{"text":"en_US","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"es_ES","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can set a locale when you create an Abiquo user","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change the owner of the files to the ","type":"text"},{"text":"tomcat","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"user","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you changed the subject property, restart the Tomcat server","type":"text"}]}]}]},{"type":"paragraph"}],"version":1}