This article describes the XML structure of a login form.
A login form consists of a logo, copyright notice, "Log in" button, and four fields: a username, password, theme, and langauge.
The following is an example of COREmanager XML form:
messages contains localized messages
copyright copyright notice
loginform information about fields of the login form
Attributes of the loginform tag contains information about the current interface theme, language, login and password:
@user user login; it used in case of errors and when changing a theme/language
@pwd user password; it used when changing a theme/language
@lang current language
@theme current interface theme
select with languages is generated from the lang tags. The key is the tag's content, the message is taken from the msg, by the key's name.
select with themes is generated frim the theme tags. The key is the value of the @name attribute, the messages - tag's content.
@project, @welcomfunc, @welcomparam, the redirect tadparameters to pass during authentication
The msg messages contain localized interface messages
title a message for the page title
user a message for the "Login" field
theme a message for the "Theme" field
passwd a message for the "Password" field
lang a message for the "Language" field
a message for the "Log in" button
cookie Error messages indicating that cookies are not enabled on your browser
The path to logo is generated from the @logo and @localdir attributes of the doc tag
@logo name of the file with logo
@localdir relative path to the directory with logo
If one or several errors occurred, the the following information will be displayed in the doc tag:
The error message that should be displayed is located in the msg tag
To change a language, call the logon function with theme, lang parameters (Example: func=logon&theme=orion&lang=ru).
To preserver the login and password that a user already entered, pass them with the username and pwd parameters. Send the post request in this case.
Call the auth function with the following parameters: username, password, and project, welcomfunc, welcomparam, redirect (if any).
In case of errors, the resulting XML will contain the error tag. See Errors.
If a user has been authenticated successfully, the XML will contain the auth tag with the session id. The page should be restarted by the main address of the control panel.