Revision as of 04:18, 6 February 2008 (view source) Zanix (Talk | contribs) (New page: __NOEDITSECTION__ {{Disclaimer}} {{MainMenu|Roster}} '''Function Overview'''<br/> Overview over all functions in the Roster that can be used by Addon Developers.<br/> ---- Latest changes ...)		Revision as of 04:21, 6 February 2008 (view source) Zanix (Talk | contribs) Newer edit →
Line 3:		Line 3:
	{{MainMenu|Roster}}		{{MainMenu|Roster}}
−	'''Function Overview'''<br/>	+	'''Functions Overview'''<br>
−	Overview over all functions in the Roster that can be used by Addon Developers.<br/>	+	Overview over all functions in the Roster that can be used by Addon Developers.<br>
	----		----
	Latest changes		Latest changes
Line 16:		Line 16:
	==border==		==border==
−	Parameters: $style, $mode, $header_txt, $width<br/>	+	Parameters: $style, $mode, $header_txt, $width<br>
−	Starts or ends fancy bodering containers<br/>	+	Starts or ends fancy bodering containers<br>
	*@param string $style What bordering style to use		*@param string $style What bordering style to use
	*@param string $mode ( start | end )		*@param string $mode ( start | end )
Line 23:		Line 23:
	*@param string $width Set a fixed width for the box		*@param string $width Set a fixed width for the box
	*@return string		*@return string
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==setTooltip==		==setTooltip==
−	Parameters: $var, $content<br/>	+	Parameters: $var, $content<br>
−	Makes a tootip and places it into the tooltip array<br/>	+	Makes a tootip and places it into the tooltip array<br>
	*@param string $var		*@param string $var
	*@param string $content		*@param string $content
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==getAllTooltips==		==getAllTooltips==
−	Parameters: none<br/>	+	Parameters: none<br>
−	Gathers all tootips and places them into javascript variables<br/>	+	Gathers all tootips and places them into javascript variables<br>
	*@param array $tooltipArray		*@param array $tooltipArray
	*@return string Tooltips placed in javascript variables		*@return string Tooltips placed in javascript variables
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==sql_highlight==		==sql_highlight==
−	Parameters: $sql<br/>	+	Parameters: $sql<br>
−	Highlight certain keywords in a SQL query<br/>	+	Highlight certain keywords in a SQL query<br>
	*@param string $sql Query string		*@param string $sql Query string
	*@return string Highlighted string		*@return string Highlighted string
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==die_quietly==		==die_quietly==
−	Parameters: $text, $title, $file, $line, $sql<br/>	+	Parameters: $text, $title, $file, $line, $sql<br>
−	Clean replacement for die(), outputs a message with debugging info if needed and ends output<br/>	+	Clean replacement for die(), outputs a message with debugging info if needed and ends output<br>
	*@param string $text Text to display on error page		*@param string $text Text to display on error page
	*@param string $title Title to place on web page (default Message)		*@param string $title Title to place on web page (default Message)
Line 54:		Line 54:
	*@param string $line Line in file to display		*@param string $line Line in file to display
	*@param string $sql Any SQL text to display		*@param string $sql Any SQL text to display
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==roster_die==		==roster_die==
−	Parameters: $message, $title, $style<br/>	+	Parameters: $message, $title, $style<br>
−	Draw a message box with the specified border color, then die cleanly<br/>	+	Draw a message box with the specified border color, then die cleanly<br>
	*@param string $message | The message to display inside the box		*@param string $message | The message to display inside the box
	*@param string $title | The box title (default Message )		*@param string $title | The box title (default Message )
	*@param string $style | The border style (default sred)		*@param string $style | The border style (default sred)
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==ajax_die==		==ajax_die==
−	Parameters: $text, $title, $file, $line, $sql<br/>	+	Parameters: $text, $title, $file, $line, $sql<br>
−	Print a roster-ajax XML error message<br/>	+	Print a roster-ajax XML error message<br>
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==backtrace==		==backtrace==
−	Parameters: none<br/>	+	Parameters: none<br>
−	Print a debug backtrace. This works in PHP4.3.x+, there is an integrated function for this starting PHP5 but I prefer always having the same layout.<br/>	+	Print a debug backtrace. This works in PHP4.3.x+, there is an integrated function for this starting PHP5 but I prefer always having the same layout.<br>
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==stripAllHtml==		==stripAllHtml==
−	Parameters: $string<br/>	+	Parameters: $string<br>
−	This will remove HTML tags, javascript sections and white space. It will also convert some common HTML entities to their text equivalent<br/>	+	This will remove HTML tags, javascript sections and white space. It will also convert some common HTML entities to their text equivalent<br>
	*@param string $file		*@param string $file
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==check_if_image==		==check_if_image==
−	Parameters: $filename<br/>	+	Parameters: $filename<br>
−	This will check if the given Filename is an image<br/>	+	This will check if the given Filename is an image<br>
	*@param imagefile $file		*@param imagefile $file
	*@return mixed The extentsion if the filetype is an image, false if it is not		*@return mixed The extentsion if the filetype is an image, false if it is not
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==colorTooltip==		==colorTooltip==
−	Parameters: $tooltip, $caption_color, $locale, $inline_caption<br/>	+	Parameters: $tooltip, $caption_color, $locale, $inline_caption<br>
−	Tooltip colorizer function with string cleaning. Use only with [[#makeOverlib]]<br/>	+	Tooltip colorizer function with string cleaning. Use only with [[#makeOverlib]]<br>
	*@param string $tooltip | Tooltip as a string (delimited by "\n" character)		*@param string $tooltip | Tooltip as a string (delimited by "\n" character)
	*@param string $caption_color | (optional) Color for the caption		*@param string $caption_color | (optional) Color for the caption
Line 98:		Line 98:
	*Default is true		*Default is true
	*@return string | Formatted tooltip		*@return string | Formatted tooltip
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==cleanTooltip==		==cleanTooltip==
−	Parameters: $tooltip, $caption_color, $inline_caption<br/>	+	Parameters: $tooltip, $caption_color, $inline_caption<br>
−	Cleans up the tooltip and parses an inline_caption if needed. Use only with [[#makeOverlib]]<br/>	+	Cleans up the tooltip and parses an inline_caption if needed. Use only with [[#makeOverlib]]<br>
	*@param string $tooltip | Tooltip as a string (delimited by "\n" character)		*@param string $tooltip | Tooltip as a string (delimited by "\n" character)
	*@param string $caption_color | (optional) Color for the caption		*@param string $caption_color | (optional) Color for the caption
Line 109:		Line 109:
	*Default is true		*Default is true
	*@return string | Formatted tooltip		*@return string | Formatted tooltip
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==makeOverlib==		==makeOverlib==
−	Parameters: $tooltip, $caption, $caption_color, $mode, $locale, $extra_parameters<br/>	+	Parameters: $tooltip, $caption, $caption_color, $mode, $locale, $extra_parameters<br>
−	Easy all in one function to make overlib tooltips. Creates a string for insertion into any html tag that has "onmouseover" and "onmouseout" events<br/>	+	Easy all in one function to make overlib tooltips. Creates a string for insertion into any html tag that has "onmouseover" and "onmouseout" events<br>
	*@param string $tooltip | Tooltip as a string (delimited by "\n" character)		*@param string $tooltip | Tooltip as a string (delimited by "\n" character)
	*@param string $caption | (optional) Text to set as a true OverLib caption		*@param string $caption | (optional) Text to set as a true OverLib caption
Line 126:		Line 126:
	*@param string $item_id		*@param string $item_id
	*@return unknown		*@return unknown
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==messagebox==		==messagebox==
−	Parameters: $message, $title, $style, $width<br/>	+	Parameters: $message, $title, $style, $width<br>
−	Draw a message box with the specified border color.<br/>	+	Draw a message box with the specified border color.<br>
	*@param string $message | The message to display inside the box		*@param string $message | The message to display inside the box
	*@param string $title | The box title (default message)		*@param string $title | The box title (default message)
Line 136:		Line 136:
	*@param string $width | Set a fixed width		*@param string $width | Set a fixed width
	*@return string $html | The HTML for the messagebox		*@return string $html | The HTML for the messagebox
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==scrollbox==		==scrollbox==
−	Parameters: $message, $title, $style, $width, $height<br/>	+	Parameters: $message, $title, $style, $width, $height<br>
−	Draw a 300x550px scrolling messagebox with the specified border color.<br/>	+	Draw a 300x550px scrolling messagebox with the specified border color.<br>
	*@param string $message | The message to display inside the box		*@param string $message | The message to display inside the box
	*@param string $title | The box title (default message)		*@param string $title | The box title (default message)
Line 147:		Line 147:
	*@param string $height | Initial height with unit (default 300px)		*@param string $height | Initial height with unit (default 300px)
	*@return string $html | The HTML for the messagebox		*@return string $html | The HTML for the messagebox
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==messageboxtoggle==		==messageboxtoggle==
−	Parameters: $message, $title, $style, $open, $width<br/>	+	Parameters: $message, $title, $style, $open, $width<br>
−	Draw a message box with the specified border color.<br/>	+	Draw a message box with the specified border color.<br>
	*@param string $message | The message to display inside the box		*@param string $message | The message to display inside the box
	*@param string $title | The box title		*@param string $title | The box title
Line 158:		Line 158:
	*@param string $width | Initial width with unit (default 550px)		*@param string $width | Initial width with unit (default 550px)
	*@return string $html | The HTML for the messagebox		*@return string $html | The HTML for the messagebox
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==scrollboxtoggle==		==scrollboxtoggle==
−	Parameters: $message, $title, $style, $open, $width, $height<br/>	+	Parameters: $message, $title, $style, $open, $width, $height<br>
−	Draw a 300x550px scrolling messagebox with the specified border color.<br/>	+	Draw a 300x550px scrolling messagebox with the specified border color.<br>
	*@param string $messages | The message to display inside the box		*@param string $messages | The message to display inside the box
	*@param string $title | The box title (default message)		*@param string $title | The box title (default message)
Line 169:		Line 169:
	*@param string $height | Initial height with unit (default 300px)		*@param string $height | Initial height with unit (default 300px)
	*@return string $html | The HTML for the messagebox		*@return string $html | The HTML for the messagebox
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==escape_array==		==escape_array==
−	Parameters: $array<br/>	+	Parameters: $array<br>
−	Recursively escape $array<br/>	+	Recursively escape $array<br>
	*@param array $array | The array to escape		*@param array $array | The array to escape
	*@return array | The same array, escaped		*@return array | The same array, escaped
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==stripslash_array==		==stripslash_array==
−	Parameters: $array<br/>	+	Parameters: $array<br>
−	Recursively stripslash $array<br/>	+	Recursively stripslash $array<br>
	*@param array $array | The array to escape		*@param array $array | The array to escape
	*@return array | The same array, escaped		*@return array | The same array, escaped
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==readbleDate==		==readbleDate==
−	Parameters: $datetime, $offset<br/>	+	Parameters: $datetime, $offset<br>
−	Converts a datetime field into a readable date<br/>	+	Converts a datetime field into a readable date<br>
	*@param string $datetime | datetime field data in DB		*@param string $datetime | datetime field data in DB
	*@param string $offset | Offset in hours to calcuate time returned		*@param string $offset | Offset in hours to calcuate time returned
	*@return string | formatted date string		*@return string | formatted date string
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==get_file_ext==		==get_file_ext==
−	Parameters: $filename<br/>	+	Parameters: $filename<br>
−	Gets a file's extention passed as a string<br/>	+	Gets a file's extention passed as a string<br>
	*@param string $filename		*@param string $filename
	*@return string		*@return string
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==seconds_to_time==		==seconds_to_time==
−	Parameters: $seconds<br/>	+	Parameters: $seconds<br>
−	Converts seconds to a string delimited by time values. Will show w,d,h,m,s<br/>	+	Converts seconds to a string delimited by time values. Will show w,d,h,m,s<br>
	*@param string $seconds		*@param string $seconds
	*@return string		*@return string
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==getaddon==		==getaddon==
−	Parameters: $addonname<br/>	+	Parameters: $addonname<br>
−	Sets up addon data for use in the addon framework<br/>	+	Sets up addon data for use in the addon framework<br>
	*@param string $addonname | The name of the addon		*@param string $addonname | The name of the addon
	*@return array $addon  | The addon's database record		*@return array $addon  | The addon's database record
	*@global array $addon_conf | The addon's config data is added to this global array.		*@global array $addon_conf | The addon's config data is added to this global array.
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==active_addon==		==active_addon==
−	Parameters: $name<br/>	+	Parameters: $name<br>
−	Check to see if an addon is active or not<br/>	+	Check to see if an addon is active or not<br>
	*@param string $name | Addon basename		*@param string $name | Addon basename
	*@return bool		*@return bool
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==urlgrabber==		==urlgrabber==
−	Parameters: $url, $timeout, $user_agent, $loopcount<br/>	+	Parameters: $url, $timeout, $user_agent, $loopcount<br>
−	Handles retrieving the contents of a URL trying multiple methods. Current methods are curl, file_get_contents, fsockopen and will try each in that order<br/>	+	Handles retrieving the contents of a URL trying multiple methods. Current methods are curl, file_get_contents, fsockopen and will try each in that order<br>
	*@param string $url | URL to retrieve		*@param string $url | URL to retrieve
	*@param int $timeout | Timeout for curl, socket connection timeout for fsock (default 5)		*@param int $timeout | Timeout for curl, socket connection timeout for fsock (default 5)
Line 230:		Line 230:
	*@param int $loopcount | (default 0)		*@param int $loopcount | (default 0)
	*@return mixed | False on error, contents on success		*@return mixed | False on error, contents on success
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==request_uri==		==request_uri==
−	Parameters: none<br/>	+	Parameters: none<br>
−	Stupid function to create an REQUEST_URI for IIS 5 servers<br/>	+	Stupid function to create an REQUEST_URI for IIS 5 servers<br>
	*@return string		*@return string
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==file_writer==		==file_writer==
−	Parameters: $filename, &$content, $mode<br/>	+	Parameters: $filename, &$content, $mode<br>
−	Attempts to write a file to the file system<br/>	+	Attempts to write a file to the file system<br>
	*@param string $filename | Name of the file		*@param string $filename | Name of the file
	*@param string $content | Content of the file		*@param string $content | Content of the file
	*@param string $mode | (default wb)		*@param string $mode | (default wb)
	*@return bool		*@return bool
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==php_as_nobody==		==php_as_nobody==
−	Parameters: $file<br/>	+	Parameters: $file<br>
−	No Description<br/>	+	No Description<br>
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==_aprint==		==_aprint==
−	Parameters: $arr, $tab<br/>	+	Parameters: $arr, $tab<br>
−	Debugging function dumps arrays/object formatted. Do Not call this, call [[#aprint|aprint()]]<br/>	+	Debugging function dumps arrays/object formatted. Do Not call this, call [[#aprint|aprint()]]<br>
	*@param array $arr		*@param array $arr
	*@param int $tab | (default 1)		*@param int $tab | (default 1)
	*@return string		*@return string
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==aprint==		==aprint==
−	Parameters: $arr, $prefix, $return<br/>	+	Parameters: $arr, $prefix, $return<br>
−	Debugging function dumps arrays/object formatted<br/>	+	Debugging function dumps arrays/object formatted<br>
	*@param array $arr		*@param array $arr
	*@param string $prefix		*@param string $prefix
	*@return string | (default false)		*@return string | (default false)
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==socketColorEn==		==socketColorEn==
−	Parameters: $socket_color, $locale<br/>	+	Parameters: $socket_color, $locale<br>
−	Helper function that returns the localized gem color in english<br/>	+	Helper function that returns the localized gem color in english<br>
	*@param string $socket_color		*@param string $socket_color
	*@return string $color		*@return string $color
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==format_microtime==		==format_microtime==
−	Parameters: none<br/>	+	Parameters: none<br>
−	No Description<br/>	+	No Description<br>
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==array_overlay==		==array_overlay==
−	Parameters: $skel, $arr<br/>	+	Parameters: $skel, $arr<br>
−	A better array_merge()<br/>	+	A better array_merge()<br>
	*@param array $skel		*@param array $skel
	*@param array $arr		*@param array $arr
	*@return array		*@return array
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==updateCheck==		==updateCheck==
−	Parameters: $addon<br/>	+	Parameters: $addon<br>
−	Checks an addon download id on the wowroster.net rss feed. And informs if there is an update.<br/>	+	Checks an addon download id on the wowroster.net rss feed. And informs if there is an update.<br>
	*@param string $name | name of the download		*@param string $name | name of the download
	*@param string $url | url		*@param string $url | url
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==dummy==		==dummy==
−	Parameters: none<br/>	+	Parameters: none<br>
−	Dummy function. For when you need a callback that doesn't do anything.<br/>	+	Dummy function. For when you need a callback that doesn't do anything.<br>
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==makelink==		==makelink==
−	Parameters: $url, $full<br/>	+	Parameters: $url, $full<br>
−	Function to create links in Roster. ALL LINKS SHOULD PASS THROUGH THIS FUNCTION. Hopefully this function will be the magic that makes porting Roster easier (Ninja looted from DragonFly, thanks you guys!).<br/>	+	Function to create links in Roster. ALL LINKS SHOULD PASS THROUGH THIS FUNCTION. Hopefully this function will be the magic that makes porting Roster easier (Ninja looted from DragonFly, thanks you guys!).<br>
	*@param string $url | (Example: <nowiki>'</nowiki>util-news-comment&amp;id=<nowiki>'</nowiki>.$news_id)		*@param string $url | (Example: <nowiki>'</nowiki>util-news-comment&amp;id=<nowiki>'</nowiki>.$news_id)
	*@param bool $full | (default false)		*@param bool $full | (default false)
	*@return string		*@return string
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	=$roster->db=		=$roster->db=
Line 312:		Line 312:
	==error==		==error==
−	Parameters: none<br/>	+	Parameters: none<br>
−	Get last SQL error<br/>	+	Get last SQL error<br>
	*@return string last SQL error		*@return string last SQL error
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==errno==		==errno==
−	Parameters:none<br/>	+	Parameters:none<br>
−	Get last SQL errno<br/>	+	Get last SQL errno<br>
	*@return string last SQL errno		*@return string last SQL errno
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==query==		==query==
−	Parameters: $query<br/>	+	Parameters: $query<br>
−	Basic query function<br/>	+	Basic query function<br>
	*@param $query Query string		*@param $query Query string
	*@return mixed Query ID / Error string / Bool		*@return mixed Query ID / Error string / Bool
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==query_first==		==query_first==
	Parameters: $query<br />		Parameters: $query<br />
−	Return the first record (single column) in a query result<br/>	+	Return the first record (single column) in a query result<br>
	*@param $query Query string		*@param $query Query string
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==build_query==		==build_query==
−	Parameters: $query, $array<br/>	+	Parameters: $query, $array<br>
−	Build query<br/>	+	Build query<br>
	*@param $query		*@param $query
	*@param $array Array of field => value pairs (default false)		*@param $array Array of field => value pairs (default false)
	*@return $query | Returns the builded query		*@return $query | Returns the builded query
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==fetch==		==fetch==
−	Parameters: $query_id, $result_type<br/>	+	Parameters: $query_id, $result_type<br>
−	Fetch one record<br/>	+	Fetch one record<br>
	*@param $query_id | Query ID (default 0)		*@param $query_id | Query ID (default 0)
	*@param $result_type | SQL_ASSOC, SQL_NUM, or SQL_BOTH (default SQL_BOTH)		*@param $result_type | SQL_ASSOC, SQL_NUM, or SQL_BOTH (default SQL_BOTH)
	*@return mixed Record / false		*@return mixed Record / false
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==fetch_all==		==fetch_all==
−	Parameters: $query_id, $result_type<br/>	+	Parameters: $query_id, $result_type<br>
−	Fetch all records<br/>	+	Fetch all records<br>
	*@param $query_id | Query ID (default 0)		*@param $query_id | Query ID (default 0)
	*@param $result_type | SQL_ASSOC, SQL_NUM, or SQL_BOTH		*@param $result_type | SQL_ASSOC, SQL_NUM, or SQL_BOTH
	*@return mixed Record Set / false		*@return mixed Record Set / false
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==result==		==result==
−	Parameters: $query_id, $row, $field<br/>	+	Parameters: $query_id, $row, $field<br>
−	Get result data<br/>	+	Get result data<br>
	*@param $query_id | Query ID (default 0)		*@param $query_id | Query ID (default 0)
	*@param $row | The row number from the result that's being retrieved. Row numbers start at 0		*@param $row | The row number from the result that's being retrieved. Row numbers start at 0
	*@param $field | The name or offset of the field being retrieved		*@param $field | The name or offset of the field being retrieved
	*@return mixed Record / false		*@return mixed Record / false
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==num_rows==		==num_rows==
−	Parameters: $query_id<br/>	+	Parameters: $query_id<br>
−	Find the number of returned rows<br/>	+	Find the number of returned rows<br>
	*@param $query_id | Query ID (default 0)		*@param $query_id | Query ID (default 0)
	*@return mixed Number of rows / false		*@return mixed Number of rows / false
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==affected_rows==		==affected_rows==
−	Parameters: $query_id<br/>	+	Parameters: $query_id<br>
−	Finds out the number of rows affected by a query<br/>	+	Finds out the number of rows affected by a query<br>
	*@param $query_id | Query ID (default 0)		*@param $query_id | Query ID (default 0)
	*@return mixed Affected Rows / false		*@return mixed Affected Rows / false
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==insert_id==		==insert_id==
−	Parameters: none<br/>	+	Parameters: none<br>
−	Find the ID of the row that was just inserted<br/>	+	Find the ID of the row that was just inserted<br>
	*@return mixed Last ID / false		*@return mixed Last ID / false
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==free_result==		==free_result==
−	Parameters: $query_id<br/>	+	Parameters: $query_id<br>
−	Free result data<br/>	+	Free result data<br>
	*@param $query_id | Query ID (default 0)		*@param $query_id | Query ID (default 0)
	*@return bool		*@return bool
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==escape==		==escape==
−	Parameters: $string<br/>	+	Parameters: $string<br>
−	Remove quote escape<br/>	+	Remove quote escape<br>
	*@param $string		*@param $string
	*@return string		*@return string
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==error_die==		==error_die==
−	Parameters: $setting<br/>	+	Parameters: $setting<br>
−	Set the error_die var<br/>	+	Set the error_die var<br>
−	@param $setting<br/>	+	@param $setting<br>
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]
	==table==		==table==
−	Parameters: $table, $addon<br/>	+	Parameters: $table, $addon<br>
−	Expand base table name to a full table name<br/>	+	Expand base table name to a full table name<br>
	*@param string $table | the base table name		*@param string $table | the base table name
	*@param string $addon | the name of the addon, empty for a base roster table		*@param string $addon | the name of the addon, empty for a base roster table
	*@return string | tablename as fit for MySQL queries		*@return string | tablename as fit for MySQL queries
−	<br/>[[#Global functions|Top]]	+	<br>[[#Global functions|Top]]

---

Revision as of 04:21, 6 February 2008

Contents 1 Main Page 2 Global functions 2.1 border 2.2 setTooltip 2.3 getAllTooltips 2.4 sql_highlight 2.5 die_quietly 2.6 roster_die 2.7 ajax_die 2.8 backtrace 2.9 stripAllHtml 2.10 check_if_image 2.11 colorTooltip 2.12 cleanTooltip 2.13 makeOverlib 2.14 messagebox 2.15 scrollbox 2.16 messageboxtoggle 2.17 scrollboxtoggle 2.18 escape_array 2.19 stripslash_array 2.20 readbleDate 2.21 get_file_ext 2.22 seconds_to_time 2.23 getaddon 2.24 active_addon 2.25 urlgrabber 2.26 request_uri 2.27 file_writer 2.28 php_as_nobody 2.29 _aprint 2.30 aprint 2.31 socketColorEn 2.32 format_microtime 2.33 array_overlay 2.34 updateCheck 2.35 dummy 2.36 makelink 3 $roster->db 3.1 error 3.2 errno 3.3 query 3.4 query_first 3.5 build_query 3.6 fetch 3.7 fetch_all 3.8 result 3.9 num_rows 3.10 affected_rows 3.11 insert_id 3.12 free_result 3.13 escape 3.14 error_die 3.15 table

Functions Overview
Overview over all functions in the Roster that can be used by Addon Developers.

---

Latest changes

• Nefuh | 05.02.2008 03:07 | Created document

---

Global functions

These function are located in functions.lib.php

border

Parameters: $style, $mode, $header_txt, $width
Starts or ends fancy bodering containers

• @param string $style What bordering style to use
• @param string $mode ( start | end )
• @param string $header_text Place text in a styled header (default null)
• @param string $width Set a fixed width for the box
• @return string

Top

setTooltip

Parameters: $var, $content
Makes a tootip and places it into the tooltip array

• @param string $var
• @param string $content

Top

getAllTooltips

Parameters: none
Gathers all tootips and places them into javascript variables

• @param array $tooltipArray
• @return string Tooltips placed in javascript variables

Top

sql_highlight

Parameters: $sql
Highlight certain keywords in a SQL query

• @param string $sql Query string
• @return string Highlighted string

Top

die_quietly

Parameters: $text, $title, $file, $line, $sql
Clean replacement for die(), outputs a message with debugging info if needed and ends output

• @param string $text Text to display on error page
• @param string $title Title to place on web page (default Message)
• @param string $file Filename to display
• @param string $line Line in file to display
• @param string $sql Any SQL text to display

Top

roster_die

Parameters: $message, $title, $style
Draw a message box with the specified border color, then die cleanly

• @param string $message | The message to display inside the box
• @param string $title | The box title (default Message )
• @param string $style | The border style (default sred)

Top

ajax_die

Parameters: $text, $title, $file, $line, $sql
Print a roster-ajax XML error message

Top

backtrace

Parameters: none
Print a debug backtrace. This works in PHP4.3.x+, there is an integrated function for this starting PHP5 but I prefer always having the same layout.

Top

stripAllHtml

Parameters: $string
This will remove HTML tags, javascript sections and white space. It will also convert some common HTML entities to their text equivalent

• @param string $file

Top

check_if_image

Parameters: $filename
This will check if the given Filename is an image

• @param imagefile $file
• @return mixed The extentsion if the filetype is an image, false if it is not

Top

colorTooltip

Parameters: $tooltip, $caption_color, $locale, $inline_caption
Tooltip colorizer function with string cleaning. Use only with #makeOverlib

• @param string $tooltip | Tooltip as a string (delimited by "\n" character)
• @param string $caption_color | (optional) Color for the caption
• Default is 'ffffff' - white
• @param string $locale | (optional) Locale so color parser can work correctly
• Default is $roster->config['locale']
• @param bool $inline_caption | (optional) (default 1)
• Default is true
• @return string | Formatted tooltip

Top

cleanTooltip

Parameters: $tooltip, $caption_color, $inline_caption
Cleans up the tooltip and parses an inline_caption if needed. Use only with #makeOverlib

• @param string $tooltip | Tooltip as a string (delimited by "\n" character)
• @param string $caption_color | (optional) Color for the caption
• Default is 'ffffff' - white
• @param bool $inline_caption | (optional) (default 1)
• Default is true
• @return string | Formatted tooltip

Top

makeOverlib

Parameters: $tooltip, $caption, $caption_color, $mode, $locale, $extra_parameters
Easy all in one function to make overlib tooltips. Creates a string for insertion into any html tag that has "onmouseover" and "onmouseout" events

• @param string $tooltip | Tooltip as a string (delimited by "\n" character)
• @param string $caption | (optional) Text to set as a true OverLib caption
• @param string $caption_color | (optional) Color for the caption
• Default is 'ffffff' - white
• @param bool $mode| (optional) Options 0=colorize,1=clean,2=pass through (default 0)
• Default 0 (colorize)
• @param string $locale | Locale so color parser can work correctly
• Only needed when $colorize is true
• Default is $roster->config['locale']
• @param string $extra_parameters | (optional) Extra OverLib parameters you wish to pass
• @param string $item_id
• @return unknown

Top

messagebox

Parameters: $message, $title, $style, $width
Draw a message box with the specified border color.

• @param string $message | The message to display inside the box
• @param string $title | The box title (default message)
• @param string $style | The border style (default sgray)
• @param string $width | Set a fixed width
• @return string $html | The HTML for the messagebox

Top

scrollbox

Parameters: $message, $title, $style, $width, $height
Draw a 300x550px scrolling messagebox with the specified border color.

• @param string $message | The message to display inside the box
• @param string $title | The box title (default message)
• @param string $style | The border style (default sgray)
• @param string $width | Initial width with unit (default 550px)
• @param string $height | Initial height with unit (default 300px)
• @return string $html | The HTML for the messagebox

Top

messageboxtoggle

Parameters: $message, $title, $style, $open, $width
Draw a message box with the specified border color.

• @param string $message | The message to display inside the box
• @param string $title | The box title
• @param string $style | The border style (default sgray)
• @param boolean $open | True if initially open (default false)
• @param string $width | Initial width with unit (default 550px)
• @return string $html | The HTML for the messagebox

Top

scrollboxtoggle

Parameters: $message, $title, $style, $open, $width, $height
Draw a 300x550px scrolling messagebox with the specified border color.

• @param string $messages | The message to display inside the box
• @param string $title | The box title (default message)
• @param string $style | The border style (default sgray)
• @param string $width | Initial width with unit (default 550px)
• @param string $height | Initial height with unit (default 300px)
• @return string $html | The HTML for the messagebox

Top

escape_array

Parameters: $array
Recursively escape $array

• @param array $array | The array to escape
• @return array | The same array, escaped

Top

stripslash_array

Parameters: $array
Recursively stripslash $array

• @param array $array | The array to escape
• @return array | The same array, escaped

Top

readbleDate

Parameters: $datetime, $offset
Converts a datetime field into a readable date

• @param string $datetime | datetime field data in DB
• @param string $offset | Offset in hours to calcuate time returned
• @return string | formatted date string

Top

get_file_ext

Parameters: $filename
Gets a file's extention passed as a string

• @param string $filename
• @return string

Top

seconds_to_time

Parameters: $seconds
Converts seconds to a string delimited by time values. Will show w,d,h,m,s

• @param string $seconds
• @return string

Top

getaddon

Parameters: $addonname
Sets up addon data for use in the addon framework

• @param string $addonname | The name of the addon
• @return array $addon | The addon's database record
• @global array $addon_conf | The addon's config data is added to this global array.

Top

active_addon

Parameters: $name
Check to see if an addon is active or not

• @param string $name | Addon basename
• @return bool

Top

urlgrabber

Parameters: $url, $timeout, $user_agent, $loopcount
Handles retrieving the contents of a URL trying multiple methods. Current methods are curl, file_get_contents, fsockopen and will try each in that order

• @param string $url | URL to retrieve
• @param int $timeout | Timeout for curl, socket connection timeout for fsock (default 5)
• @param string $user_agent | Useragent to use for connection (default false)
• @param int $loopcount | (default 0)
• @return mixed | False on error, contents on success

Top

request_uri

Parameters: none
Stupid function to create an REQUEST_URI for IIS 5 servers

• @return string

Top

file_writer

Parameters: $filename, &$content, $mode
Attempts to write a file to the file system

• @param string $filename | Name of the file
• @param string $content | Content of the file
• @param string $mode | (default wb)
• @return bool

Top

php_as_nobody

Parameters: $file
No Description

Top

_aprint

Parameters: $arr, $tab
Debugging function dumps arrays/object formatted. Do Not call this, call aprint()

• @param array $arr
• @param int $tab | (default 1)
• @return string

Top

aprint

Parameters: $arr, $prefix, $return
Debugging function dumps arrays/object formatted

• @param array $arr
• @param string $prefix
• @return string | (default false)

Top

socketColorEn

Parameters: $socket_color, $locale
Helper function that returns the localized gem color in english

• @param string $socket_color
• @return string $color

Top

format_microtime

Parameters: none
No Description

Top

array_overlay

Parameters: $skel, $arr
A better array_merge()

• @param array $skel
• @param array $arr
• @return array

Top

updateCheck

Parameters: $addon
Checks an addon download id on the wowroster.net rss feed. And informs if there is an update.

• @param string $name | name of the download
• @param string $url | url

Top

dummy

Parameters: none
Dummy function. For when you need a callback that doesn't do anything.

Top

makelink

Parameters: $url, $full
Function to create links in Roster. ALL LINKS SHOULD PASS THROUGH THIS FUNCTION. Hopefully this function will be the magic that makes porting Roster easier (Ninja looted from DragonFly, thanks you guys!).

• @param string $url | (Example: 'util-news-comment&id='.$news_id)
• @param bool $full | (default false)
• @return string

Top

$roster->db

The following functions can be used to operate on database

error

Parameters: none
Get last SQL error

• @return string last SQL error

Top

errno

Parameters:none
Get last SQL errno

• @return string last SQL errno

Top

query

Parameters: $query
Basic query function

• @param $query Query string
• @return mixed Query ID / Error string / Bool

Top

query_first

Parameters: $query
Return the first record (single column) in a query result

• @param $query Query string

Top

build_query

Parameters: $query, $array
Build query

• @param $query
• @param $array Array of field => value pairs (default false)
• @return $query | Returns the builded query

Top

fetch

Parameters: $query_id, $result_type
Fetch one record

• @param $query_id | Query ID (default 0)
• @param $result_type | SQL_ASSOC, SQL_NUM, or SQL_BOTH (default SQL_BOTH)
• @return mixed Record / false

Top

fetch_all

Parameters: $query_id, $result_type
Fetch all records

• @param $query_id | Query ID (default 0)
• @param $result_type | SQL_ASSOC, SQL_NUM, or SQL_BOTH
• @return mixed Record Set / false

Top

result

Parameters: $query_id, $row, $field
Get result data

• @param $query_id | Query ID (default 0)
• @param $row | The row number from the result that's being retrieved. Row numbers start at 0
• @param $field | The name or offset of the field being retrieved
• @return mixed Record / false

Top

num_rows

Parameters: $query_id
Find the number of returned rows

• @param $query_id | Query ID (default 0)
• @return mixed Number of rows / false

Top

affected_rows

Parameters: $query_id
Finds out the number of rows affected by a query

• @param $query_id | Query ID (default 0)
• @return mixed Affected Rows / false

Top

insert_id

Parameters: none
Find the ID of the row that was just inserted

• @return mixed Last ID / false

Top

free_result

Parameters: $query_id
Free result data

• @param $query_id | Query ID (default 0)
• @return bool

Top

escape

Parameters: $string
Remove quote escape

• @param $string
• @return string

Top

error_die

Parameters: $setting
Set the error_die var
@param $setting

Top

table

Parameters: $table, $addon
Expand base table name to a full table name

• @param string $table | the base table name
• @param string $addon | the name of the addon, empty for a base roster table
• @return string | tablename as fit for MySQL queries

Top