start of incline documentation

This commit is contained in:
themaniac 2001-03-14 06:38:11 +00:00
parent 130a36248a
commit f8304f1b3f

View File

@ -32,7 +32,11 @@
echo 'Failed attempt to break in via an old Security Hole!<br>'."\n"; echo 'Failed attempt to break in via an old Security Hole!<br>'."\n";
exit; exit;
} unset($d1);unset($d2);unset($d3); } unset($d1);unset($d2);unset($d3);
/*!
@class common
@abstract common class that contains commonly used functions
*/
class common class common
{ {
var $phpgw; var $phpgw;
@ -41,6 +45,12 @@
var $crypto; var $crypto;
// Convert an array into the format needed for the access column. // Convert an array into the format needed for the access column.
/*!
@functionn array_to_string
@abstract Convert an array into the format needed for the access column
@param $access
@param $array
*/
function array_to_string($access,$array) function array_to_string($access,$array)
{ {
$s = ''; $s = '';
@ -60,6 +70,12 @@
// This is used for searching the access fields // This is used for searching the access fields
/*!
@function sql_search
@abstract this function is used for searching the access fields
@param $table
@param $owner
*/
function sql_search($table,$owner=0) function sql_search($table,$owner=0)
{ {
global $phpgw, $phpgw_info; global $phpgw, $phpgw_info;
@ -78,6 +94,11 @@
} }
// return a array of installed languages // return a array of installed languages
/*!
@function getInstalledLanguages
@abstract return an array of installed languages
@result $installedLanguages; an array containing the installed languages
*/
function getInstalledLanguages() function getInstalledLanguages()
{ {
global $phpgw; global $phpgw;
@ -94,6 +115,12 @@
// return the preferred language of the users // return the preferred language of the users
// it's using HTTP_ACCEPT_LANGUAGE (send from the users browser) // it's using HTTP_ACCEPT_LANGUAGE (send from the users browser)
// and ...(to find out which languages are installed) // and ...(to find out which languages are installed)
/*!
@function getPreferredLanguage
@abstract return the preferred langugae of the users
@discussion it uses HTTP_ACCEPT_LANGUAGE (from the users browser) <br>
and .... to find out which languages are installed
*/
function getPreferredLanguage() function getPreferredLanguage()
{ {
global $HTTP_ACCEPT_LANGUAGE; global $HTTP_ACCEPT_LANGUAGE;
@ -127,6 +154,13 @@
} }
// connect to the ldap server and return a handle // connect to the ldap server and return a handle
/*!
@function ldapConnect
@abstract connect to the ldap server and return a handle
@param $host ldap host
@param $dn ldap_root_dn
@param $passwd ldap_root_pw
*/
function ldapConnect($host = '', $dn = '', $passwd = '') function ldapConnect($host = '', $dn = '', $passwd = '')
{ {
global $phpgw_info; global $phpgw_info;
@ -161,6 +195,13 @@
// This function is used if the developer wants to stop a running app in the middle of execution // This function is used if the developer wants to stop a running app in the middle of execution
// We may need to do some clean up before hand // We may need to do some clean up before hand
/*!
@function phpgw_exit
@abstract function to stop running an app
@discussion used to stop running an app in the middle of execution <br>
There may need to be some cleanup before hand
@param $call_footer boolean value to if true then call footer else exit
*/
function phpgw_exit($call_footer = False) function phpgw_exit($call_footer = False)
{ {
global $phpgw; global $phpgw;
@ -171,7 +212,11 @@
$phpgw->db->disconnect(); $phpgw->db->disconnect();
exit; exit;
} }
/*!
@function randomstring
@abstract return a random string of size $size
@param $size int-size of random string to return
*/
function randomstring($size) function randomstring($size)
{ {
$s = ''; $s = '';
@ -192,7 +237,11 @@
{ {
return filesystem_separator(); return filesystem_separator();
} }
/*!
@function error_list
@abstract ???
@param $error ???
*/
function error_list($error) function error_list($error)
{ {
$html_error = '<table border="0" width="50%"><tr><td align="right"><b>' . lang('error') . '</b>: </td><td align="left">' . $error[0] . '</td></tr>'; $html_error = '<table border="0" width="50%"><tr><td align="right"><b>' . lang('error') . '</b>: </td><td align="left">' . $error[0] . '</td></tr>';
@ -202,7 +251,14 @@
} }
return $html_error . '</table>'; return $html_error . '</table>';
} }
/*!
@function check_owner
@abstract none yet
@param $record ?
@param $link ?
@param $label ?
@param $extravars
*/
function check_owner($record,$link,$label,$extravars = '') function check_owner($record,$link,$label,$extravars = '')
{ {
global $phpgw, $phpgw_info; global $phpgw, $phpgw_info;
@ -220,7 +276,13 @@
return $s; return $s;
} }
/*!
@function display_fullname
@abstract return the fullname of a user
@param $lid user id?
@param $firstname firstname
@param $lastname lastname
*/
function display_fullname($lid = '', $firstname = '', $lastname = '') function display_fullname($lid = '', $firstname = '', $lastname = '')
{ {
if (! $lid && ! $firstname && ! $lastname) { if (! $lid && ! $firstname && ! $lastname) {
@ -244,7 +306,11 @@
} }
return $s; return $s;
} }
/*!
@function grab_owner_name
@abstract grab the owner name
@param $id account id
*/
function grab_owner_name($id) function grab_owner_name($id)
{ {
global $phpgw; global $phpgw;
@ -311,7 +377,9 @@
$output_text .= "</table>\n"; $output_text .= "</table>\n";
return $output_text; return $output_text;
} }
/*!
@function get_app_dir
*/
function get_app_dir($appname = ''){ function get_app_dir($appname = ''){
global $phpgw_info; global $phpgw_info;
if ($appname == '') { if ($appname == '') {