initial documentation for accounts class

This commit is contained in:
seek3r 2001-02-05 19:37:34 +00:00
parent f02cdb1bd3
commit 9d4a297b28

123
phpgwapi/doc/class.accounts Normal file
View File

@ -0,0 +1,123 @@
// There is a accounts_shared which added functions that are identical for all
class accounts_{
var $db;
var $account_id;
var $data;
var $security_equals
function read_repository()
{
/**************************************************************************\
* Read values for $this->account_id and put them into $this->data and *
* then return $this->data *
* *
* These are the values that should be set: *
* $this->data["userid"] *
* $this->data["account_id"] *
* $this->data["account_lid"] *
* $this->data["firstname"] *
* $this->data["lastname"] *
* $this->data["fullname"] *
* $this->data["lastlogin"] *
* $this->data["lastloginfrom"] *
* $this->data["lastpasswd_change"] *
* $this->data["status"] *
\**************************************************************************/
}
/**************************************************************************\
* These are the standard $this->account_id specific functions *
\**************************************************************************/
function read()
{
/**************************************************************************\
* Verify that $this->data has values, *
* if not execute $this->read_repository() *
* end by returning $this->data *
\**************************************************************************/
}
function update_data($data) {
/**************************************************************************\
* Set $this->data with the $data param that was sent *
\**************************************************************************/
}
function save_repository(){
/**************************************************************************\
* Store the values in $this->data to the repository *
\**************************************************************************/
}
/**************************************************************************\
* These are the generic functions. Not specific to $this->account_id *
\**************************************************************************/
function add($account_name, $account_type, $first_name, $last_name, $passwd = False) {
/**************************************************************************\
* Create a new account. Password is optional because of our seperated *
* auth class structure *
\**************************************************************************/
}
function delete($account_id) {
/**************************************************************************\
* Accept both acount_name or account_id and use name2id to convert to id *
* delete account. I have not worked the details of how hooks will be used *
* by apps to delete the users data. For now ignore the issue. *
\**************************************************************************/
}
function list()
{
/**************************************************************************\
* Return a list of users *
\**************************************************************************/
}
function name2id($account_name)
{
/**************************************************************************\
* Return the account_id for the account_name requested *
* Return False if you cannot find the given account_name *
\**************************************************************************/
}
function id2name($account_id)
{
/**************************************************************************\
* Return the account_id for the account_name requested *
* Return False if you cannot find the given account_name *
\**************************************************************************/
}
function get_type($account_id)
{
/**************************************************************************\
* Return the account_type for the account_id requested *
* Return False if you cannot find the given account_id *
\**************************************************************************/
}
function exists($accountname)
{
/**************************************************************************\
* Check to see if an account exists. If string is sent, *
* use $this->name2id to get the id. *
* Return True or False as appropriate *
\**************************************************************************/
}
function auto_add($account_name, $passwd, $default_prefs=False, $default_acls= False)
{
/**************************************************************************\
* This is used to auto create an account. First make sure the account_name *
* doesnt exist by using $this->exists and then create the account. *
* This function still needs to have some details worked out for dealing *
* the default values. *
\**************************************************************************/
}
} //end of class
?>