public GenieGate_Api_User login(
groups
array = array());This method performs a login, if the login succeeds, it returns an object containing information about the user. if the login fails, this will invoke the prompt() method, (which should present a form for the user to sign-in.) and exits.
This returns a GenieGate_Api_User
if login was OK, it doesn't return otherwise.
It is imperative to call this prior to sending any output or the dialog box for the login will not work.