Give login status flags a name

[dgrothaus-mc]

Document status flags with names, provide PHPdoc for the return type and the structure of the $params array. Use named status flags for validation checks.